@gravionlabs/helix-core 22.0.0

package/types/gravionlabs-helix-core-uix-utils.d.ts

@@ -0,0 +1,387 @@
+declare function cn(...args: any[]): string | undefined;
+/**
+ * @deprecated Use `cn` instead.
+ * @param args
+ * @returns
+ */
+declare function classNames(...args: any[]): string | undefined;
+
+interface BlockBodyScrollOptions {
+    className?: string;
+    variableName?: string;
+}
+declare function blockBodyScroll(option: string | BlockBodyScrollOptions | undefined): void;
+
+declare function exportCSV(csv: any, filename: string): void;
+
+declare function saveAs(file: {
+    name: string;
+    src: string;
+}): boolean;
+
+interface UnblockBodyScrollOptions {
+    className?: string;
+    variableName?: string;
+}
+declare function unblockBodyScroll(option: string | UnblockBodyScrollOptions | undefined): void;
+
+declare function absolutePosition(element: HTMLElement, target: HTMLElement, gutter?: boolean): void;
+
+declare function addClass(element: Element, className: string | undefined | null | (string | undefined | null)[]): void;
+
+declare function addStyle(element: HTMLElement, style: string | object): void;
+
+declare function alignOverlay(overlay: HTMLElement, target: HTMLElement, appendTo: string, calculateMinWidth?: boolean): void;
+
+declare function appendChild(element: unknown, child: Node | Element): void;
+
+declare function calculateBodyScrollbarWidth(): number;
+
+declare function calculateScrollbarHeight(element?: HTMLElement): number;
+
+declare function calculateScrollbarWidth(element?: HTMLElement): number;
+
+declare function clearSelection(): void;
+
+declare function createElement(type: string, attributes?: Record<string, unknown>, ...children: (string | Node)[]): HTMLElement | undefined;
+
+/**
+ * @deprecated Use `createStyleMarkup` instead.
+ */
+declare function createStyleAsString(css?: string, options?: Record<string, unknown>): string;
+
+declare function createStyleElement(css: string, attributes?: Record<string, unknown>, container?: Element): HTMLStyleElement;
+
+declare function createStyleMarkup(css?: string, attributes?: Record<string, unknown>): string;
+
+/**
+ * @deprecated Use `createStyleElement` instead.
+ */
+declare function createStyleTag(attributes?: Record<string, unknown>, container?: Element): HTMLStyleElement;
+
+declare function fadeIn(element: HTMLElement, duration: number): void;
+
+declare function fadeOut(element: HTMLElement, duration: number): void;
+
+declare function find(element: Element, selector: string): Element[];
+
+declare function findSingle(element: Element, selector: string): Element | null;
+
+declare function focus(element: HTMLElement, options?: FocusOptions): void;
+
+declare function getAttribute(element: Element, name: string): any;
+
+type BrowserType = {
+    [key: string]: string | boolean | undefined;
+};
+declare function getBrowser(): BrowserType;
+
+declare function getBrowserLanguage(): string;
+
+declare function getCSSProperty(element?: HTMLElement, property?: string, inline?: boolean): string | null;
+
+declare function getCSSVariableByRegex(variableRegex: RegExp): {
+    name: string | undefined;
+    value: string | undefined;
+} | null;
+
+/**
+ * Ported from @primeuix/utils 0.7.2 (new in 0.7.x; not present in main's 0.6.4 at vendor time).
+ */
+declare function isCssSupported(property: string, value?: string): boolean;
+
+declare function getCursorOffset(element: Element, prevText: string, nextText: string, currentText: string): {
+    top: number | string;
+    left: number | string;
+};
+
+declare function getFirstFocusableElement(element: Element, selector?: string): Element | null;
+
+declare function getFocusableElements(element: Element, selector?: string): Element[];
+
+declare function getHeight(element: HTMLElement): number;
+
+declare function getHiddenElementDimensions(element?: HTMLElement): {
+    width: number;
+    height: number;
+};
+
+declare function getHiddenElementOuterHeight(element: HTMLElement): number;
+
+declare function getHiddenElementOuterWidth(element: HTMLElement): number;
+
+declare function getIndex(element: HTMLElement): number;
+
+declare function getInnerWidth(element: HTMLElement): number;
+
+declare function getLastFocusableElement(element: Element, selector?: string): Element | null;
+
+declare function getNextElementSibling(element: Element, selector: string): Element | null;
+
+declare function getNextFocusableElement(container: Element, element: Element, selector?: string): Element | null;
+
+declare function getOffset(element?: Element | null): {
+    top: number | string;
+    left: number | string;
+};
+
+declare function getOuterHeight(element: HTMLElement, margin?: boolean): number;
+
+declare function getOuterWidth(element: unknown, margin?: boolean): number;
+
+declare function getParentNode(element: Node): ParentNode | null;
+
+declare function getParents(element: Node, parents?: ParentNode[]): ParentNode[];
+
+declare function getPreviousElementSibling(element: Element, selector: string): Element | null;
+
+declare function getScrollLeft(element?: HTMLElement): number;
+
+declare function getScrollableParents(element: Element): Element[];
+
+declare function getSelection(): string | undefined;
+
+declare function getTargetElement(target: unknown, currentElement?: Element): Window | Document | Element | null | undefined;
+
+declare function getUserAgent(): string;
+
+declare function getViewport(): {
+    width: number;
+    height: number;
+};
+
+declare function getWidth(element: HTMLElement): number;
+
+declare function getWindowScrollLeft(): number;
+
+declare function getWindowScrollTop(): number;
+
+declare function hasCSSAnimation(element: Element): boolean;
+
+declare function hasCSSTransition(element: Element): boolean;
+
+declare function hasClass(element: Element, className: string): boolean;
+
+declare function invokeElementMethod<T extends keyof Element>(element: Element, methodName: T, args?: unknown[]): void;
+
+declare function isAndroid(): boolean;
+
+declare function isAttributeEquals(element: Element, name: string, value: any): boolean;
+
+declare function isAttributeNotEquals(element: Element, name: string, value: any): boolean;
+
+declare function isClickable(element: Element): boolean;
+
+declare function isClient(): boolean;
+
+declare function isElement(element: unknown): element is Element;
+
+declare function isExist(element: Node): boolean;
+
+declare function isFocusableElement(element: unknown, selector?: string): boolean;
+
+declare function isHidden(element: HTMLElement): boolean;
+
+declare function isIOS(): boolean;
+
+declare function isPrefersReducedMotion(): boolean;
+
+declare function isRTL(element?: HTMLElement): boolean;
+
+declare function isServer(): boolean;
+
+declare function isTouchDevice(): boolean;
+
+declare function isVisible(element?: HTMLElement): boolean;
+
+declare function nestedPosition(element: HTMLElement, level: number): void;
+
+declare function nextFrame(): Promise<void>;
+
+declare function relativePosition(element: HTMLElement, target: HTMLElement, gutter?: boolean, fixedOrigin?: 'top' | 'bottom' | undefined): void;
+
+declare function remove(element: Element): void;
+
+declare function removeChild(element: unknown, child: Node): void;
+
+declare function removeClass(element: Element, className: string | undefined | null | (string | undefined | null)[]): void;
+
+declare function removeStyleTag(element: Node): Node | null;
+
+declare function resolveUserAgent(): {
+    browser: string | undefined;
+    version: string | undefined;
+};
+
+declare function scrollInView(container: HTMLElement, item: HTMLElement): void;
+
+/**
+ * Ported from @primeuix/utils 0.7.2 (main was 0.6.4 at vendor time): `attribute === 'style'` with
+ * an object value sets each CSS property via `style.setProperty` instead of stringifying it into
+ * a plain attribute value.
+ */
+declare function setAttribute(element: HTMLElement, attribute: string | undefined, value: any): void;
+
+declare function setAttributes(element: HTMLElement, attributes?: {
+    [key: string]: any;
+}): void;
+
+declare function setCSSProperty(element?: HTMLElement, property?: string, value?: any, priority?: string): void;
+
+/**
+ * Ported from @primeuix/utils 0.7.2 (main was 0.6.4 at vendor time): adds `value` (signal-style
+ * refs) and recursive `elementRef` unwrapping on top of the 0.6.4 current/el handling.
+ */
+declare function toElement(element: unknown): Element | null | undefined;
+
+type Handler = (evt: unknown) => void;
+interface EventBusOptions {
+    on(type: string, handler: Handler): void;
+    off(type: string, handler: Handler): void;
+    emit(type: string, evt?: unknown): void;
+    clear(): void;
+}
+declare function EventBus(): EventBusOptions;
+
+declare function mergeProps(...props: any[]): object | undefined;
+declare function mergeDefaultProps(...props: any[]): object | undefined;
+
+declare function compare<T = unknown>(value1: T, value2: T, comparator: (val1: T, val2: T) => number, order?: number): number;
+
+declare function contains<T = unknown>(value: T, list: T[]): boolean;
+
+declare function deepEquals(obj1: unknown, obj2: unknown): boolean;
+
+/**
+ * Merges multiple objects into one.
+ * @param args - Objects to merge.
+ * @returns Merged object.
+ */
+declare function deepMerge(...args: Record<string, unknown>[]): Record<string, unknown>;
+
+declare function equals(obj1: any, obj2: any, field?: string): boolean;
+
+declare function filter<T = any>(value: T[], fields: string[], filterValue: string): T[];
+
+declare function findIndexInList<T = any>(value: T, list: T[]): number;
+
+/**
+ * Firefox-v103 does not currently support the "findLast" method. It is stated that this method will be supported with Firefox-v104.
+ * https://caniuse.com/mdn-javascript_builtins_array_findlast
+ */
+declare function findLast<T = any>(arr: T[], callback: (value: T, index: number, array: T[]) => boolean): T | undefined;
+
+/**
+ * Firefox-v103 does not currently support the "findLastIndex" method. It is stated that this method will be supported with Firefox-v104.
+ * https://caniuse.com/mdn-javascript_builtins_array_findlastindex
+ */
+declare function findLastIndex<T = any>(arr: T[], callback: (value: T, index: number, array: T[]) => boolean): number;
+
+declare function getKeyValue<T extends Record<string, unknown>>(obj: T | undefined, key?: string, params?: unknown): unknown;
+
+declare function insertIntoOrderedArray<T>(item: T, index: number, arr: T[], sourceArr: any[]): void;
+
+declare function isArray(value: any, empty?: boolean): boolean;
+
+declare function isDate(value: unknown): value is Date;
+
+declare function isEmpty(value: any): boolean;
+
+declare function isFunction(value: unknown): value is (...args: unknown[]) => unknown;
+
+declare function isLetter(char: string): boolean;
+
+declare function isNotEmpty(value: any): boolean;
+
+declare function isNumber(value: unknown): boolean;
+
+declare function isObject(value: unknown, empty?: boolean): value is object;
+
+declare function isPrintableCharacter(char?: string): boolean;
+
+declare function isScalar(value: any): boolean;
+
+declare function isString(value: unknown, empty?: boolean): value is string;
+
+declare function localeComparator(): (val1: string, val2: string) => number;
+
+declare function matchRegex(str: string, regex?: RegExp): boolean;
+
+/**
+ * @deprecated Use `deepMerge` instead.
+ *
+ * Merges multiple objects into one.
+ * @param args - Objects to merge.
+ * @returns Merged object.
+ */
+declare function mergeKeys(...args: Record<string, unknown>[]): Record<string, unknown>;
+
+declare function minifyCSS(css?: string): string | undefined;
+
+declare function nestedKeys(obj?: Record<string, any>, parentKey?: string): string[];
+
+declare function omit(obj: unknown, ...keys: string[]): unknown;
+
+declare function removeAccents(str: string): string;
+
+declare function reorderArray<T>(value: T[], from: number, to: number): void;
+
+declare function resolve<T, P extends unknown[], R>(obj: T | ((...params: P) => R), ...params: P): T | R;
+
+declare function resolveFieldData(data: any, field: any): any;
+
+/**
+ * Shallow equal for React/Vue props comparison
+ * Ignores functions (common in props)
+ */
+declare function shallowEqualProps(propsA: Record<string, unknown>, propsB: Record<string, unknown>): boolean;
+
+/**
+ * Checks if two values are shallowly equal
+ * - Primitives: compared by value (===)
+ * - Objects/Arrays: compared by reference and first-level properties
+ *
+ * @param objA - First value to compare
+ * @param objB - Second value to compare
+ * @returns True if values are shallowly equal, false otherwise
+ *
+ * @example
+ * shallowEquals(1, 1) // true
+ * shallowEquals('a', 'a') // true
+ * shallowEquals({ a: 1 }, { a: 1 }) // true (shallow)
+ * shallowEquals({ a: { b: 1 } }, { a: { b: 1 } }) // false (nested objects are different references)
+ * shallowEquals([1, 2], [1, 2]) // true (shallow)
+ * shallowEquals([1, [2]], [1, [2]]) // false (nested arrays are different references)
+ */
+declare function shallowEquals(objA: unknown, objB: unknown): boolean;
+
+declare function sort<T>(value1: T, value2: T, order: number | undefined, comparator: (val1: T, val2: T) => number, nullSortOrder?: number): number;
+
+declare function stringify(value: unknown, indent?: number, currentIndent?: number): string;
+
+declare function toCamelCase(str: string): string;
+
+declare function toCapitalCase(str: string): string;
+
+declare function toFlatCase(str: string): string;
+
+declare function toKebabCase(str: string): string;
+
+declare function toMs(value: string | number): number;
+
+declare function toTokenKey(str: string): string;
+
+declare function toValue(value: unknown): unknown;
+
+declare function uuid(prefix?: string): string;
+
+interface ZIndexOptions {
+    get(element?: HTMLElement): number;
+    set(key: string, element: HTMLElement, baseZIndex?: number): void;
+    clear(element: HTMLElement): void;
+    getCurrent(key: string): number;
+}
+declare const ZIndex: ZIndexOptions;
+
+export { EventBus, ZIndex, absolutePosition, addClass, addStyle, alignOverlay, appendChild, blockBodyScroll, calculateBodyScrollbarWidth, calculateScrollbarHeight, calculateScrollbarWidth, classNames, clearSelection, cn, compare, contains, createElement, createStyleAsString, createStyleElement, createStyleMarkup, createStyleTag, deepEquals, deepMerge, equals, exportCSV, fadeIn, fadeOut, filter, find, findIndexInList, findLast, findLastIndex, findSingle, focus, getAttribute, getBrowser, getBrowserLanguage, getCSSProperty, getCSSVariableByRegex, getCursorOffset, getFirstFocusableElement, getFocusableElements, getHeight, getHiddenElementDimensions, getHiddenElementOuterHeight, getHiddenElementOuterWidth, getIndex, getInnerWidth, getKeyValue, getLastFocusableElement, getNextElementSibling, getNextFocusableElement, getOffset, getOuterHeight, getOuterWidth, getParentNode, getParents, getPreviousElementSibling, getScrollLeft, getScrollableParents, getSelection, getTargetElement, getUserAgent, getViewport, getWidth, getWindowScrollLeft, getWindowScrollTop, hasCSSAnimation, hasCSSTransition, hasClass, insertIntoOrderedArray, invokeElementMethod, isAndroid, isArray, isAttributeEquals, isAttributeNotEquals, isClickable, isClient, isCssSupported, isDate, isElement, isEmpty, isExist, isFocusableElement, isFunction, isHidden, isIOS, isLetter, isNotEmpty, isNumber, isObject, isPrefersReducedMotion, isPrintableCharacter, isRTL, isScalar, isServer, isString, isTouchDevice, isVisible, localeComparator, matchRegex, mergeDefaultProps, mergeKeys, mergeProps, minifyCSS, nestedKeys, nestedPosition, nextFrame, omit, relativePosition, remove, removeAccents, removeChild, removeClass, removeStyleTag, reorderArray, resolve, resolveFieldData, resolveUserAgent, saveAs, scrollInView, setAttribute, setAttributes, setCSSProperty, shallowEqualProps, shallowEquals, sort, stringify, toCamelCase, toCapitalCase, toElement, toFlatCase, toKebabCase, toMs, toTokenKey, toValue, unblockBodyScroll, uuid };
+export type { EventBusOptions, Handler, ZIndexOptions };

