@vidispine/vdt-js 23.1.0 → 23.2.0-pre.2

package/dist/index.d.ts

@@ -1,609 +1,409 @@
-import * as _vidispine_types from '@vidispine/types';
-import { KeyValuePairType, MetadataValueType, MetadataFieldValueType, MetadataGroupValueType, MetadataType, SimpleMetadataType, FacetType, SearchResultEntryTimespanType, AudioComponentType, BinaryComponentType, FileType, TimeCodeType, ContainerComponentType, TimeBaseType, VideoComponentType, ShapeType, ItemType, TranscodePresetType } from '@vidispine/types';
-
+import type { AudioComponentType } from '@vidispine/types';
+import type { BinaryComponentType } from '@vidispine/types';
+import type { ContainerComponentType } from '@vidispine/types';
+import type { FacetType } from '@vidispine/types';
+import type { FileType } from '@vidispine/types';
+import type { ItemType } from '@vidispine/types';
+import type { KeyValuePairType } from '@vidispine/types';
+import type { MetadataFieldType } from '@vidispine/types';
+import type { MetadataFieldValueType } from '@vidispine/types';
+import type { MetadataGroupValueType } from '@vidispine/types';
+import type { MetadataType } from '@vidispine/types';
+import type { MetadataValueType } from '@vidispine/types';
+import type { RationalType } from 'packages/types/dist';
+import type { SearchFacetType } from '@vidispine/types';
+import type { SearchResultEntryTimespanType } from '@vidispine/types';
+import type { ShapeType } from '@vidispine/types';
+import type { SimpleMetadataType } from '@vidispine/types';
+import type { TimeBaseType } from '@vidispine/types';
+import type { TimeCodeType } from '@vidispine/types';
+import type { TranscodePresetType } from '@vidispine/types';
+import type { VideoComponentType } from '@vidispine/types';
+
 /**
+ * Create a VidiCore metadata object from a more dense/simplified structure
  *
- * @param keyValuePairTypes
- * @returns
+ * @param input To create VidiCore metadata object of
+ * @returns A VidiCore metadata object
  *
- * @category Other
+ * @category Metadata
  */
-declare const parseKeyValuePairTypes: (keyValuePairTypes: KeyValuePairType[]) => {
-    [k: string]: string;
-};
-
+export declare const createMetadataType: (input: CreateMetadataTypeInput) => MetadataType;
+
+export declare type CreateMetadataTypeInput = InputTimespan | InputTimespan[];
+
 /**
- * Const object with VidiCore role names
+ * Create a Vidicore search facet list
  *
- * @category Auth
+ * @param input array of field names or actual search facet objects
+ * @param options Options for creating the facet
+ * @returns A VidiCore facet list
+ *
+ * @category Search
  */
