@sankhyalabs/sankhyablocks 10.0.4 → 10.1.0-dev.10

package/dist/collection/components/snk-crud/subcomponents/snk-guides-viewer.js

@@ -1,13 +1,13 @@
-import { Action as DUAction, ElementIDUtils, KeyboardManager, StringUtils, ObjectUtils } from '@sankhyalabs/core';
+import { Action as DUAction, ElementIDUtils, KeyboardManager, ObjectUtils, StringUtils } from '@sankhyalabs/core';
+import { SelectionMode } from '@sankhyalabs/core/dist/dataunit/DataUnit';
+import { buildFieldSearch, SHORTCUT_SEARCH_FIELD } from '@sankhyalabs/ezui/dist/collection/utils';
+import { buildFormMetadata, FormMetadata } from '@sankhyalabs/ezui/dist/collection/utils/form';
 import { Fragment, h } from '@stencil/core';
+import { PresentationMode } from '../../../lib';
+import { VIEW_MODE } from '../../../lib/utils/constants';
 import { SnkFormConfigManager } from '../../snk-form-config/SnkFormConfigManager';
-import { buildFormMetadata, FormMetadata } from '@sankhyalabs/ezui/dist/collection/utils/form';
-import TaskbarProcessor from '../../snk-taskbar/processor/taskbar-processor';
 import { TaskbarElement } from '../../snk-taskbar/elements/taskbar-elements';
