@sap/ux-specification 1.136.15 → 1.136.16

package/dist/specification/test/unit/decorators/validity-test-utils.d.ts

@@ -0,0 +1,131 @@
+/**
+ * @file Test utilities for validating @validity decorator behavior
+ *
+ * This module provides helper functions for:
+ * - Extracting validity metadata from decorated classes
+ * - Generating expected vs actual visibility tables
+ * - Comparing property visibility across UI5 versions
+ * - Formatting results as markdown for snapshot testing
+ */
+import type { Definition } from 'typescript-json-schema';
+import type { SchemaType } from '@sap/ux-specification-types';
+/** Emoji indicator for a visible/available property */
+export declare const EMOJI_VISIBLE = "\u2705";
+/** Emoji indicator for a hidden/unavailable property */
+export declare const EMOJI_HIDDEN = "\uD83D\uDEAB";
+/** Emoji indicator for property not found in schema */
+export declare const EMOJI_NOT_FOUND = "\u2753";
+/** Emoji indicator for a match between expected and actual */
+export declare const EMOJI_MATCH = "\u2705";
+/** Emoji indicator for a mismatch between expected and actual */
+export declare const EMOJI_DIFF = "\u26A0\uFE0F";
+/** Special version string representing the latest/newest version */
+export declare const VERSION_LATEST = "latest";
+/** Indentation for snapshot content (16 spaces to align within toMatchInlineSnapshot) */
+export declare const INDENT = "                ";
+/**
+ * Information about a property with a @validity decorator
+ */
+export interface ValidityInfo {
+    /** The property name */
+    property: string;
+    /** The UI5 version since which the property is available */
+    since: string;
+}
+/**
+ * Information about an enum value with conditional availability
+ */
+interface EnumValueInfo {
+    /** The property name that has this enum */
+    property: string;
+    /** The enum value */
+    enumValue: string;
+    /** The UI5 version since which the enum value is available */
+    since: string;
+}
+/**
+ * A row in the version visibility table showing property availability across versions
+ */
+interface VersionVisibilityRow {
+    /** The property name */
+    property: string;
+    /** The UI5 version since which the property is available */
+    since: string;
+    /** Dynamic keys for each version (e.g., '1.84.0': '✅') */
+    [version: string]: string;
+}
+/**
+ * Function type for finding a specific definition within a schema
+ */
+export type DefinitionFinder = (schema: Definition) => Definition | undefined;
+/**
+ * Finds the definition containing table properties by searching common patterns
+ */
+export declare function findTableDefinition(schema: Definition): Definition | undefined;
+/**
+ * Creates a definition finder function for a specific definition name
+ */
+export declare function findDefinitionByName(definitionName: string): DefinitionFinder;
+/**
+ * Extracts enum value validity information from a class's properties
+ */
+export declare function getEnumValidityFromClass(ClassConstructor: new () => object): EnumValueInfo[];
+/**
+ * Generates expected visibility table based on @validity decorator metadata
+ */
+export declare function generateExpectedVisibilityTable(validityInfos: ValidityInfo[], versions: string[]): VersionVisibilityRow[];
+/**
+ * Generates actual visibility table from generated schemas
+ */
+export declare function generateActualVisibilityTable(validityInfos: ValidityInfo[], versions: string[], schemaResults: Map<string, Definition>, findDefinition: DefinitionFinder): VersionVisibilityRow[];
+/**
+ * A row in the diff visibility table showing matches/mismatches between expected and actual
+ */
+interface DiffVisibilityRow {
+    /** The property name */
+    property: string;
+    /** The UI5 version since which the property is available */
+    since: string;
+    /** Dynamic keys for each version (e.g., '1.84.0': '✅' or '⚠️') */
+    [version: string]: string;
+}
+/**
+ * Generates a diff visibility table comparing expected vs actual
+ */
+export declare function generateDiffVisibilityTable(validityInfos: ValidityInfo[], versions: string[], schemaResults: Map<string, Definition>, findDefinition: DefinitionFinder): DiffVisibilityRow[];
+/**
+ * Formats visibility table as a markdown string for snapshot testing
+ */
+export declare function formatVisibilityTableMarkdown(rows: VersionVisibilityRow[], versions: string[]): string;
+/**
+ * Formats diff table as a markdown string for report generation
+ */
+export declare function formatDiffTableMarkdown(rows: DiffVisibilityRow[], versions: string[]): string;
+/**
+ * Formats enum validity information as a markdown table for report generation
+ */
+export declare function formatEnumValidityTableMarkdown(enumInfos: EnumValueInfo[], versions: string[]): string;
+/**
+ * Generates schemas for multiple UI5 versions
+ */
+export declare function generateSchemasForVersions(genericSchema: Definition, schemaType: SchemaType, versions: string[]): Promise<Map<string, Definition>>;
+/**
+ * Gets validity properties for a class from a generic schema
+ */
+export declare function getValidityProperties(genericSchema: Definition, classRef: new () => object, schemaName?: string): ValidityInfo[];
+/**
+ * Compares expected vs actual visibility and returns both tables for assertion
+ */
+export declare function compareExpectedVsActual(validityInfos: ValidityInfo[], versions: string[], schemaResults: Map<string, Definition>, findDefinition: DefinitionFinder): {
+    expected: string;
+    actual: string;
+};
+/**
+ * Compares expected vs actual enum visibility and returns both tables for assertion
+ */
+export declare function compareExpectedVsActualEnum(enumInfos: EnumValueInfo[], versions: string[], schemaResults: Map<string, Definition>, findDefinition: DefinitionFinder): {
+    expected: string;
+    actual: string;
+};
+export {};
+//# sourceMappingURL=validity-test-utils.d.ts.map

package/dist/specification/test/unit/decorators/validity-test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validity-test-utils.d.ts","sourceRoot":"","sources":["../../../../../test/unit/decorators/validity-test-utils.ts"],"names":[],"mappings":"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"}