@y/y/dist/src/utils/ids.d.ts

Shared Editing Library

export class IdRange {
    /**
     * @param {number} clock
     * @param {number} len
     */
    constructor(clock: number, len: number);
    /**
     * @type {number}
     */
    clock: number;
    /**
     * @type {number}
     */
    len: number;
    /**
     * @param {number} clock
     * @param {number} len
     */
    copyWith(clock: number, len: number): IdRange;
    /**
     * Helper method making this compatible with IdMap.
     *
     * @return {Array<ContentAttribute<any>>}
     */
    get attrs(): Array<ContentAttribute<any>>;
}
export class MaybeIdRange {
    /**
     * @param {number} clock
     * @param {number} len
     * @param {boolean} exists
     */
    constructor(clock: number, len: number, exists: boolean);
    /**
     * @type {number}
     */
    clock: number;
    /**
     * @type {number}
     */
    len: number;
    /**
     * @type {boolean}
     */
    exists: boolean;
}
export function createMaybeIdRange(clock: number, len: number, exists: boolean): MaybeIdRange;
export class IdRanges {
    /**
     * @param {Array<IdRange>} ids
     */
    constructor(ids: Array<IdRange>);
    sorted: boolean;
    /**
     * A typical use-case for IdSet is to append data. We heavily optimize this case by allowing the
     * last item to be mutated ef it isn't used currently.
     * This flag is true if the last item was exposed to the outside.
     */
    _lastIsUsed: boolean;
    /**
     * @private
     */
    private _ids;
    copy(): IdRanges;
    /**
     * @param {number} clock
     * @param {number} length
     */
    add(clock: number, length: number): void;
    /**
     * Return the list of immutable id ranges, sorted and merged.
     */
    getIds(): IdRange[];
}
/**
 * @implements {traits.EqualityTrait}
 */
export class IdSet implements traits.EqualityTrait {
    /**
     * @type {Map<number,IdRanges>}
     */
    clients: Map<number, IdRanges>;
    isEmpty(): boolean;
    /**
     * @param {(idrange:IdRange, client:number) => void} f
     */
    forEach(f: (idrange: IdRange, client: number) => void): void;
    /**
     * @param {ID} id
     * @return {boolean}
     */
    hasId(id: ID): boolean;
    /**
     * @param {number} client
     * @param {number} clock
     */
    has(client: number, clock: number): boolean;
    /**
     * Return slices of ids that exist in this idset.
     *
     * @param {number} client
     * @param {number} clock
     * @param {number} len
     * @return {Array<MaybeIdRange>}
     */
    slice(client: number, clock: number, len: number): Array<MaybeIdRange>;
    /**
     * @param {number} client
     * @param {number} clock
     * @param {number} len
     */
    add(client: number, clock: number, len: number): void;
    /**
     * @param {number} client
     * @param {number} clock
     * @param {number} len
     */
    delete(client: number, clock: number, len: number): void;
    /**
     * @param {any} other
     */
    [traits.EqualityTraitSymbol](other: any): boolean;
}
export function equalIdSets(ds1: IdSet, ds2: IdSet): boolean;
export function _deleteRangeFromIdSet(set: IdSet | IdMap<any>, client: number, clock: number, len: number): void;
export function iterateStructsByIdSet(transaction: Transaction, ds: IdSet, f: (arg0: GC | Item) => void): void;
export function findIndexInIdRanges(dis: Array<IdRange>, clock: number): number | null;
export function findRangeStartInIdRanges(dis: Array<IdRange>, clock: number): number | null;
export function mergeIdSets(idSets: Array<IdSet>): IdSet;
/**
 * @template {IdSet | IdMap<any>} S
 * @param {S} dest
 * @param {S} src
 */
export function insertIntoIdSet<S extends IdSet | IdMap<any>>(dest: S, src: S): void;
/**
 * @template {IdSet | IdMap<any>} S
 * @param {S} dest
 * @param {S} src
 */
