@sohanemon/utils 4.1.1 → 4.1.3

package/dist/functions/index.d.ts

@@ -7,6 +7,7 @@
 import { type ClassValue } from 'clsx';
 import type * as React from 'react';
 export * from './cookie';
+export * from './object';
 export declare function cn(...inputs: ClassValue[]): string;
 /**
  * @deprecated Use isLinkActive instead.

package/dist/functions/index.js

@@ -8,6 +8,7 @@ import { clsx } from 'clsx';
 import { extendTailwindMerge } from 'tailwind-merge';
 import { withFluid } from '@fluid-tailwind/tailwind-merge';
 export * from './cookie';
+export * from './object';
 export function cn(...inputs) {
     const twMerge = extendTailwindMerge(withFluid);
     return twMerge(clsx(inputs));

package/dist/functions/object.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Type representing a path split into segments
+ * @template S - The original path string type
+ */
+type SplitPath<S extends string> = S extends `${infer First}.${infer Rest}` ? [First, ...SplitPath<Rest>] : [S];
+/**
+ * Recursive type to resolve nested object types based on path
+ * @template T - Current object type
+ * @template K - Array of path segments
+ */
+type GetValue<T, K extends Array<string | number>> = K extends [
+    infer First,
+    ...infer Rest
+] ? First extends keyof T ? GetValue<T[First], Rest extends Array<string | number> ? Rest : []> : First extends `${number}` ? T extends any[] ? GetValue<T[number], Rest extends Array<string | number> ? Rest : []> : undefined : undefined : T;
+/**
+ * Get a nested value from an object using array path segments
+ * @template T - Object type
+ * @template K - Path segments array type
+ * @template D - Default value type
+ * @param obj - Source object
+ * @param path - Array of path segments
+ * @param defaultValue - Fallback value if path not found
+ * @returns Value at path or default value
+ *
+ * @example
+ * getObjectValue({a: [{b: 1}]}, ['a', 0, 'b']) // 1
+ */
+export declare function getObjectValue<T, K extends Array<string | number>, D>(obj: T, path: K, defaultValue: D): Exclude<GetValue<T, K>, undefined> | D;
+/**
+ * Get a nested value from an object using array path segments
+ * @template T - Object type
+ * @template K - Path segments array type
+ * @param obj - Source object
+ * @param path - Array of path segments
+ * @returns Value at path or undefined
+ *
+ * @example
+ * getObjectValue({a: [{b: 1}]}, ['a', 0, 'b']) // 1
+ */
+export declare function getObjectValue<T, K extends Array<string | number>>(obj: T, path: K): GetValue<T, K> | undefined;
+/**
+ * Get a nested value from an object using dot notation path
+ * @template T - Object type
+ * @template S - Path string literal type
+ * @template D - Default value type
+ * @param obj - Source object
+ * @param path - Dot-separated path string
+ * @param defaultValue - Fallback value if path not found
+ * @returns Value at path or default value
+ *
+ * @example
+ * getObjectValue({a: [{b: 1}]}, 'a.0.b', 2) // 1
+ */
+export declare function getObjectValue<T, S extends string, D>(obj: T, path: S, defaultValue: D): Exclude<GetValue<T, SplitPath<S>>, undefined> | D;
+/**
+ * Get a nested value from an object using dot notation path
+ * @template T - Object type
+ * @template S - Path string literal type
+ * @param obj - Source object
+ * @param path - Dot-separated path string
+ * @returns Value at path or undefined
+ *
+ * @example
+ * getObjectValue({a: [{b: 1}]}, 'a.0.b') // 1
+ */
+export declare function getObjectValue<T, S extends string>(obj: T, path: S): GetValue<T, SplitPath<S>> | undefined;
+export {};

package/dist/functions/object.js

@@ -0,0 +1,39 @@
+/**
+ * Implementation of deep object value retrieval with type safety
+ * @param obj - Source object
+ * @param path - Path specification (string or array)
+ * @param defaultValue - Optional fallback value
+ * @returns Value at path or default/undefined
+ */
+export function getObjectValue(obj, path, defaultValue) {
+    // Validate path type and handle edge cases
+    if (typeof path !== 'string' && !Array.isArray(path)) {
+        return defaultValue;
+    }
+    // Ensure pathArray is always an array
+    const pathArray = (() => {
+        if (Array.isArray(path))
+            return path;
+        if (path === '')
+            return [];
+        return String(path)
+            .split('.')
+            .filter((segment) => segment !== '');
+    })();
+    // Final safety check for array type
+    if (!Array.isArray(pathArray)) {
+        return defaultValue;
+    }
+    let current = obj;
+    for (const key of pathArray) {
+        if (current === null || current === undefined) {
+            return defaultValue;
+        }
+        // Convert numeric strings to numbers for arrays
+        const actualKey = typeof key === 'string' && Array.isArray(current) && /^\d+$/.test(key)
+            ? Number.parseInt(key, 10)
+            : key;
+        current = current[actualKey];
+    }
+    return current !== undefined ? current : defaultValue;
+}

