@dss-kit/ui-kit 0.1.0 → 0.1.2

package/dist/utils/hooks/index.d.ts

@@ -0,0 +1,3 @@
+export { useControlled } from './useControlled';
+export { useDropdownPosition } from './useDropdownPosition';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/utils/hooks/useControlled.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Хук для контроля значения компонента.
+ *
+ * @template T Тип значения (например, string).
+ * @param controlled Значение, переданное извне (controlled режим).
+ * @param defaultValue Значение по умолчанию (uncontrolled режим).
+ * @returns Кортеж [value, setValue] — текущее значение и сеттер (активен только в uncontrolled режиме).
+ *
+ * Если передан `value`, компонент работает в controlled-режиме и локальный стейт игнорируется.
+ * Если `value` не передан, используется внутренний `useState`.
+ */
+export declare function useControlled<T>(controlled: T | undefined, defaultValue: T): readonly [T, (newValue: React.SetStateAction<T>) => void];
+//# sourceMappingURL=useControlled.d.ts.map

package/dist/utils/hooks/useControlled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useControlled.d.ts","sourceRoot":"","sources":["../../../src/utils/hooks/useControlled.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,SAAS,EAAE,YAAY,EAAE,CAAC,2BAO5D,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,WASrC"}

package/dist/utils/hooks/useDropdownPosition.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Хук для вычисления и обновления позиции выпадающего списка (dropdown) относительно элемента-триггера.
+ *
+ * Автоматически рассчитывает абсолютную позицию на основе getBoundingClientRect() триггера,
+ * учитывая текущий скролл окна (scrollX/scrollY) и добавляя отступ в 4px снизу от триггера.
+ * Обновляет позицию при:
+ * - Открытии дропдауна (open === true).
+ * - Изменении размера окна (resize).
+ * - Скролле страницы (scroll).
+ * - Изменении размеров самого триггера (ResizeObserver).
+ *
+ * Используется для портального рендеринга дропдауна, чтобы он позиционировался точно под триггером
+ * и оставался на месте при динамических изменениях UI или окна.
+ *
+ * @template {HTMLElement} T - Тип элемента-триггера (по умолчанию HTMLElement).
+ * @param {React.RefObject<T>} triggerRef - Реф на DOM-элемент-триггер (кнопка или инпут, открывающий дропдаун).
+ * @param {boolean} open - Флаг, указывающий, открыт ли дропдаун (обновление позиции происходит только при true).
+ * @returns {{ top: number, left: number, width: number }} Объект с абсолютными координатами и шириной для стилизации дропдауна.
+ *
+ * @example
+ * const triggerRef = useRef<HTMLDivElement>(null);
+ * const [open, setOpen] = useState(false);
+ * const position = useDropdownPosition(triggerRef, open);
+ *
+ * // В JSX: <div ref={triggerRef} onClick={() => setOpen(!open)}>Триггер</div>
+ * // Дропдаун: <div style={{ position: 'absolute', top: position.top, left: position.left, width: position.width }}>...</div>
+ */
+export declare const useDropdownPosition: <T extends HTMLElement = HTMLElement>(triggerRef: React.RefObject<T>, open: boolean) => {
+    top: number;
+    left: number;
+    width: number;
+};
+//# sourceMappingURL=useDropdownPosition.d.ts.map

package/dist/utils/hooks/useDropdownPosition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDropdownPosition.d.ts","sourceRoot":"","sources":["../../../src/utils/hooks/useDropdownPosition.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,WAAW,GAAG,WAAW,EACrE,YAAY,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAC9B,MAAM,OAAO;;;;CAmCd,CAAC"}

package/dist/utils/index.d.ts

@@ -1,2 +1,3 @@
+export * from './hooks';
 export * from './styles';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/package.json

