@wshcmx/types 11.0.0-beta1 → 11.0.9

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

@@ -1,13 +1,31 @@
 type RoleCatalogDocumentTopElem = XmlTopElem &
 ObjectCodeNameBase & {
-  parent_role_id: XmlElem<number>;
+  /** Родительская категория */
+  parent_role_id: XmlElem<number | null, RoleCatalogDocumentTopElem>;
+  /**
+   * Тип объекта
+   * @default item
+   */
   catalog_name: XmlElem<string, typeof common.exchange_object_types>;
+  /**
+   * Является системным
+   * @default false
+   */
   is_std: XmlElem<boolean>;
+  /**
+   * Измененный
+   * @default false
+   */
   changed: XmlElem<boolean>;
-  modification_date: XmlElem<Date>;
-  app_instance_id: XmlElem<string>;
-  knowledge_parts: XmlElem<string>;
-  tags: XmlElem<string>;
-  experts: XmlElem<string>;
-  OnBuild(): unknown;
+  /** Дата модификации */
+  modification_date: XmlElem<Date | null>;
+  /** Код сервера */
+  app_instance_id: XmlElem<string | null>;
+  /** Значения карты знаний */
+  knowledge_parts: XmlElem<string | null>;
+  /** Тэги */
+  tags: XmlElem<string | null>;
+  /** Эксперты */
+  experts: XmlElem<string | null>;
+  OnBuild(): void;
 };

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

@@ -120,8 +120,8 @@ I18nBase & {
   /** @temp */
   converter: XmlElem<boolean | null>;
   calculate_on_server(objectId: number): unknown;
-  calculate(object: unknown, from: Date, to: Date, period: string, option: unknown): unknown;
-  calculate_context(objectTopElem: unknown, env: unknown, configuration: string): unknown;
+  calculate(object: unknown, from: Date, to: Date, period: string, option: Object): unknown;
+  calculate_context(objectTopElem: XmlTopElem, env: unknown, configuration: string): unknown;
   /** Категория */
   role_id: XmlMultiElemObject<number | null, RoleCatalogDocumentTopElem>;
 };

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

@@ -1,10 +1,20 @@
 type TestingSystemCatalogDocumentTopElem = XmlTopElem &
 AdminAccessBase & {
-  id: XmlElem<number>;
-  code: XmlElem<string>;
-  name: XmlElem<string>;
-  is_std: XmlElem<boolean>;
-  modification_date: XmlElem<Date>;
-  app_instance_id: XmlElem<string>;
-  OnBuild(): unknown;
+  id: XmlElem<number | null>;
+  /** Код */
+  code: XmlElem<string | null>;
+  /** Название */
+  name: XmlElem<string | null>;
+  /** Является системным */
+  is_std: XmlElem<boolean | null>;
+  /**
+   * Измененный
+   * @default false
+   */
+  changed: XmlElem<boolean>;
+  /** Дата модификации */
+  modification_date: XmlElem<Date | null>;
+  /** Код сервера */
+  app_instance_id: XmlElem<string | null>;
+  OnBuild(): void;
 };

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

@@ -111,6 +111,8 @@ WorkflowFieldsStatesBase & {
   changed: XmlElem<boolean>;
   doc_info: XmlElem<DocInfoBase | null>;
   run_action(action: string): void;
+  /** @temp */
+  view: XmlElem<WorkflowDocumentView | null>;
   /** Категория */
   role_id: XmlMultiElemObject<number | null, RoleCatalogDocumentTopElem>;
 };

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

