@sankhyalabs/sankhyablocks 9.1.0-dev.19 → 9.1.0-dev.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -60,20 +60,23 @@ export declare class SnkApplication {
60
60
  _templateSkeleton: TEMPLATES_SKELETON;
61
61
  _activeScrimWindow: boolean;
62
62
  /**
63
- * Define se o componente deve usar o LockManager para controle de carregamento da aplicação
63
+ * Define se o componente deve usar o LockManager para controle de carregamento da aplicação.
64
64
  */
65
65
  enableLockManagerLoadingApp: boolean;
66
+ /**
67
+ * Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
68
+ */
66
69
  messagesBuilder: SnkMessageBuilder;
67
70
  /**
68
- * Usado para salvar as configurações dos blocos de construção.
71
+ * Nome da configuração utilizada para salvar as preferências dos blocos de construção.
69
72
  */
70
73
  configName: string;
71
74
  /**
72
- * Chave da configuração legado da grade.
75
+ * Chave da configuração legada da grade, utilizada para migração de configurações antigas.
73
76
  */
74
77
  gridLegacyConfigName: string;
75
78
  /**
76
- * Chave da configuração legado do formulário.
79
+ * Chave da configuração legada do formulário, utilizada para migração de configurações antigas.
77
80
  */
78
81
  formLegacyConfigName: string;
79
82
  /**
@@ -85,93 +88,145 @@ export declare class SnkApplication {
85
88
  watchPropHandler(newValue: LoadByPkHandler, _: LoadByPkHandler): void;
86
89
  /**
87
90
  * Obtém o controlador de teclado.
88
- *
89
- * @return {KeyboardManager} the keyboard manager
91
+ * @returns {Promise<KeyboardManager>} O gerenciador de teclado.
92
+ * @async
90
93
  */
91
94
  getKeyboardManager(): Promise<KeyboardManager>;
92
95
  /**
93
- * Obtém o notificador de Layout de formulario.
94
- *
95
- * @return {LayoutFormConfig} the Configurador de Layout do Formulario
96
+ * Obtém o notificador de Layout de formulário.
97
+ * @returns {Promise<LayoutFormConfig>} O configurador de Layout do Formulário.
98
+ * @async
96
99
  */
97
100
  getLayoutFormConfig(): Promise<LayoutFormConfig>;
98
101
  /**
99
102
  * Obtém `true` caso o usuário logado seja o SUP.
103
+ * @returns {Promise<boolean>} `true` se o usuário for SUP, `false` caso contrário.
104
+ * @async
100
105
  */
101
106
  isUserSup(): Promise<boolean>;
102
107
  /**
103
108
  * Adiciona uma ação pendente que deve ser executada por um determinado locker.
104
- *
105
- * @param actionsLocker nome do locker da ação que será adicionada
106
- * @param action ação que será executada
109
+ * @param {string} actionsLocker - Nome do locker da ação que será adicionada.
110
+ * @param {Function} action - Ação que será executada.
111
+ * @returns {Promise<void>}
112
+ * @async
107
113
  */
108
114
  addPendingAction(actionsLocker: string, action: Function): Promise<void>;
109
115
  /**
110
- * Realiza a chamada ao Service Broker conforme o nome do serviço.
111
- *
112
- * @param serviceName - Nome do serviço
113
- * @param payload - Dados que serão processados na ação
114
- * @param options - Parâmetros de URL
115
- */
116
+ * Realiza a chamada ao Service Broker conforme o nome do serviço.
117
+ * @param {string} serviceName - Nome do serviço.
118
+ * @param {string | Object} payload - Dados que serão processados na ação.
119
+ * @param {Options} [options] - Parâmetros de URL.
120
+ * @returns {Promise<any>} A resposta do Service Broker.
121
+ * @async
122
+ */
116
123
  callServiceBroker(serviceName: string, payload: string | Object, options?: Options): Promise<any>;
124
+ /**
125
+ * Inicializa o onboarding para uma chave específica.
126
+ * @param {string} onboardingKey - A chave do onboarding a ser iniciado.
127
+ * @returns {Promise<void>}
128
+ * @async
129
+ */
117
130
  initOnboarding(onboardingKey: string): Promise<void>;
118
131
  private doInitOnboarding;
119
132
  /**
120
- * Obtém `true` caso o usuário logado tem permissão pra determinada ação.
133
+ * Obtém `true` caso o usuário logado tenha permissão para determinada ação.
134
+ * @param {AutorizationType} access - O tipo de acesso a ser verificado.
135
+ * @param {string} [resourceID] - O ID do recurso para verificar a permissão. Se não fornecido, verifica a permissão da aplicação.
136
+ * @returns {Promise<boolean>} `true` se o usuário tiver acesso, `false` caso contrário.
137
+ * @async
121
138
  */
122
139
  hasAccess(access: AutorizationType, resourceID?: string): Promise<boolean>;
123
140
  /**
124
- * Obtém todos os acessos do usuário logado.
141
+ * Obtém todos os acessos do usuário logado para um recurso específico ou para a aplicação.
142
+ * @param {string} [resourceID] - O ID do recurso. Se não fornecido, obtém os acessos da aplicação.
143
+ * @returns {Promise<any>} Um objeto contendo todos os tipos de acesso e se o usuário os possui.
144
+ * @async
125
145
  */
126
146
  getAllAccess(resourceID?: string): Promise<any>;
127
147
  /**
128
148
  * Obtém o valor de um parâmetro do tipo string.
149
+ * @param {string} name - O nome do parâmetro.
150
+ * @returns {Promise<string>} O valor do parâmetro como string.
151
+ * @async
129
152
  */
130
153
  getStringParam(name: string): Promise<string>;
131
154
  /**
132
155
  * Obtém o valor de um parâmetro do tipo Inteiro.
156
+ * @param {string} name - O nome do parâmetro.
157
+ * @returns {Promise<number>} O valor do parâmetro como número inteiro.
158
+ * @async
133
159
  */
134
160
  getIntParam(name: string): Promise<number>;
135
161
  /**
136
162
  * Obtém o valor de um parâmetro do tipo Decimal.
163
+ * @param {string} name - O nome do parâmetro.
164
+ * @returns {Promise<number>} O valor do parâmetro como número decimal.
165
+ * @async
137
166
  */
138
167
  getFloatParam(name: string): Promise<number>;
139
168
  /**
140
169
  * Obtém o valor de um parâmetro do tipo booleano.
170
+ * @param {string} name - O nome do parâmetro.
171
+ * @returns {Promise<boolean>} O valor do parâmetro como booleano.
172
+ * @async
141
173
  */
142
174
  getBooleanParam(name: string): Promise<boolean>;
143
175
  /**
144
176
  * Obtém o valor de um parâmetro do tipo data.
177
+ * @param {string} name - O nome do parâmetro.
178
+ * @returns {Promise<Date>} O valor do parâmetro como objeto Date.
179
+ * @async
145
180
  */
146
181
  getDateParam(name: string): Promise<Date>;
147
182
  /**
148
183
  * Exibe o conteúdo passado em um Popup.
184
+ * @param {HTMLElement} content - O elemento HTML a ser exibido no popup.
185
+ * @param {"auto" | "full"} [size="full"] - O tamanho do popup.
186
+ * @param {boolean} [useHeader=true] - Define se o cabeçalho do popup deve ser usado.
187
+ * @param {Function} [onCloseCallback] - Função a ser chamada quando o popup for fechado.
188
+ * @returns {Promise<void>}
189
+ * @async
149
190
  */
150
191
  showPopUp(content: HTMLElement, size?: "auto" | "full", useHeader?: boolean, onCloseCallback?: Function): Promise<void>;
151
192
  /**
152
193
  * Exibe o conteúdo passado em um Modal.
194
+ * @param {HTMLElement} content - O elemento HTML a ser exibido no modal.
195
+ * @returns {Promise<void>}
196
+ * @async
153
197
  */
154
198
  showModal(content: HTMLElement): Promise<void>;
155
199
  /**
156
- * Apresenta uma lista de alertas,
157
- * geralmente é utilizado para apresentar resultados
158
- * de processamentos em lote.
200
+ * Apresenta uma lista de alertas.
201
+ * Geralmente é utilizado para apresentar resultados de processamentos em lote.
202
+ * @param {Array<AlertItem>} alerts - A lista de alertas a serem exibidos.
203
+ * @returns {Promise<void>}
159
204
  */
160
205
  showAlerts(alerts: Array<AlertItem>): Promise<void>;
161
206
  /**
162
207
  * Fecha o Modal e limpa o conteúdo.
208
+ * @returns {Promise<void>}
209
+ * @async
163
210
  */
164
211
  closeModal(): Promise<void>;
165
212
  /**
166
213
  * Fecha o Popup e limpa o conteúdo.
214
+ * @returns {Promise<void>}
215
+ * @async
167
216
  */
168
217
  closePopUp(): Promise<void>;
169
218
  /**
170
- * Verifica se a licença do cliente tem determinado opcional (produto)
219
+ * Verifica se a licença do cliente tem determinado opcional (produto).
220
+ * @param {string} opcional - O nome do opcional ou uma string de opcionais separados por vírgula.
221
+ * @returns {Promise<boolean>} `true` se o cliente tiver o opcional, `false` caso contrário.
222
+ * @async
171
223
  */
172
224
  temOpcional(opcional: string): Promise<boolean>;
173
225
  /**
174
- * Obtém a configuração de um recurso por service broker
226
+ * Obtém a configuração de um recurso por service broker.
227
+ * @param {string} key - A chave da configuração.
228
+ * @returns {Promise<any>} Os dados da configuração.
229
+ * @async
175
230
  */
176
231
  getConfig(key: string): Promise<any>;
177
232
  /**
@@ -180,105 +235,186 @@ export declare class SnkApplication {
180
235
  isFeatureActive(featureName: string): Promise<boolean>;
181
236
  /**
182
237
  * Salva a configuração de determinado recurso.
238
+ * @param {string} key - A chave da configuração.
239
+ * @param {Object} data - Os dados da configuração a serem salvos.
240
+ * @returns {Promise<any>} O resultado da operação de salvamento.
241
+ * @async
183
242
  */
184
243
  saveConfig(key: string, data: Object): Promise<any>;
185
244
  /**
186
245
  * Acessa informações de contexto "empurrados" na abertura da tela.
246
+ * @param {string} attribName - O nome do atributo.
247
+ * @returns {Promise<string>} O valor do atributo.
248
+ * @async
187
249
  */
188
250
  getAttributeFromHTMLWrapper(attribName: string): Promise<string>;
189
251
  /**
190
252
  * Abre determinada tela, repassando pkObject.
253
+ * @param {string} resourceId - O ID do recurso da tela a ser aberta.
254
+ * @param {Object} pkObject - O objeto de chave primária a ser passado para a tela.
255
+ * @returns {Promise<void>}
256
+ * @async
191
257
  */
192
258
  openApp(resourceId: string, pkObject: Object): Promise<void>;
193
259
  /**
194
260
  * Realiza a chamada do WebConnection para realizar a exportação de arquivo.
195
- * @param keyPort - Chave da porta que será requisitada.
196
- * @param methodName - Nome do tipo de exportação de arquivo que será realizado.
197
- * @param params - Parâmetros necessários para realizar a exportação do arquivo.
261
+ * @param {string} keyPort - Chave da porta que será requisitada.
262
+ * @param {string} methodName - Nome do tipo de exportação de arquivo que será realizado.
263
+ * @param {IAppletCallerParams} params - Parâmetros necessários para realizar a exportação do arquivo.
264
+ * @returns {Promise<void>}
265
+ * @async
198
266
  */
199
267
  webConnection(keyPort: string, methodName: string, params: IAppletCallerParams): Promise<void>;
200
268
  private getDuPromissesStack;
201
269
  /**
202
270
  * Cria o DataUnit a partir do nome da entidade. É possível armazená-lo no cache
203
271
  * passando o dataUnitName, assim, se mais de uma chamada for feita, o mesmo DataUnit será usado.
272
+ * @param {string} entityName - O nome da entidade.
273
+ * @param {string} [dataUnitName] - O nome para identificar o DataUnit no cache.
274
+ * @param {DataUnit} [parentDataUnit] - O DataUnit pai, se houver.
275
+ * @param {string} [configName] - O nome da configuração a ser usada.
276
+ * @param {string} [resourceID] - O ID do recurso. Se não fornecido, usa o da aplicação.
277
+ * @returns {Promise<DataUnit>} O DataUnit criado ou obtido do cache.
278
+ * @async
204
279
  */
205
280
  createDataunit(entityName: string, dataUnitName?: string, parentDataUnit?: DataUnit, configName?: string, resourceID?: string): Promise<DataUnit>;
206
281
  private processResolveDataUnit;
207
282
  /**
208
283
  * Atualiza o cache de dataunits da aplicação.
209
- * @param oldName - Nome do dataunit que está em cache.
210
- * @param dataUnitName - Nome do dataunit que será armazenado em cache.
211
- * @param dataUnit - Instancia do Dataunit para ser armazenado em cache.
284
+ * @param {string} oldName - Nome do dataunit que está em cache (será removido).
285
+ * @param {string} dataUnitName - Nome do dataunit que será armazenado em cache.
286
+ * @param {DataUnit} dataUnit - Instância do Dataunit para ser armazenado em cache.
287
+ * @returns {Promise<void>}
288
+ * @async
212
289
  */
213
290
  updateDataunitCache(oldName: string, dataUnitName: string, dataUnit: DataUnit): Promise<void>;
214
291
  /**
215
- * Obtem um DataUnit do cache ou cria um caso ainda não tenha sido criado.
292
+ * Obtém um DataUnit do cache ou cria um caso ainda não tenha sido criado.
293
+ * @param {string} entityName - O nome da entidade.
294
+ * @param {string} dataUnitName - O nome para identificar o DataUnit no cache.
295
+ * @param {DataUnit} [parentDataUnit] - O DataUnit pai, se houver.
296
+ * @param {string} [configName] - O nome da configuração a ser usada.
297
+ * @param {string} [resourceID] - O ID do recurso. Se não fornecido, usa o da aplicação.
298
+ * @returns {Promise<DataUnit>} O DataUnit obtido do cache ou recém-criado.
299
+ * @async
216
300
  */
217
301
  getDataUnit(entityName: string, dataUnitName: string, parentDataUnit?: DataUnit, configName?: string, resourceID?: string): Promise<DataUnit>;
218
302
  /**
219
303
  * Registra um client event para o DataFetcher da aplicação.
220
- *
221
- * @param eventID - Nome do evento para a aplicação se registrar.
222
- * @param handler - Função de callback que será chamada quando o client event ocorrer.
304
+ * @param {String} eventID - Nome do evento para a aplicação se registrar.
305
+ * @param {(clientEvent: IClientEventResponse, dataFetcherReacaller: IDataFetcherRecaller) => void} handler - Função de callback que será chamada quando o client event ocorrer.
306
+ * @returns {Promise<void>}
307
+ * @async
223
308
  */
224
309
  addClientEvent(eventID: String, handler: (clientEvent: IClientEventResponse, dataFetcherReacaller: IDataFetcherRecaller) => void): Promise<void>;
225
310
  /**
226
- * Remove um client event para o DataFetcher da aplicação.
227
- *
228
- * @param eventID - Nome do evento a ser removido.
311
+ * Remove um client event do DataFetcher da aplicação.
312
+ * @param {String} eventID - Nome do evento a ser removido.
313
+ * @returns {Promise<void>}
314
+ * @async
229
315
  */
230
316
  removeClientEvent(eventID: String): Promise<void>;
231
317
  /**
232
- * Verfica se um client event está registrado no DataFetcher da aplicação.
233
- *
234
- * @param eventID - Nome do evento a ser verificado.
318
+ * Verifica se um client event está registrado no DataFetcher da aplicação.
319
+ * @param {String} eventID - Nome do evento a ser verificado.
320
+ * @returns {Promise<boolean>} `true` se o evento estiver registrado, `false` caso contrário.
321
+ * @async
235
322
  */
236
323
  hasClientEvent(eventID: String): Promise<boolean>;
237
324
  private get applicationResourceID();
238
325
  /**
239
326
  * Obtém o resourceID da tela em questão.
327
+ * @returns {Promise<string>} O ID do recurso da aplicação.
328
+ * @async
240
329
  */
241
330
  getResourceID(): Promise<string>;
242
331
  /**
243
- * Obtém o UserId da tela em questão.
332
+ * Obtém o UserId do usuário logado.
333
+ * @returns {Promise<string>} O ID do usuário.
334
+ * @async
244
335
  */
245
336
  getUserID(): Promise<string>;
246
337
  /**
247
338
  * Exibe o diálogo de alerta de acordo com os parâmetros passados.
339
+ * @param {string} title - O título do alerta.
340
+ * @param {string} message - A mensagem do alerta.
341
+ * @param {string} [icon] - O nome do ícone a ser exibido.
342
+ * @param {MessageOptions} [options] - Opções adicionais para a mensagem.
343
+ * @returns {Promise<boolean>}
344
+ * @async
248
345
  */
249
346
  alert(title: string, message: string, icon?: string, options?: MessageOptions): Promise<boolean>;
250
347
  /**
251
348
  * Exibe o diálogo de erro de acordo com os parâmetros passados.
349
+ * @param {string} title - O título do erro.
350
+ * @param {string} message - A mensagem do erro.
351
+ * @param {string} [icon] - O nome do ícone a ser exibido.
352
+ * @param {MessageOptions} [options] - Opções adicionais para a mensagem.
353
+ * @returns {Promise<boolean>}
354
+ * @async
252
355
  */
253
356
  error(title: string, message: string, icon?: string, options?: MessageOptions): Promise<boolean>;
254
357
  /**
255
358
  * Exibe o diálogo de sucesso de acordo com os parâmetros passados.
359
+ * @param {string} title - O título da mensagem de sucesso.
360
+ * @param {string} message - A mensagem de sucesso.
361
+ * @param {string} [icon] - O nome do ícone a ser exibido.
362
+ * @param {MessageOptions} [options] - Opções adicionais para a mensagem.
363
+ * @returns {Promise<boolean>}
364
+ * @async
256
365
  */
257
366
  success(title: string, message: string, icon?: string, options?: MessageOptions): Promise<boolean>;
258
367
  /**
259
- * Exibe um diálogo de mensagem comum
368
+ * Exibe um diálogo de mensagem comum.
369
+ * @param {string} title - O título da mensagem.
370
+ * @param {string} message - A mensagem.
371
+ * @param {string} [icon] - O nome do ícone a ser exibido.
372
+ * @param {MessageOptions} [options] - Opções adicionais para a mensagem.
373
+ * @returns {Promise<boolean>}
374
+ * @async
260
375
  */
261
376
  message(title: string, message: string, icon?: string, options?: MessageOptions): Promise<boolean>;
262
377
  /**
263
- * Exibe um diálogo de confirmação
378
+ * Exibe um diálogo de confirmação.
379
+ * @param {string} title - O título da confirmação.
380
+ * @param {string} message - A mensagem da confirmação.
381
+ * @param {string} [icon] - O nome do ícone a ser exibido.
382
+ * @param {DialogType} [dialogType] - O tipo de diálogo.
383
+ * @param {MessageOptions} [options] - Opções adicionais para a mensagem.
384
+ * @returns {Promise<boolean>} `true` se confirmado, `false` caso contrário.
385
+ * @async
264
386
  */
265
387
  confirm(title: string, message: string, icon?: string, dialogType?: DialogType, options?: MessageOptions): Promise<boolean>;
266
388
  /**
267
389
  * Exibe uma informação efêmera (de segundo plano).
390
+ * @param {string} message - A mensagem a ser exibida.
391
+ * @param {MessageOptions} [options] - Opções adicionais para a mensagem.
392
+ * @returns {Promise<void>}
393
+ * @async
268
394
  */
269
395
  info(message: string, options?: MessageOptions): Promise<void>;
270
396
  /**
271
397
  * Obtém os totalizadores da grade.
398
+ * @param {string} name - O nome da configuração de totalizadores.
399
+ * @param {string} resourceID - O ID do recurso.
400
+ * @param {Array<Filter>} filters - A lista de filtros a serem aplicados.
401
+ * @returns {Promise<Map<string, number>>} Um mapa com os nomes dos totalizadores e seus valores.
402
+ * @async
272
403
  */
273
404
  loadTotals(name: string, resourceID: string, filters: Array<Filter>): Promise<Map<string, number>>;
274
405
  /**
275
- * Obtém a informação se o último carregamento do dataunit foi feito através de um loadByPk
276
- * @returns boolean
406
+ * Obtém a informação se o último carregamento do dataunit foi feito através de um loadByPk.
407
+ * @returns {Promise<boolean>} `true` se foi carregado por PK, `false` caso contrário.
408
+ * @async
277
409
  */
278
410
  isLoadedByPk(): Promise<boolean>;
279
411
  /**
280
412
  * Remove registro do cache do PreLoader do dataunit.
281
413
  * Deve ser usado quando existe um dataunit usando loader do application, mas o removeLoader está sendo sobrescrito.
414
+ * @param {DataUnit} dataUnit - O DataUnit do qual o registro será removido.
415
+ * @param {Array<string>} recordsIDs - Os IDs dos registros a serem removidos.
416
+ * @returns {Promise<void>}
417
+ * @async
282
418
  */
283
419
  preloadMangerRemoveRecord(dataUnit: DataUnit, recordsIDs: Array<string>): Promise<void>;
284
420
  private getCountSkeleton;
@@ -299,10 +435,16 @@ export declare class SnkApplication {
299
435
  private get pesquisaFetcher();
300
436
  private get authFetcher();
301
437
  /**
302
- * Obtém as opções em componentes de pesquisa
438
+ * Obtém as opções em componentes de pesquisa.
303
439
  * Ex.: snk-config-options
304
- */
305
- executeSearch(searchArgument: ISearchArgument, fieldName: string, dataUnit: DataUnit, ctxOptions?: any): Promise<Array<IOption> | IOption>;
440
+ * @param {ISearchArgument} searchArgument - Argumentos da pesquisa.
441
+ * @param {string} fieldName - Nome do campo no DataUnit.
442
+ * @param {DataUnit} dataUnit - Instância do DataUnit.
443
+ * @param {ISearchCtxOptions} [ctxOptions] - Opções de contexto adicionais.
444
+ * @returns {Promise<Array<IOption> | IOption>} Uma lista de opções ou uma única opção.
445
+ * @async
446
+ */
447
+ executeSearch(searchArgument: ISearchArgument, fieldName: string, dataUnit: DataUnit, ctxOptions?: ISearchCtxOptions): Promise<Array<IOption> | IOption>;
306
448
  private filterInvalidFields;
307
449
  private filterMathFields;
308
450
  private builOptionItem;
@@ -312,8 +454,11 @@ export declare class SnkApplication {
312
454
  */
313
455
  executePreparedSearchPlus(mode: string, argument: string, options: any): Promise<Array<IOption> | IOption>;
314
456
  /**
315
- * Obtém as opções em componentes de pesquisa
316
- * Ex.: snk-config-options
457
+ * @param {string} mode - O modo da pesquisa ("ADVANCED" ou outro).
458
+ * @param {string} argument - O argumento da pesquisa.
459
+ * @param {any} options - Opções preparadas para a pesquisa. Veja a documentação para exemplo de uso.
460
+ * @returns {Promise<Array<IOption> | IOption>} Uma lista de opções ou uma única opção.
461
+ * @async
317
462
  */
318
463
  executePreparedSearch(mode: string, argument: string, options: any): Promise<Array<IOption> | IOption>;
319
464
  /**
@@ -321,20 +466,31 @@ export declare class SnkApplication {
321
466
  */
322
467
  isDebugMode(): Promise<boolean>;
323
468
  /**
324
- * Obtém o nome das telas da aplicação
469
+ * Obtém o nome (label) da aplicação.
470
+ * @returns {Promise<string>} O nome da aplicação.
471
+ * @async
325
472
  */
326
473
  getAppLabel(): Promise<string>;
327
474
  /**
328
- * Adiciona um listener no fetcher de Pesquisa
329
- */
475
+ * Adiciona um listener no fetcher de Pesquisa.
476
+ * @param {string} entityName - O nome da entidade.
477
+ * @param {DataUnit} dataUnit - A instância do DataUnit.
478
+ * @param {ISearchListener} listener - O listener a ser adicionado.
479
+ * @returns {Promise<IRemoveSearchListener>} Uma função para remover o listener.
480
+ * @async
481
+ */
330
482
  addSearchListener(entityName: string, dataUnit: DataUnit, listener: ISearchListener): Promise<IRemoveSearchListener>;
331
483
  /**
332
- Realiza o import de um JavaScript que está disponivel dentro da pasta /public da aplicação.
333
- @param relativePath: Define o caminho relativo para o arquivo JavaScript a ser importado.
484
+ Realiza o import de um JavaScript que está disponível dentro da pasta /public da aplicação.
485
+ @param {string | Array<string>} relativePath - Define o caminho relativo para o arquivo JavaScript a ser importado, ou uma lista de caminhos.
486
+ @returns {Promise<void>}
487
+ @async
334
488
  */
335
489
  importScript(relativePath: string | Array<string>): Promise<void>;
336
490
  /**
337
491
  * Retorna o path relativo da aplicação.
492
+ * @returns {Promise<string>} O caminho relativo da aplicação.
493
+ * @async
338
494
  */
339
495
  getApplicationPath(): Promise<string>;
340
496
  /**
@@ -345,23 +501,31 @@ export declare class SnkApplication {
345
501
  * Com base em um campo realiza um "select distinct" respeitando os
346
502
  * filtros atuais do dataUnit e um critério de filtro para a própria
347
503
  * coluna.
504
+ * @param {DataUnit} dataUnit - A instância do DataUnit.
505
+ * @param {string} fieldName - O nome do campo para o select distinct.
506
+ * @param {string} argument - O argumento de filtro para a coluna.
507
+ * @returns {Promise<Array<any>>} Uma lista de valores distintos.
508
+ * @async
348
509
  */
349
510
  executeSelectDistinct(dataUnit: DataUnit, fieldName: string, argument: string): Promise<Array<any>>;
350
511
  /**
351
- * Retorna a instancia do DataFetcher utilizado pelo application
352
- * @returns DataFetcher do application
512
+ * Retorna a instância do DataFetcher utilizado pelo application.
513
+ * @returns {Promise<DataFetcher>} O DataFetcher da aplicação.
514
+ * @async
353
515
  */
354
516
  getDataFetcher(): Promise<DataFetcher>;
355
517
  /**
356
- * Retorna uma promise que sera resolvida quando o snk-application estiver carregado e registrado no ApplicationContext
357
- * @returns SnkApplication carregado.
518
+ * Retorna uma promise que será resolvida quando o snk-application estiver carregado e registrado no ApplicationContext.
519
+ * @returns {Promise<SnkApplication>} O componente SnkApplication carregado.
520
+ * @async
358
521
  */
359
522
  whenApplicationReady(): Promise<SnkApplication>;
360
523
  /**
361
524
  * Atribui valor para parâmetros de contexto no componente de pesquisa.
362
- *
363
- * @param name - Nome do parâmetro
364
- * @param value - String conversível de acordo com o tipo do parâmetro
525
+ * @param {string} name - Nome do parâmetro.
526
+ * @param {string} value - String conversível de acordo com o tipo do parâmetro.
527
+ * @returns {Promise<void>}
528
+ * @async
365
529
  */
366
530
  setSearchFilterContext(name: string, value: string): Promise<void>;
367
531
  private clearContent;
@@ -387,7 +551,20 @@ export declare class SnkApplication {
387
551
  componentDidLoad(): Promise<void>;
388
552
  showScrimApp(active: boolean): Promise<void>;
389
553
  private changeTemplateSkeleton;
554
+ /**
555
+ * Marca a aplicação para recarregar, opcionalmente especificando um tipo de esqueleto de carregamento.
556
+ * @param {TEMPLATES_SKELETON} [templateSkeletonType] - O tipo de esqueleto de carregamento a ser exibido.
557
+ * @returns {Promise<void>}
558
+ * @async
559
+ */
390
560
  markToReload(templateSkeletonType?: TEMPLATES_SKELETON): Promise<void>;
561
+ /**
562
+ * Adiciona um bloqueio de carregamento à aplicação.
563
+ * @param {boolean} [forceReady=false] - Se `true`, força a aplicação para o estado "não pronto" antes de adicionar o bloqueio.
564
+ * @param {TEMPLATES_SKELETON} [templateSkeletonType] - O tipo de esqueleto de carregamento a ser exibido.
565
+ * @returns {Promise<string>} O ID do bloqueio adicionado.
566
+ * @async
567
+ */
391
568
  addLoadingLock(forceReady?: boolean, templateSkeletonType?: TEMPLATES_SKELETON): Promise<() => void>;
392
569
  private resolveApplicationReady;
393
570
  private stopTimeoutLockManager;
@@ -411,4 +588,9 @@ declare class PendingPromise {
411
588
  reject: Function;
412
589
  constructor(resolve: Function, reject: Function);
413
590
  }
591
+ export interface ISearchCtxOptions {
592
+ allowsNonAnalytic?: boolean;
593
+ useSearchPlus?: boolean;
594
+ [key: string]: any;
595
+ }
414
596
  export {};