@sap/ux-specification 1.142.2 → 1.142.4

package/dist/specification/src/sync/common/decoration/decorator-paths.js

@@ -0,0 +1,497 @@
+"use strict";
+/**
+ * Type-safe path builders and condition helpers for decorator conditions.
+ *
+ * This module provides:
+ *
+ *  ## Context Sources
+ * - **`app`**: App-level configuration (auto-injected from `app.config`)
+ * - **`page`**: Page-level configuration (auto-injected from `page.config`)
+ * - **`custom`**: Custom context (provided via `init()`)
+ *
+ * ## Utilities
+ * - **Path builders**: Type-safe property access for `app`, `page`, and `custom` contexts
+ * - **Condition helpers**: `when()`, `not()`, `and()`, `or()` for building conditions
+ * - **Message helper**: `msg()` for i18n-based messages
+ *
+ * @example
+ * ```typescript
+ * import { page, custom, when, not, and, or, msg } from './decorator-paths';
+ *
+ * class MyTable extends Decorator {
+ *     // Truthy check - hide when value is falsy
+ *     @hide(page.isALP)
+ *     alpOnlyField: string;
+ *
+ *     // Equality check with when() - hide when type IS GridTable
+ *     @hide(when(page.type, 'GridTable'))
+ *     gridField: string;
+ *
+ *     // Negation with not() - hide when type is NOT TreeTable
+ *     @hide(not(page.type, 'TreeTable'))
+ *     treeOnlyField: string;
+ *
+ *     // AND conditions
+ *     @hide(and(page.isALP, when(page.type, 'GridTable')))
+ *     alpGridField: string;
+ *
+ *     // OR conditions
+ *     @hide(or(when(page.actionType, 'Bound'), when(page.actionType, 'Custom')))
+ *     actionField: string;
+ *
+ *     // Message with i18n
+ *     @message(page.betaFeature, msg('BETA_WARNING', { feature: 'table' }))
+ *     betaField: string;
+ *
+ *     // Always hide
+ *     @hide(true)
+ *     internalField: string;
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MSG_SYMBOL = exports.NOT_SYMBOL = exports.WHEN_SYMBOL = exports.tableContext = exports.custom = exports.page = exports.app = exports.PATH_SYMBOL = void 0;
+exports.getPath = getPath;
+exports.isPathNode = isPathNode;
+exports.isWhenCondition = isWhenCondition;
+exports.when = when;
+exports.isNotCondition = isNotCondition;
+exports.not = not;
+exports.exists = exists;
+exports.isMessageConfig = isMessageConfig;
+exports.msg = msg;
+exports.and = and;
+exports.or = or;
+exports.isAndCondition = isAndCondition;
+exports.isOrCondition = isOrCondition;
+exports.isConditionGroup = isConditionGroup;
+exports.isOrConditionGroup = isOrConditionGroup;
+exports.isAndConditionGroup = isAndConditionGroup;
+// ============================================
+// PATH NODE INFRASTRUCTURE
+// ============================================
+/**
+ * Symbol used to store the path string within PathNode objects.
+ * This allows the decorator to extract the path at runtime.
+ *
+ * Using Symbol.for() creates a global symbol that persists across module loads,
+ * ensuring isPathNode() works correctly even when the module is loaded multiple times.
+ */
+exports.PATH_SYMBOL = Symbol.for('decorator:pathNode');
+/**
+ * Creates a type-safe path builder for a given context shape.
+ * Uses JavaScript Proxy to dynamically build paths with full TypeScript support.
+ *
+ * @template T - The shape type defining available properties
+ * @param prefix - The root prefix for all paths (e.g., 'app', 'page', 'custom')
+ * @returns A proxy object that builds typed paths
+ * @example
+ * ```typescript
+ * type MyShape = { enabled: boolean; settings: { mode: string } };
+ * const my = createPathBuilder<MyShape>('my');
+ *
+ * my.enabled[PATH_SYMBOL]           // 'my.enabled'
+ * my.settings.mode[PATH_SYMBOL]     // 'my.settings.mode'
+ * ```
+ */
+function createPathBuilder(prefix) {
+    const handler = {
+        get(_, prop) {
+            if (prop === exports.PATH_SYMBOL) {
+                return prefix;
+            }
+            if (typeof prop === 'string') {
+                return createPathBuilder(`${prefix}.${prop}`);
+            }
+            return undefined;
+        },
+        // Add 'has' trap to make 'in' operator work with PathNode check
+        has(_, prop) {
+            return prop === exports.PATH_SYMBOL;
+        }
+    };
+    return new Proxy({}, handler);
+}
+/**
+ * Extracts the path string from a PathNode.
+ *
+ * @template P - The string literal type of the path
+ * @param node - The PathNode to extract the path from
+ * @returns The path string
+ * @example
+ * ```typescript
+ * getPath(page.isALP)  // Returns: 'page.isALP'
+ * getPath(app.manifest)  // Returns: 'app.manifest'
+ * ```
+ */
+function getPath(node) {
+    return node[exports.PATH_SYMBOL];
+}
+/**
+ * Type guard to check if a value is a PathNode.
+ *
+ * @param value - The value to check
+ * @returns True if the value is a PathNode
+ */
+function isPathNode(value) {
+    return typeof value === 'object' && value !== null && exports.PATH_SYMBOL in value;
+}
+// ============================================
+// PATH BUILDER EXPORTS
+// ============================================
+/**
+ * Path builder for app.config properties.
+ *
+ * This context is **auto-injected** from `app.config` - you do not need to
+ * provide it in the customContext parameter of `init()`.
+ *
+ * @example
+ * ```typescript
+ * // Access manifest properties
+ * @hide(when(app.manifest['sap.app'].id, 'some-app-id'))
+ * ```
+ */
+exports.app = createPathBuilder('app');
+/**
+ * Path builder for page.config properties.
+ *
+ * This context is **auto-injected** from `page.config` - you do not need to
+ * provide it in the customContext parameter of `init()`.
+ *
+ * @example
+ * ```typescript
+ * // Simple truthy check
+ * @hide(page.isALP)
+ *
+ * // Equality check with when()
+ * @hide(when(page.isALP, true))
+ * @hide(when(page.visualization, 'Chart'))
+ *
+ * // Nested property
+ * @hide(when(page.settings.enabled, false))
+ * ```
+ */
+exports.page = createPathBuilder('page');
+/**
+ * Path builder for custom context properties.
+ *
+ * This context **must be provided** in the customContext parameter of `init()`.
+ * Use this for runtime-specific conditions like table state, section state, etc.
+ *
+ * **Note**: For table-specific decorators, prefer using `tableContext` which provides
+ * full type safety for table properties.
+ *
+ * @example
+ * ```typescript
+ * // In decorator
+ * @hide(when(custom.table.type, 'ResponsiveTable'))
+ * @hide(when(custom.table.views, (views) => views.length > 0))
+ *
+ * // In init
+ * decorator.init({
+ *     table: { type: 'GridTable', views: [] }
+ * });
+ * ```
+ */
+exports.custom = createPathBuilder('custom');
+/**
+ * Type-safe path builder for table decorator context.
+ *
+ * This context **must be provided** in the customContext parameter of `init()`.
+ * Use this for table-specific conditions in List Report table decorators.
+ *
+ * Properties are accessed directly without nesting (e.g., `tableContext.type` not `tableContext.table.type`).
+ *
+ * @example
+ * ```typescript
+ * // In decorator - with full type safety
+ * @hide(when(tableContext.type, 'AnalyticalTable'))
+ * @hide(not(tableContext.type, 'TreeTable'))
+ * @hide(when(tableContext.creationMode, (cm) => cm?.name === 'CreationDialog'))
+ *
+ * // In init - provide flat context object
+ * decorator.init({
+ *     type: 'GridTable',
+ *     creationMode: { name: 'NewPage' },
+ *     analyticalConfiguration: undefined,
+ *     popinLayout: undefined
+ * });
+ * ```
+ */
+exports.tableContext = createPathBuilder('custom');
+// ============================================
+// WHEN CONDITION HELPER
+// ============================================
+/**
+ * Symbol used to identify WhenCondition objects.
+ */
+exports.WHEN_SYMBOL = Symbol.for('decorator:when');
+/**
+ * Type guard to check if a value is a WhenCondition.
+ *
+ * @param value - The value to check
+ * @returns True if value is a WhenCondition
+ */
+function isWhenCondition(value) {
+    return typeof value === 'object' && value !== null && exports.WHEN_SYMBOL in value;
+}
+/**
+ * Creates a condition that checks if a path's value matches an expected value or function.
+ *
+ * @param path - The PathNode to check
+ * @param expected - The expected value or a function that receives the value and returns boolean
+ * @returns A WhenCondition object
+ * @example
+ * ```typescript
+ * // Equality check
+ * @hide(when(page.type, 'GridTable'))
+ *
+ * // Custom function (e.g., negation)
+ * @hide(when(page.type, (type) => type !== 'GridTable'))
+ *
+ * // Check array length
+ * @hide(when(custom.table.views, (views) => views?.length === 0))
+ *
+ * // Numeric comparison
+ * @hide(when(page.count, (count) => count > 10))
+ * ```
+ */
+function when(path, expected) {
+    return {
+        [exports.WHEN_SYMBOL]: true,
+        path,
+        expected
+    };
+}
+// ============================================
+// NOT CONDITION HELPER
+// ============================================
+/**
+ * Symbol used to identify NotCondition objects.
+ */
+exports.NOT_SYMBOL = Symbol.for('decorator:not');
+/**
+ * Type guard to check if a value is a NotCondition.
+ *
+ * @param value - The value to check
+ * @returns True if value is a NotCondition
+ */
+function isNotCondition(value) {
+    return typeof value === 'object' && value !== null && exports.NOT_SYMBOL in value;
+}
+/**
+ * Creates a negated condition that checks if a path's value does not match an expected value or function.
+ * This is the opposite of `when()`. While `when(path, value)` passes when value === expected,
+ * `not(path, value)` passes when value !== expected.
+ *
+ * Can also invert a WhenCondition created by `when()` or `exists()`.
+ *
+ * @param pathOrCondition - The PathNode to check or a WhenCondition to invert
+ * @param expected - Optional: The expected value or a function that receives the value and returns boolean
+ * @returns A NotCondition object
+ * @example
+ * ```typescript
+ * // Falsy check - hide when value is falsy
+ * @hide(not(page.enabled))
+ *
+ * // Inequality check - hide when type is NOT TreeTable
+ * @hide(not(page.type, 'TreeTable'))
+ *
+ * // Custom function negation - hide when function returns false
+ * @hide(not(custom.settings, (s) => s?.enabled === true))
+ *
+ * // Invert exists() - hide when value does NOT exist
+ * @hide(not(exists(tableContext.creationMode)))
+ *
+ * // Combined with and() - hide when BOTH conditions are met
+ * @hide(and(not(page.type, 'TreeTable'), page.isEnabled))
+ * ```
+ */
+function not(pathOrCondition, expected) {
+    // If first argument is a WhenCondition, extract its path and expected WITHOUT inverting
+    // The negate flag will handle inversion later in conditionToSingle
+    if (isWhenCondition(pathOrCondition)) {
+        const condition = pathOrCondition;
+        return {
+            [exports.NOT_SYMBOL]: true,
+            path: condition.path,
+            expected: condition.expected // Pass through without inversion - negate flag handles it
+        };
+    }
+    // Normal case: path + optional expected
+    return {
+        [exports.NOT_SYMBOL]: true,
+        path: pathOrCondition,
+        expected
+    };
+}
+// ============================================
+// EXISTS HELPER
+// ============================================
+/**
+ * Creates a condition that checks if a path's value exists (is not undefined).
+ * This is a semantic shorthand for `when(path, (value) => value !== undefined)`.
+ *
+ * @param path - The PathNode to check for existence
+ * @returns A WhenCondition that checks for defined value
+ * @example
+ * ```typescript
+ * // Check if property exists - show message only when value is set
+ * @message(
+ *     and(
+ *         not(tableContext.type, 'AnalyticalTable'),
+ *         exists(tableContext.analyticalConfiguration.aggregationOnLeafLevel)
+ *     ),
+ *     msg('PROPERTY_NOT_ALLOWED')
+ * )
+ *
+ * // Can be negated with not() - though typically just use truthy check
+ * @hide(not(exists(tableContext.creationMode)))
+ * ```
+ */
+function exists(path) {
+    return when(path, (value) => value !== undefined);
+}
+// ============================================
+// MESSAGE HELPER
+// ============================================
+/**
+ * Symbol used to identify MessageConfig objects.
+ */
+exports.MSG_SYMBOL = Symbol.for('decorator:msg');
+/**
+ * Type guard to check if a value is a MessageConfig.
+ *
+ * @param value - The value to check
+ * @returns True if value is a MessageConfig
+ */
+function isMessageConfig(value) {
+    return typeof value === 'object' && value !== null && exports.MSG_SYMBOL in value;
+}
+/**
+ * Creates an i18n message configuration for use with the `@message` decorator.
+ *
+ * @param i18nKey - The i18n translation key
+ * @param params - Optional parameters to pass to the translation function.
+ *   Values can be static or PathNode references for dynamic resolution.
+ * @param options - Optional configuration
+ * @param options.deletable - Whether the message can be dismissed/deleted in the UI (default: false)
+ * @returns A MessageConfig object
+ * @example
+ * ```typescript
+ * // Simple message
+ * @message(page.betaFeature, msg('BETA_WARNING'))
+ *
+ * // Message with static parameters
+ * @message(when(page.type, 'GridTable'), msg('TABLE_WARNING', { type: 'GridTable' }))
+ *
+ * // Message with dynamic parameters (resolved from context at runtime)
+ * @message(condition, msg('TABLE_WARNING', { tableType: tableContext.table.type }))
+ *
+ * // Deletable message
+ * @message(page.deprecated, msg('DEPRECATED', { since: '1.96' }, { deletable: true }))
+ * ```
+ */
+function msg(i18nKey, params, options) {
+    return {
+        [exports.MSG_SYMBOL]: true,
+        i18nKey,
+        params,
+        deletable: options?.deletable ?? false
+    };
+}
+// ============================================
+// CONDITION HELPER FUNCTIONS
+// ============================================
+/**
+ * Creates an AND condition group where ALL conditions must be met.
+ *
+ * @param conditions - Conditions to combine (PathNode for truthy, WhenCondition for value check)
+ * @returns An AndCondition object for use with decorators
+ * @example
+ * ```typescript
+ * // Both must be truthy
+ * @hide(and(page.isALP, page.isMultiView))
+ *
+ * // Mixed truthy and value checks
+ * @hide(and(page.isALP, when(page.type, 'GridTable')))
+ *
+ * // Multiple value checks
+ * @hide(and(when(page.isALP, true), when(page.isMultiView, true)))
+ * ```
+ */
+function and(...conditions) {
+    return {
+        __type: 'and',
+        conditions
+    };
+}
+/**
+ * Creates an OR condition group where AT LEAST ONE condition must be met.
+ *
+ * @param conditions - Conditions to combine (PathNode for truthy, WhenCondition for value check)
+ * @returns An OrCondition object for use with decorators
+ * @example
+ * ```typescript
+ * // Either must be truthy
+ * @hide(or(page.isALP, page.isOVP))
+ *
+ * // Either value must match
+ * @hide(or(when(page.actionType, 'Bound'), when(page.actionType, 'Custom')))
+ * ```
+ */
+function or(...conditions) {
+    return {
+        __type: 'or',
+        conditions
+    };
+}
+/**
+ * Type guard to check if a value is an AndCondition.
+ *
+ * @param value - The value to check
+ * @returns True if value is an AndCondition
+ */
+function isAndCondition(value) {
+    return typeof value === 'object' && value !== null && value.__type === 'and';
+}
+/**
+ * Type guard to check if a value is an OrCondition.
+ *
+ * @param value - The value to check
+ * @returns True if value is an OrCondition
+ */
+function isOrCondition(value) {
+    return typeof value === 'object' && value !== null && value.__type === 'or';
+}
+/**
+ * Type guard to check if a value is a ConditionGroup (and or or).
+ *
+ * @param value - The value to check
+ * @returns True if value is a ConditionGroup
+ */
+function isConditionGroup(value) {
+    return isAndCondition(value) || isOrCondition(value);
+}
+// ============================================
+// NESTED CONDITION TYPE GUARDS
+// ============================================
+/**
+ * Type guard to check if an AND condition item is a nested OR group.
+ *
+ * @param item - The condition item to check
+ * @returns True if item is an OrConditionGroup
+ */
+function isOrConditionGroup(item) {
+    return item !== null && typeof item === 'object' && '__orConditions' in item;
+}
+/**
+ * Type guard to check if an OR condition item is a nested AND group.
+ *
+ * @param item - The condition item to check
+ * @returns True if item is an AndConditionGroup
+ */
+function isAndConditionGroup(item) {
+    return item !== null && typeof item === 'object' && '__andConditions' in item;
+}
+//# sourceMappingURL=decorator-paths.js.map

