//
// Copyright 2024 Signal Messenger, LLC
// SPDX-License-Identifier: AGPL-3.0-only
//

#import <Foundation/Foundation.h>

NS_ASSUME_NONNULL_BEGIN

@interface NSString (OWS)

- (NSString *)ows_stripped;

- (NSString *)digitsOnly;

@property (nonatomic, readonly) BOOL hasAnyASCII;
@property (nonatomic, readonly) BOOL isOnlyASCII;

/// Trims and filters a string for display
- (NSString *)filterStringForDisplay;

/// Filters a substring for display, but does not trim it.
- (NSString *)filterSubstringForDisplay;

- (NSString *)filterFilename;

@property (nonatomic, readonly) NSString *withoutBidiControlCharacters;
@property (nonatomic, readonly) NSString *ensureBalancedBidiControlCharacters;
@property (nonatomic, readonly) NSString *bidirectionallyBalancedAndIsolated;

- (NSString *)stringByPrependingCharacter:(unichar)character;
- (NSString *)stringByAppendingCharacter:(unichar)character;

@end

NS_ASSUME_NONNULL_END