@wshcmx/types 13.3.0 → 13.5.0

package/CONTRIBUTING.md

@@ -1,5 +1,23 @@
 🤝 Как сделать вклад?
 
 1. Клонируй репозиторий
-2. Делай правку
-3. Создавай PR
+2. Установи зависимости и проверь проект:
+
+   ```bash
+   pnpm install --frozen-lockfile
+   pnpm run check
+   ```
+
+3. Для генератора .NET установи зависимости отдельно:
+
+   ```bash
+   pnpm --dir dotnet/Wshcmx.Types/scripts install --frozen-lockfile
+   pnpm run generate:dotnet
+   ```
+
+   Команды выполняются из корня репозитория. Оба проекта используют pnpm;
+   изменения зависимостей нужно фиксировать вместе с соответствующим `pnpm-lock.yaml`.
+   В CI зависимости устанавливаются с `--frozen-lockfile`.
+
+4. Делай правку
+5. Создавай PR

package/README.md

@@ -17,12 +17,25 @@
 > [!CAUTION]
 > Для использования работы на проекте с typescript советуем использовать [cli](https://github.com/wshcmx/cli), который решает проблемы связанные с транспиляцией кода под платформу WebSoftHCM.
 
-### npm
+### pnpm
 
 ```bash
-npm i @wshcmx/types -D
+pnpm add @wshcmx/types -D
 ```
 
+### .NET
+
+Generate the C# models and build the NuGet package from the repository root
+(Node.js 25 and .NET SDK 8 or later):
+
+```bash
+npm ci
+npm run generate:dotnet
+dotnet pack dotnet/Wshcmx.Types/Wshcmx.Types.csproj -c Release -o ./nupkg
+```
+
+The package includes this README.
+
 ## 🔨 Настройка
 
 Типы можно использовать как в проектах, написанных с использованием ts, так и в проектах, написанных на js.
@@ -30,7 +43,7 @@ npm i @wshcmx/types -D
 Генерируем конфиг, либо просто создаем вручную файл **tsconfig.json**
 
 ```bash
-npx tsc -init
+pnpm exec tsc -init
 ```
 
 Далее обновляем конфиг:

package/lib/core/index.d.ts

@@ -552,11 +552,12 @@ declare function XQueryLiteral(arg: string | number | Date): string;
 
 /**
  * Возвращает фрагмент сроки по заданным позициям (в символах).
+ * @param {string} str - Строка.
  * @param {number} startPosition - Начальная позиция.
  * @param {number} endPosition - Конечная позиция.
  * @returns {string} Результат.
  */
-declare function StrCharRangePos(startPosition: number, endPosition: number): string;
+declare function StrCharRangePos(str: string, startPosition: number, endPosition: number): string;
 
 /**
  * Проверяет две строки на равенство, в том числе без учета регистра.
@@ -1076,9 +1077,10 @@ declare function ParseDate(date: string): Date;
  * @param {Date} date - Объект даты.
  * @param {boolean} [showTime] - Включать время. По умолчанию true.
  * @param {boolean} [showSeconds] - Включать секунды во времени. По умолчанию true.
+ * @param {boolean} [showLocalTime] - Преобразовывать в местоное время. По умолчанию false.
  * @returns {string} Строка с датой.
  */
-declare function StrDate(date: Date, showTime?: boolean, showSeconds?: boolean): string;
+declare function StrDate(date: Date, showTime?: boolean, showSeconds?: boolean, showLocalTime?: boolean): string;
 
 /**
  * Возвращает время в миллисекундах, прошедшее с момента запуска операционной системы.

package/lib/object/index.d.ts

@@ -36,10 +36,15 @@ interface Object {
   DeleteOptProperty(key: string): void;
 
   /**
-   * Возвращает значение атрибута объекта. Если атрубут отсутствует, выдает undefined.
+   * Возвращает значение атрибута объекта. Если атрубут отсутствует, выдает defaultValue или undefined.
    * @param {string} key - Наименование атрибута объекта.
    * @param {unknown} [defaultValue] - Значение по умолчанию, возращаемое в случае отсутствия атрибута.
    */
+  GetOptProperty<O, K extends keyof O & string, D>(
+    this: O,
+    key: K,
+    defaultValue: D
+  ): Exclude<O[K], undefined> | D;
   GetOptProperty<O, K extends string, D = undefined>(
     this: O,
     key: K,

package/lib/xml/resource/index.d.ts

@@ -187,8 +187,8 @@ GameBonusBase & {
   check_resource_double(fileName: string, size: number): unknown;
   put_data(url: string, source: unknown, filename: unknown): unknown;
   put_data_add(url: string, code: string): unknown;
-  del_data_add(id: string): unknown;
-  put_str(data: string, filename: unknown, source: unknown): unknown;
+  del_data_add(id: string): void;
+  put_str(data: string, filename: string, source?: XmlDocument): void;
   add_counter(source: unknown): unknown;
   del_counter(source: unknown, sourceId: number): unknown;
   obtain_link(source: unknown): unknown;

package/package.json

@@ -1,18 +1,10 @@
 {
   "name": "@wshcmx/types",
-  "version": "13.3.0",
+  "version": "13.5.0",
   "type": "module",
   "directories": {
     "lib": "lib"
   },
-  "scripts": {
-    "check": "npm run lint:lib && npm run lint:tests && npm run tsc:lib && npm run tsc:tests",
-    "lint:lib": "eslint -c ./lib/eslint.config.js lib",
-    "lint:tests": "eslint -c ./tests/eslint.config.js tests",
-    "tsc:lib": "tsc -p lib/tsconfig.json",
-    "tsc:tests": "tsc -p tests/tsconfig.json",
-    "generate:dotnet": "node dotnet/Wshcmx.Types/scripts/index.ts"
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/wshcmx/types.git"
@@ -34,9 +26,17 @@
   "homepage": "https://github.com/wshcmx/types#readme",
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "eslint": "^10.10.0",
-    "eslint-plugin-jsdoc": "^64.4.0",
+    "eslint": "^10.13.0",
+    "eslint-plugin-jsdoc": "^65.4.0",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.70.0"
+    "typescript-eslint": "^8.72.0"
+  },
+  "scripts": {
+    "check": "pnpm run lint:lib && pnpm run lint:tests && pnpm run tsc:lib && pnpm run tsc:tests",
+    "lint:lib": "eslint -c ./lib/eslint.config.js lib",
+    "lint:tests": "eslint -c ./tests/eslint.config.js tests",
+    "tsc:lib": "tsc -p lib/tsconfig.json",
+    "tsc:tests": "tsc -p tests/tsconfig.json",
+    "generate:dotnet": "node dotnet/Wshcmx.Types/scripts/index.ts"
   }
-}
+}