@@ -0,0 +1,78 @@
+interface BmMessageRecipient {
+  /** Сотрудник */
+  person_id: XmlElem<number | null, CollaboratorCatalogDocumentTopElem>;
+  /**
+   * Статус
+   * @default not_read
+   */
+  state_id: XmlElem<string | null, typeof common.message_states>;
+}
+
+interface BmMessageDispRole {
+  id: XmlElem<string | null>;
+}
+
+interface BmMessageReply {
+  message_id: XmlElem<string | null>;
+  /** Блок отвечаемого сообщения */
+  block_message_id: XmlElem<number | null, BlockMessageCatalogDocumentTopElem>;
+}
+
+interface BmMessageForward {
+  message_id: XmlElem<string | null>;
+  /** Блок пересылаемого сообщения */
+  block_message_id: XmlElem<number | null, BlockMessageCatalogDocumentTopElem>;
+  /** Разговор пересылаемого сообщения */
+  conversation_id: XmlElem<number | null, ConversationCatalogDocumentTopElem>;
+}
+
+interface BmMessageView {
+  /**
+   * @temp
+   * @default catalogs
+   */
+  tab_select: XmlElem<string>;
+}
+
+interface BmMessage extends ObjectTypeBase, FileListBase, CatalogListBase {
+  id: XmlElem<string | null>;
+  /** Текст сообщения */
+  text: XmlElem<string | null>;
+  /**
+   * Есть новая реакция
+   * @default false
+   */
+  new_reaction: XmlElem<boolean>;
+  /**
+   * Тип
+   * @default message
+   */
+  type_id: XmlElem<string | null, typeof common.message_types>;
+  /** @default undefined */
+  check_link: XmlElem<string | null>;
+  /**
+   * Статус
+   * @default active
+   */
+  state_id: XmlElem<string | null, typeof common.conversation_message_states>;
+  /** Дата создания */
+  create_date: XmlElem<Date | null>;
+  /** Дата редактирования */
+  edit_date: XmlElem<Date | null>;
+  /** Адресаты */
+  recipients: XmlMultiElem<BmMessageRecipient | null>;
+  disp_roles: XmlMultiElem<BmMessageDispRole | null>;
+  /** Данные по отвечаемому сообщению */
+  reply: XmlElem<BmMessageReply | null>;
+  /** Данные по пересылаемому сообщению */
+  forward: XmlElem<BmMessageForward | null>;
+  /**
+   * Настройки сообщения неактивны
+   * @default false
+   */
+  disabled_data: XmlElem<boolean>;
+  /** Настройки сообщения */
+  data: XmlElem<string | null>;
+  /** @temp */
+  view: XmlElem<BmMessageView | null>;
+}

package/lib/xmldocument/index.d.ts