package/dist/specification/src/sync/common/decoration/decorator-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator-paths.js","sourceRoot":"","sources":["../../../../../../src/sync/common/decoration/decorator-paths.ts"],"names":[],"mappings":"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"}

package/dist/specification/src/sync/common/decoration/decorators.d.ts

@@ -1,12 +1,19 @@
 import 'reflect-metadata';
-import type { SyncRule, PageLayoutInformation, ValidityInformation, SyncRuleProvider, Validity, BooleanCondition, DependsOnCondition, DependsOnMessage, MultiDependsOnCondition } from '@sap/ux-specification-types';
+import type { SyncRule, PageLayoutInformation, ValidityInformation, SyncRuleProvider, Validity, DependsOnCondition } from '@sap/ux-specification-types';
+import { type ConditionInput, type MessageConfig } from './decorator-paths';
+/**
+ * Metadata keys for schema post-processing.
+ * Used by decorators to store metadata that is processed during schema generation.
+ */
 export declare const metadataKeys: {
     description: symbol;
-    hidden: symbol;
     isViewNode: symbol;
     syncRule: symbol;
-    dependsOn: symbol;
     validity: symbol;
+    hide: symbol;
+    message: symbol;
+    readonly: symbol;
+    enums: symbol;
 };
 export declare const syncRule: (propSpec: SyncRule) => any;
 /**
@@ -54,39 +61,124 @@ export declare function isViewNode(target: Function): void;
  */
 export declare function description(text: string): (target: Function) => void;
 /**
- * Decorator to conditionally hide a property in the schema based on a condition function.
- * The condition function is evaluated during schema generation with the appropriate context.
+ * Internal metadata structure stored by decorators.
+ * Extends DependsOnCondition with optional message configuration.
+ */
+export interface DecoratorMetadata extends DependsOnCondition {
+    messageConfig?: MessageConfig;
+}
+/**
+ * Decorator to conditionally hide a property based on conditions.
+ * The property will be hidden when the condition(s) ARE met.
+ *
+ * @example
+ * ```typescript
+ * import { page, custom, when, and, or } from './decorator-paths';
+ *
+ * // Truthy check - hide when page.isALP is truthy
+ * @hide(page.isALP)
+ *
+ * // Equality check - hide when page.type === 'GridTable'
+ * @hide(when(page.type, 'GridTable'))
  *
- * @param condition - A function that takes context and returns boolean indicating if property should be hidden
- * @returns PropertyDecorator or ClassDecorator depending on usage
+ * // Custom function - hide when function returns true (type !== 'GridTable')
+ * @hide(when(page.type, (type) => type !== 'GridTable'))
+ *
+ * // Always hide
+ * @hide(true)
+ *
+ * // AND logic - hide when isALP is truthy AND type === 'GridTable'
+ * @hide(and(page.isALP, when(page.type, 'GridTable')))
+ *
+ * // OR logic - hide when actionType === 'Bound' OR actionType === 'Custom'
+ * @hide(or(when(page.actionType, 'Bound'), when(page.actionType, 'Custom')))
+ * ```
+ * @param condition - The condition to evaluate
+ * @returns PropertyDecorator
  */
