api.d.ts

import { XMLDocument, XMLElement, XMLAttribute } from "@xml-tools/ast";
import { OffsetRange } from "@ui5-language-assistant/logic-utils";
import { UI5ValidatorsConfig } from "./src/validate-xml-views";
import { Context } from "@ui5-language-assistant/context";
import { Range } from "vscode-languageserver-types";

export function validateXMLView<ExternalXMLViewIssue>(opts: {
  validators: UI5ValidatorsConfig<UI5XMLViewIssue | ExternalXMLViewIssue>;
  context: Context;
  xmlView: XMLDocument;
}): (UI5XMLViewIssue | ExternalXMLViewIssue)[];

export declare const defaultValidators: UI5ValidatorsConfig;

export { UI5ValidatorsConfig } from "./src/validate-xml-views";

export type XMLViewIssueSeverity = "hint" | "info" | "warn" | "error";

export interface BaseUI5XMLViewIssue<T extends string = "base"> {
  issueType: T;
  kind: string;
  message: string;
  severity: XMLViewIssueSeverity;
  offsetRange: OffsetRange;
  code?: string | number;
  tags?: DiagnosticTag[];
}

export type UseOfDeprecatedAttributeIssue =
  | UseOfDeprecatedPropertyIssue
  | UseOfDeprecatedAggregationIssue
  | UseOfDeprecatedEventIssue
  | UseOfDeprecatedAssociationIssue;

export type UI5XMLViewIssue =
  | UnknownEnumValueIssue
  | UseOfDeprecatedClassIssue
  | UseOfDeprecatedAggregationIssue
  | UseOfDeprecatedPropertyIssue
  | UseOfDeprecatedEventIssue
  | UseOfDeprecatedAssociationIssue
  | UnknownNamespaceInXmlnsAttributeValueIssue
  | InvalidBooleanValueIssue
  | NonUniqueIDIssue
  | NonStableIDIssue
  | UnknownAttributeKeyIssue
  | UnknownTagNameIssue
  | InvalidAggregationCardinalityIssue
  | InvalidAggregationTypeIssue;

// A sub-interface per issue type may seem redundant, but this allows
// a sub-issue type to have additional properties (if needed) in the future.
export interface UnknownEnumValueIssue extends BaseUI5XMLViewIssue {
  kind: "UnknownEnumValue";
}

export interface UseOfDeprecatedClassIssue extends BaseUI5XMLViewIssue {
  kind: "UseOfDeprecatedClass";
}

export interface UseOfDeprecatedAggregationIssue extends BaseUI5XMLViewIssue {
  kind: "UseOfDeprecatedAggregation";
}

export interface UseOfDeprecatedPropertyIssue extends BaseUI5XMLViewIssue {
  kind: "UseOfDeprecatedProperty";
}

export interface UseOfDeprecatedEventIssue extends BaseUI5XMLViewIssue {
  kind: "UseOfDeprecatedEvent";
}

export interface UseOfDeprecatedAssociationIssue extends BaseUI5XMLViewIssue {
  kind: "UseOfDeprecatedAssociation";
}

export interface InvalidAggregationCardinalityIssue
  extends BaseUI5XMLViewIssue {
  kind: "InvalidAggregationCardinality";
}

export interface InvalidAggregationTypeIssue extends BaseUI5XMLViewIssue {
  kind: "InvalidAggregationType";
}

export interface UnknownNamespaceInXmlnsAttributeValueIssue
  extends BaseUI5XMLViewIssue {
  kind: "UnknownNamespaceInXmlnsAttributeValue";
}

export interface UnknownAttributeKeyIssue extends BaseUI5XMLViewIssue {
  kind: "UnknownAttributeKey";
}

export interface UnknownTagNameIssue extends BaseUI5XMLViewIssue {
  kind: "UnknownTagName";
}

export interface InvalidBooleanValueIssue extends BaseUI5XMLViewIssue {
  kind: "InvalidBooleanValue";
}

export interface NonUniqueIDIssue extends BaseUI5XMLViewIssue {
  kind: "NonUniqueIDIssue";
  identicalIDsRanges: {
    range: Range;
    uri: string;
  }[];
}

export interface NonStableIDIssue extends BaseUI5XMLViewIssue {
  kind: "NonStableIDIssue";
}

type XMLAttributeValidator<T> = (
  attribute: XMLAttribute,
  context: Context
) => T[];

type XMLDocumentValidator<T> = (document: XMLDocument, context: Context) => T[];

type XMLElementValidator<T> = (XMLElement: XMLElement, context: Context) => T[];

export type Validators = {
  validateUnknownEnumValue: XMLAttributeValidator<UnknownEnumValueIssue>;
  validateUnknownXmlnsNamespace: XMLAttributeValidator<UnknownNamespaceInXmlnsAttributeValueIssue>;
  validateBooleanValue: XMLAttributeValidator<InvalidBooleanValueIssue>;
  validateUseOfDeprecatedAttribute: XMLAttributeValidator<UseOfDeprecatedAttributeIssue>;
  validateUnknownAttributeKey: XMLAttributeValidator<UnknownAttributeKeyIssue>;
  validateUseOfDeprecatedAggregation: XMLElementValidator<UseOfDeprecatedAggregationIssue>;
  validateUseOfDeprecatedClass: XMLElementValidator<UseOfDeprecatedClassIssue>;
  validateUnknownTagName: XMLElementValidator<UnknownTagNameIssue>;
  validateExplicitAggregationCardinality: XMLElementValidator<InvalidAggregationCardinalityIssue>;
  validateAggregationType: XMLElementValidator<InvalidAggregationTypeIssue>;
  validateNonStableId: XMLElementValidator<NonStableIDIssue>;
};

export const validators: Validators;

export function isPossibleBindingAttributeValue(value: string): boolean;

export { validateNonUniqueID } from "./src/api";