@@ -55,7 +55,7 @@ interface XmlDocument {
 
   /**
    * Если для формы документа установлен параметр USE-LAST-SAVED-DATA="1",
-   * то данный атрибут доступен в методе {@link OnSave}() документа.
+   * то данный атрибут доступен в методе {@link OnSave} документа.
    * Он устанавливается в соответствии с предыдущей сохраненной копией
    * корневого элемента документа.
    * Атрибут используется, если нужно сравнить предыдущее значение
@@ -114,7 +114,7 @@ interface XmlDocument {
   /**
    * Свойство {@link TempData} содержит объект, в котором можно хранить произвольные данные.
    * Данные хранятся только на время, пока открыт документ.
-   * Может быть использовано, в частности, для передачи данных между {@link OnBeforeSave}() и {@link OnSave}().
+   * Может быть использовано, в частности, для передачи данных между {@link OnBeforeSave} и {@link OnSave}.
    * {@link TempData} представляет из себя стандартный объект в режиме совместимости.
    */
   TempData: Object;
@@ -190,11 +190,11 @@ interface XmlDocument {
    * Устаревший метод.
    * В новой объектной модели используется метод DefaultDb.OpenNewObjectDoc(),
    * который сразу и создает новый объектный документ, и присваивает ему id и url.
-   * Также в новой объектной модели используется метод {@link BindToDbObjectType}().
-   * @param {string | DefaultDb} [database] - Имя базы.
+   * Также в новой объектной модели используется метод {@link BindToDbObjectType}.
+   * @param {string | typeof DefaultDb} [database] - Имя базы.
    * @param {number} [docId=0] - Id объекта.
    */
-  BindToDb(database?: string | DefaultDb, docId?: number): undefined;
+  BindToDb(database?: string | typeof DefaultDb, docId?: number): undefined;
 
   /**
    * Преобразует документ (как правило, вновь созданный) в объектный
@@ -238,7 +238,7 @@ interface XmlDocument {
   FindExtDataElemByFieldID(extID: number): XmlElem<number>;
 
   /**
-   * Дает сигнал потоку, запущенному через {@link EvalThread}() относительно данного документа,
+   * Дает сигнал потоку, запущенному через {@link EvalThread} относительно данного документа,
    * прекратить исполнение.
    *
    * Вызов данного метода не означает, что поток завершится мгновенно,
@@ -333,11 +333,7 @@ interface XmlDocument {
   /**
    * Возвращает элемент документа с полным путем относительно документа.
    * @param {string} path - Путь к элементу (включая корневой элемент).
-   * @param {XmlElem}
-   * @example
-   * ```
-   * doc.SubElem("person.view.last_state_id")
-   * ```
+   * @example doc.SubElem("person.view.last_state_id")
    */
   SubElem<T extends XmlElem<unknown>>(path: string): T;
 
@@ -346,7 +342,6 @@ interface XmlDocument {
    * Если аргумент совпадает с именем дочернего элемента, выдается дочерний элемент.
    * Редко используемая функция.
    * @param {string} elemName - Имя элемента.
-   * @param {XmlElem}
    */
   TopOrChildElem<T extends XmlElem<unknown>>(elemName: string): T;
 

package/lib/xmlelem/index.d.ts

@@ -373,7 +373,7 @@ interface XmElem<T, ForeignElem = never> {
   /**
    * Добавляет уже созданный элемент в качестве в качестве дочернего по отношению к текущему элементу.
    * Аргументом может быть элемент, уже созданный каким-либо образом, например, через функцию {@link CrateElem}.
-   * @param {XmlElem<T>} elem - Созданный заранее элемент.
+   * @param {XmlElem<T>} element - Созданный заранее элемент.
    */
   AddChildElem(element: XmlElem<T>): void;
 
@@ -468,7 +468,7 @@ interface XmElem<T, ForeignElem = never> {
    * и возвращает вычисленное значение.
    * @param {string} name - Имя дочернего элемента, метода или атрибута.
    */
-  ChildValue(): T;
+  ChildValue(name: string): T;
 
   /**
    * Очищает значение данного элемента и его дочерних элементов.
@@ -597,10 +597,7 @@ interface XmElem<T, ForeignElem = never> {
    * Проверяет, существует ли в форме текущего элемента дочерний элемент с таким именем,
    * не являющийся методом.
    * @param {string} name - Имя дочернего элемента.
-   * @example
-   * ```
-   * elem.FormChildExists("xxx") ↔ elem.Form.ChildExists("xxx") && !elem.Form.Child("xxx").IsMethod
-   * ```
+   * @example elem.FormChildExists("xxx") ↔ elem.Form.ChildExists("xxx") && !elem.Form.Child("xxx").IsMethod
    */
   FormChildExists(name: string): boolean;
 
@@ -725,7 +722,7 @@ interface XmElem<T, ForeignElem = never> {
    * содержащей данные в формате XML.
    * Из строки подгружаются только те данные, которые присутствуют в исходном XML.
    * Если необходимо полностью синхронизировать элемент с данными из строки,
-   * перед вызовом данного метода необходимо вызывать метод {@link Clear}().
+   * перед вызовом данного метода необходимо вызывать метод {@link Clear}.
    * @param {string} data - Строка, содержащая данные в формате XML.
    */
   LoadData(data: string): void;
@@ -789,9 +786,9 @@ interface XmElem<T, ForeignElem = never> {
    * возвращает значенеи второго аргумента, если втрой аргумент
    * не указан - возвращает пустую строку.
    * @param {string} name - Имя атрибута.
-   * @param {string} defaultVal - Строка, возвращаемая при отсутствии заданного атрибута.
+   * @param {string} defaultValue - Строка, возвращаемая при отсутствии заданного атрибута.
    */
-  OptAttrValue(name: string, value?: string): string;
+  OptAttrValue(name: string, defaultValue?: string): string;
 
   /**
    * Возвращает дочерний элемент. Находит дочерний элемент по имени.
@@ -870,7 +867,7 @@ interface XmElem<T, ForeignElem = never> {
   /**
    * Очищает содержимое элемента и загружает новое из строки, содержащей XML.
    * Имя корневого элемента в XML должно совпадать с именем текущего элемента.
-   * {@link SetInnerXml}().
+   * {@link SetInnerXml}.
    * @param {string} xml - Xml строка.
    */
   SetXml(xml: string): void;
@@ -879,10 +876,9 @@ interface XmElem<T, ForeignElem = never> {
    * Сортирует дочерние элементы в заданном порядке.
    * Метод должен содержать четное число аргументов.
    * Каждая пара аргументов соответствует параметрам сортировки.
-   * @param {string} name - Выражение, относительно которого производится сортировка.
-   * @param {string} order - Направление сортировки: `+` или `-`.
+   * @param {string} argsAndOrders - Поочередно выражения, относительно которых производится сортировка, и направления сортировки: `+` или `-`.
    */
-  Sort(...args: string[]): void;
+  Sort(...argsAndOrders: string[]): void;
 
   /**
    * Вызывает принудительный пересчет всех подэлементов текущего элемента.

package/lib/xmlformelem/index.d.ts

@@ -222,7 +222,7 @@ interface XmlFormElem {
    * Проверяет, существует ли дочерний элемент с заданым именем.
    * @param {string} name - Имя элемента.
    */
-  ChildExists(): boolean;
+  ChildExists(name: string): boolean;
 
   /**
    * Создает клон текущего элемента формы и возвращает ссылку на него.
@@ -259,8 +259,8 @@ interface XmlFormElem {
   /**
    * Метод возвращает элемент формы вниз по иерархии с заданным путем относительно текущего элемента.
    * Если элемент не найден, возвращает undefined.
-   * Если в аргументе path передать имя элемента (без "." ), то метод будет работать также как {@link OptChild}.
-   * @param {string} path - Путь к элементу (через "." ).
+   * Если в аргументе path передать имя элемента (без "."), то метод будет работать также как {@link OptChild}.
+   * @param {string} path - Путь к элементу (через ".").
    */
   EvalOptPath(path: string): XmlFormElem | never;
 

package/package.json

@@ -1,15 +1,17 @@
 {
   "name": "@wshcmx/types",
-  "version": "11.0.0-beta1",
+  "version": "11.0.9",
+  "type": "module",
   "directories": {
     "lib": "lib"
   },
   "scripts": {
-    "lint": "eslint -c ./lib/.eslintrc.json lib",
+    "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",
-    "check": "npm run lint && npm run tsc:lib && npm run tsc:tests",
-    "version:check": "node ci/version-check.js"
+    "prepare": "husky"
   },
   "repository": {
     "type": "git",
@@ -24,22 +26,17 @@
     "wxhcmx-types",
     "wt"
   ],
-  "author": "",
-  "license": "ISC",
+  "author": "umbrik",
+  "license": "MIT",
   "bugs": {
     "url": "https://github.com/wshcmx/types/issues"
   },
   "homepage": "https://github.com/wshcmx/types#readme",
   "devDependencies": {
-    "@types/node": "^20.4.5",
-    "@typescript-eslint/eslint-plugin": "^5.26.0",
-    "@typescript-eslint/parser": "^5.26.0",
-    "@umbrik/eslint-config-hcm-wt": "^1.5.0",
-    "eslint": "^8.17.0",
-    "eslint-plugin-jsdoc": "^46.4.5",
-    "eslint-plugin-no-for-of-loops": "^1.0.1",
-    "semver": "^7.6.2",
-    "typescript": "^5.6.3",
-    "typescript-eslint": "^7.13.0"
+    "eslint": "^9.22.0",
+    "eslint-plugin-jsdoc": "^50.6.6",
+    "husky": "^9.1.7",
+    "typescript": "^5.8.2",
+    "typescript-eslint": "^8.26.1"
   }
 }

package/lib/.eslintrc.json

@@ -1,54 +0,0 @@
-{
-  "extends": [
-    "eslint:recommended",
-    "plugin:@typescript-eslint/recommended",
-    "@umbrik/eslint-config-hcm-wt"
-  ],
-  "parser": "@typescript-eslint/parser",
-  "parserOptions": {
-    "ecmaVersion": "latest",
-    "project": "./tsconfig.json",
-    "tsconfigRootDir": "lib"
-  },
-  "plugins": [
-    "@typescript-eslint",
-    "jsdoc"
-  ],
-  "rules": {
-    "max-len": "off",
-    "no-unused-vars": "off",
-    "@typescript-eslint/no-unused-vars": "error",
-    "@typescript-eslint/no-empty-interface": "off",
-    "jsdoc/check-alignment": "error",
-    "jsdoc/check-indentation": "error",
-    "jsdoc/check-param-names": "error",
-    "jsdoc/check-property-names": "error",
-    "jsdoc/check-types": "error",
-    "jsdoc/no-blank-block-descriptions": "error",
-    "jsdoc/no-multi-asterisks": "error",
-    "jsdoc/require-asterisk-prefix": "error",
-    "jsdoc/require-description": "error",
-    "jsdoc/require-hyphen-before-param-description": "error",
-    "jsdoc/require-jsdoc": "error",
-    "jsdoc/require-param": "error",
-    "jsdoc/require-param-description": "error",
-    "jsdoc/require-param-name": "error",
-    "jsdoc/require-param-type": "error",
-    "jsdoc/check-access": "error",
-    "jsdoc/check-values": "error",
-    "jsdoc/empty-tags": "error",
-    "jsdoc/implements-on-classes": "error",
-    "jsdoc/multiline-blocks": "error",
-    "jsdoc/require-property": "error",
-    "jsdoc/require-property-description": "error",
-    "jsdoc/require-property-name": "error",
-    "jsdoc/require-property-type": "error",
-    "jsdoc/require-returns": "error",
-    "jsdoc/require-returns-check": "error",
-    "jsdoc/require-returns-description": "error",
-    "jsdoc/require-returns-type": "error",
-    "jsdoc/require-yields": "error",
-    "jsdoc/require-yields-check": "error",
-    "jsdoc/tag-lines": "error"
-  }
-}

package/lib/defaultdb/index.d.ts

@@ -1,27 +0,0 @@
-interface DefaultDb {
-  Name: string;
-  UseObjectTypes: boolean;
-  UseSqlStorage: boolean;
-  UseFtV2: boolean;
-  SqlConnection: never;
-  IsShared: boolean;
-  /** /WebsoftServer/wt_data. */
-  StorageDirectory: string;
-  ObjectForms: unknown[];
-  SharedDocs: Object;
-  // HostDir: T;
-  RegisterObjectType(urlScheme: string, object: Object): void;
-  RegisterCatalog(urlScheme: string): never | undefined;
-  OpenObjectDoc<T extends XmlDocument>(catalogName: string, id: number): T;
-  OpenNewObjectDoc<T extends XmlDocument>(objectName: string): T;
-  DeleteObjectDoc(objectName: string, objectId: number, bool?: boolean): void;
-  ChangeObjectFields(arg: object): object;
-  UpdateObjectSecondaryData(arg: object): object;
-  GetObjectForm<T>(name: string): T;
-  GetOptCatalog<T>(catalogName: string): T;
-  GetRecordPrimaryObjectUrl(object: object): string;
-  RunSql(cmd: string): unknown;
-}
-
-// eslint-disable-next-line @typescript-eslint/no-redeclare
-declare const DefaultDb: DefaultDb;