Optimize

.github/workflows/nodejs.yml → .github/workflows/main.yml

@@ -8,7 +8,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Check out code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
       - name: Lint changelog file
         uses: avto-dev/markdown-lint@v1
         with:
@@ -21,28 +21,16 @@ jobs:
     name: testing on Node
     strategy:
       matrix:
-        node-version: [ 20.x ]
+        node-version: [ 22.x ]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
           node-version: ${{ matrix.node-version }}
 
-      - name: Get npm cache directory
-        id: npm-cache
-        run: |
-          echo "dir=$(npm config get cache)" >> $GITHUB_OUTPUT
-
-      - uses: actions/cache@v4
-        with:
-          path: ${{ steps.npm-cache.outputs.dir }}
-          key: ${{ runner.os }}-node-${{ hashFiles('**/package.json') }}
-          restore-keys: |
-            ${{ runner.os }}-node-
-
       - run: yarn install
       - run: yarn lint
         env:
@@ -54,30 +42,18 @@ jobs:
     needs: [ lint-changelog, lint-code ]
     strategy:
       matrix:
-        node-version: [ 20.x,22.x,24.x ]
+        node-version: [ 22.x,24.x ]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
           node-version: ${{ matrix.node-version }}
 
-      - name: Get npm cache directory
-        id: npm-cache
-        run: |
-          echo "dir=$(npm config get cache)" >> $GITHUB_OUTPUT
-
-      - uses: actions/cache@v4
-        with:
-          path: ${{ steps.npm-cache.outputs.dir }}
-          key: ${{ runner.os }}-node-${{ hashFiles('**/package.json') }}
-          restore-keys: |
-            ${{ runner.os }}-node-
-
       - run: yarn install
-      - run: yarn test
+      - run: yarn test-all
         env:
           CI: true
 
@@ -86,13 +62,13 @@ jobs:
     needs: [ lint-changelog, testing-on-node ]
     if: ${{ startsWith(github.ref, 'refs/tags/v') }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       # Setup .npmrc file to publish to npm
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
-          node-version: '20.x'
+          node-version: '22.x'
           registry-url: 'https://registry.npmjs.org'
-      - run: npm install
+      - run: yarn install
       # Publish to npm
       - run: npm publish --access public
         env:

.npmignore

@@ -0,0 +1,21 @@
+# Folders not needed in the published package
+node_modules
+coverage
+docs
+tests
+scripts
+.github
+.husky
+
+# Local/output artifacts
+*.log
+.output.txt
+.DS_Store
+
+# TypeScript project files (config is whitelisted via package.json "files")
+tsconfig.esm.json
+tsconfig.types.json
+
+# Editor/IDE
+.idea
+.vscode

CHANGELOG.md

@@ -7,6 +7,38 @@ and this project adheres to [Semantic Versioning][semver].
 
 ## [unreleased]
 
+## [5.0.0] - 2025-12-05
+
+### Added
+
+- [format] New options-object API for `number`, adds `NumberFormatOptions` and `numberRus` preset
+- [date] New helpers: `dateToStringUTC`, `parseISO` (strict ISO/RFC3339 parser)
+- [is] New predicates: `isBlank`, `isUrl` docs extended; added/clarified predicates for floats, integers, numerics
+- [object] New/extended docs and tests for `defaults`, `merge`, `fromQueryString`, `pathToObject`, `values`, `sum`, `logicalAnd`, `getSize`, `toQueryObjects`, `toQueryString`
+- [core] New clone strategy based on `structuredClone` with fallback for plain objects/arrays
+- [tests] Integration test for imports/typings (`tests/integration/importMu.ts`); extended tests for format/date/is/object
+- [docs] Full per-helper documentation in `docs/**` for all functions listed in `docs/README.md` (EN) and
+  `docs/ru/README.md` (RU overview)
+
+### Changed
+
+- [core] Drop CJS usage in src; ESM-first package layout, Node >= 22 as minimum runtime
+- [object] `merge` and `defaults` made **immutable**, use only own enumerable keys, deep-merge only plain objects; arrays now cloned instead of merged; added proto-pollution guards
+- [core] `clone` behavior modernized for Node 22 (uses `structuredClone` where safe; clearer handling of Dates, complex types)
+- [date] `elapsed` and `now` simplified; `dateToString` explicitly local, `dateToStringUTC` explicitly UTC
+- [format] `number`/`numberRus` now корректно обрабатывают `NaN`, `Infinity`, `-0`; RU‑локаль: запятая как десятичный разделитель, пробел — тысячный
+- [is] Ужесточена логика `isNumeric`, `isEven`, других числовых предикатов (используются `Number.isFinite`, явное приведение)
+- [object] Использование современных нативных API (`Object.hasOwn`, `Object.values`, `URLSearchParams`) вместо самописных утилит
+- [core/object/date/format/is] Масштабное обновление JSDoc и пользовательской документации для отражения новой семантики
+- [tests] Jest/ts-jest сконфигурирован на `isolatedModules: true` через `tsconfig.json`
+
+### Fixed
+
+- [format] Исправлена русская локаль в `numberRus` (запятая как десятичный разделитель, пробел как разделитель тысяч)
+- [object] Исправлены возможные пути proto-pollution в `fromQueryString`, `pathToObject` и связанных хелперах
+- [is] Устранены неточные проверки чисел (отказ от глобального `isNaN`/`isFinite` в пользу `Number.isNaN`/`Number.isFinite`)
+- [docs] Устранены расхождения между документацией и кодом, добавлены отсутствующие страницы, обновлены README EN/RU
+
 ## [4.7.0] - 2023-11-28
 
 ### Added

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2022 Fureev Eugene
+Copyright (c) 2025 Fureev Eugene
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal