zcw-shared 1.10.1 → 1.10.3

package/dist/functions/android/modifyManifest.js

@@ -0,0 +1,201 @@
+export async function modifyManifest(manifestPath, modifications, fs, deps) {
+    try {
+        if (!fs.existsSync(manifestPath)) {
+            return {
+                success: false,
+                error: `AndroidManifest.xml文件不存在: ${manifestPath}`
+            };
+        }
+        const xmlContent = fs.readFileSync(manifestPath, 'utf8');
+        const parser = new deps.xmlParser();
+        const xmlDoc = parser.parseFromString(xmlContent, 'text/xml');
+        const parseError = xmlDoc.getElementsByTagName('parsererror');
+        if (parseError.length > 0) {
+            return {
+                success: false,
+                error: `XML解析失败: ${parseError[0].textContent}`
+            };
+        }
+        let hasModifications = false;
+        for (const modification of modifications) {
+            try {
+                const success = await applyModification(xmlDoc, modification, deps);
+                if (success) {
+                    hasModifications = true;
+                }
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: `应用修改失败 (${modification.xpath}): ${error instanceof Error ? error.message : String(error)}`
+                };
+            }
+        }
+        if (hasModifications) {
+            const serializer = new deps.xmlSerializer();
+            const updatedXmlContent = serializer.serializeToString(xmlDoc);
+            const formattedXml = formatXml(updatedXmlContent);
+            fs.writeFileSync(manifestPath, formattedXml, 'utf8');
+            return {
+                success: true,
+                message: `成功应用 ${modifications.length} 个修改`,
+                data: { modificationsApplied: modifications.length }
+            };
+        }
+        else {
+            return {
+                success: true,
+                message: `无需修改`,
+                data: { modificationsApplied: 0 }
+            };
+        }
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `修改AndroidManifest.xml失败: ${error instanceof Error ? error.message : String(error)}`
+        };
+    }
+}
+async function applyModification(xmlDoc, modification, deps) {
+    const { xpath, action, attributeName, value, elementName, attributes } = modification;
+    const elements = evaluateXPath(xmlDoc, xpath, deps);
+    if (elements.length === 0) {
+        if (action === 'addElement') {
+            return await createElementPath(xmlDoc, xpath, elementName, attributes, deps);
+        }
+        return false;
+    }
+    let modified = false;
+    for (const element of elements) {
+        switch (action) {
+            case 'setAttribute':
+                if (attributeName && value !== undefined) {
+                    element.setAttribute(attributeName, value);
+                    modified = true;
+                }
+                break;
+            case 'setTextContent':
+                if (value !== undefined) {
+                    element.textContent = value;
+                    modified = true;
+                }
+                break;
+            case 'addElement':
+                if (elementName) {
+                    const newElement = xmlDoc.createElement(elementName);
+                    if (attributes) {
+                        Object.entries(attributes).forEach(([key, val]) => {
+                            newElement.setAttribute(key, val);
+                        });
+                    }
+                    if (value) {
+                        newElement.textContent = value;
+                    }
+                    element.appendChild(newElement);
+                    modified = true;
+                }
+                break;
+            case 'removeElement':
+                if (element.parentNode && 'removeChild' in element.parentNode) {
+                    element.parentNode.removeChild(element);
+                    modified = true;
+                }
+                break;
+        }
+    }
+    return modified;
+}
+function evaluateXPath(xmlDoc, xpath, deps) {
+    try {
+        const select = deps.xpath.useNamespaces({
+            'android': 'http://schemas.android.com/apk/res/android'
+        });
+        const result = select(xpath, xmlDoc);
+        const elements = [];
+        if (Array.isArray(result)) {
+            for (const node of result) {
+                if (node && typeof node === 'object' && 'nodeType' in node && node.nodeType === 1) {
+                    elements.push(node);
+                }
+            }
+        }
+        else if (result && typeof result === 'object' && 'nodeType' in result && result.nodeType === 1) {
+            elements.push(result);
+        }
+        return elements;
+    }
+    catch (error) {
+        return [];
+    }
+}
+async function createElementPath(xmlDoc, xpath, elementName, attributes, deps) {
+    try {
+        const select = deps.xpath.useNamespaces({
+            'android': 'http://schemas.android.com/apk/res/android'
+        });
+        const pathParts = xpath.split('/');
+        let currentElement = xmlDoc.documentElement;
+        if (!currentElement) {
+            return false;
+        }
+        for (let i = 1; i < pathParts.length - 1; i++) {
+            const part = pathParts[i];
+            if (!part)
+                continue;
+            const elementName = part.split('[')[0];
+            const existingElements = select(`.//${elementName}`, currentElement);
+            let targetElement = null;
+            if (Array.isArray(existingElements) && existingElements.length > 0) {
+                targetElement = existingElements[0];
+            }
+            else if (existingElements && typeof existingElements === 'object' && 'nodeType' in existingElements) {
+                targetElement = existingElements;
+            }
+            if (!targetElement) {
+                targetElement = xmlDoc.createElement(elementName);
+                currentElement.appendChild(targetElement);
+            }
+            currentElement = targetElement;
+        }
+        const newElement = xmlDoc.createElement(elementName);
+        if (attributes) {
+            Object.entries(attributes).forEach(([key, value]) => {
+                newElement.setAttribute(key, value);
+            });
+        }
+        currentElement.appendChild(newElement);
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}
+function formatXml(xmlString) {
+    try {
+        let formatted = xmlString
+            .replace(/></g, '>\n<')
+            .replace(/^\s*\n/gm, '');
+        const lines = formatted.split('\n');
+        let indentLevel = 0;
+        const indentSize = 2;
+        const formattedLines = lines.map(line => {
+            const trimmed = line.trim();
+            if (!trimmed)
+                return '';
+            if (trimmed.startsWith('</')) {
+                indentLevel = Math.max(0, indentLevel - 1);
+            }
+            const indented = ' '.repeat(indentLevel * indentSize) + trimmed;
+            if (trimmed.startsWith('<') && !trimmed.startsWith('</') && !trimmed.endsWith('/>') && !trimmed.includes('</')) {
+                indentLevel++;
+            }
+            return indented;
+        });
+        return formattedLines.join('\n');
+    }
+    catch (error) {
+        return xmlString;
+    }
+}
+//# sourceMappingURL=modifyManifest.js.map

package/dist/functions/android/modifyManifest.js.map

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

package/dist/functions/android/permission.d.ts

@@ -0,0 +1,30 @@
+import type { SystemDependencies } from '../../../types/android-build.d';
+import type { FileSystem } from '../../../references/node.d';
+export declare function configureManifestPermissions(manifestPath: string, permissions: string[], fs: FileSystem, deps: SystemDependencies): Promise<{
+    success: boolean;
+    error: string;
+    message?: undefined;
+    data?: undefined;
+} | {
+    success: boolean;
+    message: string;
+    data: {
+        modificationsApplied: number;
+    };
+    error?: undefined;
+}>;
+export declare function removeManifestPermission(manifestPath: string, permission: string, fs: FileSystem, deps: SystemDependencies): Promise<{
+    success: boolean;
+    error: string;
+    message?: undefined;
+    data?: undefined;
+} | {
+    success: boolean;
+    message: string;
+    data: {
+        modificationsApplied: number;
+    };
+    error?: undefined;
+}>;
+export declare function hasManifestPermission(manifestPath: string, permission: string, fs: FileSystem, deps: SystemDependencies): Promise<boolean>;
+export declare function getManifestPermissions(manifestPath: string, fs: FileSystem, deps: SystemDependencies): Promise<string[]>;

package/dist/functions/android/permission.js

@@ -0,0 +1,65 @@
+import { modifyManifest } from './modifyManifest';
+export async function configureManifestPermissions(manifestPath, permissions, fs, deps) {
+    const modifications = permissions.map(permission => ({
+        xpath: '//manifest',
+        action: 'addElement',
+        elementName: 'uses-permission',
+        attributes: {
+            'android:name': permission
+        }
+    }));
+    return modifyManifest(manifestPath, modifications, fs, deps);
+}
+export async function removeManifestPermission(manifestPath, permission, fs, deps) {
+    const modifications = [
+        {
+            xpath: `//uses-permission[@android:name="${permission}"]`,
+            action: 'removeElement'
+        }
+    ];
+    return modifyManifest(manifestPath, modifications, fs, deps);
+}
+export async function hasManifestPermission(manifestPath, permission, fs, deps) {
+    try {
+        const content = await fs.readFile(manifestPath, 'utf-8');
+        const parser = new deps.xmlParser();
+        const doc = parser.parseFromString(content, 'text/xml');
+        const elements = doc.getElementsByTagName('uses-permission');
+        for (let i = 0; i < elements.length; i++) {
+            const element = elements.item(i);
+            if (element) {
+                const nameAttr = element.getAttribute('android:name');
+                if (nameAttr === permission) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    catch (error) {
+        return false;
+    }
+}
+export async function getManifestPermissions(manifestPath, fs, deps) {
+    try {
+        const content = await fs.readFile(manifestPath, 'utf-8');
+        const parser = new deps.xmlParser();
+        const doc = parser.parseFromString(content, 'text/xml');
+        const permissions = [];
+        const elements = doc.getElementsByTagName('uses-permission');
+        for (let i = 0; i < elements.length; i++) {
+            const element = elements.item(i);
+            if (element) {
+                const nameAttr = element.getAttribute('android:name');
+                if (nameAttr) {
+                    permissions.push(nameAttr);
+                }
+            }
+        }
+        return permissions;
+    }
+    catch (error) {
+        return [];
+    }
+}
+//# sourceMappingURL=permission.js.map

package/dist/functions/android/permission.js.map

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

package/dist/functions/color/colorValidation.d.ts

@@ -0,0 +1,11 @@
+import type { RgbColor, HslColor } from '../../../types/color.d';
+export declare function clampRgbValue(value: number): number;
+export declare function clampHueValue(value: number): number;
+export declare function clampPercentageValue(value: number): number;
+export declare function clampAlphaValue(value: number): number;
+export declare function isValidRgbColor(rgb: RgbColor): boolean;
+export declare function isValidHslColor(hsl: HslColor): boolean;
+export declare function isValidRgbValue(value: number): boolean;
+export declare function isValidHueValue(value: number): boolean;
+export declare function isValidPercentageValue(value: number): boolean;
+export declare function isValidAlphaValue(value: number): boolean;

package/dist/functions/color/colorValidation.js

@@ -0,0 +1,35 @@
+export function clampRgbValue(value) {
+    return Math.max(0, Math.min(255, Math.round(value)));
+}
+export function clampHueValue(value) {
+    return Math.max(0, Math.min(360, Math.round(value)));
+}
+export function clampPercentageValue(value) {
+    return Math.max(0, Math.min(100, Math.round(value)));
+}
+export function clampAlphaValue(value) {
+    return Math.max(0, Math.min(1, value));
+}
+export function isValidRgbColor(rgb) {
+    return (typeof rgb.r === 'number' && rgb.r >= 0 && rgb.r <= 255 &&
+        typeof rgb.g === 'number' && rgb.g >= 0 && rgb.g <= 255 &&
+        typeof rgb.b === 'number' && rgb.b >= 0 && rgb.b <= 255);
+}
+export function isValidHslColor(hsl) {
+    return (typeof hsl.h === 'number' && hsl.h >= 0 && hsl.h <= 360 &&
+        typeof hsl.s === 'number' && hsl.s >= 0 && hsl.s <= 100 &&
+        typeof hsl.l === 'number' && hsl.l >= 0 && hsl.l <= 100);
+}
+export function isValidRgbValue(value) {
+    return typeof value === 'number' && value >= 0 && value <= 255;
+}
+export function isValidHueValue(value) {
+    return typeof value === 'number' && value >= 0 && value <= 360;
+}
+export function isValidPercentageValue(value) {
+    return typeof value === 'number' && value >= 0 && value <= 100;
+}
+export function isValidAlphaValue(value) {
+    return typeof value === 'number' && value >= 0 && value <= 1;
+}
+//# sourceMappingURL=colorValidation.js.map

package/dist/functions/color/colorValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorValidation.js","sourceRoot":"","sources":["../../../src/functions/color/colorValidation.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AACtD,CAAC;AAKD,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AACtD,CAAC;AAKD,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AACtD,CAAC;AAKD,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAA;AACxC,CAAC;AAKD,MAAM,UAAU,eAAe,CAAC,GAAa;IAC3C,OAAO,CACL,OAAO,GAAG,CAAC,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG;QACvD,OAAO,GAAG,CAAC,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG;QACvD,OAAO,GAAG,CAAC,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,CACxD,CAAA;AACH,CAAC;AAKD,MAAM,UAAU,eAAe,CAAC,GAAa;IAC3C,OAAO,CACL,OAAO,GAAG,CAAC,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG;QACvD,OAAO,GAAG,CAAC,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG;QACvD,OAAO,GAAG,CAAC,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,CACxD,CAAA;AACH,CAAC;AAKD,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,GAAG,CAAA;AAChE,CAAC;AAKD,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,GAAG,CAAA;AAChE,CAAC;AAKD,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,GAAG,CAAA;AAChE,CAAC;AAKD,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;AAC9D,CAAC"}

package/dist/functions/color/deduplicateColors.d.ts

@@ -0,0 +1,4 @@
+import type { ColorReference } from '../../../types/color.d';
+export declare function deduplicateColors(colors: ColorReference[]): ColorReference[];
+export declare function deduplicateColorsByValue(colors: ColorReference[]): ColorReference[];
+export declare function deduplicateColorsByStandardizedValue(colors: ColorReference[], standardizeColor: (color: string) => string): ColorReference[];

package/dist/functions/color/deduplicateColors.js

@@ -0,0 +1,40 @@
+export function deduplicateColors(colors) {
+    return deduplicateBy(colors, createUniqueKey);
+}
+function deduplicateBy(colors, keyFn) {
+    if (!colors?.length)
+        return [];
+    const seen = new Set();
+    return colors.filter(color => {
+        const key = keyFn(color);
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+function createUniqueKey(color) {
+    const normalizedValue = color.originalValue.toLowerCase().replace(/\s+/g, '');
+    return `${color.file}:${color.line}:${normalizedValue}`;
+}
+export function deduplicateColorsByValue(colors) {
+    return deduplicateBy(colors, color => color.originalValue.toLowerCase().replace(/\s+/g, ''));
+}
+export function deduplicateColorsByStandardizedValue(colors, standardizeColor) {
+    if (!colors?.length)
+        return [];
+    const seen = new Set();
+    return colors.filter(color => {
+        try {
+            const standardizedValue = standardizeColor(color.originalValue);
+            if (seen.has(standardizedValue))
+                return false;
+            seen.add(standardizedValue);
+            return true;
+        }
+        catch {
+            return true;
+        }
+    });
+}
+//# sourceMappingURL=deduplicateColors.js.map

package/dist/functions/color/deduplicateColors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deduplicateColors.js","sourceRoot":"","sources":["../../../src/functions/color/deduplicateColors.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,iBAAiB,CAAC,MAAwB;IACxD,OAAO,aAAa,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;AAC/C,CAAC;AAKD,SAAS,aAAa,CAAC,MAAwB,EAAE,KAAwC;IACvF,IAAI,CAAC,MAAM,EAAE,MAAM;QAAE,OAAO,EAAE,CAAA;IAE9B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;QAC3B,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;QACxB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAA;QAC/B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACb,OAAO,IAAI,CAAA;IACb,CAAC,CAAC,CAAA;AACJ,CAAC;AAKD,SAAS,eAAe,CAAC,KAAqB;IAC5C,MAAM,eAAe,GAAG,KAAK,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAC7E,OAAO,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,eAAe,EAAE,CAAA;AACzD,CAAC;AAQD,MAAM,UAAU,wBAAwB,CAAC,MAAwB;IAC/D,OAAO,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAA;AAC9F,CAAC;AASD,MAAM,UAAU,oCAAoC,CAClD,MAAwB,EACxB,gBAA2C;IAE3C,IAAI,CAAC,MAAM,EAAE,MAAM;QAAE,OAAO,EAAE,CAAA;IAE9B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;QAC3B,IAAI,CAAC;YACH,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAA;YAC/D,IAAI,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC;gBAAE,OAAO,KAAK,CAAA;YAC7C,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;YAC3B,OAAO,IAAI,CAAA;QACb,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/functions/css/extractCssVariables.d.ts

@@ -0,0 +1,12 @@
+import type { ColorReference } from '../../../types/color.d';
+export interface CssVariableExtractionOptions {
+    validOnly?: boolean;
+    cssVariables?: Record<string, string>;
+}
+export declare function extractCssVariables(text: string, filePath: string, options?: CssVariableExtractionOptions): ColorReference[];
+export declare function extractCssVariableDefinitions(text: string): Array<{
+    variableName: string;
+    value: string;
+    line: number;
+    context: string;
+}>;

package/dist/functions/css/extractCssVariables.js

@@ -0,0 +1,53 @@
+export function extractCssVariables(text, filePath, options = {}) {
+    const { validOnly = true, cssVariables = {} } = options;
+    if (!text || typeof text !== 'string') {
+        return [];
+    }
+    const variables = [];
+    const lines = text.split('\n');
+    const cssVarPattern = /var\(\s*(--[\w-]+)(?:\s*,\s*([^)]+))?\s*\)/g;
+    lines.forEach((line, lineIndex) => {
+        let match;
+        while ((match = cssVarPattern.exec(line)) !== null) {
+            const [fullMatch, variableName, fallback] = match;
+            const variableValue = cssVariables[variableName];
+            if (validOnly && !variableValue && !fallback) {
+                continue;
+            }
+            variables.push({
+                originalValue: fullMatch,
+                format: 'css-variable',
+                line: lineIndex + 1,
+                file: filePath,
+                context: line.trim(),
+                isVariableReference: true,
+                variableName
+            });
+        }
+        cssVarPattern.lastIndex = 0;
+    });
+    return variables;
+}
+export function extractCssVariableDefinitions(text) {
+    if (!text || typeof text !== 'string') {
+        return [];
+    }
+    const definitions = [];
+    const lines = text.split('\n');
+    const cssVarDefPattern = /--(\w[\w-]*?)\s*:\s*([^;]+);/g;
+    lines.forEach((line, lineIndex) => {
+        let match;
+        while ((match = cssVarDefPattern.exec(line)) !== null) {
+            const [, variableName, value] = match;
+            definitions.push({
+                variableName: `--${variableName}`,
+                value: value.trim(),
+                line: lineIndex + 1,
+                context: line.trim()
+            });
+        }
+        cssVarDefPattern.lastIndex = 0;
+    });
+    return definitions;
+}
+//# sourceMappingURL=extractCssVariables.js.map

package/dist/functions/css/extractCssVariables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractCssVariables.js","sourceRoot":"","sources":["../../../src/functions/css/extractCssVariables.ts"],"names":[],"mappings":"AA2BA,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,QAAgB,EAChB,UAAwC,EAAE;IAE1C,MAAM,EAAE,SAAS,GAAG,IAAI,EAAE,YAAY,GAAG,EAAE,EAAE,GAAG,OAAO,CAAA;IAEvD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,SAAS,GAAqB,EAAE,CAAA;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAG9B,MAAM,aAAa,GAAG,6CAA6C,CAAA;IAEnE,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE;QAChC,IAAI,KAAK,CAAA;QACT,OAAO,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACnD,MAAM,CAAC,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAA;YACjD,MAAM,aAAa,GAAG,YAAY,CAAC,YAAY,CAAC,CAAA;YAGhD,IAAI,SAAS,IAAI,CAAC,aAAa,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC7C,SAAQ;YACV,CAAC;YAED,SAAS,CAAC,IAAI,CAAC;gBACb,aAAa,EAAE,SAAS;gBACxB,MAAM,EAAE,cAA6B;gBACrC,IAAI,EAAE,SAAS,GAAG,CAAC;gBACnB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE;gBACpB,mBAAmB,EAAE,IAAI;gBACzB,YAAY;aACb,CAAC,CAAA;QACJ,CAAC;QAGD,aAAa,CAAC,SAAS,GAAG,CAAC,CAAA;IAC7B,CAAC,CAAC,CAAA;IAEF,OAAO,SAAS,CAAA;AAClB,CAAC;AASD,MAAM,UAAU,6BAA6B,CAC3C,IAAY;IAOZ,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,WAAW,GAKZ,EAAE,CAAA;IAEP,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAG9B,MAAM,gBAAgB,GAAG,+BAA+B,CAAA;IAExD,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE;QAChC,IAAI,KAAK,CAAA;QACT,OAAO,CAAC,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACtD,MAAM,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,GAAG,KAAK,CAAA;YAErC,WAAW,CAAC,IAAI,CAAC;gBACf,YAAY,EAAE,KAAK,YAAY,EAAE;gBACjC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;gBACnB,IAAI,EAAE,SAAS,GAAG,CAAC;gBACnB,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE;aACrB,CAAC,CAAA;QACJ,CAAC;QAGD,gBAAgB,CAAC,SAAS,GAAG,CAAC,CAAA;IAChC,CAAC,CAAC,CAAA;IAEF,OAAO,WAAW,CAAA;AACpB,CAAC"}

package/dist/functions/debug/createDebugger.d.ts

@@ -0,0 +1,21 @@
+import type { Window } from '../../../references/browser.d';
+import type { Global } from '../../../references/node.d';
+export interface DebuggerColor {
+    color: string;
+    background: string;
+}
+export interface DebuggerOptions {
+    flag: string;
+    color?: DebuggerColor;
+    force?: boolean;
+}
+export interface Debugger {
+    log: (message: string, ...args: any[]) => void;
+    group: (title: string, collapsed?: boolean) => void;
+    groupEnd: () => void;
+    trace: (message: string) => void;
+    error: (message: string, ...args: any[]) => void;
+    warn: (message: string, ...args: any[]) => void;
+    info: (message: string, ...args: any[]) => void;
+}
+export declare function createDebugger(options: DebuggerOptions, env: Window | Global): Debugger;

package/dist/functions/debug/createDebugger.js

@@ -0,0 +1,89 @@
+export function createDebugger(options, env) {
+    const { flag, color, force = false } = options;
+    let debugEnabled = null;
+    const isDevelopment = () => {
+        return 'window' in env
+            ? Boolean(env.__DEV__)
+            : env.process?.env.NODE_ENV === 'development' || Boolean(env.__DEV__);
+    };
+    const checkBrowserDebug = (windowEnv) => {
+        try {
+            const urlParams = new windowEnv.URLSearchParams(windowEnv.location.search);
+            if (urlParams.has(flag))
+                return true;
+        }
+        catch {
+        }
+        try {
+            return windowEnv.localStorage?.getItem(flag) === 'true';
+        }
+        catch {
+            return false;
+        }
+    };
+    const checkNodeDebug = (nodeEnv) => {
+        return nodeEnv.process?.env.DEBUG?.includes(flag) ?? false;
+    };
+    const isDebugEnabled = () => {
+        if (debugEnabled !== null)
+            return debugEnabled;
+        if (force) {
+            debugEnabled = true;
+            return true;
+        }
+        if (!isDevelopment()) {
+            debugEnabled = false;
+            return false;
+        }
+        debugEnabled = 'window' in env
+            ? checkBrowserDebug(env)
+            : checkNodeDebug(env);
+        return debugEnabled;
+    };
+    const styleString = color
+        ? `color: ${color.color}; background: ${color.background}; padding: 2px 4px; border-radius: 2px; font-weight: bold;`
+        : '';
+    const flagLabel = `[${flag}]`;
+    const styledFlagLabel = `%c${flagLabel}`;
+    const createLogMethod = (method) => {
+        return (message, ...args) => {
+            if (!isDebugEnabled())
+                return;
+            if (color) {
+                env.console[method](styledFlagLabel, styleString, message, ...args);
+            }
+            else {
+                env.console[method](flagLabel, message, ...args);
+            }
+        };
+    };
+    return {
+        log: createLogMethod('log'),
+        error: createLogMethod('error'),
+        warn: createLogMethod('warn'),
+        info: createLogMethod('info'),
+        group: (title, collapsed = false) => {
+            if (!isDebugEnabled())
+                return;
+            const method = collapsed ? env.console.groupCollapsed : env.console.group;
+            method(`${flagLabel} ${title}`);
+        },
+        groupEnd: () => {
+            if (!isDebugEnabled())
+                return;
+            env.console.groupEnd();
+        },
+        trace: (message) => {
+            if (!isDebugEnabled())
+                return;
+            if (color) {
+                env.console.log(styledFlagLabel, styleString, message);
+            }
+            else {
+                env.console.log(flagLabel, message);
+            }
+            env.console.trace();
+        }
+    };
+}
+//# sourceMappingURL=createDebugger.js.map

package/dist/functions/debug/createDebugger.js.map

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

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

@@ -0,0 +1,8 @@
+import type { Rect } from "../../../types/geometry";
+import type { Window } from "../../../references/browser.d";
+export declare function detectOverflow(elementRect: Rect, window: Window, padding?: number): {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+};

package/dist/functions/dom/detectOverflow.js

@@ -0,0 +1,17 @@
+import { getViewportRect } from "./getViewportRect";
+export function detectOverflow(elementRect, window, padding = 0) {
+    const viewportRect = getViewportRect(window);
+    const overflow = {
+        top: viewportRect.top + padding - elementRect.top,
+        right: elementRect.right - (viewportRect.right - padding),
+        bottom: elementRect.bottom - (viewportRect.bottom - padding),
+        left: viewportRect.left + padding - elementRect.left,
+    };
+    return {
+        top: overflow.top > 0 ? overflow.top : 0,
+        right: overflow.right > 0 ? overflow.right : 0,
+        bottom: overflow.bottom > 0 ? overflow.bottom : 0,
+        left: overflow.left > 0 ? overflow.left : 0,
+    };
+}
+//# sourceMappingURL=detectOverflow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detectOverflow.js","sourceRoot":"","sources":["../../../src/functions/dom/detectOverflow.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAepD,MAAM,UAAU,cAAc,CAC5B,WAAiB,EACjB,MAAc,EACd,UAAkB,CAAC;IAEnB,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG;QACf,GAAG,EAAE,YAAY,CAAC,GAAG,GAAG,OAAO,GAAG,WAAW,CAAC,GAAG;QACjD,KAAK,EAAE,WAAW,CAAC,KAAK,GAAG,CAAC,YAAY,CAAC,KAAK,GAAG,OAAO,CAAC;QACzD,MAAM,EAAE,WAAW,CAAC,MAAM,GAAG,CAAC,YAAY,CAAC,MAAM,GAAG,OAAO,CAAC;QAC5D,IAAI,EAAE,YAAY,CAAC,IAAI,GAAG,OAAO,GAAG,WAAW,CAAC,IAAI;KACrD,CAAC;IACF,OAAO;QACL,GAAG,EAAE,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACxC,KAAK,EAAE,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9C,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACjD,IAAI,EAAE,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KAC5C,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { Rect } from '../../../types/geometry';
+import type { HTMLElement } from '../../../references/dom.d';
+export declare function getElementRect(element: HTMLElement): Rect;