/**
* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
*/
/**
* @module engine/view/tokenlist
*/
import { type ArrayOrItem } from "@ckeditor/ckeditor5-utils";
import type { ViewElementAttributeValue } from "./element.js";
/**
* Token list. Allows handling (adding, removing, retrieving) a set of tokens (for example class names).
*/
export declare class ViewTokenList implements ViewElementAttributeValue {
	/**
	* The set of tokens.
	*/
	private _set;
	/**
	* Returns true if token list has no tokens set.
	*/
	get isEmpty(): boolean;
	/**
	* Number of tokens.
	*/
	get size(): number;
	/**
	* Checks if a given token is set.
	*/
	has(name: string): boolean;
	/**
	* Returns all tokens.
	*/
	keys(): Array<string>;
	/**
	* Resets the value to the given one.
	*/
	setTo(value: string): this;
	/**
	* Sets a given token without affecting other tokens.
	*/
	set(tokens: ArrayOrItem<string>): void;
	/**
	* Removes given token.
	*/
	remove(tokens: ArrayOrItem<string>): void;
	/**
	* Removes all tokens.
	*/
	clear(): void;
	/**
	* Returns a normalized tokens string.
	*/
	toString(): string;
	/**
	* Returns `true` if both attributes have the same tokens.
	*/
	isSimilar(other: ViewTokenList): boolean;
	/**
	* Clones the attribute value.
	*
	* @internal
	*/
	_clone(): this;
	/**
	* Used by the {@link module:engine/view/matcher~Matcher Matcher} to collect matching attribute tokens.
	*
	* @internal
	* @param tokenPattern The matched token name pattern.
	* @returns An array of matching tokens.
	*/
	_getTokensMatch(tokenPattern: true | string | RegExp): Array<string> | undefined;
	/**
	* Returns a list of consumables for the attribute.
	*
	* Could be filtered by the given token name.
	*
	* @internal
	*/
	_getConsumables(name?: string): Array<string>;
	/**
	* Used by {@link module:engine/view/element~ViewElement#_canMergeAttributesFrom} to verify if the given attribute
	* can be merged without conflicts into the attribute.
	*
	* This method is indirectly used by the {@link module:engine/view/downcastwriter~ViewDowncastWriter} while downcasting
	* an {@link module:engine/view/attributeelement~ViewAttributeElement} to merge it with other `AttributeElement`.
	*
	* @internal
	*/
	_canMergeFrom(): boolean;
	/**
	* Used by {@link module:engine/view/element~ViewElement#_mergeAttributesFrom} to merge a given attribute into the attribute.
	*
	* This method is indirectly used by the {@link module:engine/view/downcastwriter~ViewDowncastWriter} while down-casting
	* an {@link module:engine/view/attributeelement~ViewAttributeElement} to merge it with other ViewAttributeElement.
	*
	* @internal
	*/
	_mergeFrom(other: ViewTokenList): void;
	/**
	* Used by {@link module:engine/view/element~ViewElement#_canSubtractAttributesOf} to verify if the given attribute
	* can be fully subtracted from the attribute.
	*
	* This method is indirectly used by the {@link module:engine/view/downcastwriter~ViewDowncastWriter} while down-casting
	* an {@link module:engine/view/attributeelement~ViewAttributeElement} to unwrap the ViewAttributeElement.
	*
	* @internal
	*/
	_isMatching(other: ViewTokenList): boolean;
}