@@ -1,78 +1,80 @@
-{
-  "name": "@dss-kit/ui-kit",
-  "version": "0.1.0",
-  "type": "module",
-  "main": "./dist/ui-kit.cjs.js",
-  "module": "./dist/ui-kit.es.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/ui-kit.es.js",
-      "require": "./dist/ui-kit.cjs.js",
-      "types": "./dist/index.d.ts"
-    },
-    "./ui-kit.css": "./dist/ui-kit.css",
-    "./root.css": "./dist/root.css",
-    "./styles/utils": "./dist/styles/utils/index.scss"
-  },
-  "files": [
-    "dist"
-  ],
-  "sideEffects": false,
-  "scripts": {
-    "build:base": "vite build",
-    "build:root": "vite build --config vite.config.root.ts",
-    "build": "npm run build:base && npm run build:root",
-    "dev": "vite",
-    "type-check": "tsc --noEmit",
-    "lint": "eslint --ext \".js,.ts,.tsx\" --ignore-path .gitignore .",
-    "lint:fix": "npm run lint -- --fix",
-    "format": "prettier --check --ignore-path .gitignore .",
-    "format:fix": "prettier --write --ignore-path .gitignore .",
-    "test": "jest",
-    "storybook": "storybook dev -p 6006",
-    "storybook:build": "storybook build"
-  },
-  "peerDependencies": {
-    "@emotion/css": "^11.13.5",
-    "framer-motion": "^12.23.22",
-    "react": ">=18.0.0 <20.0.0",
-    "react-dom": ">=18.0.0 <20.0.0"
-  },
-  "dependencies": {
-    "classnames": "^2.5.1"
-  },
-  "devDependencies": {
-    "@storybook/addon-docs": "^9.0.14",
-    "@storybook/react-vite": "^9.0.14",
-    "@testing-library/react": "^16.0.0",
-    "@types/jest": "^29.5.12",
-    "@types/node": "^22.3.0",
-    "@types/react": "^18.3.3",
-    "@vitejs/plugin-react": "^4.6.0",
-    "eslint": "^8.57.0",
-    "eslint-config-airbnb": "^19.0.4",
-    "eslint-config-airbnb-typescript": "^18.0.0",
-    "eslint-config-prettier": "^9.1.0",
-    "eslint-plugin-import": "^2.29.1",
-    "eslint-plugin-react": "^7.35.0",
-    "eslint-plugin-react-hooks": "^4.6.2",
-    "eslint-plugin-simple-import-sort": "^12.1.1",
-    "eslint-plugin-storybook": "^9.0.14",
-    "eslint-plugin-unused-imports": "^4.1.3",
-    "globals": "^15.9.0",
-    "jest": "^29.7.0",
-    "jest-environment-jsdom": "^29.7.0",
-    "jest-transform-stub": "^2.0.0",
-    "prettier": "^3.3.3",
-    "sass": "^1.77.8",
-    "storybook": "^9.0.14",
-    "ts-jest": "^29.2.5",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.5.3",
-    "vite": "^7.0.0",
-    "vite-plugin-dts": "^4.5.4",
-    "vite-plugin-static-copy": "^3.1.0",
-    "vite-plugin-svgr": "^4.2.0"
-  }
-}
+{
+  "name": "@dss-kit/ui-kit",
+  "version": "0.1.2",
+  "type": "module",
+  "main": "./dist/ui-kit.cjs.js",
+  "module": "./dist/ui-kit.es.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/ui-kit.es.js",
+      "require": "./dist/ui-kit.cjs.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./ui-kit.css": "./dist/ui-kit.css",
+    "./root.css": "./dist/root.css",
+    "./styles/utils": "./dist/styles/utils/index.scss"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build:base": "vite build",
+    "build:root": "vite build --config vite.config.root.ts",
+    "build": "npm run build:base && npm run build:root",
+    "dev": "vite",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint --ext \".js,.ts,.tsx\" --ignore-path .gitignore .",
+    "lint:fix": "npm run lint -- --fix",
+    "format": "prettier --check --ignore-path .gitignore .",
+    "format:fix": "prettier --write --ignore-path .gitignore .",
+    "test": "jest",
+    "storybook": "storybook dev -p 6006",
+    "storybook:build": "storybook build"
+  },
+  "peerDependencies": {
+    "@emotion/css": "^11.13.5",
+    "framer-motion": "^12.23.22",
+    "react": ">=18.0.0 <20.0.0",
+    "react-dom": ">=18.0.0 <20.0.0"
+  },
+  "dependencies": {
+    "@tanstack/react-virtual": "^3.13.12",
+    "classnames": "^2.5.1"
+  },
+  "devDependencies": {
+    "@storybook/addon-docs": "^9.0.14",
+    "@storybook/react-vite": "^9.0.14",
+    "@testing-library/react": "^16.0.0",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^22.3.0",
+    "@types/react": "^18.3.3",
+    "@types/react-dom": "^18.3.3",
+    "@vitejs/plugin-react": "^4.6.0",
+    "eslint": "^8.57.0",
+    "eslint-config-airbnb": "^19.0.4",
+    "eslint-config-airbnb-typescript": "^18.0.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-import": "^2.29.1",
+    "eslint-plugin-react": "^7.35.0",
+    "eslint-plugin-react-hooks": "^4.6.2",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "eslint-plugin-storybook": "^9.0.14",
+    "eslint-plugin-unused-imports": "^4.1.3",
+    "globals": "^15.9.0",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "jest-transform-stub": "^2.0.0",
+    "prettier": "^3.3.3",
+    "sass": "^1.77.8",
+    "storybook": "^9.0.14",
+    "ts-jest": "^29.2.5",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.5.3",
+    "vite": "^7.0.0",
+    "vite-plugin-dts": "^4.5.4",
+    "vite-plugin-static-copy": "^3.1.0",
+    "vite-plugin-svgr": "^4.2.0"
+  }
+}