-import { VIEW_MODE } from '../../../lib/utils/constants';
-import { PresentationMode } from '../../../lib';
-import { SelectionMode } from '@sankhyalabs/core/dist/dataunit/DataUnit';
-import { buildFieldSearch, SHORTCUT_SEARCH_FIELD } from '@sankhyalabs/ezui/dist/collection/utils';
+import TaskbarProcessor from '../../snk-taskbar/processor/taskbar-processor';
 const FORM_NAME_PREFIX = "__FORM:";
 export class SnkGuidesViewer {
   constructor() {
@@ -30,6 +30,7 @@ export class SnkGuidesViewer {
     this.enableGridInsert = false;
     this.ignoreReadOnlyFormFields = undefined;
     this.getCustomTitle = undefined;
+    this.customGuidesConfig = [];
     this._hasToCreateFieldSearch = true;
     this._breadcrumbItems = [];
     this._guides = undefined;
@@ -44,6 +45,13 @@ export class SnkGuidesViewer {
   observeDataUnit() {
     this.loadGuides(true);
   }
+  async observeFormConfigManager(value) {
+    const showFormConfig = !!value;
+    await this._viewStack.show(showFormConfig ?
+      GUIDES_VIEWER_VIEW_MODE.CONFIG :
+      GUIDES_VIEWER_VIEW_MODE.GUIDES);
+    this.formConfigVisibilityChanged.emit(showFormConfig);
+  }
   observeDataState(newValue, oldValue) {
     var _a, _b, _c, _d, _e, _f;
     const newRecordsIds = (_b = (_a = newValue === null || newValue === void 0 ? void 0 : newValue.selectionInfo) === null || _a === void 0 ? void 0 : _a.recordIds) !== null && _b !== void 0 ? _b : (_c = newValue === null || newValue === void 0 ? void 0 : newValue.selectedRecord) === null || _c === void 0 ? void 0 : _c['__record__id__'];
@@ -92,7 +100,14 @@ export class SnkGuidesViewer {
    * Atribui o foco para o componente.
    */
   async setFocus() {
-    this._container.focus();
+    var _a;
+    (_a = this._container) === null || _a === void 0 ? void 0 : _a.focus();
+  }
+  /**
+   * Recarrega os guias baseada nos metadados atuais.
+   */
+  async reloadGuides() {
+    this.loadGuides(false);
   }
   exitViewer() {
     if (!this.enableGridInsert && this.dataUnit.isDirty()) {
@@ -136,7 +151,7 @@ export class SnkGuidesViewer {
     if (!this._configManager.isLoaded) {
       return;
     }
-    this._masterFormMetadata = buildFormMetadata(this.masterFormConfig, this.dataUnit, true);
+    this._masterFormMetadata = buildFormMetadata(this.masterFormConfig, this.dataUnit, true, this.customGuidesConfig);
     const allSheets = this._masterFormMetadata.getAllSheets();
     const currentRecord = this.dataUnit.getSelectedRecord();
     const disableDetails = this.hasToDisableDetails(currentRecord);
@@ -147,6 +162,13 @@ export class SnkGuidesViewer {
         item.tooltip = this.getMessage("snkCrud.detail.tooltip.needSingleSelection");
         item.disabled = true;
       }
+      if (sheet.isCustom && sheet.ctxProps) {
+        Object.entries(sheet.ctxProps).forEach(([key, value]) => {
+          if (value !== undefined) {
+            item[key] = value;
+          }
+        });
+      }
       guides.push(item);
     });
     this._guides = guides;
@@ -282,38 +304,52 @@ export class SnkGuidesViewer {
     return `${this.entityPath}/${entityName}`;
   }
   getContent() {
-    var _a, _b, _c, _d, _e;
     if (!this.selectedGuide) {
+      this.snkShowGuide.emit(undefined);
       return;
     }
     const guideId = this.selectedGuide.id;
-    let content;
+    this.snkShowGuide.emit(guideId);
+    if (this.isCustomGuide(guideId)) {
+      return h("slot", { name: guideId });
+    }
     const levels = guideId.split("::");
     const currentLevel = levels.pop();
     const childEntityName = FormMetadata.getDetailName(currentLevel);
     let detailId = guideId;
-    if (childEntityName || levels.length > 0) {
-      let formName;
-      let detailBranch;
-      if (guideId.includes(FORM_NAME_PREFIX)) {
-        [detailId, formName] = guideId.split(FORM_NAME_PREFIX);
-        const pathSize = ((_a = this._breadcrumbItems) === null || _a === void 0 ? void 0 : _a.length) || 0;
-        detailBranch = pathSize > 1 ? this._breadcrumbItems[pathSize - 2] : this.selectedGuide;
-      }
-      else {
-        detailBranch = this.selectedGuide;
-      }
-      content = this.wrapDetail(levels, h("snk-detail-view", { ref: (ref) => this._currentDetail = ref, dataUnitName: this.getDataUnitName(levels, childEntityName), onSnkDetailGuidesChange: (evt) => this.updateGuide(evt.detail), entityName: childEntityName, selectedForm: formName, branchGuide: detailBranch, guideItemPath: this._breadcrumbItems, key: `detail${detailId}`, canEdit: this.canEdit, onSnkSwitchGuide: evt => this._guideNavigator.selectGuide(evt.detail), resourceID: this.resourceID, taskbarCustomContainerId: this.detailTaskbarCustomContainerId, customEditors: this._customEditors, customRenders: this._customRenders, presentationMode: this.presentationMode }));
+    if (this.isDetailGuide(childEntityName, levels)) {
+      return this.buildDetailGuideContent(guideId, detailId, levels, childEntityName);
+    }
+    return this.buildFormViewGuideContent(guideId);
+  }
+  buildFormViewGuideContent(cardId) {
+    var _a, _b, _c, _d;
+    const sheet = this._masterFormMetadata.getSheet(cardId);
+    if (!sheet)
+      return;
+    const cardConfig = (_b = (_a = this.masterFormConfig) === null || _a === void 0 ? void 0 : _a.cardsState) === null || _b === void 0 ? void 0 : _b.get(cardId);
+    return (h("snk-form-view", { ref: ref => this._mainForm = ref, fixed: cardConfig === null || cardConfig === void 0 ? void 0 : cardConfig.fixed, summaryFields: (_d = (_c = this.masterFormConfig) === null || _c === void 0 ? void 0 : _c.summary) === null || _d === void 0 ? void 0 : _d.get(cardId), name: cardId, label: sheet.label, fields: sheet.fields, dataUnit: this.dataUnit, formMetadata: this._masterFormMetadata, recordsValidator: this.recordsValidator, fieldToFocus: this._fieldToGetFocus, key: cardId, onSnkRequestClearFieldToFocus: _ => this.clearFieldToFocusHandler(), customEditors: this._customEditors, fieldsProps: this._fieldsProps, fieldSearch: this._fieldSearch }, this.presentationMode == PresentationMode.SECONDARY && this.buildTaskBar()));
+  }
+  isDetailGuide(childEntityName, levels) {
+    return childEntityName || levels.length > 0;
+  }
+  buildDetailGuideContent(guideId, detailId, levels, childEntityName) {
+    var _a;
+    let formName;
+    let detailBranch;
+    if (guideId.includes(FORM_NAME_PREFIX)) {
+      [detailId, formName] = guideId.split(FORM_NAME_PREFIX);
+      const pathSize = ((_a = this._breadcrumbItems) === null || _a === void 0 ? void 0 : _a.length) || 0;
+      detailBranch = pathSize > 1 ? this._breadcrumbItems[pathSize - 2] : this.selectedGuide;
     }
     else {
-      const cardId = this.selectedGuide.id;
-      const sheet = this._masterFormMetadata.getSheet(cardId);
-      if (sheet) {
-        const cardConfig = (_c = (_b = this.masterFormConfig) === null || _b === void 0 ? void 0 : _b.cardsState) === null || _c === void 0 ? void 0 : _c.get(cardId);
-        content = h("snk-form-view", { ref: ref => this._mainForm = ref, fixed: cardConfig === null || cardConfig === void 0 ? void 0 : cardConfig.fixed, summaryFields: (_e = (_d = this.masterFormConfig) === null || _d === void 0 ? void 0 : _d.summary) === null || _e === void 0 ? void 0 : _e.get(cardId), name: cardId, label: sheet.label, fields: sheet.fields, dataUnit: this.dataUnit, formMetadata: this._masterFormMetadata, recordsValidator: this.recordsValidator, fieldToFocus: this._fieldToGetFocus, key: guideId, onSnkRequestClearFieldToFocus: _ => this.clearFieldToFocusHandler(), customEditors: this._customEditors, fieldsProps: this._fieldsProps, fieldSearch: this._fieldSearch }, this.presentationMode == PresentationMode.SECONDARY && this.buildTaskBar());
-      }
+      detailBranch = this.selectedGuide;
     }
-    return content;
+    return this.wrapDetail(levels, h("snk-detail-view", { ref: (ref) => this._currentDetail = ref, dataUnitName: this.getDataUnitName(levels, childEntityName), onSnkDetailGuidesChange: (evt) => this.updateGuide(evt.detail), entityName: childEntityName, selectedForm: formName, branchGuide: detailBranch, guideItemPath: this._breadcrumbItems, key: `detail${detailId}`, canEdit: this.canEdit, onSnkSwitchGuide: evt => this._guideNavigator.selectGuide(evt.detail), resourceID: this.resourceID, taskbarCustomContainerId: this.detailTaskbarCustomContainerId, customEditors: this._customEditors, customRenders: this._customRenders, presentationMode: this.presentationMode }));
+  }
+  isCustomGuide(guideId) {
+    var _a;
+    return (_a = this.customGuidesConfig) === null || _a === void 0 ? void 0 : _a.map(g => g.id).includes(guideId);
   }
   onBreadcrumbClickHandler(item) {
     if ((item === null || item === void 0 ? void 0 : item.id) == undefined) {
@@ -451,7 +487,7 @@ export class SnkGuidesViewer {
   }
   buildTaskBar() {
     var _a;
-    return h("div", { class: `snk-guides-viewer__header-taskbar ${this.presentationMode != PresentationMode.SECONDARY ? 'ez-align--right' : 'ez-padding-bottom--medium'}` }, h("snk-taskbar", { key: "guideViewerTaskbar", "data-element-id": "guideViewer", configName: this.configName, buttons: this._taskbarProcessor.buttons, disabledButtons: this._taskbarProcessor.disabledButtons, customButtons: this._taskbarProcessor.customButtons, actionsList: this.getActionsList(), actionsSettingsList: this.getSettingsListForm(), messagesBuilder: this.messagesBuilder, presentationMode: this.presentationMode, primaryButton: ((_a = this.dataState) === null || _a === void 0 ? void 0 : _a.isDirty) ? TaskbarElement.SAVE : TaskbarElement.INSERT, "data-taskbar-owner": "master", dataUnit: this.dataUnit, resourceID: this.resourceID, customSlotId: "GUIDES_VIEWER_TASKBAR_CUSTOM_ELEMENTS", alignRigth: true }, h("slot", { name: "GUIDES_VIEWER_TASKBAR_CUSTOM_ELEMENTS" })));
+    return h("div", { class: `snk-guides-viewer__header-taskbar ${this.presentationMode != PresentationMode.SECONDARY ? 'ez-align--right' : 'ez-padding-bottom--medium'}` }, h("snk-taskbar", { key: "guideViewerTaskbar", "data-element-id": "guideViewer", configName: this.configName, buttons: this._taskbarProcessor.buttons, disabledButtons: this._taskbarProcessor.disabledButtons, customButtons: this._taskbarProcessor.customButtons, actionsList: this.getActionsList(), actionsSettingsList: this.getSettingsListForm(), messagesBuilder: this.messagesBuilder, presentationMode: this.presentationMode, primaryButton: ((_a = this.dataState) === null || _a === void 0 ? void 0 : _a.isDirty) ? TaskbarElement.SAVE : TaskbarElement.INSERT, "data-taskbar-owner": "master", dataUnit: this.dataUnit, resourceID: this.resourceID, customSlotId: "GUIDES_VIEWER_TASKBAR_CUSTOM_ELEMENTS", additionalSlotId: "GUIDES_VIEWER_DYNAMIC_SEARCH", alignRigth: true }, h("slot", { name: "GUIDES_VIEWER_TASKBAR_CUSTOM_ELEMENTS" }), h("slot", { name: "GUIDES_VIEWER_DYNAMIC_SEARCH" })));
   }
   async dataUnitActionHandler(action) {
     var _a;
@@ -525,6 +561,9 @@ export class SnkGuidesViewer {
     const labels = selectedRecords.map(record => this.messagesBuilder.getMessage("snkCrud.title", record));
     return `[${labels.join(", ")}]`;
   }
+  getCustomGuidesConfig() {
+    return this._currentDetail ? [] : this.customGuidesConfig;
+  }
   componentDidLoad() {
     this.dataUnit.subscribe(this.dataUnitActionHandler.bind(this));
     this.initKeyboardManager();
@@ -541,17 +580,14 @@ export class SnkGuidesViewer {
       await this._mainForm.showSearchField();
     }, { description: this.getMessage("snkSimpleCrud.findFields"), element: this._element });
   }
-  render() {
-    var _a, _b;
+  renderFormConfig() {
     if (this._formEditorConfigManager != undefined) {
-      return (h("snk-form-config", { ref: ref => this._container = ref, tabindex: -1, dataUnit: this._formEditorDataUnit, messagesBuilder: this.messagesBuilder, configManager: this._formEditorConfigManager, onConfigClose: () => this._formEditorConfigManager = null }));
-    }
-    if (!this.dataUnit || !this._configManager.isLoaded) {
-      return;
+      return (h("snk-form-config", { ref: ref => this._container = ref, tabindex: -1, dataUnit: this._formEditorDataUnit, messagesBuilder: this.messagesBuilder, configManager: this._formEditorConfigManager, onConfigClose: () => this._formEditorConfigManager = null, customGuidesConfig: this.getCustomGuidesConfig() }));
     }
-    this.loadTaskbarProcessor();
-    const showGuides = this._guides && (this._guides.length > 1);
-    return (h("section", { class: "snk-guides-viewer", ref: ref => this._container = ref, tabindex: -1 }, h("div", { class: "ez-row snk-guides-viewer__header" }, h("div", { class: "snk-guides-viewer__header-breadcrumb ez-flex--align-items-center ez-flex-item--align-center ez-padding-left--large", key: "header" }, h("ez-button", { onClick: () => this.exitViewer(), title: this.getMessage("snkCrud.goBackTitle"), mode: "icon", iconName: "arrow_back", class: "ez-padding-right--medium", size: "small" }), h("div", { class: "ez-flex ez-flex--column ez-flex-item--auto" }, h("h1", { class: "ez-title ez-title--primary ez-title--xlarge", title: this.getTitleTooltip() }, this.getTitle()), ((_a = this._breadcrumbItems) === null || _a === void 0 ? void 0 : _a.length) > 1 &&
+  }
+  renderGuidesNavigator(showGuides) {
+    var _a, _b;
+    return (h("section", { class: "snk-guides-viewer", ref: ref => this._container = ref, tabIndex: -1 }, h("div", { class: "ez-row snk-guides-viewer__header" }, h("div", { class: "snk-guides-viewer__header-breadcrumb ez-flex--align-items-center ez-flex-item--align-center ez-padding-left--large", key: "header" }, h("ez-button", { onClick: () => this.exitViewer(), title: this.getMessage("snkCrud.goBackTitle"), mode: "icon", iconName: "arrow_back", class: "ez-padding-right--medium", size: "small" }), h("div", { class: "ez-flex ez-flex--column ez-flex-item--auto" }, h("h1", { class: "ez-title ez-title--primary ez-title--xlarge", title: this.getTitleTooltip() }, this.getTitle()), ((_a = this._breadcrumbItems) === null || _a === void 0 ? void 0 : _a.length) > 1 &&
       h("div", { class: "ez-margin-top--extra-small" }, h("ez-breadcrumb", Object.assign({ items: this._breadcrumbItems, onSelectedItem: (evt) => this.onBreadcrumbClickHandler(evt === null || evt === void 0 ? void 0 : evt.detail) }, { [ElementIDUtils.DATA_ELEMENT_ID_ATTRIBUTE_NAME]: `${ElementIDUtils.getInternalIDInfo("breadcrumb")}` }))))), this.presentationMode != PresentationMode.SECONDARY && this.buildTaskBar()), h("div", { class: "snk-guides-viewer__container" }, showGuides ?
       h("ez-guide-navigator", { ref: (ref) => this._guideNavigator = ref, class: "snk-guides-viewer__guide-navigator", items: this._guides, selectedId: this.selectedGuide ? this.selectedGuide.id : undefined, onEzSelectionChange: evt => this.updateSelectedGuideHandler(evt.detail) })
       :
@@ -567,6 +603,14 @@ export class SnkGuidesViewer {
       fieldsProps: this._fieldsProps
     }), this.getContent())), h("snk-configurator", { ref: (ref) => this._snkConfigurator = ref, viewMode: this.getConfigViewMode(), onConfigSelected: (evt) => this.changeConfigViewMode(evt.detail), messagesBuilder: this.messagesBuilder, onOpenConfig: (evt) => this.openConfig(evt.detail), resourceID: this.resourceID })));
   }
+  render() {
+    if (!this.dataUnit || !this._configManager.isLoaded) {
+      return;
+    }
+    this.loadTaskbarProcessor();
+    const showGuides = this._guides && (this._guides.length > 1);
+    return (h("ez-view-stack", { ref: (ref) => this._viewStack = ref, "data-element-id": "guides-viewer-stack" }, h("stack-item", null, this.renderGuidesNavigator(showGuides)), h("stack-item", null, this.renderFormConfig())));
+  }
   static get is() { return "snk-guides-viewer"; }
   static get encapsulation() { return "scoped"; }
   static get originalStyleUrls() {
@@ -918,6 +962,29 @@ export class SnkGuidesViewer {
           "tags": [],
           "text": "Fornece  uma fun\u00E7\u00E3o para obter um t\u00EDtulo customizado do formul\u00E1rio."
         }
+      },
+      "customGuidesConfig": {
+        "type": "unknown",
+        "mutable": false,
+        "complexType": {
+          "original": "Array<CustomGuideItem>",
+          "resolved": "CustomGuideItem[]",
+          "references": {
+            "Array": {
+              "location": "global"
+            },
+            "CustomGuideItem": {
+              "location": "local"
+            }
+          }
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "Fornece as informa\u00E7\u00F5es das guias personalizadas."
+        },
+        "defaultValue": "[]"
       }
     };
   }
@@ -937,6 +1004,21 @@ export class SnkGuidesViewer {
   }
   static get events() {
     return [{
+        "method": "snkShowGuide",
+        "name": "snkShowGuide",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "docs": {
+          "tags": [],
+          "text": "Emitido quando a uma gua \u00E9 exibida no formul\u00E1rio."
+        },
+        "complexType": {
+          "original": "string",
+          "resolved": "string",
+          "references": {}
+        }
+      }, {
         "method": "snkMasterFormConfigChange",
         "name": "snkMasterFormConfigChange",
         "bubbles": true,
@@ -956,6 +1038,21 @@ export class SnkGuidesViewer {
             }
           }
         }
+      }, {
+        "method": "formConfigVisibilityChanged",
+        "name": "formConfigVisibilityChanged",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "docs": {
+          "tags": [],
+          "text": "Emitido quando a visibilidade do configurador do formul\u00E1rio \u00E9 alterada."
+        },
+        "complexType": {
+          "original": "boolean",
+          "resolved": "boolean",
+          "references": {}
+        }
       }, {
         "method": "exit",
         "name": "exit",
@@ -1129,6 +1226,22 @@ export class SnkGuidesViewer {
           "text": "Atribui o foco para o componente.",
           "tags": []
         }
+      },
+      "reloadGuides": {
+        "complexType": {
+          "signature": "() => Promise<void>",
+          "parameters": [],
+          "references": {
+            "Promise": {
+              "location": "global"
+            }
+          },
+          "return": "Promise<void>"
+        },
+        "docs": {
+          "text": "Recarrega os guias baseada nos metadados atuais.",
+          "tags": []
+        }
       }
     };
   }
@@ -1137,6 +1250,9 @@ export class SnkGuidesViewer {
     return [{
         "propName": "dataUnit",
         "methodName": "observeDataUnit"
+      }, {
+        "propName": "_formEditorConfigManager",
+        "methodName": "observeFormConfigManager"
       }, {
         "propName": "dataState",
         "methodName": "observeDataState"
@@ -1167,3 +1283,8 @@ var TASKBAR_ID;
   TASKBAR_ID["MUTIPLE_EDITION"] = "snkGuideViewer.multiple_edition";
   TASKBAR_ID["REGULAR"] = "snkGuideViewer.regular";
 })(TASKBAR_ID || (TASKBAR_ID = {}));
+var GUIDES_VIEWER_VIEW_MODE;
+(function (GUIDES_VIEWER_VIEW_MODE) {
+  GUIDES_VIEWER_VIEW_MODE[GUIDES_VIEWER_VIEW_MODE["GUIDES"] = 0] = "GUIDES";
+  GUIDES_VIEWER_VIEW_MODE[GUIDES_VIEWER_VIEW_MODE["CONFIG"] = 1] = "CONFIG";
+})(GUIDES_VIEWER_VIEW_MODE || (GUIDES_VIEWER_VIEW_MODE = {}));

package/dist/collection/components/snk-custom-slot-guide/snk-custom-slot-guide.css

@@ -0,0 +1,3 @@
+:host{
+  display: none;
+}

package/dist/collection/components/snk-custom-slot-guide/snk-custom-slot-guide.js

@@ -0,0 +1,95 @@
+import { h, Host } from '@stencil/core';
+export class SnkCustomSlotGuide {
+  constructor() {
+    this.slotName = 'CUSTOM_SLOT_GUIDE';
+  }
+  onGuideChange(evt) {
+    const guideName = evt.detail;
+    if (guideName === this.slotName) {
+      this._element.style.setProperty('display', 'block');
+    }
+    else {
+      this._element.style.setProperty('display', 'none');
+    }
+  }
+  onFormConfigVisibilityChange(evt) {
+    const isFormConfigVisible = evt.detail;
+    if (isFormConfigVisible) {
+      this._element.style.setProperty('display', 'none');
+    }
+  }
+  componentDidLoad() {
+    this.snkCustomSlotGuideLoaded.emit(this.slotName);
+  }
+  render() {
+    return (h(Host, { slot: this.slotName, id: this.slotName, class: "custom-slot-guide-container" }, h("slot", null)));
+  }
+  static get is() { return "snk-custom-slot-guide"; }
+  static get encapsulation() { return "scoped"; }
+  static get originalStyleUrls() {
+    return {
+      "$": ["snk-custom-slot-guide.css"]
+    };
+  }
+  static get styleUrls() {
+    return {
+      "$": ["snk-custom-slot-guide.css"]
+    };
+  }
+  static get properties() {
+    return {
+      "slotName": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "string",
+          "resolved": "string",
+          "references": {}
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [],
+          "text": "Nome do slot onde os elementos customizados dever\u00E3o aparecer."
+        },
+        "attribute": "slot-name",
+        "reflect": false,
+        "defaultValue": "'CUSTOM_SLOT_GUIDE'"
+      }
+    };
+  }
+  static get events() {
+    return [{
+        "method": "snkCustomSlotGuideLoaded",
+        "name": "snkCustomSlotGuideLoaded",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "docs": {
+          "tags": [],
+          "text": "Emitido quando elemento \u00E9 carregado na tela."
+        },
+        "complexType": {
+          "original": "string",
+          "resolved": "string",
+          "references": {}
+        }
+      }];
+  }
+  static get elementRef() { return "_element"; }
+  static get listeners() {
+    return [{
+        "name": "snkShowGuide",
+        "method": "onGuideChange",
+        "target": "window",
+        "capture": false,
+        "passive": false
+      }, {
+        "name": "formConfigVisibilityChanged",
+        "method": "onFormConfigVisibilityChange",
+        "target": "window",
+        "capture": false,
+        "passive": false
+      }];
+  }
+}

package/dist/collection/components/snk-data-unit/snk-data-unit.js

@@ -479,6 +479,8 @@ export class SnkDataUnit {
       return records;
     const parentSelectedRecord = parentDataUnit.getSelectedRecord();
     const selfInfo = parentDataUnit === null || parentDataUnit === void 0 ? void 0 : parentDataUnit.getChildInfo(this.getCleanDataUnitName());
+    if (!selfInfo)
+      return records;
     const { links } = selfInfo;
     if (!links || links.length === 0)
       return records;

package/dist/collection/components/snk-form-config/FormConfigHelper.js

@@ -126,11 +126,30 @@ export function buildChildrenGuides(dataUnit, initialOrderIndex = 0, guidesList)
       name: child.name,
       visible: true,
       isCustom: true,
-      order: initialOrderIndex++,
+      order: initialOrderIndex++
     });
   }
   return childrenWithNoGuide;
 }
+export function buildCustomGuides(customGuidesList, guidesList) {
+  let initialOrderIndex = guidesList.length;
+  const customGuidesToAdd = getCustomGuidesNotIncludedInList(customGuidesList, guidesList);
+  return customGuidesToAdd.map(guide => {
+    return {
+      name: guide.id,
+      label: guide.label,
+      visible: true,
+      isCustom: true,
+      order: initialOrderIndex++
+    };
+  });
+}
+function isCustomGuideIncludedInList(guidesList, guide) {
+  return guidesList.some(fromList => fromList.name === guide.id || fromList.label === guide.label);
+}
+function getCustomGuidesNotIncludedInList(customGuidesList, guidesList) {
+  return customGuidesList.filter(guide => !isCustomGuideIncludedInList(guidesList, guide));
+}
 function handleFieldsTabNames(allFields) {
   // Campos que não fazem parte de nenhuma aba ou da aba "Geral", devem ser movidos para a aba __main.
   return allFields.map(field => {

package/dist/collection/components/snk-form-config/snk-form-config.js

@@ -4,7 +4,7 @@ import { h, Host } from '@stencil/core';
 import { ApplicationUtils } from '@sankhyalabs/ezui/dist/collection/utils';
 import { UserConfigType } from '../../lib/http/data-fetcher/fetchers/form-config-fetcher';
 import { GROUP_NAMES, TAB_NAMES } from '../../lib/utils/constants';
-import { buildChildrenGuides, buildGuides, buildGuidesMap, buildNewGuideName, getFieldsToSave, updateTabInFieldsFromGroupList, } from './FormConfigHelper';
+import { buildChildrenGuides, buildCustomGuides, buildGuides, buildGuidesMap, buildNewGuideName, getFieldsToSave, updateTabInFieldsFromGroupList, } from './FormConfigHelper';
 export class SnkFormConfig {
   constructor() {
     this.guidesMap = new Map();
@@ -22,6 +22,7 @@ export class SnkFormConfig {
     this.configManager = undefined;
     this.ignoreReadOnlyFormFields = undefined;
     this.messagesBuilder = undefined;
+    this.customGuidesConfig = [];
   }
   handleFieldConfigChanged() {
     this.hasChanges = true;
@@ -92,8 +93,8 @@ export class SnkFormConfig {
       this.configOptions = userConfig;
       const isDefault = this._formConfig != undefined ? this._formConfig.defaultConfiguration : true;
       const origin = (isDefault ? UserConfigType.DEFAULT : UserConfigType.USER);
-      this.configSelected = userConfig.find((config) => config.origin === origin);
-      this.originalConfigSelected = userConfig.find((config) => config.origin === origin);
+      this.configSelected = userConfig === null || userConfig === void 0 ? void 0 : userConfig.find((config) => config.origin === origin);
+      this.originalConfigSelected = userConfig === null || userConfig === void 0 ? void 0 : userConfig.find((config) => config.origin === origin);
     }
     catch (error) {
       console.error(this.getMessage('snkFormConfig.errors.failFetchUserConfig'));
@@ -161,6 +162,7 @@ export class SnkFormConfig {
     this.guidesList = [];
     this.guidesList.push(...buildGuides(this._formConfig, this.getMessage('snkFormConfig.form.mainArea')));
     this.guidesList.push(...buildChildrenGuides(this.dataUnit, this.getInitialOrder(this.guidesList), this.guidesList));
+    this.guidesList.push(...buildCustomGuides(this.customGuidesConfig, this.guidesList));
     this.guidesMap = buildGuidesMap((_a = this._formConfig) === null || _a === void 0 ? void 0 : _a.fields, this.guidesList, this.dataUnit, this.getMessage('snkFormConfig.form.tabGeneral'));
   }
   getConfig() {
@@ -389,6 +391,30 @@ export class SnkFormConfig {
           "tags": [],
           "text": "Respons\u00E1vel por flexibilizar e padronizar o uso de mensagens nos blocos de constru\u00E7\u00E3o."
         }
+      },
+      "customGuidesConfig": {
+        "type": "unknown",
+        "mutable": false,
+        "complexType": {
+          "original": "Array<CustomGuideItem>",
+          "resolved": "CustomGuideItem[]",
+          "references": {
+            "Array": {
+              "location": "global"
+            },
+            "CustomGuideItem": {
+              "location": "import",
+              "path": "../snk-crud/subcomponents/snk-guides-viewer"
+            }
+          }
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "Informa\u00E7\u00F5es das guias personalizadas."
+        },
+        "defaultValue": "[]"
       }
     };
   }

package/dist/collection/components/snk-grid/snk-grid.css

@@ -9,6 +9,8 @@
   width: 100%;
   padding: var(--snk-grid-padding);
   outline: none;
+
+  --snk-grid-header--min-height: 40px;
 }
 
 .snk-grid__header {
@@ -16,15 +18,27 @@
   display: flex;
   flex-wrap: nowrap;
   justify-content: flex-end;
+  align-items: flex-start;
+  min-height: var(--snk-grid-header--min-height);
 }
 
 .snk-grid__filter-bar {
   width: 100%;
+  display: flex;
+  align-items: flex-start;
 }
 
 .snk-grid__header-divider {
   /*public*/
   margin-bottom: var(--space--medium);
+  margin-top: var(--space--small);
+  align-self: stretch;
+}
+
+.snk-grid__header snk-taskbar {
+  display: flex;
+  align-items: flex-start;
+  min-height: var(--snk-grid-header--min-height);
 }
 
 .snk-grid__table {