package/dist/hooks/index.d.ts

@@ -94,15 +94,40 @@ export declare function useCopyToClipboard({ timeout }: {
 /**
  * Properties for height calculation.
  */
-type CalculationProps = {
+type CalculationProps2 = {
     blockIds: string[];
     dynamic?: boolean | string;
     margin?: number;
     substract?: boolean;
 };
 /**
+ *
  * Hook to calculate the height of an element based on viewport and other block heights.
  * @param params - Configuration object for height calculation.
  * @returns The calculated height.
  */
-export declare const useHeightCalculation: ({ blockIds, margin, substract, dynamic, }: CalculationProps) => number;
+export declare const useHeightCalculation: ({ blockIds, margin, substract, dynamic, }: CalculationProps2) => number;
+/**
+ * Properties for DOM calculation.
+ */
+type CalculationProps = {
+    blockIds: string[];
+    dynamic?: boolean | string;
+    margin?: number;
+    substract?: boolean;
+    onChange?: (results: {
+        blocksHeight: number;
+        blocksWidth: number;
+        remainingWidth: number;
+        remainingHeight: number;
+    }) => void;
+};
+/**
+ * Hook to calculate dimensions (height and width) of an element based on viewport and other block dimensions.
+ * @param params - Configuration object for dimension calculation.
+ * @returns An object containing the calculated height and width.
+ */
+export declare const useDomCalculation: ({ blockIds, margin, substract, dynamic, onChange, }: CalculationProps) => {
+    height: number;
+    width: number;
+};

package/dist/hooks/index.js

@@ -260,6 +260,7 @@ export function useCopyToClipboard({ timeout = 2000 }) {
     return { isCopied, copy };
 }
 /**
+ *
  * Hook to calculate the height of an element based on viewport and other block heights.
  * @param params - Configuration object for height calculation.
  * @returns The calculated height.
@@ -292,3 +293,47 @@ export const useHeightCalculation = ({ blockIds = [], margin = 0, substract = tr
     }, []);
     return height;
 };
+/**
+ * Hook to calculate dimensions (height and width) of an element based on viewport and other block dimensions.
+ * @param params - Configuration object for dimension calculation.
+ * @returns An object containing the calculated height and width.
+ */
+export const useDomCalculation = ({ blockIds = [], margin = 0, substract = true, dynamic = false, onChange, }) => {
+    const [dimensions, setDimensions] = React.useState({
+        height: 500,
+        width: 500,
+    });
+    const handleCalculation = () => {
+        const blocksHeight = blockIds.reduce((prevHeight, id) => prevHeight + (document.getElementById(id)?.clientHeight || 0), 0);
+        const blocksWidth = blockIds.reduce((prevWidth, id) => prevWidth + (document.getElementById(id)?.clientWidth || 0), 0);
+        const height = substract
+            ? window.innerHeight - blocksHeight - margin
+            : blocksHeight + margin;
+        const width = substract
+            ? window.innerWidth - blocksWidth - margin
+            : blocksWidth + margin;
+        const newDimensions = { height, width };
+        setDimensions(newDimensions);
+        onChange?.({
+            blocksWidth,
+            blocksHeight,
+            remainingWidth: width,
+            remainingHeight: height,
+        });
+    };
+    useIsomorphicEffect(() => {
+        handleCalculation();
+        if (!dynamic)
+            return;
+        if (typeof dynamic === 'string') {
+            const resizableElement = document.getElementById(dynamic);
+            const resizeObserver = new ResizeObserver(() => handleCalculation());
+            if (resizableElement)
+                resizeObserver.observe(resizableElement);
+            return () => resizeObserver.disconnect();
+        }
+        window.addEventListener('resize', handleCalculation);
+        return () => window.removeEventListener('resize', handleCalculation);
+    }, []);
+    return dimensions;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sohanemon/utils",
-  "version": "4.1.1",
+  "version": "4.1.3",
   "author": "Sohan Emon <sohanemon@outlook.com>",
   "description": "",
   "type": "module",
@@ -15,33 +15,19 @@
   },
   "typesVersions": {
     "*": {
-      "core": [
-        "dist/index.d.ts"
-      ],
-      "types": [
-        "dist/types/index.d.ts"
-      ],
-      "hooks": [
-        "dist/hooks/index.d.ts"
-      ],
-      "components": [
-        "dist/components/index.d.ts"
-      ]
+      "core": ["dist/index.d.ts"],
+      "types": ["dist/types/index.d.ts"],
+      "hooks": ["dist/hooks/index.d.ts"],
+      "components": ["dist/components/index.d.ts"]
     }
   },
-  "files": [
-    "dist",
-    "README.md"
-  ],
+  "files": ["dist", "README.md"],
   "scripts": {
     "build": "tsc",
     "build:watch": "tsc --watch",
     "export": "tsc && npm publish"
   },
-  "keywords": [
-    "utils",
-    "cn"
-  ],
+  "keywords": ["utils", "cn"],
   "license": "ISC",
   "devDependencies": {
     "@types/node": "^22.4.0",