@seniorsistemas/data-seniorx-core 2.3.0 → 3.0.0

package/features/tree/components/tree-node-item/tree-node-item.component.d.ts

@@ -0,0 +1,37 @@
+import { ElementRef, EventEmitter } from '@angular/core';
+import type { InternalTreeNodeItem, TreeNodeEdit } from '../../../../core/types/tree.type';
+import * as i0 from "@angular/core";
+export declare class TreeNodeItemComponent {
+    private readonly cdr;
+    private readonly translate;
+    ariaLevel: number;
+    showCheckbox: boolean;
+    treeNodeItem: InternalTreeNodeItem;
+    treeNodeItemClicked: EventEmitter<{
+        item: InternalTreeNodeItem;
+        event: Event;
+    }>;
+    treeNodeEdit: EventEmitter<TreeNodeEdit>;
+    nodeExpanded: EventEmitter<InternalTreeNodeItem<unknown>>;
+    nodeCollapsed: EventEmitter<InternalTreeNodeItem<unknown>>;
+    protected input?: ElementRef<HTMLInputElement>;
+    protected get hasChildren(): boolean;
+    protected get editable(): boolean;
+    protected get checkboxAriaLabel(): string;
+    protected get expandAriaLabel(): string;
+    protected get collapseAriaLabel(): string;
+    protected get editInputAriaLabel(): string;
+    protected get editButtonAriaLabel(): string;
+    protected expandNode(): void;
+    protected collapseNode(): void;
+    protected handleCheckboxChange(event: Event, node: InternalTreeNodeItem): void;
+    protected onCheckboxKeydown(event: KeyboardEvent, node: InternalTreeNodeItem): void;
+    protected handleTreeNodeItemClick(event: Event, treeNodeItem?: InternalTreeNodeItem): void;
+    protected handleTreeNodeItemKeyboardActivate(event: Event): void;
+    protected toggleExpanded(treeNodeItem: InternalTreeNodeItem): void;
+    protected toggleEditing(event: Event): void;
+    protected cancelEdit(event: Event): void;
+    protected saveEdit(event: Event): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TreeNodeItemComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TreeNodeItemComponent, "sdc-tree-node-item", never, { "ariaLevel": { "alias": "ariaLevel"; "required": false; }; "showCheckbox": { "alias": "showCheckbox"; "required": false; }; "treeNodeItem": { "alias": "treeNodeItem"; "required": true; }; }, { "treeNodeItemClicked": "treeNodeItemClicked"; "treeNodeEdit": "treeNodeEdit"; "nodeExpanded": "nodeExpanded"; "nodeCollapsed": "nodeCollapsed"; }, never, never, true, never>;
+}

package/features/tree/tree.component.d.ts

