@swisspost/design-system-components 10.0.0-next.71 → 10.0.0-next.72

package/dist/types/utils/property-decorators/bound.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Options for the GreaterThan decorator validation.
+ *
+ * @property includeMin - Whether the minimum value is inclusive (default: false for exclusive behavior).
+ */
+export type GreaterThanOptions = {
+    includeMin?: boolean;
+};
+/**
+ * Property decorator that validates the property value is greater than the specified minimum.
+ *
+ * Validation runs on `componentDidLoad` and whenever the property value changes.
+ *
+ * @typeParam T - Component type used to constrain property-name bounds.
+ * @param minimum - The minimum allowed value (exclusive by default) or property name to read it from.
+ * @param options - Configuration object with `includeMin` flag (default: false for exclusive behavior).
+ */
+export declare function GreaterThan<T extends object>(minimum: number | Extract<keyof T, string>, options?: GreaterThanOptions): (target: T, property: string) => void;
+/**
+ * Options for the LessThan decorator validation.
+ *
+ * @property includeMax - Whether the maximum value is inclusive (default: true).
+ */
+export type LessThanOptions = {
+    includeMax?: boolean;
+};
+/**
+ * Property decorator that validates the property value is less than the specified maximum.
+ *
+ * Validation runs on `componentDidLoad` and whenever the property value changes.
+ *
+ * @typeParam T - Component type used to constrain property-name bounds.
+ * @param maximum - The maximum allowed value (inclusive by default) or property name to read it from.
+ * @param options - Configuration object with `includeMax` flag (default: true for inclusive behavior).
+ */
+export declare function LessThan<T extends object>(maximum: number | Extract<keyof T, string>, options?: LessThanOptions): (target: T, property: string) => void;

package/dist/types/utils/property-decorators/create-validator-decorator.d.ts

@@ -12,6 +12,11 @@ interface Validator {
     /** Executes the validation logic for the given component property. */
     run: (component: object, property: string) => boolean;
 }
+/**
+ * Registers that `dependentProp` should be re-validated when `dependencyProp` changes.
+ * Ensures the dependency property has an accessor so its setter can trigger dependents.
+ */
+export declare function registerDependency(target: object, dependencyProp: string, dependentProp: string): void;
 /**
  * Creates a property decorator that registers a validator for a component property.
  *

package/dist/types/utils/property-decorators/index.d.ts

@@ -1,5 +1,5 @@
 export { ArrayOf } from './array-of';
-export { createValidatorDecorator, getValidationContext } from './create-validator-decorator';
+export { GreaterThan, LessThan } from './bound';
 export { DateValue } from './date';
 export { IsoDate } from './iso-date';
 export { OneOf } from './one-of';

package/dist/types/utils/property-decorators/required.d.ts

@@ -1,8 +1,17 @@
+interface RequiredDecoratorOptions<T extends object> {
+    when: Extract<keyof T, string>;
+    truthy?: boolean;
+}
 /**
  * Property decorator that validates the property is not empty.
  * If the property is empty (undefined, null, '', NaN), an error is logged.
  * This validator is blocking: if it fails, subsequent validators will not run.
  *
  * Validation runs on `componentDidLoad` and whenever the property value changes.
+ *
+ * @param options - Optional configuration.
+ * @param options.when - The property name to watch. Validation only runs when this property's value matches the `truthy` option.
+ * @param options.truthy - The value that the `when` property must match for validation to run. Defaults to `true`.
  */
-export declare function Required(): (target: object, property: string) => void;
+export declare function Required<T extends object>(options?: RequiredDecoratorOptions<T>): (target: T, property: string) => void;
+export {};