-export declare function hidden(condition?: BooleanCondition): PropertyDecorator & ClassDecorator;
+export declare function hide(condition: ConditionInput): PropertyDecorator;
 /**
- * Helper function to create a DependsOnMessage object.
+ * Decorator to conditionally display a message based on conditions.
+ * A message will be shown when the condition(s) are met.
+ * Multiple @message decorators can be applied to the same property - all matching conditions will show their messages.
+ *
+ * @param condition - The condition to evaluate
+ * @param messageConfig - The message configuration (use msg() helper)
+ * @returns PropertyDecorator
+ * @example
+ * ```typescript
+ * import { page, when, msg } from './decorator-paths';
+ *
+ * // Simple message
+ * @message(page.betaFeature, msg('BETA_WARNING'))
  *
- * @param text - The message text (can be true for default i18n message, a string, or a function)
- * @param deletable - Whether the message can be deleted/dismissed in the UI
- * @returns A DependsOnMessage object
+ * // Message with parameters
+ * @message(when(page.type, 'GridTable'), msg('TABLE_WARNING', { type: 'GridTable' }))
+ *
+ * // Deletable message
+ * @message(page.deprecated, msg('DEPRECATED', { since: '1.96' }, { deletable: true }))
+ *
+ * // With AND/OR conditions
+ * @message(and(page.isALP, when(page.type, 'GridTable')), msg('ALP_GRID_INFO'))
+ *
+ * // Multiple messages on same property
+ * @message(when(page.type, 'AnalyticalTable'), msg('ANALYTICAL_WARNING'))
+ * @message(when(page.mode, 'edit'), msg('EDIT_MODE_WARNING'))
+ * ```
  */