export function insertIntoIdMap<S extends IdSet | IdMap<any>>(dest: S, src: S): void;
export function _diffSet<Set extends IdSet | IdMap<any>>(set: Set, exclude: IdSet | IdMap<any>): Set;
/**
 * Remove all ranges from `exclude` from `idSet`. The result is a fresh IdSet containing all ranges from `idSet` that are not
 * in `exclude`.
 *
 * @type {(idSet: IdSet, exclude: IdSet|IdMap<any>) => IdSet}
 */
export const diffIdSet: (idSet: IdSet, exclude: IdSet | IdMap<any>) => IdSet;
export function _intersectSets<SetA extends IdSet | IdMap<any>, SetB extends IdSet | IdMap<any>>(setA: SetA, setB: SetB): SetA extends IdMap<infer A> ? (SetB extends IdMap<infer B> ? IdMap<A | B> : IdMap<A>) : IdSet;
export function intersectSets<SetA extends IdSet | IdMap<any>, SetB extends IdSet | IdMap<any>>(setA: SetA, setB: SetB): SetA extends IdMap<infer A> ? (SetB extends IdMap<infer B> ? IdMap<A | B> : IdMap<A>) : IdSet;
export function createIdSet(): IdSet;
export function createDeleteSetFromStructStore(ss: StructStore): IdSet;
export function _createInsertSliceFromStructs(structs: Array<GC | Item | Skip>, filterDeleted: boolean): IdRange[];
export function createInsertSetFromStructStore(ss: StructStore, filterDeleted: boolean): IdSet;
export function writeIdSet(encoder: IdSetEncoderV1 | IdSetEncoderV2, idSet: IdSet): void;
export function readIdSet(decoder: IdSetDecoderV1 | IdSetDecoderV2): IdSet;
export function readAndApplyDeleteSet(decoder: IdSetDecoderV1 | IdSetDecoderV2, transaction: Transaction, store: StructStore): Uint8Array<ArrayBuffer> | null;
/**
 * @template Attrs
 */
export class AttrRange<Attrs> {
    /**
     * @param {number} clock
     * @param {number} len
     * @param {Array<ContentAttribute<Attrs>>} attrs
     */
    constructor(clock: number, len: number, attrs: Array<ContentAttribute<Attrs>>);
    /**
     * @readonly
     */
    readonly clock: number;
    /**
     * @readonly
     */
    readonly len: number;
    /**
     * @readonly
     */
    readonly attrs: ContentAttribute<Attrs>[];
    /**
     * @param {number} clock
     * @param {number} len
     */
    copyWith(clock: number, len: number): AttrRange<Attrs>;
}
/**
 * @todo rename this to `Attribute`
 * @template V
 */
export class ContentAttribute<V> {
    /**
     * @param {string} name
     * @param {V} val
     */
    constructor(name: string, val: V);
    name: string;
    val: V;
    hash(): string;
}
export function createContentAttribute<V>(name: string, val: V): ContentAttribute<V>;
export function createMaybeAttrRange<Attrs>(clock: number, len: number, attrs: Array<ContentAttribute<Attrs>> | null): MaybeAttrRange<Attrs>;
/**
 * Whenever this is instantiated, it must receive a fresh array of ops, not something copied.
 *
 * @template Attrs
 */
export class AttrRanges<Attrs> {
    /**
     * @param {Array<AttrRange<Attrs>>} ids
     */
    constructor(ids: Array<AttrRange<Attrs>>);
    sorted: boolean;
    /**
     * @private
     */
    private _ids;
    copy(): AttrRanges<Attrs>;
    /**
     * @param {number} clock
     * @param {number} length
     * @param {Array<ContentAttribute<Attrs>>} attrs
     */
    add(clock: number, length: number, attrs: Array<ContentAttribute<Attrs>>): void;
    /**
     * Return the list of id ranges, sorted and merged.
     */
    getIds(): AttrRange<Attrs>[];
}
/**
 * @template Attrs
 */