package/types/gravionlabs-helix-core-usestyle.d.ts

@@ -0,0 +1,15 @@
+import * as i0 from '@angular/core';
+
+declare class UseStyle {
+    document: Document;
+    use(css: any, options?: any): {
+        id: any;
+        name: any;
+        el: HTMLStyleElement;
+        css: any;
+    } | undefined;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UseStyle, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
+
+export { UseStyle };

package/types/gravionlabs-helix-core-utils.d.ts

@@ -0,0 +1,54 @@
+import { AbstractControl, FormArray, ValidatorFn, AbstractControlOptions, AsyncValidatorFn } from '@angular/forms';
+
+declare class ObjectUtils {
+    static isArray(value: any, empty?: boolean): boolean;
+    static isObject(value: any, empty?: boolean): boolean;
+    static equals(obj1: any, obj2: any, field?: string): boolean;
+    static equalsByValue(obj1: any, obj2: any): boolean;
+    static resolveFieldData(data: any, field: any): any;
+    static isFunction(obj: any): boolean;
+    static reorderArray(value: any[], from: number, to: number): void;
+    static insertIntoOrderedArray(item: any, index: number, arr: any[], sourceArr: any[]): void;
+    static findIndexInList(item: any, list: any): number;
+    static contains(value: any, list: any): boolean;
+    static removeAccents(str: any): any;
+    static isDate(input: any): boolean;
+    static isEmpty(value: any): boolean;
+    static isNotEmpty(value: any): boolean;
+    static compare(value1: any, value2: any, locale: any, order?: number): number;
+    static sort(value1: any, value2: any, order: number | undefined, locale: any, nullSortOrder?: number): number;
+    static merge(obj1?: any, obj2?: any): any;
+    static isPrintableCharacter(char?: string): false | RegExpMatchArray | null;
+    static getItemValue(obj: any, ...params: any[]): any;
+    static findLastIndex(arr: any, callback: any): number;
+    static findLast(arr: any, callback: any): any;
+    static deepEquals(a: any, b: any): boolean;
+    static minifyCSS(css: any): any;
+    static toFlatCase(str: string): string;
+    static isString(value: any, empty?: boolean): boolean;
+}
+
+declare function UniqueComponentId(prefix?: string): string;
+
+declare const _default: {
+    get: (el: any) => number;
+    set: (key: any, el: any, baseZIndex: any) => void;
+    clear: (el: any) => void;
+    getCurrent: () => any;
+    generateZIndex: (key: any, baseZIndex: any) => any;
+    revertZIndex: (zIndex: any) => void;
+};
+
+declare const transformToBoolean: (value: any) => boolean;
+declare const transformToNumber: (value: string | number) => number;
+
+declare function helixFormErrorMap(control: AbstractControl, name?: string, result?: Record<string, string>): Record<string, string>;
+declare class HelixFormArrayWithFactory<TControl extends AbstractControl = AbstractControl> extends FormArray<TControl> {
+    readonly createControl: () => TControl;
+    constructor(createControl: () => TControl, validatorOrOpts?: ValidatorFn | ValidatorFn[] | AbstractControlOptions | null, asyncValidator?: AsyncValidatorFn | AsyncValidatorFn[] | null);
+    alignLength(length: number): void;
+    reset(value?: any, options?: object): void;
+    setValue(value: any, options?: object): void;
+}
+
+export { HelixFormArrayWithFactory, ObjectUtils, UniqueComponentId, _default as ZIndexUtils, helixFormErrorMap, transformToBoolean, transformToNumber };

package/types/gravionlabs-helix-core-validators.d.ts

@@ -0,0 +1,40 @@
+import { ValidatorFn, AbstractControl } from '@angular/forms';
+
+declare enum ValidatorKey {
+    Required = "Required",
+    Email = "Email",
+    Number = "Number",
+    Integer = "Integer",
+    Min = "Min",
+    Max = "Max",
+    MinLength = "MinLength",
+    MaxLength = "MaxLength",
+    Pattern = "Pattern",
+    Date = "Date",
+    OneOf = "OneOf",
+    AllOf = "AllOf"
+}
+
+type ValidatorMessage = (value: any) => string;
+declare const EMPTY_VALUES: (string | null | undefined)[];
+declare const isEmptyValue: (v: unknown) => boolean;
+declare const checkEmpty: (allowEmpty: boolean, check: (value: unknown) => boolean) => (ctrl: AbstractControl) => boolean;
+declare const buildValidator: (isValid: (ctrl: AbstractControl) => boolean, key: ValidatorKey, msg: string | ValidatorMessage) => ValidatorFn;
+
+declare const Validators: {
+    required: (msg: string | ValidatorMessage) => ValidatorFn;
+    email: (msg: string | ValidatorMessage, allowEmpty?: boolean) => ValidatorFn;
+    pattern: (msg: string | ValidatorMessage, regex: RegExp, allowEmpty?: boolean) => ValidatorFn;
+    date: (msg: string | ValidatorMessage, allowEmpty?: boolean) => ValidatorFn;
+    number: (msg: string | ValidatorMessage, allowEmpty?: boolean) => ValidatorFn;
+    integer: (msg: string | ValidatorMessage, allowEmpty?: boolean) => ValidatorFn;
+    min: (msg: string | ValidatorMessage, minimum: number, allowEmpty?: boolean) => ValidatorFn;
+    max: (msg: string | ValidatorMessage, maximum: number, allowEmpty?: boolean) => ValidatorFn;
+    minLength: (msg: string | ValidatorMessage, min: number, allowEmpty?: boolean) => ValidatorFn;
+    maxLength: (msg: string | ValidatorMessage, max: number, allowEmpty?: boolean) => ValidatorFn;
+    oneOf: (msg: string | ValidatorMessage, options: unknown[]) => ValidatorFn;
+    allOf: (msg: string | ValidatorMessage, options: unknown[], allowEmpty?: boolean) => ValidatorFn;
+};
+
+export { EMPTY_VALUES, ValidatorKey, Validators, buildValidator, checkEmpty, isEmptyValue };
+export type { ValidatorMessage };

package/types/gravionlabs-helix-core.d.ts

@@ -0,0 +1,2 @@
+
+export { };