-export declare const dependsOnMessage: (text?: DependsOnMessage["text"], deletable?: boolean) => DependsOnMessage;
+export declare function message(condition: ConditionInput, messageConfig: MessageConfig): PropertyDecorator;
 /**
- * Decorator to conditionally show/hide a property based on one or more property values.
- * The decorated property will be hidden if the dependency condition(s) are not met.
+ * Decorator to conditionally mark a property as readonly based on conditions.
+ * The property will be readonly when the condition(s) are met.
+ *
+ * @example
+ * ```typescript
+ * import { page, custom, when } from './decorator-paths';
  *
- * @param pathOrConditions - A string property path or an array of condition objects (all must be met)
- * @param conditionOrValueOrMessage - Single condition: condition/expected value/message; Multi-condition: message parameter
- * @param message - Optional message parameter (only for single condition with condition/value)
+ * // Truthy check - readonly if page.isLocked is truthy
+ * @readonly(page.isLocked)
+ *
+ * // Equality check - readonly if mode === 'view'
+ * @readonly(when(page.mode, 'view'))
+ *
+ * // Custom function - readonly if role is 'viewer'
+ * @readonly(when(custom.user.role, (role) => role === 'viewer'))
+ * ```
+ * @param condition - The condition to evaluate
  * @returns PropertyDecorator
  */