@@ -0,0 +1,37 @@
+import { EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
+import type { InternalTreeNodeItem, TreeNodeEdit, TreeNodeItem, TreeSelectionMode } from '../../core/types/tree.type';
+import * as i0 from "@angular/core";
+export declare class TreeComponent implements OnChanges {
+    treeData: TreeNodeItem[];
+    loading: boolean;
+    selectionMode: TreeSelectionMode;
+    showCheckbox: boolean;
+    allExpanded: boolean;
+    private _selected;
+    get selected(): TreeNodeItem[];
+    set selected(value: TreeNodeItem[] | TreeNodeItem | undefined);
+    selectedChange: EventEmitter<TreeNodeItem<unknown> | TreeNodeItem<unknown>[]>;
+    treeNodeItemClicked: EventEmitter<TreeNodeItem<unknown>>;
+    treeNodeEdit: EventEmitter<TreeNodeEdit>;
+    nodeExpanded: EventEmitter<TreeNodeItem<unknown>>;
+    nodeCollapsed: EventEmitter<TreeNodeItem<unknown>>;
+    ngOnChanges(changes: SimpleChanges): void;
+    protected onTreeNodeItemClicked({ item }: {
+        item: InternalTreeNodeItem;
+    }): void;
+    protected onTreeNodeEdit(payload: TreeNodeEdit): void;
+    protected onNodeExpanded(item: InternalTreeNodeItem): void;
+    protected onNodeCollapsed(item: InternalTreeNodeItem): void;
+    private toggleChecked;
+    private syncChildrenCheckedState;
+    private emitSelection;
+    private syncSelectedChanges;
+    private collapseAll;
+    private expandAll;
+    private normalizeTreeSelection;
+    private parseInternalTreeNodeItem;
+    private get selectedElements();
+    private get multiple();
+    static ɵfac: i0.ɵɵFactoryDeclaration<TreeComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TreeComponent, "sdc-tree", never, { "treeData": { "alias": "treeData"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "selectionMode": { "alias": "selectionMode"; "required": false; }; "showCheckbox": { "alias": "showCheckbox"; "required": false; }; "allExpanded": { "alias": "allExpanded"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; }, { "selectedChange": "selectedChange"; "treeNodeItemClicked": "treeNodeItemClicked"; "treeNodeEdit": "treeNodeEdit"; "nodeExpanded": "nodeExpanded"; "nodeCollapsed": "nodeCollapsed"; }, never, never, true, never>;
+}

package/features/visual-sql-editor/components/visual-sql-editor-field-modal/visual-sql-editor-field-modal.component.d.ts

@@ -0,0 +1,18 @@
+import { EventEmitter } from "@angular/core";
+import type { DynamicViewBuilderField, DynamicViewBuilderFieldFunction } from "../../../../core/types/dynamic-view-builder.type";
+import type { FieldModalStep } from "../../types/visual-sql-editor.types";
+import * as i0 from "@angular/core";
+export declare class VisualSqlEditorFieldModalComponent {
+    visible: boolean;
+    step: FieldModalStep;
+    drafts: DynamicViewBuilderField[];
+    functionEditColumn: string | null;
+    functionDraft: DynamicViewBuilderFieldFunction;
+    readonly visibleChange: EventEmitter<boolean>;
+    readonly closed: EventEmitter<void>;
+    readonly stepChange: EventEmitter<FieldModalStep>;
+    readonly draftsChange: EventEmitter<DynamicViewBuilderField[]>;
+    readonly saved: EventEmitter<DynamicViewBuilderField[]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<VisualSqlEditorFieldModalComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<VisualSqlEditorFieldModalComponent, "sdc-vse-field-modal", never, { "visible": { "alias": "visible"; "required": false; }; "step": { "alias": "step"; "required": false; }; "drafts": { "alias": "drafts"; "required": false; }; "functionEditColumn": { "alias": "functionEditColumn"; "required": false; }; "functionDraft": { "alias": "functionDraft"; "required": false; }; }, { "visibleChange": "visibleChange"; "closed": "closed"; "stepChange": "stepChange"; "draftsChange": "draftsChange"; "saved": "saved"; }, never, never, true, never>;
+}

package/features/visual-sql-editor/components/visual-sql-editor-filter-modal/visual-sql-editor-filter-modal.component.d.ts

@@ -0,0 +1,17 @@
+import { EventEmitter } from "@angular/core";
+import type { DynamicViewBuilderFilter } from "../../../../core/types/dynamic-view-builder.type";
+import type { FilterModalMode, FilterModalStep } from "../../types/visual-sql-editor.types";
+import * as i0 from "@angular/core";
+export declare class VisualSqlEditorFilterModalComponent {
+    visible: boolean;
+    editIndex: number | null;
+    step: FilterModalStep;
+    mode: FilterModalMode;
+    draft: Partial<DynamicViewBuilderFilter>;
+    readonly visibleChange: EventEmitter<boolean>;
+    readonly closed: EventEmitter<void>;
+    readonly stepChange: EventEmitter<FilterModalStep>;
+    readonly saved: EventEmitter<DynamicViewBuilderFilter>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<VisualSqlEditorFilterModalComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<VisualSqlEditorFilterModalComponent, "sdc-vse-filter-modal", never, { "visible": { "alias": "visible"; "required": false; }; "editIndex": { "alias": "editIndex"; "required": false; }; "step": { "alias": "step"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "draft": { "alias": "draft"; "required": false; }; }, { "visibleChange": "visibleChange"; "closed": "closed"; "stepChange": "stepChange"; "saved": "saved"; }, never, never, true, never>;
+}

package/features/visual-sql-editor/components/visual-sql-editor-join-modal/visual-sql-editor-join-modal.component.d.ts

@@ -0,0 +1,13 @@
+import { EventEmitter } from "@angular/core";
+import type { DynamicViewBuilderJoin } from "../../../../core/types/dynamic-view-builder.type";
+import * as i0 from "@angular/core";
+export declare class VisualSqlEditorJoinModalComponent {
+    visible: boolean;
+    editIndex: number | null;
+    draft: DynamicViewBuilderJoin;
+    readonly visibleChange: EventEmitter<boolean>;
+    readonly closed: EventEmitter<void>;
+    readonly saved: EventEmitter<DynamicViewBuilderJoin>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<VisualSqlEditorJoinModalComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<VisualSqlEditorJoinModalComponent, "sdc-vse-join-modal", never, { "visible": { "alias": "visible"; "required": false; }; "editIndex": { "alias": "editIndex"; "required": false; }; "draft": { "alias": "draft"; "required": false; }; }, { "visibleChange": "visibleChange"; "closed": "closed"; "saved": "saved"; }, never, never, true, never>;
+}

package/features/visual-sql-editor/components/visual-sql-editor-sort-modal/visual-sql-editor-sort-modal.component.d.ts

@@ -0,0 +1,13 @@
+import { EventEmitter } from "@angular/core";
+import type { DynamicViewBuilderSort } from "../../../../core/types/dynamic-view-builder.type";
+import * as i0 from "@angular/core";
+export declare class VisualSqlEditorSortModalComponent {
+    visible: boolean;
+    editIndex: number | null;
+    draft: DynamicViewBuilderSort;
+    readonly visibleChange: EventEmitter<boolean>;
+    readonly closed: EventEmitter<void>;
+    readonly saved: EventEmitter<DynamicViewBuilderSort>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<VisualSqlEditorSortModalComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<VisualSqlEditorSortModalComponent, "sdc-vse-sort-modal", never, { "visible": { "alias": "visible"; "required": false; }; "editIndex": { "alias": "editIndex"; "required": false; }; "draft": { "alias": "draft"; "required": false; }; }, { "visibleChange": "visibleChange"; "closed": "closed"; "saved": "saved"; }, never, never, true, never>;
+}

package/features/visual-sql-editor/components/visual-sql-editor-source-modal/visual-sql-editor-source-modal.component.d.ts

@@ -0,0 +1,15 @@
+import { EventEmitter } from "@angular/core";
+import type { SourceModalDraft, SourceModalStep } from "../../types/visual-sql-editor.types";
+import * as i0 from "@angular/core";
+export declare class VisualSqlEditorSourceModalComponent {
+    visible: boolean;
+    step: SourceModalStep;
+    drafts: SourceModalDraft[];
+    readonly visibleChange: EventEmitter<boolean>;
+    readonly closed: EventEmitter<void>;
+    readonly stepChange: EventEmitter<SourceModalStep>;
+    readonly draftsChange: EventEmitter<SourceModalDraft[]>;
+    readonly saved: EventEmitter<SourceModalDraft[]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<VisualSqlEditorSourceModalComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<VisualSqlEditorSourceModalComponent, "sdc-vse-source-modal", never, { "visible": { "alias": "visible"; "required": false; }; "step": { "alias": "step"; "required": false; }; "drafts": { "alias": "drafts"; "required": false; }; }, { "visibleChange": "visibleChange"; "closed": "closed"; "stepChange": "stepChange"; "draftsChange": "draftsChange"; "saved": "saved"; }, never, never, true, never>;
+}

package/features/visual-sql-editor/services/visual-sql-editor-flow.service.d.ts

@@ -0,0 +1,26 @@
+import { OnDestroy, ElementRef, QueryList, ChangeDetectorRef } from "@angular/core";
+import type { BuilderFlowArrow, BuilderSectionId } from "../types/visual-sql-editor.types";
+import * as i0 from "@angular/core";
+/**
+ * Context object provided by the host component so the flow service can read
+ * ViewChild / ViewChildren references without importing the component itself.
+ */
+export interface FlowArrowContext {
+    sectionsContainer: ElementRef<HTMLElement> | undefined;
+    builderSections: QueryList<ElementRef<HTMLElement>> | undefined;
+    sectionOrder: readonly BuilderSectionId[];
+    changeDetectorRef: ChangeDetectorRef;
+    /** Callback invoked by the service when computed state changes. */
+    onFlowArrowsChange(arrows: BuilderFlowArrow[], measuredHeight: string): void;
+}
+export declare class VisualSqlEditorFlowService implements OnDestroy {
+    private refreshFlowArrowsFrame;
+    private refreshFlowArrowsTimeout;
+    ngOnDestroy(): void;
+    scheduleFlowArrowRefresh(context: FlowArrowContext): void;
+    refreshFlowArrows(context: FlowArrowContext): void;
+    refreshMeasuredPreviewHeight(context: FlowArrowContext): string;
+    buildFlowArrows(context: FlowArrowContext): BuilderFlowArrow[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<VisualSqlEditorFlowService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<VisualSqlEditorFlowService>;
+}

package/features/visual-sql-editor/services/visual-sql-editor-state.service.d.ts

@@ -0,0 +1,72 @@
+import type { DynamicViewBuilderField, DynamicViewBuilderFilter, DynamicViewBuilderJoin, DynamicViewBuilderSort } from "../../../core/types/dynamic-view-builder.type";
+import type { SourceModalStep, FieldModalStep, FilterModalStep, FilterModalMode, SourceModalDraft } from "../types/visual-sql-editor.types";
+import * as i0 from "@angular/core";
+export declare class VisualSqlEditorStateService {
+    sourceModalVisible: boolean;
+    sourceModalStep: SourceModalStep;
+    sourceModalDrafts: SourceModalDraft[];
+    openSourceModal(existingSources: Array<{
+        table: string;
+        alias?: string | null;
+    }>, resolveDefaultAlias: (table: string) => string, step?: SourceModalStep): void;
+    closeSourceModal(): void;
+    goToSourceModalStep(step: SourceModalStep): void;
+    joinModalVisible: boolean;
+    joinEditIndex: number | null;
+    joinDraft: {
+        sourceColumn: string;
+        targetColumn: string;
+        operator: string;
+    };
+    openJoinModal(current: DynamicViewBuilderJoin | null, index: number | null): void;
+    closeJoinModal(): void;
+    sortModalVisible: boolean;
+    sortEditIndex: number | null;
+    sortDraft: {
+        column: string;
+        functionName: string;
+        direction: string;
+    };
+    openSortModal(current: DynamicViewBuilderSort | null, index: number | null): void;
+    closeSortModal(): void;
+    fieldModalVisible: boolean;
+    fieldModalStep: FieldModalStep;
+    fieldModalDrafts: DynamicViewBuilderField[];
+    fieldFunctionEditColumn: string | null;
+    fieldFunctionDraft: {
+        column: string;
+        functionName: string;
+        functionAlias: string;
+    };
+    openFieldModal(drafts: DynamicViewBuilderField[], openAtStep: FieldModalStep): void;
+    closeFieldModal(): void;
+    goToFieldModalStep(step: FieldModalStep): void;
+    filterModalVisible: boolean;
+    filterEditIndex: number | null;
+    filterModalStep: FilterModalStep;
+    filterModalMode: FilterModalMode;
+    filterDraft: {
+        mode: FilterModalMode;
+        column: string;
+        operator: string;
+        connector: import("../../../core/types/dynamic-view-builder.type").DynamicViewBuilderFilterConnector;
+        optional: boolean;
+        valueType: import("../../../core/types/dynamic-view-builder.type").DynamicViewBuilderFilterValueType;
+        value: string;
+        valuesText: string;
+        betweenStart: string;
+        betweenEnd: string;
+        parameterName: string;
+        domainExpression: string;
+    };
+    openFilterModal(current: DynamicViewBuilderFilter | null, index: number | null): void;
+    private resolveFilterMode;
+    private resolveFilterModalStep;
+    private buildFilterDraft;
+    private buildEmptyFilterDraft;
+    private buildFilterDraftFromCurrent;
+    closeFilterModal(): void;
+    goToFilterModalStep(step: FilterModalStep, canProceed: boolean, canReview: boolean): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<VisualSqlEditorStateService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<VisualSqlEditorStateService>;
+}

package/features/visual-sql-editor/types/visual-sql-editor.types.d.ts

@@ -0,0 +1,182 @@
+import type { PicklistRecord } from "../../../core/types/picklist.type";
+import type { BadgeColor } from "../../../core/types/badge.type";
+export type SelectionModalMode = "tables" | "fields" | "groupBy";
+export type BuilderLayoutMode = "stacked" | "split";
+export type SourceModalStep = "select" | "configure";
+export type FieldModalStep = "select" | "configure";
+export type FilterModalStep = "select" | "configure" | "review";
+export type BuilderSectionId = "tables" | "joins" | "groupBy" | "fields" | "sorting" | "filters";
+export type FilterModalMode = "condition" | "domain";
+export interface SelectionRow {
+    id: string;
+    name: string;
+    meta: string;
+    selected: boolean;
+    disabled: boolean;
+    dbLabel?: string;
+    tableLabel?: string;
+    pathType?: "table" | "column";
+    prefix?: string;
+    note?: string;
+}
+export interface SourceViewItem {
+    id: string;
+    dbLabel: string;
+    tableLabel: string;
+    alias: string;
+    hasCustomAlias: boolean;
+}
+export interface SourceModalDraft {
+    table: string;
+    alias: string;
+}
+export interface SourceConfiguredItem {
+    id: string;
+    table: string;
+    dbLabel: string;
+    tableLabel: string;
+    alias: string;
+}
+export interface JoinViewItem {
+    id: string;
+    sourceTable: string;
+    sourceField: string;
+    operator: string;
+    targetTable: string;
+    targetField: string;
+}
+export interface SimpleViewItem {
+    id: string;
+    dbLabel: string;
+    tableLabel: string;
+    fieldLabel: string;
+}
+export interface FieldViewItem {
+    id: string;
+    sourceIndex: number;
+    column: string;
+    orderLabel: string;
+    dbLabel: string;
+    tableLabel: string;
+    fieldLabel: string;
+    alias: string;
+    width: string;
+    functionName: string;
+    functionLabel: string;
+    functionAlias: string;
+    hasCustomConfig: boolean;
+    order: number;
+}
+export interface SortViewItem {
+    id: string;
+    dbLabel: string;
+    tableLabel: string;
+    fieldLabel: string;
+    functionName: string;
+    functionLabel: string;
+    direction: string;
+}
+export interface SortSelectableItem {
+    id: string;
+    column: string;
+    functionName: string;
+    tableLabel: string;
+    fieldLabel: string;
+    meta: string;
+}
+export interface FilterViewItem {
+    id: string;
+    dbLabel: string;
+    tableLabel: string;
+    fieldLabel: string;
+    operatorLabel: string;
+    subtitle: string;
+    optional: boolean;
+    isDomain: boolean;
+}
+export interface FilterReviewItem {
+    id: string;
+    label: string;
+    value: string;
+    emphasize?: "path" | "code" | "default";
+}
+export interface ColumnDisplayParts {
+    dbLabel: string;
+    tableLabel: string;
+    fieldLabel: string;
+}
+export interface TableDisplayParts {
+    dbLabel: string;
+    tableLabel: string;
+}
+export interface FieldModalConfiguredItem {
+    id: string;
+    column: string;
+    tableLabel: string;
+    fieldLabel: string;
+    alias: string;
+    width: string;
+    functionName: string;
+    functionLabel: string;
+    functionAlias: string;
+}
+export interface BuilderFlowArrow {
+    id: string;
+    direction: "right" | "down";
+    left: number;
+    top: number;
+}
+export interface ColumnPicklistItem extends PicklistRecord {
+    [key: string]: unknown;
+    id: number;
+    title: string;
+    titlePrefix: string;
+    titleSuffix: string;
+    titlePrefixColor: string;
+    titleSuffixColor: string;
+    badge: string;
+    badgeColor: BadgeColor;
+    column: string;
+}
+export interface SortPicklistItem extends PicklistRecord {
+    [key: string]: unknown;
+    id: number;
+    title: string;
+    titlePrefix: string;
+    titleSuffix: string;
+    titlePrefixColor: string;
+    titleSuffixColor: string;
+    badge: string;
+    badgeColor: BadgeColor;
+    selectionId: string;
+    column: string;
+}
+export interface TablePicklistItem extends PicklistRecord {
+    [key: string]: unknown;
+    id: number;
+    title: string;
+    titlePrefix: string;
+    titleSuffix: string;
+    titlePrefixColor: string;
+    titleSuffixColor: string;
+    badge: string;
+    badgeColor: BadgeColor;
+    table: string;
+}
+export interface PreviewColumnLike {
+    field: string;
+    header?: string;
+    type?: string;
+}
+export type DynamicModalDimension = {
+    width: string;
+    height: string;
+};
+export type DynamicModalDimensionsMap = {
+    source: DynamicModalDimension;
+    selection: DynamicModalDimension;
+    join: DynamicModalDimension;
+    sort: DynamicModalDimension;
+    filter: DynamicModalDimension;
+    field: DynamicModalDimension;
+};

package/features/visual-sql-editor/utils/visual-sql-editor-sanitize.util.d.ts

@@ -0,0 +1,14 @@
+import type { DynamicViewBuilderColumnOption } from "../../../core/types/dynamic-view-builder.type";
+/**
+ * Returns true when the given data type string is a numeric type.
+ */
+export declare function isNumericType(value?: string): boolean;
+/**
+ * Returns true when the given data type string is a date/time type.
+ */
+export declare function isDateType(value?: string): boolean;
+/**
+ * Returns the list of valid filter operator keys for a given column option,
+ * based on the column's data type.
+ */
+export declare function filterOperatorsForColumn(column: DynamicViewBuilderColumnOption): string[];

package/features/visual-sql-editor/utils/visual-sql-editor-sql.util.d.ts

@@ -0,0 +1,81 @@
+import type { DynamicViewBuilderColumnOption, DynamicViewBuilderField, DynamicViewBuilderFilter, DynamicViewBuilderFunction, DynamicViewBuilderJoin, DynamicViewBuilderSort, DynamicViewBuilderSource, DynamicViewBuilderTableOption } from "../../../core/types/dynamic-view-builder.type";
+/**
+ * Context object carrying the resolved config data needed by SQL generation functions.
+ * All functions in this util are pure with respect to this context.
+ */
+export interface SqlContext {
+    /** Available column options from config.availableData.columns */
+    columns: DynamicViewBuilderColumnOption[];
+    /** Available table options from config.availableData.tables */
+    tables: DynamicViewBuilderTableOption[];
+    /** Selected sources from config.generated.sources */
+    sources: DynamicViewBuilderSource[];
+}
+/**
+ * Wraps a SQL string value in single quotes, escaping internal single quotes.
+ */
+export declare function quoteSqlValue(value: string): string;
+/**
+ * Decorates a string value with % wildcards according to the LIKE operator variant.
+ */
+export declare function decorateLikeValue(operator: string, value: string): string;
+/**
+ * Resolves the SQL fragment for a source table including its alias.
+ */
+export declare function resolveSourceSql(ctx: SqlContext, source: DynamicViewBuilderTableOption | {
+    table: string;
+    alias: string;
+}): string;
+/**
+ * Resolves the SQL fragment for a column reference using the source alias.
+ */
+export declare function resolveColumnSql(ctx: SqlContext, value: string): string;
+/**
+ * Resolves the SQL fragment for an aggregate function call.
+ */
+export declare function resolveFunctionSql(ctx: SqlContext, item: DynamicViewBuilderFunction): string;
+/**
+ * Resolves the SQL fragment for a field (column or function expression) in the SELECT list.
+ */
+export declare function resolveFieldSql(ctx: SqlContext, field: string | DynamicViewBuilderField): string;
+/**
+ * Resolves the SQL fragment for a sort item (column or function expression).
+ */
+export declare function resolveSortSql(ctx: SqlContext, item: DynamicViewBuilderSort): string;
+/**
+ * Resolves the SQL comparison operator string for a filter operator key.
+ */
+export declare function resolveFilterOperatorSql(value: string): string;
+/**
+ * Resolves the SQL value fragment for a filter, applying quoting and LIKE decoration.
+ */
+export declare function resolveFilterValueSql(ctx: SqlContext, columnValue: string, operator: string, value: unknown): string;
+/**
+ * Resolves the full SQL fragment for a single filter condition.
+ */
+export declare function resolveFilterSql(// NOSONAR - complexity: extraction would risk behavior change
+ctx: SqlContext, filter: DynamicViewBuilderFilter): string;
+/**
+ * Resolves the full SQL fragment for a JOIN clause.
+ */
+export declare function resolveJoinSql(ctx: SqlContext, item: DynamicViewBuilderJoin): string;
+/**
+ * Builds the WHERE clause lines for a list of filters.
+ * Returns an empty array when no filters are provided.
+ */
+export declare function buildWhereSql(ctx: SqlContext, filters: DynamicViewBuilderFilter[]): string[];
+/**
+ * Builds the GROUP BY clause lines for a list of column identifiers.
+ * Returns an empty array when groupBy is empty.
+ */
+export declare function buildGroupBySql(ctx: SqlContext, groupBy: string[]): string[];
+/**
+ * Builds the ORDER BY clause lines for a list of sort items.
+ * Returns an empty array when sorting is empty.
+ */
+export declare function buildOrderBySql(ctx: SqlContext, sorting: DynamicViewBuilderSort[]): string[];
+/**
+ * Builds the complete generated SQL string from the provided config data.
+ * Returns an empty string when sources is empty.
+ */
+export declare function buildGeneratedSql(sources: DynamicViewBuilderSource[], normalizedFields: DynamicViewBuilderField[], joins: DynamicViewBuilderJoin[], filters: DynamicViewBuilderFilter[], groupBy: string[], sorting: DynamicViewBuilderSort[], ctx: SqlContext): string;

package/features/visual-sql-editor/utils/visual-sql-editor-text.util.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Normalizes a string for search comparison by removing diacritics,
+ * converting to lowercase and trimming whitespace.
+ */
+export declare function normalize(value: string): string;
+/**
+ * Converts a string to a slug by normalizing and replacing non-alphanumeric
+ * characters with underscores, then trimming leading/trailing underscores.
+ */
+export declare function slugify(value: string): string;
+/**
+ * Deduplicates an array of items by a key resolved from each item.
+ * Preserves the last occurrence of each key.
+ */
+export declare function deduplicateByKey<T>(items: T[], keyResolver: (item: T) => string): T[];

package/features/visual-sql-editor/utils/visual-sql-editor.constants.d.ts

@@ -0,0 +1,36 @@
+import type { BadgeColor } from "../../../core/types/badge.type";
+import type { DynamicViewBuilderFilterConnector, DynamicViewBuilderFilterValueType } from "../../../core/types/dynamic-view-builder.type";
+import type { DynamicModalDimensionsMap } from "../types/visual-sql-editor.types";
+export declare const EMPTY_VALUE = "";
+export declare const DEFAULT_JOIN_OPERATOR = "EQUALS";
+export declare const DEFAULT_FUNCTION_NAME = "count";
+export declare const DEFAULT_SORT_DIRECTION = "ASC";
+export declare const EMPTY_SORT_FUNCTION = "__base__";
+export declare const FLOW_ARROW_INSET = 3;
+export declare const FLOW_ARROW_MIN_GAP = 12;
+export declare const FLOW_ARROWS_REFRESH_DELAY_MS = 120;
+export declare const DEFAULT_FILTER_OPERATOR = "EQUAL";
+export declare const DEFAULT_FILTER_CONNECTOR: DynamicViewBuilderFilterConnector;
+export declare const DEFAULT_FILTER_VALUE_TYPE: DynamicViewBuilderFilterValueType;
+export declare const FILTER_MODE_DOMAIN = "domain";
+export declare const OVERLAY_APPEND_TARGET = "body";
+export declare const MODAL_Z_INDEX_OFFSET = 20;
+export declare const MODAL_OVERLAY_Z_INDEX: number;
+export declare const FIELD_PICKLIST_ROWS = 8;
+export declare const FILTER_PICKLIST_ROWS = 9;
+export declare const VISUAL_SQL_TABLE_COLOR = "#425466";
+export declare const VISUAL_SQL_FIELD_COLOR = "#1f8a52";
+export declare const PICKLIST_DATA_TYPE_BADGE_COLOR: BadgeColor;
+export declare const PICKLIST_FUNCTION_BADGE_COLOR: BadgeColor;
+export declare const FALLBACK_SELECT_TABLES = "Selecionar tabelas";
+export declare const FALLBACK_EMPTY_SELECTION = "Nenhum selecionado";
+export declare const PREVIEW_ROWS_PER_PAGE_OPTIONS: number[];
+export declare const ALIAS_MAX_LENGTH = 12;
+export declare const MIN_PARTS_FOR_DB = 3;
+export declare const DB_PARTS_OFFSET = -2;
+export declare const MIN_PARTS_FOR_TABLE = 2;
+export declare const JOIN_OPERATOR_LABELS: Record<string, {
+    key: string;
+    fallback: string;
+}>;
+export declare const DYNAMIC_MODAL_DIMENSIONS: DynamicModalDimensionsMap;