export class IdMap<Attrs> {
    /**
     * @type {Map<number,AttrRanges<Attrs>>}
     */
    clients: Map<number, AttrRanges<Attrs>>;
    /**
     * @type {Map<string, ContentAttribute<Attrs>>}
     */
    attrsH: Map<string, ContentAttribute<Attrs>>;
    /**
     * @type {Set<ContentAttribute<Attrs>>}
     */
    attrs: Set<ContentAttribute<Attrs>>;
    /**
     * @param {(attrRange:AttrRange<Attrs>, client:number) => void} f
     */
    forEach(f: (attrRange: AttrRange<Attrs>, client: number) => void): void;
    isEmpty(): boolean;
    /**
     * @param {ID} id
     * @return {boolean}
     */
    hasId(id: ID): boolean;
    /**
     * @param {number} client
     * @param {number} clock
     * @return {boolean}
     */
    has(client: number, clock: number): boolean;
    /**
     * Return attributions for a slice of ids.
     *
     * @param {ID} id
     * @param {number} len
     * @return {Array<MaybeAttrRange<Attrs>>}
     */
    sliceId(id: ID, len: number): Array<MaybeAttrRange<Attrs>>;
    /**
     * Return attributions for a slice of ids.
     *
     * @param {number} client
     * @param {number} clock
     * @param {number} len
     * @return {Array<MaybeAttrRange<Attrs>>}
     */
    slice(client: number, clock: number, len: number): Array<MaybeAttrRange<Attrs>>;
    /**
     * @param {number} client
     * @param {number} clock
     * @param {number} len
     * @param {Array<ContentAttribute<Attrs>>} attrs
     */
    add(client: number, clock: number, len: number, attrs: Array<ContentAttribute<Attrs>>): void;
    /**
     * @param {number} client
     * @param {number} clock
     * @param {number} len
     */
    delete(client: number, clock: number, len: number): void;
}
export function idmapAttrsEqual<T>(a: Array<T>, b: Array<T>): boolean;
export function mergeIdMaps<T>(ams: Array<IdMap<T>>): IdMap<T>;
export function createIdMapFromIdSet(idset: IdSet, attrs: Array<ContentAttribute<any>>): IdMap<any>;
export function createIdSetFromIdMap(idmap: IdMap<any>): IdSet;
export function writeIdMap<Attr>(encoder: IdSetEncoderV1 | IdSetEncoderV2, idmap: IdMap<Attr>): void;
export function encodeIdMap(idmap: IdMap<any>): Uint8Array<ArrayBuffer>;
export function readIdMap(decoder: IdSetDecoderV1 | IdSetDecoderV2): IdMap<any>;
export function decodeIdMap(data: Uint8Array): IdMap<any>;
export function createIdMap(): IdMap<any>;
export function diffIdMap<ISet extends IdMap<any>>(set: ISet, exclude: IdSet | IdMap<any>): ISet;
export function intersectMaps<SetA extends IdSet | IdMap<any>, SetB extends IdSet | IdMap<any>>(setA: SetA, setB: SetB): SetA extends IdMap<infer A> ? (SetB extends IdMap<infer B> ? IdMap<A | B> : IdMap<A>) : IdSet;
export function filterIdMap<Attrs>(idmap: IdMap<Attrs>, predicate: (attr: Array<ContentAttribute<Attrs>>) => boolean): IdMap<Attrs>;
export type MaybeAttrRange<Attrs> = {
    clock: number;
    len: number;
    attrs: Array<ContentAttribute<Attrs>> | null;
};
import * as traits from 'lib0/traits';
import { IdSetEncoderV2 } from './UpdateEncoder.js';
import { IdSetDecoderV2 } from './UpdateDecoder.js';
//# sourceMappingURL=ids.d.ts.map