-declare const ROLE_NAMES: {
-    readonly ACCESSCONTROL_READ: "_accesscontrol_read";
-    readonly ACCESSCONTROL_WRITE: "_accesscontrol_write";
-    readonly ADMINISTRATOR: "_administrator";
-    readonly AUTO_PROJECTION_READ: "_auto_projection_read";
-    readonly AUTO_PROJECTION_WRITE: "_auto_projection_write";
-    readonly COLLECTION_NOTIFICATION_READ: "_collection_notification_read";
-    readonly COLLECTION_NOTIFICATION_WRITE: "_collection_notification_write";
-    readonly COLLECTION_READ: "_collection_read";
-    readonly COLLECTION_WRITE: "_collection_write";
-    readonly CONFIGURATION_READ: "_configuration_read";
-    readonly DELETION_LOCK_NOTIFICATION_READ: "_deletion_lock_notification_read";
-    readonly DELETION_LOCK_NOTIFICATION_WRITE: "_deletion_lock_notification_write";
-    readonly DELETION_LOCK_READ: "_deletion_lock_read";
-    readonly DELETION_LOCK_WRITE: "_deletion_lock_write";
-    readonly DOCUMENT_NOTIFICATION_READ: "_document_notification_read";
-    readonly DOCUMENT_NOTIFICATION_WRITE: "_document_notification_write";
-    readonly DOCUMENT_READ: "_document_read";
-    readonly DOCUMENT_WRITE: "_document_write";
-    readonly ERROR_READ: "_error_read";
-    readonly ERROR_WRITE: "_error_write";
-    readonly EXPORT: "_export";
-    readonly EXPORT_TEMPLATE_READ: "_export_template_read";
-    readonly EXPORT_TEMPLATE_WRITE: "_export_template_write";
-    readonly EXTERNAL_ID_READ: "_external_id_read";
-    readonly EXTERNAL_ID_WRITE: "_external_id_write";
-    readonly FILE_NOTIFICATION_READ: "_file_notification_read";
-    readonly FILE_NOTIFICATION_WRITE: "_file_notification_write";
-    readonly FILE_READ: "_file_read";
-    readonly FILE_WRITE: "_file_write";
-    readonly GROUP_READ: "_group_read";
-    readonly GROUP_WRITE: "_group_write";
-    readonly IMPORT_WRITE: "_import";
-    readonly ITEM_ID_READ: "_item_id_read";
-    readonly ITEM_ID_WRITE: "_item_id_write";
-    readonly ITEM_NOTIFICATION_READ: "_item_notification_read";
-    readonly ITEM_NOTIFICATION_WRITE: "_item_notification_write";
-    readonly ITEM_WRITE: "_item_write";
-    readonly ITEM_SEARCH: "_item_search";
-    readonly ITEM_SHAPE_READ: "_item_shape_read";
-    readonly ITEM_SHAPE_WRITE: "_item_shape_write";
-    readonly ITEM_TIMELINE_READ: "_item_timeline_read";
-    readonly ITEM_TIMELINE_WRITE: "_item_timeline_write";
-    readonly ITEM_URI: "_item_uri";
-    readonly JOB_NOTIFICATION_READ: "_job_notification_read";
-    readonly JOB_NOTIFICATION_WRITE: "_job_notification_write";
-    readonly JOB_READ: "_job_read";
-    readonly JOB_WRITE: "_job_write";
-    readonly LIBRARY_READ: "_library_read";
-    readonly LIBRARY_WRITE: "_library_write";
-    readonly LOCK_READ: "_lock_read";
-    readonly LOCK_WRITE: "_lock_write";
-    readonly LOG_READ: "_log_read";
-    readonly METADATA_DATASET_READ: "_metadata_dataset_read";
-    readonly METADATA_DATASET_WRITE: "_metadata_dataset_write";
-    readonly METADATA_FIELD_GROUP_READ: "_metadata_field_group_read";
-    readonly METADATA_FIELD_GROUP_WRITE: "_metadata_field_group_write";
-    readonly METADATA_FIELD_READ: "_metadata_field_read";
-    readonly METADATA_FIELD_WRITE: "_metadata_field_write";
-    readonly METADATA_GLOBAL_READ: "_metadata_global_read";
-    readonly METADATA_GLOBAL_WRITE: "_metadata_global_write";
-    readonly METADATA_LOCK_READ: "_metadata_lock_read";
-    readonly METADATA_LOCK_WRITE: "_metadata_lock_write";
-    readonly METADATA_READ: "_metadata_read";
-    readonly METADATA_SCHEMA_READ: "_metadata_schema_read";
-    readonly METADATA_SCHEMA_WRITE: "_metadata_schema_write";
-    readonly METADATA_WRITE: "_metadata_write";
-    readonly OTIF_ANALYZE: "_otif_analyze";
-    readonly OTIF_READ: "_otif_read";
-    readonly OTIF_WRITE: "_otif_write";
-    readonly PLACEHOLDER_NOTIFICATION_READ: "_placeholder_notification_read";
-    readonly PLACEHOLDER_NOTIFICATION_WRITE: "_placeholder_notification_write";
-    readonly PROJECTION_READ: "_projection_read";
-    readonly PROJECTION_WRITE: "_projection_write";
-    readonly QUOTA_NOTIFICATION_READ: "_quota_notification_read";
-    readonly QUOTA_NOTIFICATION_WRITE: "_quota_notification_write";
-    readonly QUOTA_READ: "_quota_read";
-    readonly QUOTA_WRITE: "_quota_write";
-    readonly RELATION_READ: "_relation_read";
-    readonly RELATION_WRITE: "_relation_write";
-    readonly RESOURCE_READ: "_resource_read";
-    readonly RESOURCE_WRITE: "_resource_write";
-    readonly RUN_AS: "_run_as";
-    readonly SEARCH: "_search";
-    readonly SEQUENCE_READ: "_sequence_read";
-    readonly SEQUENCE_WRITE: "_sequence_write";
-    readonly SHAPE_TAG_READ: "_shape_tag_read";
-    readonly SHAPE_TAG_WRITE: "_shape_tag_write";
-    readonly SITE_MANAGER: "_site_manager";
-    readonly SITE_RULE_READ: "_site_rule_read";
-    readonly SITE_RULE_WRITE: "_site_rule_write";
-    readonly STORAGE_GROUP_READ: "_storage_group_read";
-    readonly STORAGE_GROUP_WRITE: "_storage_group_write";
-    readonly STORAGE_NOTIFICATION_READ: "_storage_notification_read";
-    readonly STORAGE_NOTIFICATION_WRITE: "_storage_notification_write";
-    readonly STORAGE_READ: "_storage_read";
-    readonly STORAGE_RULE_READ: "_storage_rule_read";
-    readonly STORAGE_RULE_WRITE: "_storage_rule_write";
-    readonly STORAGE_WRITE: "_storage_write";
-    readonly SUPER_ACCESS_USER: "_super_access_user";
-    readonly TASKDEFINITION_READ: "_taskdefinition_read";
-    readonly TASKDEFINITION_WRITE: "_taskdefinition_write";
-    readonly THUMBNAIL_READ: "_thumbnail_read";
-    readonly THUMBNAIL_WRITE: "_thumbnail_write";
-    readonly TRANSCODER: "_transcoder";
-    readonly TRANSFER_READ: "_transfer_read";
-    readonly TRANSFER_WRITE: "_transfer_write";
-    readonly USER: "_user";
-    readonly VXA: "_vxa";
-    readonly VXA_READ: "_vxa_read";
-};
-type RoleNameTypes = keyof typeof ROLE_NAMES;
-
-type InputValueTypes = string | boolean | number | Date;
-/** Possible input values for the field value */
-type InputValue = InputValueTypes | InputValueTypes[];
-/** Input value object for the field value */
-type InputValueObject = {
-    value: string | InputValue;
-} & Omit<MetadataValueType, 'value'>;
-type InputFieldValue = InputValueObject | InputValue | InputValueObject[] | InputValue[];
-/** Input object to create field of */
-type InputFieldObject = {
-    value: InputFieldValue;
-} & MetadataFieldValueType;
-/** Input to create a field of */
-type InputField = InputFieldValue | InputFieldObject;
-/** Input to create one or multiple groups and/or fields of */
-type InputGroupsOrFields = InputGroup | InputGroup[] | InputField | InputField[];
-/** Input object to create group of */
-type InputGroup = {
-    [groupOrFieldName: string]: InputGroupsOrFields;
-} & Partial<MetadataGroupValueType>;
-/** Input to create a timespan of */
-type InputTimespan = {
-    /** Start for timespan */
-    start?: string | number;
-    /** End for timespan */
-    end?: string | number;
-    /** Base for timespan (typically undefined) */
-    base?: string;
-    /** Group or field metadata */
-    [groupOrFieldName: string]: InputGroupsOrFields;
+export declare const createSearchFacetList: (input?: CreateSearchFacetListInput, options?: Partial<CreateSearchFacetListOptions>) => SearchFacetType[];
+
+export declare type CreateSearchFacetListInput = (string | SearchFacetType)[];
+
+export declare type CreateSearchFacetListOptions = {
+    count?: boolean;
+    exclude?: boolean;
 };
-type CreateMetadataTypeInput = InputTimespan | InputTimespan[];
+
 /**
- * Create a VidiCore metadata object from a more dense/simplified structure
+ * Create a TimeBase Instance from a number, string or object representation of a time base
  *
- * @param input To create VidiCore metadata object of
- * @returns A VidiCore metadata object
+ * @param timeBase Input to create time base from
+ * @returns A TimeBase instance
  *
- * @category Metadata
+ * @category Time
  */
-declare const createMetadataType: (input: CreateMetadataTypeInput) => MetadataType;
-
-type ParsedValueAttributes = Partial<Omit<MetadataValueType, 'value'>>;
-type ParsedValue<TOptions> = TOptions extends {
-    includeValueAttributes?: false;
-} ? string : {
-    value: string;
-} & ParsedValueAttributes;
-type ParseValueOptions = {
-    /** Include attributes on value (`true` for all) */
-    includeValueAttributes?: boolean | (keyof ParsedValueAttributes)[];
-};
-
-type ParsedValueList<TOptions> = TOptions extends {
-    joinValue?: string;
-    includeValueAttributes?: false;
-} ? string : TOptions extends {
-    arrayOnSingleValue?: true;
-} ? ParsedValue<TOptions>[] : ParsedValue<TOptions> | ParsedValue<TOptions>[];
-interface ParseValueListOptions extends ParseValueOptions {
-    /** String to join the values, (e.g. `,`) */
-    joinValue?: string;
-    /** Return values as array even if single value */
-    arrayOnSingleValue?: boolean;
-}
-
-type ParsedFieldAttributes = Partial<Omit<MetadataFieldValueType, 'value'>>;
-type ParsedFieldObject<TOptions> = {
-    value: ParsedValueList<TOptions>;
-} & ParsedFieldAttributes;
-type ParsedField<TOptions> = TOptions extends {
-    includeFieldAttributes?: false;
-} ? ParsedValueList<TOptions> : ParsedFieldObject<TOptions>;
-interface ParseFieldOptions extends ParseValueListOptions {
-    /** Include attributes on field (`true` for all) */
-    includeFieldAttributes?: boolean | (keyof ParsedFieldAttributes)[];
-}
-
-interface ParseFieldListOptions extends ParseFieldOptions {
-    /** Return fields as list */
-    fieldAsList?: boolean;
-    /** Return fields as array even if only one field */
-    arrayOnSingleField?: boolean;
-    /** Return all fields flattened (Note: keys might be overridden) */
-    overrideField?: boolean;
-}
-type ParsedFieldList<TOptions> = TOptions extends {
-    fieldAsList?: true;
-} ? ParsedField<TOptions>[] : TOptions extends {
-    arrayOnSingle?: true;
-    arrayOnSingleField?: undefined | true;
-} | {
-    arrayOnSingleField?: true;
-} ? {
-    [name: string]: ParsedField<TOptions>[];
-} : TOptions extends {
-    flat?: true;
-    overrideField?: true | undefined;
-} | {
-    overrideField?: true;
-} ? {
-    [name: string]: ParsedField<TOptions>;
-} : {
-    [name: string]: ParsedField<TOptions> | ParsedField<TOptions>[];
+export declare const createTimeBase: (timeBase: TimeBaseInput | string | number) => TimeBase;
+
+/**
+ * Create a TimeCode instance from smpte, seconds/samples, timeCode object or string
+ *
+ * @param timeCode Smpte, seconds/samples, timeCode object or string
+ * @param options For the format functions
+ * @returns A TimeCode instance
+ *
+ * @category Time
+ */
+export declare const createTimeCode: (timeCode: TimeCodeInput | string | number, options?: CreateTimeCodeOptions) => TimeCode;
+
+export declare type CreateTimeCodeOptions = TimeCodeInputOptions | FormatTimeCodeSmpteOptions | FormatTimeCodeSecondsOptions | FormatTimeCodeTextOptions;
+
+/**
+ * Const object with document types
+ *
+ * @category Shape
+ */
+export declare const DOCUMENT_TYPES: {
+    readonly PDF: "PDF";
+    readonly TEXT: "TEXT";
+    readonly MSWORD: "MSWORD";
+    readonly JSON: "JSON";
+    readonly XML: "XML";
 };
+
+declare type DocumentType_2 = keyof typeof DOCUMENT_TYPES;
+export { DocumentType_2 as DocumentType }
+
 /**
- * Parse a metadata field list according to selected options
+ * Array with all available metadata field attributes
+ *
+ * @category Metadata
+ */
+export declare const FIELD_ATTRIBUTE_KEYS: (keyof MetadataFieldValueType)[];
+
+/**
+ * Array with all VidiCore system field definition types
  *
  * @remarks
- * When parsing duplicate fields (same field name in the same field list) it will:
- * - with default options: combine field values to one array within the same field name key
- * - with `joinValue` enabled: join values within each field (returns array with string for each field value)
- * - with `fieldAsList` enabled: separate fields in the list/array (as usual, even if not duplicate)
- * - with `includeFieldAttributes` enabled: return an array of field objects
- * - with `overrideField` enabled: return the latest duplicated field it parses
+ * The `-noindex` and `-sortable` suffix for types has been replaced with boolean options in field definitions (since 4.1).
  *
- * @param fieldList Field list to parse
- * @param [options=defaultOptions] Options for how to parse the field list
- * @returns A parsed field list
+ * @category Field
+ */
+export declare const FIELD_DEFINITION_TYPES: readonly ["date", "float", "integer", "long", "string", "string-exact", "boolean", "timeCode"];
+
+/**
+ * Array with all available metadata field value attributes
  *
  * @category Metadata
  */
-declare const parseFieldList: <TOptions extends ParseFieldListOptions = ParseFieldListOptions>(fieldList: MetadataFieldValueType[], options?: TOptions) => ParsedFieldList<TOptions>;
-
-type ParsedGroupAttributes = Omit<MetadataGroupValueType, 'field' | 'group'>;
-interface ParseGroupOptions extends ParseFieldListOptions {
-    /** Include group attributes (`true` for all) */
-    includeGroupAttributes?: boolean | (keyof ParsedGroupAttributes)[];
-    /** Return groups as list */
-    groupAsList?: boolean;
-    /** Return groups as array even if only one group */
-    arrayOnSingleGroup?: boolean;
-    /** Return all groups flattened (Note: keys might be overridden) */
-    overrideGroup?: boolean;
-}
-type ParsedGroup<TOptions> = ((TOptions extends {
-    groupAsList?: true;
-} ? {
-    group?: ParsedGroupList<TOptions>;
-} : {
-    [name: string]: ParsedGroupList<TOptions>;
-}) & (TOptions extends {
-    fieldAsList?: true;
-} ? {
-    field?: ParsedFieldList<TOptions>;
-} : {
-    [name: string]: ParsedFieldList<TOptions>;
-})) & ParsedGroupAttributes;
-type ParseGroupListOptions = ParseGroupOptions;
-type ParsedGroupList<TOptions> = TOptions extends {
-    groupAsList?: true;
-} ? ParsedGroup<TOptions>[] : TOptions extends {
-    arrayOnSingle?: true;
-    arrayOnSingleGroup?: true | undefined;
-} | {
-    arrayOnSingleGroup?: true;
-} ? {
-    [groupName: string]: ParsedGroup<TOptions>[];
-} : TOptions extends {
-    flat?: true;
-    overrideGroup?: true | undefined;
-} | {
-    overrideGroup?: true;
-} ? {
-    [groupName: string]: ParsedGroup<TOptions>;
-} : {
-    [groupName: string]: ParsedGroup<TOptions> | ParsedGroup<TOptions>[];
-};
+export declare const FIELD_VALUE_ATTRIBUTE_KEYS: (keyof MetadataValueType)[];
+
 /**
- * Parse a metadata group list according to selected options
+ * Const object with all file states in VidiCore
+ * (see https://apidoc.vidispine.com/latest/storage/storage.html#file-states for more info)
  *
- * @remarks
- * Parsing duplicate groups (same group name in the same group list) it will:
- * - with default options: combine group objects to one array within the same group name key
- * - with `groupAsList` enabled: return separate group objects in a list/array (as usual, even if not duplicate)
- * - with `overrideGroup` enabled: return the latest duplicated group it parses
+ * @category File
+ */
+export declare const FILE_STATES: {
+    /** Just created, not used. */
+    readonly NONE: "NONE";
+    /** Discovered or created, not yet marked as finished. */
+    readonly OPEN: "OPEN";
+    /** File does no longer grow. */
+    readonly CLOSED: "CLOSED";
+    /** The current state is not known. */
+    readonly UNKNOWN: "UNKNOWN";
+    /** File is missing from the file system/storage. */
+    readonly MISSING: "MISSING";
+    /** File has been missing for a longer period. Candidate for restoration from archive. */
+    readonly LOST: "LOST";
+    /** File will appear on file system/storage, transfer subsystem or transcoder will create it. */
+    readonly TO_APPEAR: "TO_APPEAR";
+    /** The file is no longer in use, and will be deleted at the next clean-up sweep. */
+    readonly TO_BE_DELETED: "TO_BE_DELETED";
+    /** File is in use by transfer subsystem or transcoder. */
+    readonly BEING_READ: "BEING_READ";
+    /** File is archived. */
+    readonly ARCHIVED: "ARCHIVED";
+    /** File will be synchronized by multi-site agent. */
+    readonly AWAITING_SYNC: "AWAITING_SYNC";
+};
+
+export declare type FileStateTypes = keyof typeof FILE_STATES;
+
+export declare type FilteredShapeListObject = {
+    src: string;
+    type: string;
+    shape: ShapeType;
+    parsedShape: ParsedShapeType;
+    [key: string]: string | ParsedShapeType | ShapeType;
+};
+
+/**
+ * Filter a shape type list to get shapes that are playable in a browser
  *
- * @param groupList Group list to parse
- * @param options options for how to parse list
- * @returns A parsed group list
+ * @param itemType
+ * @param options
+ * @returns
  *
- * @category Metadata
+ * @category Shape
  */
-declare const parseGroupList: <TOptions extends ParseGroupOptions = ParseGroupOptions>(groupList: MetadataGroupValueType[], options?: TOptions) => ParsedGroupList<TOptions>;
-
-type ParsedTimespanAttributes = Omit<MetadataType['timespan'][number], 'field' | 'group'>;
-interface ParseTimespanOptions extends ParseGroupListOptions {
-    /** Include attributes on timespan (`true` for all) */
-    includeTimespanAttributes?: boolean | (keyof ParsedTimespanAttributes)[];
-    /** Return groups, fields, and values as array */
-    arrayOnSingle?: boolean;
-    /** Flatten timespan, groups and fields (Note: keys might be overridden) */
-    flat?: boolean;
-}
-type ParsedTimespan<TOptions> = ((TOptions extends {
-    groupAsList?: true;
-} ? {
-    group?: ParsedGroupList<TOptions>;
-} : {
-    [name: string]: ParsedGroupList<TOptions>;
-}) & (TOptions extends {
-    fieldAsList?: true;
-} ? {
-    field?: ParsedFieldList<TOptions>;
-} : {
-    [name: string]: ParsedFieldList<TOptions>;
-})) & ParsedTimespanAttributes;
+export declare const filterShapeSource: (itemType: ItemType, options?: FilterShapeSourceOption) => FilteredShapeListObject[];
+
+export declare type FilterShapeSourceOption = {
+    sortPriority?: Function;
+    allowedMimeTypes?: string[];
+    allowedMethods?: string[];
+    sourceKey?: string;
+    mimeTypeKey?: string;
+    shapeKey?: string;
+    parsedShapeKey?: string;
+};
+
 /**
- *
- * Parses timespan according to specified options
+ * Find the thumbnail uri in a VidiCore item object that's nearest a timeCode
  *
  * @remarks
- * To ensure a flat (no array) representation when using `flat: true`, the parser will also set `overrideGroup` and `overrideField` to true (unless those are explicitly set false)
- *
- * @param timespan - A VidiCore metadata timespan
- * @param options - Options to change how it is parsed
- * @returns Timespan parsed according to options
+ * Time code is included in path of VidiCore thumbnail uris
  *
- * @see {@link parseGroupList} and {@link parseFieldList} for more info
+ * @param itemType A VidiCore item object
+ * @param timeCode A timeCode to find nearest thumbnail to
+ * @returns A URI of a thumbnail, `undefined` if item has no thumbnails
  *
- * @category Metadata
+ * @category Thumbnail
  */
-declare const parseTimespan: <TOptions extends ParseTimespanOptions = ParseTimespanOptions>(timespan: MetadataType['timespan'][number], options?: TOptions) => ParsedTimespan<TOptions>;
-
-type ParsedTimespanList<TOptions> = TOptions extends {
-    timespanAsList?: true;
-} ? ParsedTimespan<TOptions>[] : TOptions extends {
-    flat?: true;
-    onlyGeneric?: true | undefined;
-} | {
-    onlyGeneric?: true;
-} ? ParsedTimespan<TOptions> : {
-    [timespanKey: string]: ParsedTimespan<TOptions>[];
-};
-interface ParseTimespanListOptions extends ParseTimespanOptions {
-    /** Return timespans as list */
-    timespanAsList?: boolean;
-    /** String to join timespans with (defaults to '_') */
-    joinTimespan?: string;
-    /** Sort timespanList by ascending start then end time */
-    sortTimespan?: boolean;
-    /** Return a flat representation - only one timespan with groups/fields named the same as single - of the timespan list (Note: timespans/fields/groups can be overridden) */
-    flat?: boolean;
-    /** Flatten timespans to one object with generic timespan having highest priority (Note: fields/groups might be overridden) */
-    flatTimespan?: boolean;
-}
+export declare const findNearestThumbnail: (itemType: ItemType, timeCode: TimeCode | TimeCodeInput) => string;
+
 /**
- * Parses timespanList according to specified options.
- * The attributes can be targeted for each sub-type.
+ * Format a string representation of a time base to a TimeBase Instance
  *
- * @param timespanList - A Vidicore metadata timespan list
- * @param options - Options which change how the metadataType is parsed.
- * @returns Timespan list parsed according to options
+ * @param timeBaseText The string to format to a TimeBase instance
+ * @returns A TimeBase Instance
  *
- * @see {@link parseTimespan} for more info
+ * @category Time
+ */
+export declare const formatTimeBaseText: (timeBaseText?: string | number) => TimeBase;
+
+/**
+ * Create a TimeBase instance of an object
  *
- * @category Metadata
+ * @param timeBase A TimeBase object
+ * @returns A TimeBase instance
+ *
+ * @category Time
  */
-declare const parseTimespanList: <TOptions extends ParseTimespanListOptions = ParseTimespanListOptions>(timespanList: MetadataType['timespan'], options?: TOptions) => ParsedTimespanList<TOptions>;
-
-type ParsedMetadataAttributes = Partial<Omit<MetadataType, 'timespan' | 'revision'> & {
-    revision?: string[];
-}>;
-type ParsedMetadataType<TOptions> = (TOptions extends {
-    timespanAsList?: true;
-} ? {
-    timespan: ParsedTimespanList<TOptions>;
-} : TOptions extends {
-    flat?: true;
-} ? ParsedTimespanList<TOptions> : {
-    [timespanKey: string]: ParsedTimespanList<TOptions>;
-}) & (TOptions extends {
-    includeMetadataAttributes?: true | string[];
-} ? ParsedMetadataAttributes : {});
-interface ParseMetadataTypeOptions extends ParseTimespanListOptions {
-    /** Include metadata attributes (`true` for all) */
-    includeMetadataAttributes?: boolean | (keyof ParsedMetadataAttributes)[];
-    /** Flatten timespans, groups and fields (Note: keys might be overridden) */
-    flat?: boolean;
-}
+export declare const formatTimeBaseType: (timeBase: TimeBaseInput) => TimeBase;
+
 /**
- * Parses MetadataType according to specified options
+ * Format seconds to TimeCode object
  *
  * @remarks
- * Be aware that you need to take into account that the returned groups and fields can be an array if it has multiple values or groups/fields with same name.
- * If you are certain your metadata type won't return multiple groups/fields/values with same name or don't mind that they _might_ be overridden:
- * you can use the option `flat` along with `joinValue` or `arrayOnSingleValue: false`.
+ * Input time base is always considered as 1:1 since it expects seconds as input
  *
- * @param metadataType - A MetadataType from VidiCore
- * @param options - Options which change how the metadataType is parsed
- * @returns Metadata object parsed according to options
+ * Note: Max 15 digits accuracy (double precision float64), e.g.
+ * - 10^6 seconds can have 10^9 decimals (nanosecond) precision
+ * - 10^9 seconds can have 10^6 decimals (microsecond) precision
+ * - 10^12 seconds can have 10^3 decimals (millisecond) precision
  *
- * @see {@link parseTimespanList} for more info
+ * @param seconds With or without decimals ("." and "," are both interpreted as decimal)
+ * @param options Options for how to format the seconds to a TimeCode
+ * @returns A TimeCode instance
  *
- * @category Metadata
+ * @category Time
  */
-declare function parseMetadataType<TOptions extends ParseMetadataTypeOptions = ParseMetadataTypeOptions>(metadataType: MetadataType, options?: TOptions): ParsedMetadataType<TOptions>;
-
+export declare const formatTimeCodeSeconds: (seconds: string | number, options?: FormatTimeCodeSecondsOptions) => TimeCode;
+
+export declare interface FormatTimeCodeSecondsOptions extends TimeCodeInputOptions {
+    /**
+     * The TimeBase the output TimeCode should have
+     *
+     * Note: if unset and useGCD=false, denominator will be 10^(amount-of-decimals)
+     */
+    timeBase?: number | string | TimeBaseInput;
+    /**
+     * Samples and denominator are divided with GCD
+     *
+     * e.g. `1.04 => 104@100 => 26@25` (if no explicit `timeBase` is set)
+     */
+    useGCD?: boolean;
+}
+
 /**
- * Parse simple (key/value) metadata
+ * Format smpte text to a TimeCode Instance
  *
- * Not indexed metadata, available on almost all entities (storages, library, user, group, etc...)
+ * Options for `exceedingMode`:
+ * - `add` will be overflow to higher unit (e.g. PAL and 00:00:00:25 => 00:00:01:00)
+ * - `ignore` will be truncated (e.g. PAL and 00:00:00:25 => 00:00:00:24)
+ * - `error` will throw error (e.g. PAL and 00:00:00:25 => Error)
  *
- * @param simpleMetadataType A VidiCore simple metadata object
- * @returns A parsed simple metadata object
+ * @param smpte String representation of smpte
+ * @param options Options for creating the time code from smpte
+ * @returns TimeCode instance created from smpte string
  *
- * @category Metadata
+ * @category Time
  */
-declare const parseSimpleMetadataType: (simpleMetadataType: SimpleMetadataType) => {
-    [key: string]: string;
-};
-
-type MetadataTypeToWebVttOptions = {
-    /** Name of group containing subtitle field/text */
-    subtitleGroup?: string;
-    /** Name of field (text) to use for the subtitles */
-    subtitleField?: string;
-};
+export declare const formatTimeCodeSmpte: (smpte: string, options?: FormatTimeCodeSmpteOptions) => TimeCode;
+
+export declare interface FormatTimeCodeSmpteOptions extends TimeCodeInputOptions {
+    /** TimeBase of smpte (and consequently TimeBase of output TimeCode) */
+    timeBase?: number | string | TimeBaseInput;
+    /** How to handle exceeding values (default `error`) */
+    exceedingMode?: 'add' | 'ignore' | 'error';
+}
+
 /**
- * Convert metadata subtitle groups to WebVtt subtitles
+ * Format text to a TimeCode instance
  *
- * @param metadataType - Vidicore metadata object (should include subtitleGroup and subtitleField)
- * @param options - options for how to map subtitle group
- * @returns WebVtt subtitles
+ * @returns A TimeCode instance
  *
- * @category Metadata
+ * @category Time
  */
-declare const metadataTypeToWebVtt: (metadataType: MetadataType, options?: MetadataTypeToWebVttOptions) => string;
-
+export declare const formatTimeCodeText: (timeCodeText?: number | string, options?: FormatTimeCodeTextOptions) => TimeCode;
+
+export declare interface FormatTimeCodeTextOptions extends TimeCodeInputOptions {
+    /** The time base the returned TimeCode should have */
+    timeBase?: number | string | TimeBaseInput;
+}
+
 /**
- * Array with all available VidiCore system/default field group names
+ * Format an object to a TimeCode instance
  *
- * @category Metadata
+ * @param timeCode To create TimeCode instance of
+ * @param options For the TimeCode constructor
+ * @returns  A TimeCode instance
+ *
+ * @category Time
  */
-declare const SYSTEM_FIELDGROUPS: readonly ["stl_subtitle", "stl_tti", "stl_gsi", "mrk_marker", "pho_validation", "pho_resource", "pho_error", "facedetect_rect", "facedetect_face", "originalTrackFilename", "stl_gsiHeader"];
-
+export declare const formatTimeCodeType: (timeCode: TimeCodeInput, options?: TimeCodeInputOptions) => TimeCode;
+
 /**
- * Array with all available VidiCore system/default field names (including transient)
+ * Return a const for the document type of a shape (looks at mimeType)
  *
- * @category Metadata
+ * @param shape A VidiCore shape
+ * @returns The document type for a shape
+ *
+ * @category Shape
  */
-declare const SYSTEM_FIELDS: readonly ["title", "user", "shapeTag", "representativeThumbnail", "representativeThumbnailNoAuth", "representativeItems", "itemId", "collectionId", "mediaType", "mimeType", "created", "startTimeCode", "startSeconds", "fieldValidationError", "schemaValidationError", "originalFilename", "originalUri", "originalAudioCodec", "originalVideoCodec", "originalHeight", "originalWidth", "originalFormat", "durationSeconds", "durationTimeCode", "solr-index", "__user", "__collection", "__collection_size", "__ancestor_collection", "__ancestor_collection_size", "__shape", "__shape_size", "__shape_last_added", "__placeholder_shape_size", "__version", "__version_count", "__storage", "__storage_size", "__shapetag_{tag}_hash_{hash}", "__storage_{tag}", "__storage_{tag}_size", "__storagegroup", "__storagegroup_size", "__sequence", "__sequence_size", "__metadata_last_modified", "__external_id", "__deletion_lock_id", "__deletion_lock_expiry", "__child_collection", "__child_collection_size", "__parent_collection", "__parent_collection_size", "__items_size", "stl_text", "stl_justification", "stl_xrelative", "stl_yrelative", "stl_vertical", "stl_verticalbase", "stl_horizontalbase", "stl_sizerelative", "stl_color", "stl_outline", "stl_outlinecolor", "stl_outlinesize", "stl_font", "stl_service", "stl_tti", "stl_gsi", "cct", "tcd", "tcf", "oet", "cd", "mnc", "cpn", "dfc", "tcp", "tcs", "tet", "tnb", "tnd", "en", "co", "tng", "rd", "mnr", "dsc", "opt", "lc", "tpt", "tn", "slr", "tns", "rn", "pub", "dsn", "ecd", "mrk_zerolength", "mrk_text", "mrk_color", "pho_resource_name", "pho_error_level", "pho_error_code", "pho_error_description", "facedetect_rect_width", "facedetect_rect_height", "facedetect_rect_y", "facedetect_rect_x", "facedetect_pid", "facedetect_rect", "trackId", "eidr_actor", "eidr_alternateId", "eidr_countryOfOrigin", "eidr_director", "eidr_id", "eidr_referentType", "eidr_releaseDate", "eidr_resourceName", "eidr_status", "eidr_sync", "ttml_div", "ttml_root", "vxa_collection_id", "vxaId", "vxaLocalPath", "tco", "cs", "ebn", "tf", "cf", "sgn", "tci", "jc", "vp", "sn"];
-
+export declare const getShapeDocumentType: (shape?: ShapeType) => DocumentType_2;
+
 /**
- * Array with all available metadata field value attributes
+ * Returns a const for which media type a shape has
  *
- * @category Metadata
+ * @param shape
+ * @returns
+ *
+ * @category Shape
  */
-declare const FIELD_VALUE_ATTRIBUTE_KEYS: (keyof MetadataValueType)[];
-
+export declare const getShapeMediaType: (shape: ShapeType) => ShapeMediaType;
+
 /**
- * Array with all available metadata field attributes
+ * Array with all available metadata group attributes
  *
  * @category Metadata
  */
-declare const FIELD_ATTRIBUTE_KEYS: (keyof MetadataFieldValueType)[];
-
-/**
- * Array with all available metadata group attributes
- *
- * @category Metadata
- */
-declare const GROUP_ATTRIBUTE_KEYS: (keyof MetadataGroupValueType)[];
-
-type CreateFacetTypeFieldList = string[];
-type CreateFacetTypeOptions = {
-    count: boolean;
-};
-/**
- * Create a Vidicore facet list
- *
- * @param fieldList Input to create facet of
- * @param options Options for creating the facet
- * @returns A VidiCore facet list
- *
- * @category Search
- */
-declare const createFacetType: (fieldList?: CreateFacetTypeFieldList, options?: Partial<CreateFacetTypeOptions>) => {
-    field: string;
-    name: string;
-    count: boolean;
-    exclude: CreateFacetTypeFieldList;
-}[];
-
-type ParsedFacetTypeCount = {
-    [fieldValue: string]: number;
-};
-/** Parsed facet type */
-type ParsedFacetType = {
-    [fieldName: string]: ParsedFacetTypeCount;
+export declare const GROUP_ATTRIBUTE_KEYS: (keyof MetadataGroupValueType)[];
+
+/** Input to create a field of */
+export declare type InputField = InputFieldValue | InputFieldObject;
+
+/** Input object to create field of */
+export declare type InputFieldObject = {
+    value: InputFieldValue;
+} & MetadataFieldValueType;
+
+export declare type InputFieldValue = InputValueObject | InputValue | InputValueObject[] | InputValue[];
+
+/** Input object to create group of */
+export declare type InputGroup = {
+    [groupOrFieldName: string]: InputGroupsOrFields;
+} & Partial<MetadataGroupValueType>;
+
+/** Input to create one or multiple groups and/or fields of */
+export declare type InputGroupsOrFields = InputGroup | InputGroup[] | InputField | InputField[];
+
+/** Input to create a timespan of */
+export declare type InputTimespan = {
+    /** Start for timespan */
+    start?: string | number;
+    /** End for timespan */
+    end?: string | number;
+    /** Base for timespan (typically undefined) */
+    base?: string;
+    /** Group or field metadata */
+    [groupOrFieldName: string]: InputGroupsOrFields;
 };
+
+/** Possible input values for the field value */
+export declare type InputValue = InputValueTypes | InputValueTypes[];
+
+/** Input value object for the field value */
+export declare type InputValueObject = {
+    value: string | InputValue;
+} & Omit<MetadataValueType, 'value'>;
+
+export declare type InputValueTypes = string | boolean | number | Date;
+
 /**
- * Parse a VidiCore facet type list
+ * Convert metadata subtitle groups to WebVtt subtitles
  *
- * @param facetType A facet type list to parse
- * @returns A parsed facet type list
+ * @param metadataType - Vidicore metadata object (should include subtitleGroup and subtitleField)
+ * @param options - options for how to map subtitle group
+ * @returns WebVtt subtitles
  *
- * @category Search
+ * @category Metadata
  */
-declare const parseFacetType: (facetType?: FacetType[]) => ParsedFacetType;
-
-type ParseHighlightTimespanOptions = {
-    /** Return an array if there is a single value */
-    arrayOnSingle?: boolean;
-    /** Return timespans as list */
-    timespanAsList?: boolean;
-    /** String to join the values (e.g. `,`) */
-    joinValue?: string;
-};
-type ParsedHighlightTimespan = {
-    start?: string;
-    end?: string;
-    [key: string]: string | string[];
+export declare const metadataTypeToWebVtt: (metadataType: MetadataType, options?: MetadataTypeToWebVttOptions) => string;
+
+export declare type MetadataTypeToWebVttOptions = {
+    /** Name of group containing subtitle field/text */
+    subtitleGroup?: string;
+    /** Name of field (text) to use for the subtitles */
+    subtitleField?: string;
 };
+
 /**
- * Parses highlight timespan in VidiCore into key/value object.
- * The attributes can be targeted for each sub-type.
- * @param timespan - A VidiCore search timespan
- * @param options - Options which change how the timespans are parsed
+ * Parses the technical information of a AudioComponentType.
+ * @param audioComponentType - A AudioComponentType from VidiCore.
+ * @returns Parsed component object.
  *
- * @category Search
+ * @category Shape
  */
-declare const parseHighlightTimespan: (timespan: SearchResultEntryTimespanType, options: ParseHighlightTimespanOptions) => ParsedHighlightTimespan;
-
-interface ParseHighlightTimespanListOptions extends ParseHighlightTimespanOptions {
-    /** Return parsed timespan as list (in an array) */
-    timespanAsList?: boolean;
-    /** Character to join the start/end time codes with */
-    joinTimespan?: string;
-    /** Flatten to field-name/field-value (Note: field-values may be overwritten) */
-    flat?: boolean;
-    /** Flatten timespan to object with start/end as key */
-    flatTimespan?: boolean;
-}
+export declare const parseAudioComponent: (audioComponentType: AudioComponentType) => ParsedAudioComponentType;
+
 /**
- * Parses highlight timespans from VidiCore into key/value object.
- * The attributes can be targeted for each sub-type.
- *
- * @param highlightTimespanList - A list of timespans from VidiCore.
- * @param options - Options to change how the timespans are parsed
+ * Parses the technical information of a BinaryComponentType.
+ * @param binaryComponentType - A BinaryComponentType from VidiCore.
+ * @returns Parsed component object.
  *
- * @category Search
+ * @category Shape
  */
-declare const parseHighlightTimespanList: (highlightTimespanList?: SearchResultEntryTimespanType[], options?: ParseHighlightTimespanListOptions) => ParsedHighlightTimespan | ParsedHighlightTimespan[];
-
+export declare const parseBinaryComponent: (binaryComponentType?: BinaryComponentType) => ParsedBinaryComponentType;
+
 /**
- * Parse Vidicore "NOW" constants to a date object
- *
- * Format: `NOW[+/-][number][HOUR/DAY/MONTH/YEAR(s)]` (e.g. "NOW-2HOURS")
- *
- * @remarks
- * Returns an approximate date since it's created client side
- *
- * @param value A "NOW" constant
- * @returns A date from the NOW constant
+ * Parses the technical information of a ContainerComponentType.
+ * @param containerComponentType - A ContainerComponentType from VidiCore.
+ * @returns Parsed component object.
  *
- * @category Search
+ * @category Shape
  */
-declare const parseNowDate: (value?: string) => Date;
-
-type ParsedBaseMediaInfoType = {
-    Bit_rate_mode?: string;
-    Source?: string;
-} & {
-    [key: string]: string;
-};
-type ParsedAudioMediaInfoType = ParsedBaseMediaInfoType;
-type ParsedBinaryMediaInfoType = ParsedBaseMediaInfoType;
-type ParsedVideoMediaInfoType = ParsedBaseMediaInfoType & {
-    Format_Settings_GOP?: string;
-    intra_dc_precision?: string;
-};
-
-type ParsedAudioComponentType = {
+export declare const parseContainerComponent: (containerComponentType?: ContainerComponentType) => ParsedContainerComponentType;
+
+export declare type ParsedAudioComponentType = {
     audioFormat?: string;
     audioCodec?: string;
     audioSamplerate?: string;
@@ -618,56 +418,29 @@ type ParsedAudioComponentType = {
     };
     audioMediaInfo?: ParsedAudioMediaInfoType;
 };
-/**
- * Parses the technical information of a AudioComponentType.
- * @param audioComponentType - A AudioComponentType from VidiCore.
- * @returns Parsed component object.
- *
- * @category Shape
- */
-declare const parseAudioComponent: (audioComponentType: AudioComponentType) => ParsedAudioComponentType;
-
-type ParsedBinaryComponentType = {
+
+export declare type ParsedAudioMediaInfoType = ParsedBaseMediaInfoType;
+
+export declare type ParsedBaseMediaInfoType = {
+    Bit_rate_mode?: string;
+    Source?: string;
+} & {
+    [key: string]: string;
+};
+
+export declare type ParsedBinaryComponentType = {
     binaryMetadata?: {
         [key: string]: string;
     };
     binaryMediaInfo?: ParsedBinaryMediaInfoType;
 };
-/**
- * Parses the technical information of a BinaryComponentType.
- * @param binaryComponentType - A BinaryComponentType from VidiCore.
- * @returns Parsed component object.
- *
- * @category Shape
- */
-declare const parseBinaryComponent: (binaryComponentType?: BinaryComponentType) => ParsedBinaryComponentType;
-
-type ParsedFileType = {
-    uri?: string;
-    hash?: string;
-    fileSize?: string;
-    fileSizeBytes?: number;
-    path?: string;
-    fileName?: string;
-    fileId?: string;
-};
-/**
- * Parses a VidiCore file object
- *
- * @remarks
- * File sizes are parsed with JEDEC standard (base 2)
- *
- * @param fileType VidiCore file object
- * @returns A parsed file object
- *
- * @category File
- */
-declare const parseFileType: (fileType: FileType) => ParsedFileType;
-
+
+export declare type ParsedBinaryMediaInfoType = ParsedBaseMediaInfoType;
+
 /**
  * Parsed container component
  */
-type ParsedContainerComponentType = {
+export declare type ParsedContainerComponentType = {
     containerFormat?: string;
     videoFormat?: string;
     audioFormat?: string;
@@ -682,617 +455,566 @@ type ParsedContainerComponentType = {
     };
     containerMediaInfo?: ParsedBaseMediaInfoType;
 } & ParsedFileType;
-/**
- * Parses the technical information of a ContainerComponentType.
- * @param containerComponentType - A ContainerComponentType from VidiCore.
- * @returns Parsed component object.
- *
- * @category Shape
- */
-declare const parseContainerComponent: (containerComponentType?: ContainerComponentType) => ParsedContainerComponentType;
-
-type TimeBaseInput = {
-    /** The numerator for the TimeBase */
-    numerator?: number | string;
-    /** The denominator for the TimeBase */
-    denominator?: number | string;
+
+export declare type ParsedFacetList = {
+    facetName?: string;
+    fieldName?: string;
+    count?: {
+        [fieldValue: string]: number;
+    };
+    range?: {
+        start: number | string;
+        end: number | string;
+        count: number;
+    }[];
+}[];
+
+/** Parsed facet type */
+export declare type ParsedFacetType = {
+    [fieldName: string]: ParsedFacetTypeCount;
+};
+
+export declare type ParsedFacetTypeCount = {
+    [fieldValue: string]: number;
+};
+
+export declare type ParsedField<TOptions> = TOptions extends {
+    includeFieldAttributes?: false;
+} ? ParsedValueList<TOptions> : ParsedFieldObject<TOptions>;
+
+export declare type ParsedFieldAttributes = Partial<Omit<MetadataFieldValueType, 'value'>>;
+
+declare type ParsedFieldDefinition = {
+    name?: string;
+    type?: string;
+    defaultValue?: string;
+    restrictions?: {
+        min?: number;
+        max?: number;
+        minLength?: number;
+        maxLength?: number;
+        pattern?: RegExp;
+    };
+    required?: boolean;
+    data?: {
+        [key: string]: string;
+    };
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+};
+
+export declare type ParsedFieldDefinitionList = ParsedFieldDefinition[];
+
+export declare type ParsedFieldList<TOptions> = TOptions extends {
+    fieldAsList?: true;
+} ? ParsedField<TOptions>[] : TOptions extends {
+    arrayOnSingle?: true;
+    arrayOnSingleField?: undefined | true;
+} | {
+    arrayOnSingleField?: true;
+} ? {
+    [name: string]: ParsedField<TOptions>[];
+} : TOptions extends {
+    flat?: true;
+    overrideField?: true | undefined;
+} | {
+    overrideField?: true;
+} ? {
+    [name: string]: ParsedField<TOptions>;
+} : {
+    [name: string]: ParsedField<TOptions> | ParsedField<TOptions>[];
+};
+
+export declare type ParsedFieldObject<TOptions> = {
+    value: ParsedValueList<TOptions>;
+} & ParsedFieldAttributes;
+
+export declare type ParsedFileType = {
+    uri?: string;
+    hash?: string;
+    fileSize?: string;
+    fileSizeBytes?: number;
+    path?: string;
+    fileName?: string;
+    fileId?: string;
+    storageId?: string;
+    folderPath?: string;
+};
+
+export declare type ParsedGroup<TOptions> = ((TOptions extends {
+    groupAsList?: true;
+} ? {
+    group?: ParsedGroupList<TOptions>;
+} : {
+    [name: string]: ParsedGroupList<TOptions>;
+}) & (TOptions extends {
+    fieldAsList?: true;
+} ? {
+    field?: ParsedFieldList<TOptions>;
+} : {
+    [name: string]: ParsedFieldList<TOptions>;
+})) & ParsedGroupAttributes;
+
+export declare type ParsedGroupAttributes = Omit<MetadataGroupValueType, 'field' | 'group'>;
+
+export declare type ParsedGroupList<TOptions> = TOptions extends {
+    groupAsList?: true;
+} ? ParsedGroup<TOptions>[] : TOptions extends {
+    arrayOnSingle?: true;
+    arrayOnSingleGroup?: true | undefined;
+} | {
+    arrayOnSingleGroup?: true;
+} ? {
+    [groupName: string]: ParsedGroup<TOptions>[];
+} : TOptions extends {
+    flat?: true;
+    overrideGroup?: true | undefined;
+} | {
+    overrideGroup?: true;
+} ? {
+    [groupName: string]: ParsedGroup<TOptions>;
+} : {
+    [groupName: string]: ParsedGroup<TOptions> | ParsedGroup<TOptions>[];
+};
+
+export declare type ParsedHighlightTimespan = {
+    start?: string;
+    end?: string;
+    [key: string]: string | string[];
 };
+
 /**
- * TimeBase class representing the TimeBaseType in VidiCore
- *
- * For more info, see the [Time bases section in VidiCore API Docs](https://apidoc.vidispine.com/latest/time.html#time-bases)
- *
- * @category Time
+ * TODO
  */
-declare class TimeBase {
-    /** The numerator for the TimeBase */
-    numerator: number;
-    /** The denominator for the TimeBase */
-    denominator: number;
-    /**
-     * Constructor for TimeBase
-     *
-     * @param timeBaseType A TimeBaseType object
-     */
-    constructor(timeBaseType?: TimeBaseInput);
-    /**
-     * Get TimeBase in a constant representation (e.g. "PAL") if possible, otherwise undefined
-     * @returns Constant representation of the TimeBase
-     */
-    toConstant(): string;
-    /**
-     * Get TimeBase as a VidiCore TimeBaseType string
-     *
-     * @remarks
-     * Default format: denominator(:numerator if > 1)
-     *
-     * `constant` has precedence over `fraction` if both are true (e.g. NTSC > 30000:1001)
-     *
-     * @param options For how to display it as text
-     * @returns Text representation of the TimeBase
-     */
-    toText(options?: {
-        /** Show time base as constant (e.g. PAL) */
-        constant?: boolean;
-        /** Show time base as fraction (25:1) even when numerator is 1 */
-        fraction?: boolean;
-    }): string;
-    /**
-     * Output TimeBase as frame rate (by default max 16 decimal places)
-     *
-     * @remarks
-     * Default format: rate with two decimals if needed (i.e. decimals are > 0)
-     *
-     * `rounded` has precedence over `fixed`
-     *
-     * @param options On how to return the rate
-     *
-     * @return Rate of the TimeBase
-     */
-    toRate(options?: {
-        /** Rounded to nearest integer */
-        rounded?: boolean;
-        /** Amount of decimal places
-         * - `true` two decimal places
-         * - `false` max amount of decimal places
-         * - `number` that amount of decimal places
-         */
-        fixed?: boolean | number;
-    }): number;
-    /**
-     * Get TimeBase in a object representation
-     *
-     * @returns TimeBase as `{denominator, numerator}` object
-     */
-    toObject(): TimeBaseType;
-    /**
-     * @deprecated Use {@link TimeBase#toObject | toObject} instead
-     *
-     * @returns TimeBase as `{denominator, numerator}` object
-     */
-    toJson(): TimeBaseType;
-}
-
+export declare type ParsedMediaConvertTranscodePreset = {
+    description?: string;
+    containerFormat?: any;
+    videoFormat?: string;
+    height?: number;
+    width?: number;
+    dimension?: string;
+    aspectRatio?: string;
+    fieldOrder?: string;
+    videoBitrate?: number;
+    timeBase?: TimeBase;
+    frameRate?: string | number;
+    audioFormat?: string;
+    audioSamplerate?: string;
+    audioBitrate?: string;
+    audioBitRateMode?: string;
+};
+
+export declare type ParsedMetadataAttributes = Partial<Omit<MetadataType, 'timespan' | 'revision'> & {
+    revision?: string[];
+}>;
+
+export declare type ParsedMetadataType<TOptions> = (TOptions extends {
+    timespanAsList?: true;
+} ? {
+    timespan: ParsedTimespanList<TOptions>;
+} : TOptions extends {
+    flat?: true;
+} ? ParsedTimespanList<TOptions> : {
+    [timespanKey: string]: ParsedTimespanList<TOptions>;
+}) & (TOptions extends {
+    includeMetadataAttributes?: true | string[];
+} ? ParsedMetadataAttributes : {});
+
+export declare type ParsedShapeType = {
+    uri?: string;
+    tag?: string;
+    mimeType?: string;
+} & ParsedContainerComponentType & ParsedBinaryComponentType & ParsedAudioComponentType & ParsedVideoComponentType;
+
+export declare type ParsedTimespan<TOptions> = ((TOptions extends {
+    groupAsList?: true;
+} ? {
+    group?: ParsedGroupList<TOptions>;
+} : {
+    [name: string]: ParsedGroupList<TOptions>;
+}) & (TOptions extends {
+    fieldAsList?: true;
+} ? {
+    field?: ParsedFieldList<TOptions>;
+} : {
+    [name: string]: ParsedFieldList<TOptions>;
+})) & ParsedTimespanAttributes;
+
+export declare type ParsedTimespanAttributes = Omit<MetadataType['timespan'][number], 'field' | 'group'>;
+
+export declare type ParsedTimespanList<TOptions> = TOptions extends {
+    timespanAsList?: true;
+} ? ParsedTimespan<TOptions>[] : TOptions extends {
+    flat?: true;
+    onlyGeneric?: true | undefined;
+} | {
+    onlyGeneric?: true;
+} ? ParsedTimespan<TOptions> : {
+    [timespanKey: string]: ParsedTimespan<TOptions>[];
+};
+
+export declare type ParsedTranscodePreset = {
+    description?: string;
+    containerFormat?: any;
+    videoFormat?: string;
+    height?: number;
+    width?: number;
+    dimension?: string;
+    aspectRatio?: string;
+    fieldOrder?: string;
+    videoBitrate?: number;
+    timeBase?: TimeBase;
+    frameRate?: string | number;
+    audioFormat?: string;
+    audioSamplerate?: string;
+    audioBitrate?: string;
+    audioBitRateMode?: string;
+    audioChannels?: number;
+};
+
+export declare type ParsedValue<TOptions> = TOptions extends {
+    includeValueAttributes?: false;
+} ? string : {
+    value: string;
+} & ParsedValueAttributes;
+
+export declare type ParsedValueAttributes = Partial<Omit<MetadataValueType, 'value'>>;
+
+export declare type ParsedValueList<TOptions> = TOptions extends {
+    joinValue?: string;
+    includeValueAttributes?: false;
+} ? string : TOptions extends {
+    arrayOnSingleValue?: true;
+} ? ParsedValue<TOptions>[] : ParsedValue<TOptions> | ParsedValue<TOptions>[];
+
+export declare type ParsedVideoComponentType = {
+    videoFormat?: string;
+    dimension?: string;
+    frameRate?: string | number;
+    height?: number;
+    width?: number;
+    timeBase?: TimeBase;
+    timeCode?: TimeCode;
+    videoCodec?: string;
+    smpte?: string;
+    videoBitrate?: string;
+    videoBitrateMbps?: number;
+    fieldOrder?: string;
+    colorSpace?: string;
+    chromaSubsampling?: string;
+    aspectRatio?: string;
+    colorPrimaries?: string;
+    videoMetadata?: {
+        [key: string]: string;
+    };
+    videoMediaInfo?: ParsedVideoMediaInfoType;
+};
+
+export declare type ParsedVideoMediaInfoType = ParsedBaseMediaInfoType & {
+    Format_Settings_GOP?: string;
+    intra_dc_precision?: string;
+};
+
 /**
- * Create a TimeBase Instance from a number, string or object representation of a time base
+ * Parse a VidiCore facet list
  *
- * @param timeBase Input to create time base from
- * @returns A TimeBase instance
+ * @param facetType A facet list to parse
+ * @returns A parsed facet list
  *
- * @category Time
+ * @category Search
  */
-declare const createTimeBase: (timeBase: TimeBaseInput | string | number) => TimeBase;
-
+export declare const parseFacetList: (facetList?: FacetType[]) => ParsedFacetList;
+
 /**
- * Format a string representation of a time base to a TimeBase Instance
+ * Parse a VidiCore facet type list
  *
- * @param timeBaseText The string to format to a TimeBase instance
- * @returns A TimeBase Instance
+ * @param facetType A facet type list to parse
+ * @returns A parsed facet type list
  *
- * @category Time
+ * @category Search
  */
-declare const formatTimeBaseText: (timeBaseText?: string | number) => TimeBase;
-
+export declare const parseFacetType: (facetType?: FacetType[]) => ParsedFacetType;
+
 /**
- * Create a TimeBase instance of an object
+ * Parse a metadata field definition list
  *
- * @param timeBase A TimeBase object
- * @returns A TimeBase instance
+ * @remarks
+ * - `values` are parsed to an options array (as `[{ label, value }, ...]`)
+ *   - Include values using the `includeValues: true` query parameter
+ * - `restrictions.required` is parsed from restrictions having defined minInclusive or minLength > 0
  *
- * @category Time
+ * @param fieldList Field definition list to parse
+ * @returns A parsed field list
+ *
+ * @category Field
  */
-declare const formatTimeBaseType: (timeBase: TimeBaseInput) => TimeBase;
-
-type TimeCodeInput = {
-    /** Amount of samples for the time code */
-    samples?: number | string;
-    /** The time base for the time code */
-    timeBase?: string | TimeBaseInput | TimeBase;
-};
-type TimeCodeInputOptions = {
-    /** If time code is dropFrame or not (by default checks timeBase) */
-    dropFrame?: boolean;
-    /** Separator for frame in smpte output (default ":" for non-drop-frame and ";" for dropFrame) */
-    frameSeparator?: string;
-};
+export declare const parseFieldDefinitionList: (fieldList: MetadataFieldType[]) => ParsedFieldDefinitionList;
+
+export declare type ParseFieldDefinitionListOptions = {};
+
 /**
- * TimeCode class representing the TimeCodeType in VidiCore
+ * Parse a metadata field list according to selected options
  *
- * For more info, see the [Time Codes section of VidiCore API Docs](https://apidoc.vidispine.com/latest/time.html#time-codes)
+ * @remarks
+ * When parsing duplicate fields (same field name in the same field list) it will:
+ * - with default options: combine field values to one array within the same field name key
+ * - with `joinValue` enabled: join values within each field (returns array with string for each field value)
+ * - with `fieldAsList` enabled: separate fields in the list/array (as usual, even if not duplicate)
+ * - with `includeFieldAttributes` enabled: return an array of field objects
+ * - with `overrideField` enabled: return the latest duplicated field it parses
  *
- * @category Time
+ * @param fieldList Field list to parse
+ * @param [options=defaultOptions] Options for how to parse the field list
+ * @returns A parsed field list
+ *
+ * @category Metadata
  */
-declare class TimeCode {
-    /** Amount of samples for the time code */
-    samples: number;
-    /** The time base for the time code */
-    timeBase: TimeBase;
-    /** If time code is dropFrame or not (by default checks timeBase) */
-    dropFrame?: boolean;
-    /** Separator for frame in smpte output (default ":" for non-drop-frame and ";" for dropFrame) */
-    frameSeparator?: string;
-    /**
-     * Constructor for TimeCode
-     *
-     * @param timeCodeType Object to create TimeCode of
-     * @param options Options for the timeCode
-     */
-    constructor(timeCodeType: TimeCodeInput, options?: TimeCodeInputOptions);
-    /**
-     * Return this TimeCode added with the supplied timeCodeType
-     * - If time bases differ, it will retain the time base of this TimeCode instance
-     * - If supplied time code has a more granular time base, it will round down exceeding samples (hasn't reached that sample yet)
-     *
-     * @remarks
-     * If you don't want to "lose" frames in the manner described above, make sure time code you're operating on has higher time base granularity
-     *
-     * To exemplify:
-     * - "51@50".add("25@25") => "101@50"
-     * - while "25@25".add("51@50") => "50@25"
-     *
-     * @param timeCode A TimeCode instance you want to add with
-     * @returns A new TimeCode instance with the addition applied
-     */
-    add(timeCode: TimeCode): TimeCode;
-    /**
-     * Return this TimeCode subtracted with the supplied timeCodeType
-     * - If time bases differ, it will retain the time base of the instance time code
-     * - If supplied time code has a more granular time base, it will round down exceeding samples (hasn't reached that sample yet)
-     *
-     * @remarks
-     * If you don't want to "lose" frames in the manner described above, make sure time code you're operating on has higher time base granularity
-  
-     * To exemplify:
-     * - "101@50".subtract("25@25") => "51@50"
-     * - while "50@25".subtract("51@50") => "25@25"
-     *
-     * @param timeCode A TimeCode instance you want to subtract with
-     * @returns A new TimeCode instance with the subtraction applied
-     */
-    subtract(timeCode: TimeCode): TimeCode;
-    /**
-     * Creates a new TimeCode instance with specified timeBase and samples adjusted to that.
-     *
-     * @remarks
-     * If it conforms to a less granular time base - it will floor samples (hasn't reached that sample yet)
-     * - e.g. "51@50".conformTo("PAL") => "25@PAL" (not "26@PAL")
-     *
-     * @param timeBase The TimeBase it should conform the TimeCode to
-     * @param options Explicitly set TimeCode options, by default these are derived from `timeBase`
-     * @returns A new TimeCode instance with the conformTo timeBase applied
-     */
-    conformTimeBase(timeBase: TimeCodeInput['timeBase'], options?: TimeCodeInputOptions): TimeCode;
-    /**
-     * Get TimeCode as a text representation
-     *
-     * @remarks
-     * Default format: `samples@denominator[:numerator (if > 1)])`
-     *
-     * `constant` has precedence over `fraction` if both are true
-     *
-     * @param options Options for how to format text
-     * @returns Text representation of TimeCode
-     */
-    toText(options?: {
-        /** Include time base even if seconds (i.e. append @1 or @1:1) */
-        includeTimeBaseForSeconds?: boolean;
-        /** show as constant (e.g. @PAL) */
-        constant?: boolean;
-        /** show as fraction (e.g. @25:1) */
-        fraction?: boolean;
-    }): string;
-    /**
-     *  Get TimeCode in a units object representation
-     *
-     * @returns Units (time and frames) for the time code
-     */
-    toUnits(): {
-        hours: number;
-        minutes: number;
-        seconds: number;
-        frames: number;
-    };
-    /**
-     * Get TimeCode in a time object representation
-     *
-     * Note: "milliseconds" is rounded down - use "partialSeconds" for another representation
-     *
-     * @returns Time for the time code
-     */
-    toTime(): {
-        hours: number;
-        minutes: number;
-        seconds: number;
-        milliseconds: number;
-        partialSeconds: number;
-    };
-    /**
-     * Get TimeCode in a seconds representation
-     *
-     * @returns Total seconds for the time code
-     */
-    toSeconds(): number;
-    /**
-     * Get TimeCode in a duration representation
-     *
-     * The time unit keys for the format string are:
-     * - `h` for hour
-     * - `m` for minute
-     * - `s` for seconds
-     * - `S` for milliseconds
-     * - Any other char will be kept in the duration output string
-     *
-     * Note: Add several consecutive chars for zero padding.
-     *
-     * By default it:
-     * - uses colon delimiter (e.g. for format "hhmmss")
-     * - shows "m:ss" or "h:mm:ss" if format is undefined
-     *
-     * @param options Options for how to display duration
-     * @returns Duration representation of the TimeCode
-     */
-    toDuration(options?: {
-        /** Specify format of duration string, (e.g. `hh:mm:ss.S` for "01:23:04.5") */
-        format?: string;
-    }): string;
-    /**
-     * Get TimeCode in a smpte representation
-     *
-     * @returns Smpte representation of the TimeCode
-     */
-    toSmpte(): string;
-    /**
-     * Get TimeCode as a VidiCore TimeCodeType object
-     *
-     * @returns  TimeCode as `{ samples, timeBase }`
-     */
-    toObject(): {
-        samples: number;
-        timeBase: _vidispine_types.RationalType;
-    };
-    /**
-     * @deprecated Use {@link TimeCode#toObject | toObject} instead
-     *
-     * @returns TimeCode as `{ samples, timeBase }`
-     */
-    toJson(): {
-        samples: number;
-        timeBase: _vidispine_types.RationalType;
-    };
-}
-
-interface FormatTimeCodeSecondsOptions extends TimeCodeInputOptions {
-    /**
-     * The TimeBase the output TimeCode should have
-     *
-     * Note: if unset and useGCD=false, denominator will be 10^(amount-of-decimals)
-     */
-    timeBase?: number | string | TimeBaseInput;
-    /**
-     * Samples and denominator are divided with GCD
-     *
-     * e.g. `1.04 => 104@100 => 26@25` (if no explicit `timeBase` is set)
-     */
-    useGCD?: boolean;
+export declare const parseFieldList: <TOptions extends ParseFieldListOptions = ParseFieldListOptions>(fieldList: MetadataFieldValueType[], options?: TOptions) => ParsedFieldList<TOptions>;
+
+export declare interface ParseFieldListOptions extends ParseFieldOptions {
+    /** Return fields as list */
+    fieldAsList?: boolean;
+    /** Return fields as array even if only one field */
+    arrayOnSingleField?: boolean;
+    /** Return all fields flattened (Note: keys might be overridden) */
+    overrideField?: boolean;
+}
+
+export declare interface ParseFieldOptions extends ParseValueListOptions {
+    /** Include attributes on field (`true` for all) */
+    includeFieldAttributes?: boolean | (keyof ParsedFieldAttributes)[];
 }
+
 /**
- * Format seconds to TimeCode object
+ * Parses a VidiCore file object
  *
  * @remarks
- * Input time base is always considered as 1:1 since it expects seconds as input
- *
- * Note: Max 15 digits accuracy (double precision float64), e.g.
- * - 10^6 seconds can have 10^9 decimals (nanosecond) precision
- * - 10^9 seconds can have 10^6 decimals (microsecond) precision
- * - 10^12 seconds can have 10^3 decimals (millisecond) precision
+ * File sizes are parsed with JEDEC standard (base 2)
  *
- * @param seconds With or without decimals ("." and "," are both interpreted as decimal)
- * @param options Options for how to format the seconds to a TimeCode
- * @returns A TimeCode instance
+ * @param fileType VidiCore file object
+ * @returns A parsed file object
  *
- * @category Time
+ * @category File
  */
-declare const formatTimeCodeSeconds: (seconds: string | number, options?: FormatTimeCodeSecondsOptions) => TimeCode;
-
-interface FormatTimeCodeSmpteOptions extends TimeCodeInputOptions {
-    /** TimeBase of smpte (and consequently TimeBase of output TimeCode) */
-    timeBase?: number | string | TimeBaseInput;
-    /** How to handle exceeding values (default `error`) */
-    exceedingMode?: 'add' | 'ignore' | 'error';
-}
+export declare const parseFileType: (fileType: FileType) => ParsedFileType;
+
 /**
- * Format smpte text to a TimeCode Instance
+ * Parse a metadata group list according to selected options
  *
- * Options for `exceedingMode`:
- * - `add` will be overflow to higher unit (e.g. PAL and 00:00:00:25 => 00:00:01:00)
- * - `ignore` will be truncated (e.g. PAL and 00:00:00:25 => 00:00:00:24)
- * - `error` will throw error (e.g. PAL and 00:00:00:25 => Error)
+ * @remarks
+ * Parsing duplicate groups (same group name in the same group list) it will:
+ * - with default options: combine group objects to one array within the same group name key
+ * - with `groupAsList` enabled: return separate group objects in a list/array (as usual, even if not duplicate)
+ * - with `overrideGroup` enabled: return the latest duplicated group it parses
  *
- * @param smpte String representation of smpte
- * @param options Options for creating the time code from smpte
- * @returns TimeCode instance created from smpte string
+ * @param groupList Group list to parse
+ * @param options options for how to parse list
+ * @returns A parsed group list
  *
- * @category Time
+ * @category Metadata
  */
-declare const formatTimeCodeSmpte: (smpte: string, options?: FormatTimeCodeSmpteOptions) => TimeCode;
-
-interface FormatTimeCodeTextOptions extends TimeCodeInputOptions {
-    /** The time base the returned TimeCode should have */
-    timeBase?: number | string | TimeBaseInput;
+export declare const parseGroupList: <TOptions extends ParseGroupOptions = ParseGroupOptions>(groupList: MetadataGroupValueType[], options?: TOptions) => ParsedGroupList<TOptions>;
+
+export declare type ParseGroupListOptions = ParseGroupOptions;
+
+export declare interface ParseGroupOptions extends ParseFieldListOptions {
+    /** Include group attributes (`true` for all) */
+    includeGroupAttributes?: boolean | (keyof ParsedGroupAttributes)[];
+    /** Return groups as list */
+    groupAsList?: boolean;
+    /** Return groups as array even if only one group */
+    arrayOnSingleGroup?: boolean;
+    /** Return all groups flattened (Note: keys might be overridden) */
+    overrideGroup?: boolean;
 }
+
 /**
- * Format text to a TimeCode instance
- *
- * @returns A TimeCode instance
+ * Parses highlight timespan in VidiCore into key/value object.
+ * The attributes can be targeted for each sub-type.
+ * @param timespan - A VidiCore search timespan
+ * @param options - Options which change how the timespans are parsed
  *
- * @category Time
+ * @category Search
  */
-declare const formatTimeCodeText: (timeCodeText?: number | string, options?: FormatTimeCodeTextOptions) => TimeCode;
-
-type CreateTimeCodeOptions = TimeCodeInputOptions | FormatTimeCodeSmpteOptions | FormatTimeCodeSecondsOptions | FormatTimeCodeTextOptions;
+export declare const parseHighlightTimespan: (timespan: SearchResultEntryTimespanType, options: ParseHighlightTimespanOptions) => ParsedHighlightTimespan;
+
 /**
- * Create a TimeCode instance from smpte, seconds/samples, timeCode object or string
+ * Parses highlight timespans from VidiCore into key/value object.
+ * The attributes can be targeted for each sub-type.
  *
- * @param timeCode Smpte, seconds/samples, timeCode object or string
- * @param options For the format functions
- * @returns A TimeCode instance
+ * @param highlightTimespanList - A list of timespans from VidiCore.
+ * @param options - Options to change how the timespans are parsed
  *
- * @category Time
+ * @category Search
  */
-declare const createTimeCode: (timeCode: TimeCodeInput | string | number, options?: CreateTimeCodeOptions) => TimeCode;
-
+export declare const parseHighlightTimespanList: (highlightTimespanList?: SearchResultEntryTimespanType[], options?: ParseHighlightTimespanListOptions) => ParsedHighlightTimespan | ParsedHighlightTimespan[];
+
+export declare interface ParseHighlightTimespanListOptions extends ParseHighlightTimespanOptions {
+    /** Return parsed timespan as list (in an array) */
+    timespanAsList?: boolean;
+    /** Character to join the start/end time codes with */
+    joinTimespan?: string;
+    /** Flatten to field-name/field-value (Note: field-values may be overwritten) */
+    flat?: boolean;
+    /** Flatten timespan to object with start/end as key */
+    flatTimespan?: boolean;
+}
+
+export declare type ParseHighlightTimespanOptions = {
+    /** Return an array if there is a single value */
+    arrayOnSingle?: boolean;
+    /** Return timespans as list */
+    timespanAsList?: boolean;
+    /** String to join the values (e.g. `,`) */
+    joinValue?: string;
+};
+
 /**
- * Format an object to a TimeCode instance
  *
- * @param timeCode To create TimeCode instance of
- * @param options For the TimeCode constructor
- * @returns  A TimeCode instance
+ * @param keyValuePairTypes
+ * @returns
  *
- * @category Time
+ * @category Other
  */
-declare const formatTimeCodeType: (timeCode: TimeCodeInput, options?: TimeCodeInputOptions) => TimeCode;
-
-type ParsedVideoComponentType = {
-    videoFormat?: string;
-    dimension?: string;
-    frameRate?: string | number;
-    height?: number;
-    width?: number;
-    timeBase?: TimeBase;
-    timeCode?: TimeCode;
-    videoCodec?: string;
-    smpte?: string;
-    videoBitrate?: string;
-    videoBitrateMbps?: number;
-    fieldOrder?: string;
-    colorSpace?: string;
-    chromaSubsampling?: string;
-    aspectRatio?: string;
-    colorPrimaries?: string;
-    videoMetadata?: {
-        [key: string]: string;
-    };
-    videoMediaInfo?: ParsedVideoMediaInfoType;
+export declare const parseKeyValuePairType: (keyValuePairTypes: KeyValuePairType[]) => {
+    [k: string]: string;
 };
+
 /**
- * Parses the technical information of a VideoComponentType.
- * @param {Object} videoComponentType - A VideoComponentType from VidiCore.
- * @returns {Object} Parsed component object.
- *
- * @category Shape
- */
-declare const parseVideoComponent: (videoComponentType?: VideoComponentType) => ParsedVideoComponentType;
-
-type ParsedShapeType = {
-    uri?: string;
-    tag?: string;
-    mimeType?: string;
-} & ParsedContainerComponentType & ParsedBinaryComponentType & ParsedAudioComponentType & ParsedVideoComponentType;
-/**
- * Parses the technical information of a ShapeType and its various components.
+ * TODO
  *
- * Will only parse the first videoComponent, audioComponent, binaryComponent in the corresponding array.
- * To parse a selected component see:
- * - {@link parseContainerComponent}
- * - {@link parseVideoComponent}
- * - {@link parseAudioComponent}
- * - {@link parseBinaryComponent}
- * @param shapeType - A ShapeType from VidiCore.
- * @returns Parsed shape object.
+ * @param mediaconvert
+ * @returns
  *
- * @category Shape
+ * @category Transcode
  */
-declare const parseShapeType: (shapeType?: ShapeType) => ParsedShapeType;
-
+export declare const parseMediaConvertPreset: (mediaconvert: TranscodePresetType['mediaconvert']) => ParsedMediaConvertTranscodePreset;
+
 /**
- * Const object with document types
+ * Parses MetadataType according to specified options
  *
- * @category Shape
- */
-declare const DOCUMENT_TYPES: {
-    readonly PDF: "PDF";
-    readonly TEXT: "TEXT";
-    readonly MSWORD: "MSWORD";
-    readonly JSON: "JSON";
-    readonly XML: "XML";
-};
-
-/**
- * Const object with media types
+ * @remarks
+ * Be aware that you need to take into account that the returned groups and fields can be an array if it has multiple values or groups/fields with same name.
+ * If you are certain your metadata type won't return multiple groups/fields/values with same name or don't mind that they _might_ be overridden:
+ * you can use the option `flat` along with `joinValue` or `arrayOnSingleValue: false`.
  *
- * @category Shape
- */
-declare const SHAPE_MEDIA_TYPES: {
-    readonly IMAGE: "IMAGE";
-    readonly AUDIO: "AUDIO";
-    readonly VIDEO: "VIDEO";
-    readonly DOCUMENT: "DOCUMENT";
-    readonly BINARY: "BINARY";
-};
-
-type DocumentType = keyof typeof DOCUMENT_TYPES;
-/**
- * Return a const for the document type of a shape (looks at mimeType)
+ * @param metadataType - A MetadataType from VidiCore
+ * @param options - Options which change how the metadataType is parsed
+ * @returns Metadata object parsed according to options
  *
- * @param shape A VidiCore shape
- * @returns The document type for a shape
+ * @see {@link parseTimespanList} for more info
  *
- * @category Shape
+ * @category Metadata
  */
-declare const getShapeDocumentType: (shape?: ShapeType) => DocumentType;
-
-type FilteredShapeListObject = {
-    src: string;
-    type: string;
-    shape: ShapeType;
-    parsedShape: ParsedShapeType;
-    [key: string]: string | ParsedShapeType | ShapeType;
-};
-type FilterShapeSourceOption = {
-    sortPriority?: Function;
-    allowedMimeTypes?: string[];
-    allowedMethods?: string[];
-    sourceKey?: string;
-    mimeTypeKey?: string;
-    shapeKey?: string;
-    parsedShapeKey?: string;
-};
+export declare function parseMetadataType<TOptions extends ParseMetadataTypeOptions = ParseMetadataTypeOptions>(metadataType: MetadataType, options?: TOptions): ParsedMetadataType<TOptions>;
+
+export declare interface ParseMetadataTypeOptions extends ParseTimespanListOptions {
+    /** Include metadata attributes (`true` for all) */
+    includeMetadataAttributes?: boolean | (keyof ParsedMetadataAttributes)[];
+    /** Flatten timespans, groups and fields (Note: keys might be overridden) */
+    flat?: boolean;
+}
+
 /**
- * Filter a shape type list to get shapes that are playable in a browser
+ * Parse Vidicore "NOW" constants to a date object
  *
- * @param itemType
- * @param options
- * @returns
+ * Format: `NOW[+/-][number][HOUR/DAY/MONTH/YEAR(s)]` (e.g. "NOW-2HOURS")
  *
- * @category Shape
+ * @remarks
+ * Returns an approximate date since it's created client side
+ *
+ * @param value A "NOW" constant
+ * @returns A date from the NOW constant
+ *
+ * @category Search
  */
-declare const filterShapeSource: (itemType: ItemType, options?: FilterShapeSourceOption) => FilteredShapeListObject[];
-
-type ShapeMediaType = keyof typeof SHAPE_MEDIA_TYPES;
+export declare const parseNowDate: (value?: string) => Date;
+
 /**
- * Returns a const for which media type a shape has
+ * Parses the technical information of a ShapeType and its various components.
  *
- * @param shape
- * @returns
+ * Will only parse the first videoComponent, audioComponent, binaryComponent in the corresponding array.
+ * To parse a selected component see:
+ * - {@link parseContainerComponent}
+ * - {@link parseVideoComponent}
+ * - {@link parseAudioComponent}
+ * - {@link parseBinaryComponent}
+ * @param shapeType - A ShapeType from VidiCore.
+ * @returns Parsed shape object.
  *
  * @category Shape
  */
-declare const getShapeMediaType: (shape: ShapeType) => ShapeMediaType;
-
+export declare const parseShapeType: (shapeType?: ShapeType) => ParsedShapeType;
+
 /**
- * Const object with all file states in VidiCore
- * (see https://apidoc.vidispine.com/latest/storage/storage.html#file-states for more info)
+ * Parse simple (key/value) metadata
  *
- * @category File
+ * Not indexed metadata, available on almost all entities (storages, library, user, group, etc...)
+ *
+ * @param simpleMetadataType A VidiCore simple metadata object
+ * @returns A parsed simple metadata object
+ *
+ * @category Metadata
  */
-declare const FILE_STATES: {
-    /** Just created, not used. */
-    readonly NONE: "NONE";
-    /** Discovered or created, not yet marked as finished. */
-    readonly OPEN: "OPEN";
-    /** File does no longer grow. */
-    readonly CLOSED: "CLOSED";
-    /** The current state is not known. */
-    readonly UNKNOWN: "UNKNOWN";
-    /** File is missing from the file system/storage. */
-    readonly MISSING: "MISSING";
-    /** File has been missing for a longer period. Candidate for restoration from archive. */
-    readonly LOST: "LOST";
-    /** File will appear on file system/storage, transfer subsystem or transcoder will create it. */
-    readonly TO_APPEAR: "TO_APPEAR";
-    /** The file is no longer in use, and will be deleted at the next clean-up sweep. */
-    readonly TO_BE_DELETED: "TO_BE_DELETED";
-    /** File is in use by transfer subsystem or transcoder. */
-    readonly BEING_READ: "BEING_READ";
-    /** File is archived. */
-    readonly ARCHIVED: "ARCHIVED";
-    /** File will be synchronized by multi-site agent. */
-    readonly AWAITING_SYNC: "AWAITING_SYNC";
+export declare const parseSimpleMetadataType: (simpleMetadataType: SimpleMetadataType) => {
+    [key: string]: string;
 };
-type FileStateTypes = keyof typeof FILE_STATES;
-
+
 /**
- * Find the thumbnail uri in a VidiCore item object that's nearest a timeCode
+ *
+ * Parses timespan according to specified options
  *
  * @remarks
- * Time code is included in path of VidiCore thumbnail uris
+ * To ensure a flat (no array) representation when using `flat: true`, the parser will also set `overrideGroup` and `overrideField` to true (unless those are explicitly set false)
  *
- * @param itemType A VidiCore item object
- * @param timeCode A timeCode to find nearest thumbnail to
- * @returns A URI of a thumbnail, `undefined` if item has no thumbnails
+ * @param timespan - A VidiCore metadata timespan
+ * @param options - Options to change how it is parsed
+ * @returns Timespan parsed according to options
  *
- * @category Thumbnail
- */
-declare const findNearestThumbnail: (itemType: ItemType, timeCode: TimeCode | TimeCodeInput) => string;
-
-/**
- * TODO
+ * @see {@link parseGroupList} and {@link parseFieldList} for more info
+ *
+ * @category Metadata
  */
-type ParsedMediaConvertTranscodePreset = {
-    description?: string;
-    containerFormat?: any;
-    videoFormat?: string;
-    height?: number;
-    width?: number;
-    dimension?: string;
-    aspectRatio?: string;
-    fieldOrder?: string;
-    videoBitrate?: number;
-    timeBase?: TimeBase;
-    frameRate?: string | number;
-    audioFormat?: string;
-    audioSamplerate?: string;
-    audioBitrate?: string;
-    audioBitRateMode?: string;
-};
+export declare const parseTimespan: <TOptions extends ParseTimespanOptions = ParseTimespanOptions>(timespan: MetadataType['timespan'][number], options?: TOptions) => ParsedTimespan<TOptions>;
+
 /**
- * TODO
+ * Parses timespanList according to specified options.
+ * The attributes can be targeted for each sub-type.
  *
- * @param mediaconvert
- * @returns
+ * @param timespanList - A Vidicore metadata timespan list
+ * @param options - Options which change how the metadataType is parsed.
+ * @returns Timespan list parsed according to options
  *
- * @category Transcode
+ * @see {@link parseTimespan} for more info
+ *
+ * @category Metadata
  */
-declare const parseMediaConvertPreset: (mediaconvert: TranscodePresetType['mediaconvert']) => ParsedMediaConvertTranscodePreset;
-
-type ParsedTranscodePreset = {
-    description?: string;
-    containerFormat?: any;
-    videoFormat?: string;
-    height?: number;
-    width?: number;
-    dimension?: string;
-    aspectRatio?: string;
-    fieldOrder?: string;
-    videoBitrate?: number;
-    timeBase?: TimeBase;
-    frameRate?: string | number;
-    audioFormat?: string;
-    audioSamplerate?: string;
-    audioBitrate?: string;
-    audioBitRateMode?: string;
-    audioChannels?: number;
-};
+export declare const parseTimespanList: <TOptions extends ParseTimespanListOptions = ParseTimespanListOptions>(timespanList: MetadataType['timespan'], options?: TOptions) => ParsedTimespanList<TOptions>;
+
+export declare interface ParseTimespanListOptions extends ParseTimespanOptions {
+    /** Return timespans as list */
+    timespanAsList?: boolean;
+    /** String to join timespans with (defaults to '_') */
+    joinTimespan?: string;
+    /** Sort timespanList by ascending start then end time */
+    sortTimespan?: boolean;
+    /** Return a flat representation - only one timespan with groups/fields named the same as single - of the timespan list (Note: timespans/fields/groups can be overridden) */
+    flat?: boolean;
+    /** Flatten timespans to one object with generic timespan having highest priority (Note: fields/groups might be overridden) */
+    flatTimespan?: boolean;
+}
+
+export declare interface ParseTimespanOptions extends ParseGroupListOptions {
+    /** Include attributes on timespan (`true` for all) */
+    includeTimespanAttributes?: boolean | (keyof ParsedTimespanAttributes)[];
+    /** Return groups, fields, and values as array */
+    arrayOnSingle?: boolean;
+    /** Flatten timespan, groups and fields (Note: keys might be overridden) */
+    flat?: boolean;
+}
+
 /**
  * Parse a VidiCore transcode preset
  *
@@ -1301,6 +1023,441 @@ type ParsedTranscodePreset = {
  *
  * @category Transcode
  */
-declare const parseTranscodePreset: (transcodePresetType: TranscodePresetType) => ParsedTranscodePreset;
-
-export { CreateFacetTypeFieldList, CreateFacetTypeOptions, CreateMetadataTypeInput, CreateTimeCodeOptions, DOCUMENT_TYPES, DocumentType, FIELD_ATTRIBUTE_KEYS, FIELD_VALUE_ATTRIBUTE_KEYS, FILE_STATES, FileStateTypes, FilterShapeSourceOption, FilteredShapeListObject, FormatTimeCodeSecondsOptions, FormatTimeCodeSmpteOptions, FormatTimeCodeTextOptions, GROUP_ATTRIBUTE_KEYS, InputField, InputFieldObject, InputFieldValue, InputGroup, InputGroupsOrFields, InputTimespan, InputValue, InputValueObject, InputValueTypes, MetadataTypeToWebVttOptions, ParseFieldListOptions, ParseFieldOptions, ParseGroupListOptions, ParseGroupOptions, ParseHighlightTimespanListOptions, ParseHighlightTimespanOptions, ParseMetadataTypeOptions, ParseTimespanListOptions, ParseTimespanOptions, ParseValueListOptions, ParseValueOptions, ParsedAudioComponentType, ParsedAudioMediaInfoType, ParsedBaseMediaInfoType, ParsedBinaryComponentType, ParsedBinaryMediaInfoType, ParsedContainerComponentType, ParsedFacetType, ParsedFacetTypeCount, ParsedField, ParsedFieldAttributes, ParsedFieldList, ParsedFieldObject, ParsedFileType, ParsedGroup, ParsedGroupAttributes, ParsedGroupList, ParsedHighlightTimespan, ParsedMediaConvertTranscodePreset, ParsedMetadataAttributes, ParsedMetadataType, ParsedShapeType, ParsedTimespan, ParsedTimespanAttributes, ParsedTimespanList, ParsedTranscodePreset, ParsedValue, ParsedValueAttributes, ParsedValueList, ParsedVideoComponentType, ParsedVideoMediaInfoType, ROLE_NAMES, RoleNameTypes, SHAPE_MEDIA_TYPES, SYSTEM_FIELDGROUPS, SYSTEM_FIELDS, ShapeMediaType, TimeBase, TimeBaseInput, TimeCode, TimeCodeInput, TimeCodeInputOptions, createFacetType, createMetadataType, createTimeBase, createTimeCode, filterShapeSource, findNearestThumbnail, formatTimeBaseText, formatTimeBaseType, formatTimeCodeSeconds, formatTimeCodeSmpte, formatTimeCodeText, formatTimeCodeType, getShapeDocumentType, getShapeMediaType, metadataTypeToWebVtt, parseAudioComponent, parseBinaryComponent, parseContainerComponent, parseFacetType, parseFieldList, parseFileType, parseGroupList, parseHighlightTimespan, parseHighlightTimespanList, parseKeyValuePairTypes as parseKeyValuePairType, parseMediaConvertPreset, parseMetadataType, parseNowDate, parseShapeType, parseSimpleMetadataType, parseTimespan, parseTimespanList, parseTranscodePreset, parseVideoComponent };
+export declare const parseTranscodePreset: (transcodePresetType: TranscodePresetType) => ParsedTranscodePreset;
+
+export declare interface ParseValueListOptions extends ParseValueOptions {
+    /** String to join the values, (e.g. `,`) */
+    joinValue?: string;
+    /** Return values as array even if single value */
+    arrayOnSingleValue?: boolean;
+}
+
+export declare type ParseValueOptions = {
+    /** Include attributes on value (`true` for all) */
+    includeValueAttributes?: boolean | (keyof ParsedValueAttributes)[];
+};
+
+/**
+ * Parses the technical information of a VideoComponentType.
+ * @param {Object} videoComponentType - A VideoComponentType from VidiCore.
+ * @returns {Object} Parsed component object.
+ *
+ * @category Shape
+ */
+export declare const parseVideoComponent: (videoComponentType?: VideoComponentType) => ParsedVideoComponentType;
+
+/**
+ * Const object with VidiCore role names
+ *
+ * @category Auth
+ */
+export declare const ROLE_NAMES: {
+    readonly ACCESSCONTROL_READ: "_accesscontrol_read";
+    readonly ACCESSCONTROL_WRITE: "_accesscontrol_write";
+    readonly ADMINISTRATOR: "_administrator";
+    readonly AUTO_PROJECTION_READ: "_auto_projection_read";
+    readonly AUTO_PROJECTION_WRITE: "_auto_projection_write";
+    readonly COLLECTION_NOTIFICATION_READ: "_collection_notification_read";
+    readonly COLLECTION_NOTIFICATION_WRITE: "_collection_notification_write";
+    readonly COLLECTION_READ: "_collection_read";
+    readonly COLLECTION_WRITE: "_collection_write";
+    readonly CONFIGURATION_READ: "_configuration_read";
+    readonly DELETION_LOCK_NOTIFICATION_READ: "_deletion_lock_notification_read";
+    readonly DELETION_LOCK_NOTIFICATION_WRITE: "_deletion_lock_notification_write";
+    readonly DELETION_LOCK_READ: "_deletion_lock_read";
+    readonly DELETION_LOCK_WRITE: "_deletion_lock_write";
+    readonly DOCUMENT_NOTIFICATION_READ: "_document_notification_read";
+    readonly DOCUMENT_NOTIFICATION_WRITE: "_document_notification_write";
+    readonly DOCUMENT_READ: "_document_read";
+    readonly DOCUMENT_WRITE: "_document_write";
+    readonly ERROR_READ: "_error_read";
+    readonly ERROR_WRITE: "_error_write";
+    readonly EXPORT: "_export";
+    readonly EXPORT_TEMPLATE_READ: "_export_template_read";
+    readonly EXPORT_TEMPLATE_WRITE: "_export_template_write";
+    readonly EXTERNAL_ID_READ: "_external_id_read";
+    readonly EXTERNAL_ID_WRITE: "_external_id_write";
+    readonly FILE_NOTIFICATION_READ: "_file_notification_read";
+    readonly FILE_NOTIFICATION_WRITE: "_file_notification_write";
+    readonly FILE_READ: "_file_read";
+    readonly FILE_WRITE: "_file_write";
+    readonly GROUP_READ: "_group_read";
+    readonly GROUP_WRITE: "_group_write";
+    readonly IMPORT_WRITE: "_import";
+    readonly ITEM_ID_READ: "_item_id_read";
+    readonly ITEM_ID_WRITE: "_item_id_write";
+    readonly ITEM_NOTIFICATION_READ: "_item_notification_read";
+    readonly ITEM_NOTIFICATION_WRITE: "_item_notification_write";
+    readonly ITEM_WRITE: "_item_write";
+    readonly ITEM_SEARCH: "_item_search";
+    readonly ITEM_SHAPE_READ: "_item_shape_read";
+    readonly ITEM_SHAPE_WRITE: "_item_shape_write";
+    readonly ITEM_TIMELINE_READ: "_item_timeline_read";
+    readonly ITEM_TIMELINE_WRITE: "_item_timeline_write";
+    readonly ITEM_URI: "_item_uri";
+    readonly JOB_NOTIFICATION_READ: "_job_notification_read";
+    readonly JOB_NOTIFICATION_WRITE: "_job_notification_write";
+    readonly JOB_READ: "_job_read";
+    readonly JOB_WRITE: "_job_write";
+    readonly LIBRARY_READ: "_library_read";
+    readonly LIBRARY_WRITE: "_library_write";
+    readonly LOCK_READ: "_lock_read";
+    readonly LOCK_WRITE: "_lock_write";
+    readonly LOG_READ: "_log_read";
+    readonly METADATA_DATASET_READ: "_metadata_dataset_read";
+    readonly METADATA_DATASET_WRITE: "_metadata_dataset_write";
+    readonly METADATA_FIELD_GROUP_READ: "_metadata_field_group_read";
+    readonly METADATA_FIELD_GROUP_WRITE: "_metadata_field_group_write";
+    readonly METADATA_FIELD_READ: "_metadata_field_read";
+    readonly METADATA_FIELD_WRITE: "_metadata_field_write";
+    readonly METADATA_GLOBAL_READ: "_metadata_global_read";
+    readonly METADATA_GLOBAL_WRITE: "_metadata_global_write";
+    readonly METADATA_LOCK_READ: "_metadata_lock_read";
+    readonly METADATA_LOCK_WRITE: "_metadata_lock_write";
+    readonly METADATA_READ: "_metadata_read";
+    readonly METADATA_SCHEMA_READ: "_metadata_schema_read";
+    readonly METADATA_SCHEMA_WRITE: "_metadata_schema_write";
+    readonly METADATA_WRITE: "_metadata_write";
+    readonly OTIF_ANALYZE: "_otif_analyze";
+    readonly OTIF_READ: "_otif_read";
+    readonly OTIF_WRITE: "_otif_write";
+    readonly PLACEHOLDER_NOTIFICATION_READ: "_placeholder_notification_read";
+    readonly PLACEHOLDER_NOTIFICATION_WRITE: "_placeholder_notification_write";
+    readonly PROJECTION_READ: "_projection_read";
+    readonly PROJECTION_WRITE: "_projection_write";
+    readonly QUOTA_NOTIFICATION_READ: "_quota_notification_read";
+    readonly QUOTA_NOTIFICATION_WRITE: "_quota_notification_write";
+    readonly QUOTA_READ: "_quota_read";
+    readonly QUOTA_WRITE: "_quota_write";
+    readonly RELATION_READ: "_relation_read";
+    readonly RELATION_WRITE: "_relation_write";
+    readonly RESOURCE_READ: "_resource_read";
+    readonly RESOURCE_WRITE: "_resource_write";
+    readonly RUN_AS: "_run_as";
+    readonly SEARCH: "_search";
+    readonly SEQUENCE_READ: "_sequence_read";
+    readonly SEQUENCE_WRITE: "_sequence_write";
+    readonly SHAPE_TAG_READ: "_shape_tag_read";
+    readonly SHAPE_TAG_WRITE: "_shape_tag_write";
+    readonly SITE_MANAGER: "_site_manager";
+    readonly SITE_RULE_READ: "_site_rule_read";
+    readonly SITE_RULE_WRITE: "_site_rule_write";
+    readonly STORAGE_GROUP_READ: "_storage_group_read";
+    readonly STORAGE_GROUP_WRITE: "_storage_group_write";
+    readonly STORAGE_NOTIFICATION_READ: "_storage_notification_read";
+    readonly STORAGE_NOTIFICATION_WRITE: "_storage_notification_write";
+    readonly STORAGE_READ: "_storage_read";
+    readonly STORAGE_RULE_READ: "_storage_rule_read";
+    readonly STORAGE_RULE_WRITE: "_storage_rule_write";
+    readonly STORAGE_WRITE: "_storage_write";
+    readonly SUPER_ACCESS_USER: "_super_access_user";
+    readonly TASKDEFINITION_READ: "_taskdefinition_read";
+    readonly TASKDEFINITION_WRITE: "_taskdefinition_write";
+    readonly THUMBNAIL_READ: "_thumbnail_read";
+    readonly THUMBNAIL_WRITE: "_thumbnail_write";
+    readonly TRANSCODER: "_transcoder";
+    readonly TRANSFER_READ: "_transfer_read";
+    readonly TRANSFER_WRITE: "_transfer_write";
+    readonly USER: "_user";
+    readonly VXA: "_vxa";
+    readonly VXA_READ: "_vxa_read";
+};
+
+export declare type RoleNameTypes = keyof typeof ROLE_NAMES;
+
+/**
+ * Const object with media types
+ *
+ * @category Shape
+ */
+export declare const SHAPE_MEDIA_TYPES: {
+    readonly IMAGE: "IMAGE";
+    readonly AUDIO: "AUDIO";
+    readonly VIDEO: "VIDEO";
+    readonly DOCUMENT: "DOCUMENT";
+    readonly BINARY: "BINARY";
+};
+
+export declare type ShapeMediaType = keyof typeof SHAPE_MEDIA_TYPES;
+
+/**
+ * Array with all available VidiCore system/default field group names
+ *
+ * @category Metadata
+ */
+export declare const SYSTEM_FIELDGROUPS: readonly ["stl_subtitle", "stl_tti", "stl_gsi", "mrk_marker", "pho_validation", "pho_resource", "pho_error", "facedetect_rect", "facedetect_face", "originalTrackFilename", "stl_gsiHeader"];
+
+/**
+ * Array with all available VidiCore system/default field names (including transient)
+ *
+ * @category Metadata
+ */
+export declare const SYSTEM_FIELDS: readonly ["title", "user", "shapeTag", "representativeThumbnail", "representativeThumbnailNoAuth", "representativeItems", "itemId", "collectionId", "mediaType", "mimeType", "created", "startTimeCode", "startSeconds", "fieldValidationError", "schemaValidationError", "originalFilename", "originalUri", "originalAudioCodec", "originalVideoCodec", "originalHeight", "originalWidth", "originalFormat", "durationSeconds", "durationTimeCode", "solr-index", "__user", "__collection", "__collection_size", "__ancestor_collection", "__ancestor_collection_size", "__shape", "__shape_size", "__shape_last_added", "__placeholder_shape_size", "__version", "__version_count", "__storage", "__storage_size", "__shapetag_{tag}_hash_{hash}", "__storage_{tag}", "__storage_{tag}_size", "__storagegroup", "__storagegroup_size", "__sequence", "__sequence_size", "__metadata_last_modified", "__external_id", "__deletion_lock_id", "__deletion_lock_expiry", "__child_collection", "__child_collection_size", "__parent_collection", "__parent_collection_size", "__items_size", "stl_text", "stl_justification", "stl_xrelative", "stl_yrelative", "stl_vertical", "stl_verticalbase", "stl_horizontalbase", "stl_sizerelative", "stl_color", "stl_outline", "stl_outlinecolor", "stl_outlinesize", "stl_font", "stl_service", "stl_tti", "stl_gsi", "cct", "tcd", "tcf", "oet", "cd", "mnc", "cpn", "dfc", "tcp", "tcs", "tet", "tnb", "tnd", "en", "co", "tng", "rd", "mnr", "dsc", "opt", "lc", "tpt", "tn", "slr", "tns", "rn", "pub", "dsn", "ecd", "mrk_zerolength", "mrk_text", "mrk_color", "pho_resource_name", "pho_error_level", "pho_error_code", "pho_error_description", "facedetect_rect_width", "facedetect_rect_height", "facedetect_rect_y", "facedetect_rect_x", "facedetect_pid", "facedetect_rect", "trackId", "eidr_actor", "eidr_alternateId", "eidr_countryOfOrigin", "eidr_director", "eidr_id", "eidr_referentType", "eidr_releaseDate", "eidr_resourceName", "eidr_status", "eidr_sync", "ttml_div", "ttml_root", "vxa_collection_id", "vxaId", "vxaLocalPath", "tco", "cs", "ebn", "tf", "cf", "sgn", "tci", "jc", "vp", "sn"];
+
+/**
+ * TimeBase class representing the TimeBaseType in VidiCore
+ *
+ * For more info, see the [Time bases section in VidiCore API Docs](https://apidoc.vidispine.com/latest/time.html#time-bases)
+ *
+ * @category Time
+ */
+export declare class TimeBase {
+    /** The numerator for the TimeBase */
+    numerator: number;
+    /** The denominator for the TimeBase */
+    denominator: number;
+    /**
+     * Constructor for TimeBase
+     *
+     * @param timeBaseType A TimeBaseType object
+     */
+    constructor(timeBaseType?: TimeBaseInput);
+    /**
+     * Get TimeBase in a constant representation (e.g. "PAL") if possible, otherwise undefined
+     * @returns Constant representation of the TimeBase
+     */
+    toConstant(): string;
+    /**
+     * Get TimeBase as a VidiCore TimeBaseType string
+     *
+     * @remarks
+     * Default format: denominator(:numerator if > 1)
+     *
+     * `constant` has precedence over `fraction` if both are true (e.g. NTSC > 30000:1001)
+     *
+     * @param options For how to display it as text
+     * @returns Text representation of the TimeBase
+     */
+    toText(options?: {
+        /** Show time base as constant (e.g. PAL) */
+        constant?: boolean;
+        /** Show time base as fraction (25:1) even when numerator is 1 */
+        fraction?: boolean;
+    }): string;
+    /**
+     * Output TimeBase as frame rate (by default max 16 decimal places)
+     *
+     * @remarks
+     * Default format: rate with two decimals if needed (i.e. decimals are > 0)
+     *
+     * `rounded` has precedence over `fixed`
+     *
+     * @param options On how to return the rate
+     *
+     * @return Rate of the TimeBase
+     */
+    toRate(options?: {
+        /** Rounded to nearest integer */
+        rounded?: boolean;
+        /** Amount of decimal places
+         * - `true` two decimal places
+         * - `false` max amount of decimal places
+         * - `number` that amount of decimal places
+         */
+        fixed?: boolean | number;
+    }): number;
+    /**
+     * Get TimeBase in a object representation
+     *
+     * @returns TimeBase as `{denominator, numerator}` object
+     */
+    toObject(): TimeBaseType;
+    /**
+     * @deprecated Use {@link TimeBase#toObject | toObject} instead
+     *
+     * @returns TimeBase as `{denominator, numerator}` object
+     */
+    toJson(): TimeBaseType;
+}
+
+export declare type TimeBaseInput = {
+    /** The numerator for the TimeBase */
+    numerator?: number | string;
+    /** The denominator for the TimeBase */
+    denominator?: number | string;
+};
+
+/**
+ * TimeCode class representing the TimeCodeType in VidiCore
+ *
+ * For more info, see the [Time Codes section of VidiCore API Docs](https://apidoc.vidispine.com/latest/time.html#time-codes)
+ *
+ * @category Time
+ */
+export declare class TimeCode {
+    /** Amount of samples for the time code */
+    samples: number;
+    /** The time base for the time code */
+    timeBase: TimeBase;
+    /** If time code is dropFrame or not (by default checks timeBase) */
+    dropFrame: boolean;
+    /** Separator for frame in smpte output (default ":" for non dropFrame and ";" for dropFrame) */
+    frameSeparator: string;
+    /**
+     * Constructor for TimeCode
+     *
+     * @param timeCodeType Object to create TimeCode of
+     * @param options Options for the timeCode
+     */
+    constructor(timeCodeType: TimeCodeInput, options?: TimeCodeInputOptions);
+    /**
+     * Return this TimeCode added with the supplied timeCodeType
+     * - If time bases differ, it will retain the time base of this TimeCode instance
+     * - If supplied time code has a more granular time base, it will round down exceeding samples (hasn't reached that sample yet)
+     *
+     * @remarks
+     * If you don't want to "lose" frames in the manner described above, make sure time code you're operating on has higher time base granularity
+     *
+     * To exemplify:
+     * - "51@50".add("25@25") => "101@50"
+     * - while "25@25".add("51@50") => "50@25"
+     *
+     * @param timeCode A TimeCode instance you want to add with
+     * @returns A new TimeCode instance with the addition applied
+     */
+    add(timeCode: TimeCode): TimeCode;
+    /**
+     * Return this TimeCode subtracted with the supplied timeCodeType
+     * - If time bases differ, it will retain the time base of the instance time code
+     * - If supplied time code has a more granular time base, it will round down exceeding samples (hasn't reached that sample yet)
+     *
+     * @remarks
+     * If you don't want to "lose" frames in the manner described above, make sure time code you're operating on has higher time base granularity
+
+     * To exemplify:
+     * - "101@50".subtract("25@25") => "51@50"
+     * - while "50@25".subtract("51@50") => "25@25"
+     *
+     * @param timeCode A TimeCode instance you want to subtract with
+     * @returns A new TimeCode instance with the subtraction applied
+     */
+    subtract(timeCode: TimeCode): TimeCode;
+    /**
+     * Creates a new TimeCode instance with specified timeBase and samples adjusted to that.
+     *
+     * @remarks
+     * If it conforms to a less granular time base - it will floor samples (hasn't reached that sample yet)
+     * - e.g. "51@50".conformTo("PAL") => "25@PAL" (not "26@PAL")
+     *
+     * @param timeBase The TimeBase it should conform the TimeCode to
+     * @param options Explicitly set TimeCode options, by default these are derived from `timeBase`
+     * @returns A new TimeCode instance with the conformTo timeBase applied
+     */
+    conformTimeBase(timeBase: TimeCodeInput['timeBase'], options?: TimeCodeInputOptions): TimeCode;
+    /**
+     * Get TimeCode as a text representation
+     *
+     * @remarks
+     * Default format: `samples@denominator[:numerator (if > 1)])`
+     *
+     * `constant` has precedence over `fraction` if both are true
+     *
+     * @param options Options for how to format text
+     * @returns Text representation of TimeCode
+     */
+    toText(options?: {
+        /** Include time base even if seconds (i.e. append @1 or @1:1) */
+        includeTimeBaseForSeconds?: boolean;
+        /** show as constant (e.g. @PAL) */
+        constant?: boolean;
+        /** show as fraction (e.g. @25:1) */
+        fraction?: boolean;
+    }): string;
+    /**
+     * Get TimeCode in a units object representation
+     *
+     * @remarks
+     * If samples is `Infinity` it also returns `Infinity` for all units
+     *
+     * @returns Units (time and frames) for the time code
+     */
+    toUnits(): {
+        hours: number;
+        minutes: number;
+        seconds: number;
+        frames: number;
+    };
+    /**
+     * Get TimeCode in a time object representation
+     *
+     * Note: "milliseconds" is rounded down - use "partialSeconds" for another representation
+     *
+     * @returns Time for the time code
+     */
+    toTime(): {
+        hours: number;
+        minutes: number;
+        seconds: number;
+        milliseconds: number;
+        partialSeconds: number;
+    };
+    /**
+     * Get TimeCode in a seconds representation
+     *
+     * @returns Total seconds for the time code
+     */
+    toSeconds(): number;
+    /**
+     * Get TimeCode in a duration representation
+     *
+     * The time unit keys for the format string are:
+     * - `h` for hour
+     * - `m` for minute
+     * - `s` for seconds
+     * - `S` for milliseconds
+     * - Any other char will be kept in the duration output string
+     *
+     * Note: Add several consecutive chars for zero padding.
+     *
+     * By default it:
+     * - uses colon delimiter (e.g. for format "hhmmss")
+     * - shows "m:ss" or "h:mm:ss" if format is undefined
+     *
+     * @param options Options for how to display duration
+     * @returns Duration representation of the TimeCode
+     */
+    toDuration(options?: {
+        /** Specify format of duration string, (e.g. `hh:mm:ss.S` for "01:23:04.5") */
+        format?: string;
+    }): string;
+    /**
+     * Get TimeCode in a smpte representation
+     *
+     * @returns Smpte representation of the TimeCode
+     */
+    toSmpte(): string;
+    /**
+     * Get TimeCode as a VidiCore TimeCodeType object
+     *
+     * @returns  TimeCode as `{ samples, timeBase }`
+     */
+    toObject(): {
+        samples: number;
+        timeBase: RationalType;
+    };
+    /**
+     * @deprecated Use {@link TimeCode#toObject | toObject} instead
+     *
+     * @returns TimeCode as `{ samples, timeBase }`
+     */
+    toJson(): {
+        samples: number;
+        timeBase: RationalType;
+    };
+}
+
+export declare type TimeCodeInput = {
+    /** Amount of samples for the time code */
+    samples?: number | string;
+    /** The time base for the time code */
+    timeBase?: string | TimeBaseInput | TimeBase;
+};
+
+export declare type TimeCodeInputOptions = {
+    /** If time code is dropFrame or not (by default checks timeBase) */
+    dropFrame?: boolean;
+    /** Separator for frame in smpte output (default ":" for non-drop-frame and ";" for dropFrame) */
+    frameSeparator?: string;
+};
+
+export { }