-export declare function dependsOn(pathOrConditions: string | MultiDependsOnCondition, conditionOrValueOrMessage?: BooleanCondition | any | DependsOnMessage, message?: DependsOnMessage): PropertyDecorator;
+export declare function readonly(condition: ConditionInput): PropertyDecorator;
 /**
- * Retrieves the dependsOn metadata associated with a specific property of a target object.
+ * Metadata structure for the @enums decorator.
+ * Extends DecoratorMetadata with the list of allowed enum values.
+ */
+export interface EnumsDecoratorMetadata extends DecoratorMetadata {
+    /** The allowed enum values when the condition is met */
+    allowedValues: string[];
+}
+/**
+ * Decorator to conditionally restrict enum values based on conditions.
+ * When the condition is met, only the specified allowedValues will be available.
+ * If multiple @enums decorators exist on the same property, the first matching condition wins.
  *
- * @param target - The object containing the property.
- * @param propertyName - The name of the property whose dependsOn metadata is to be retrieved.
- * @returns The dependsOn information of the property, or undefined if no metadata is found.
+ * @example
+ * ```typescript
+ * import { custom, when } from './decorator-paths';
+ *
+ * // Restrict to specific values when table type is TreeTable
+ * @enums(when(custom.table.type, 'TreeTable'), ['Inline', 'NewPage', 'CreationDialog'])
+ *
+ * // Different values for other table types
+ * @enums(when(custom.table.type, 'ResponsiveTable'), ['Inline', 'InlineCreationRows', 'NewPage', 'CreationDialog', 'External'])
+ *
+ * // Default values when no other condition matches
+ * @enums(true, ['NewPage', 'CreationDialog'])
+ * ```
+ * @param condition - The condition to evaluate
+ * @param allowedValues - Array of allowed enum values when condition is met
+ * @returns PropertyDecorator
  */
-export declare function getDependsOnMetadata(target: object, propertyName: string): DependsOnCondition | undefined;
+export declare function enums(condition: ConditionInput, allowedValues: string[]): PropertyDecorator;
 /**
  * Generates a deprecation message for a given key, optionally including additional validity information.
  *