@contentauth/c2pa-types 0.3.0 → 0.4.0

package/types/Builder.d.ts

@@ -5,28 +5,8 @@
  * and run json-schema-to-typescript to regenerate this file.
  */
 
-/**
- * Assertions in C2PA can be stored in several formats
- */
-export type ManifestAssertionKind = "Cbor" | "Json" | "Binary" | "Uri";
 export type UriOrResource = ResourceRef | HashedUri;
 export type DateT = string;
-/**
- * The type of shape for the range.
- */
-export type ShapeType = "rectangle" | "circle" | "polygon";
-/**
- * The type of unit for the range.
- */
-export type UnitType = "pixel" | "percent";
-/**
- * The type of time.
- */
-export type TimeType = "npt";
-/**
- * The type of range for the region of interest.
- */
-export type RangeType = "spatial" | "temporal" | "frame" | "textual" | "identified";
 /**
  * A role describing the region.
  */
@@ -41,13 +21,14 @@ export type Role =
   | "c2pa.styled"
   | "c2pa.watermarked";
 /**
- * The relationship of the ingredient to the current asset.
+ * Assertions in C2PA can be stored in several formats
  */
-export type Relationship = "parentOf" | "componentOf" | "inputTo";
+export type ManifestAssertionKind = "Cbor" | "Json" | "Binary" | "Uri";
 /**
  * Represents the type of builder flow being used.
  *
- * This determines how the builder will be used, such as creating a new asset, opening an existing asset, or updating an existing asset.
+ * This determines how the builder will be used, such as creating a new asset, opening an existing asset,
+ * or updating an existing asset.
  */
 export type BuilderIntent =
   | {
@@ -58,7 +39,9 @@ export type BuilderIntent =
 /**
  * Description of the source of an asset.
  *
- * The full list of possible digital source types are found below: <https://spec.c2pa.org/specifications/specifications/2.2/specs/C2PA_Specification.html#_digital_source_type> <https://cv.iptc.org/newscodes/digitalsourcetype>
+ * The full list of possible digital source types are found below:
+ * <https://spec.c2pa.org/specifications/specifications/2.2/specs/C2PA_Specification.html#_digital_source_type>
+ * <https://cv.iptc.org/newscodes/digitalsourcetype>
  */
 export type DigitalSourceType =
   | "http://c2pa.org/digitalsourcetype/empty"
@@ -83,101 +66,126 @@ export type DigitalSourceType =
   | "http://cv.iptc.org/newscodes/digitalsourcetype/composite"
   | "http://cv.iptc.org/newscodes/digitalsourcetype/compositeCapture"
   | "http://cv.iptc.org/newscodes/digitalsourcetype/compositeSynthetic"
-  | {
-      Other: string;
-    };
+  | string;
 
 /**
  * Use a Builder to add a signed manifest to an asset.
  *
  * # Example: Building and signing a manifest
  *
- * ```ignore-wasm32 use c2pa::Result; use std::path::PathBuf;
+ * ```ignore-wasm32
+ * use c2pa::Result;
+ * use std::path::PathBuf;
  *
- * use c2pa::{create_signer, Builder, SigningAlg}; use serde::Serialize; use serde_json::json; use tempfile::tempdir;
+ * use c2pa::{create_signer, Builder, SigningAlg};
+ * use serde::Serialize;
+ * use serde_json::json;
+ * use tempfile::tempdir;
  *
- * #[derive(Serialize)] struct Test { my_tag: usize, }
+ * #[derive(Serialize)]
+ * struct Test {
+ *     my_tag: usize,
+ * }
  *
- * # fn main() -> Result<()> { #[cfg(feature = "file_io")] { let manifest_json = json!({ "claim_generator_info": [ { "name": "c2pa_test", "version": "1.0.0" } ], "title": "Test_Manifest" }).to_string();
+ * # fn main() -> Result<()> {
+ * #[cfg(feature = "file_io")]
+ * {
+ *     let manifest_json = json!({
+ *        "claim_generator_info": [
+ *           {
+ *               "name": "c2pa_test",
+ *               "version": "1.0.0"
+ *           }
+ *        ],
+ *        "title": "Test_Manifest"
+ *     }).to_string();
  *
- * let mut builder = Builder::from_json(&manifest_json)?; builder.add_assertion("org.contentauth.test", &Test { my_tag: 42 })?;
+ *     let mut builder = Builder::from_json(&manifest_json)?;
+ *     builder.add_assertion("org.contentauth.test", &Test { my_tag: 42 })?;
  *
- * let source = PathBuf::from("tests/fixtures/C.jpg"); let dir = tempdir()?; let dest = dir.path().join("test_file.jpg");
+ *     let source = PathBuf::from("tests/fixtures/C.jpg");
+ *     let dir = tempdir()?;
+ *     let dest = dir.path().join("test_file.jpg");
  *
- * // Create a ps256 signer using certs and key files. TO DO: Update example. let signcert_path = "tests/fixtures/certs/ps256.pub"; let pkey_path = "tests/fixtures/certs/ps256.pem"; let signer = create_signer::from_files(signcert_path, pkey_path, SigningAlg::Ps256, None)?;
+ *     // Create a ps256 signer using certs and key files. TO DO: Update example.
+ *     let signcert_path = "tests/fixtures/certs/ps256.pub";
+ *     let pkey_path = "tests/fixtures/certs/ps256.pem";
+ *     let signer = create_signer::from_files(signcert_path, pkey_path, SigningAlg::Ps256, None)?;
  *
- * // embed a manifest using the signer builder.sign_file( signer.as_ref(), &source, &dest)?; } # Ok(()) # } ```
+ *     // embed a manifest using the signer
+ *     builder.sign_file(
+ *         signer.as_ref(),
+ *         &source,
+ *         &dest)?;
+ *     }
+ * # Ok(())
+ * # }
+ * ```
  */
 export interface Builder {
   /**
-   * A list of assertions
+   * The version of the claim.  Defaults to 2.
    */
-  assertions?: AssertionDefinition[];
+  claim_version?: number | null;
+  /**
+   * Optional prefix added to the generated Manifest Label
+   * This is typically a reverse domain name.
+   */
+  vendor?: string | null;
   /**
-   * Claim Generator Info is always required with at least one entry
+   * Claim Generator Info is always required with an entry
    */
   claim_generator_info?: ClaimGeneratorInfo[];
   /**
-   * The version of the claim.  Defaults to 2.
+   * Optional manifest metadata. This will be deprecated in the future; not recommended to use.
    */
-  claim_version?: number | null;
+  metadata?: AssertionMetadata[] | null;
   /**
-   * The format of the source file as a MIME type.
+   * A human-readable title, generally source filename.
    */
-  format?: string;
+  title?: string | null;
   /**
-   * A List of ingredients
+   * The format of the source file as a MIME type.
    */
-  ingredients?: Ingredient[];
+  format?: string;
   /**
    * Instance ID from `xmpMM:InstanceID` in XMP metadata.
    */
   instance_id?: string;
   /**
-   * A builder should construct a created, opened or updated manifest.
-   */
-  intent?: BuilderIntent | null;
-  /**
-   * Allows you to pre-define the manifest label, which must be unique. Not intended for general use.  If not set, it will be assigned automatically.
+   * An optional ResourceRef to a thumbnail image that represents the asset that was signed.
+   * Must be available when the manifest is signed.
    */
-  label?: string | null;
+  thumbnail?: ResourceRef | null;
   /**
-   * Optional manifest metadata. This will be deprecated in the future; not recommended to use.
+   * A List of ingredients
    */
-  metadata?: AssertionMetadata[] | null;
+  ingredients?: Ingredient[];
   /**
-   * If true, the manifest store will not be embedded in the asset on sign
+   * A list of assertions
    */
-  no_embed: boolean;
+  assertions?: AssertionDefinition[];
   /**
    * A list of redactions - URIs to redacted assertions.
    */
   redactions?: string[] | null;
   /**
-   * Optional remote URL for the manifest
+   * Allows you to pre-define the manifest label, which must be unique.
+   * Not intended for general use.  If not set, it will be assigned automatically.
    */
-  remote_url?: string | null;
+  label?: string | null;
   /**
-   * An optional ResourceRef to a thumbnail image that represents the asset that was signed. Must be available when the manifest is signed.
+   * Optional remote URL for the manifest
    */
-  thumbnail?: ResourceRef | null;
+  remote_url?: string | null;
   /**
-   * A human-readable title, generally source filename.
+   * If true, the manifest store will not be embedded in the asset on sign
    */
-  title?: string | null;
+  no_embed: boolean;
   /**
-   * Optional prefix added to the generated Manifest Label This is typically a reverse domain name.
+   * A builder should construct a created, opened or updated manifest.
    */
-  vendor?: string | null;
-  [k: string]: unknown;
-}
-/**
- * Defines an assertion that consists of a label that can be either a C2PA-defined assertion label or a custom label in reverse domain format.
- */
-export interface AssertionDefinition {
-  data: unknown;
-  kind?: ManifestAssertionKind | null;
-  label: string;
+  intent?: BuilderIntent | null;
   [k: string]: unknown;
 }
 /**
@@ -186,22 +194,22 @@ export interface AssertionDefinition {
  * This structure is also used for actions softwareAgent
  */
 export interface ClaimGeneratorInfo {
-  /**
-   * hashed URI to the icon (either embedded or remote)
-   */
-  icon?: UriOrResource | null;
   /**
    * A human readable string naming the claim_generator
    */
   name: string;
-  /**
-   * A human readable string of the OS the claim generator is running on
-   */
-  operating_system?: string | null;
   /**
    * A human readable string of the product's version
    */
   version?: string | null;
+  /**
+   * hashed URI to the icon (either embedded or remote)
+   */
+  icon?: UriOrResource | null;
+  /**
+   * A human readable string of the OS the claim generator is running on
+   */
+  operating_system?: string | null;
   [k: string]: unknown;
 }
 /**
@@ -211,27 +219,29 @@ export interface ClaimGeneratorInfo {
  */
 export interface ResourceRef {
   /**
-   * The algorithm used to hash the resource (if applicable).
+   * The mime type of the referenced resource.
    */
-  alg?: string | null;
+  format: string;
+  /**
+   * A URI that identifies the resource as referenced from the manifest.
+   *
+   * This may be a JUMBF URI, a file path, a URL or any other string.
+   * Relative JUMBF URIs will be resolved with the manifest label.
+   * Relative file paths will be resolved with the base path if provided.
+   */
+  identifier: string;
   /**
    * More detailed data types as defined in the C2PA spec.
    */
   data_types?: AssetType[] | null;
   /**
-   * The mime type of the referenced resource.
+   * The algorithm used to hash the resource (if applicable).
    */
-  format: string;
+  alg?: string | null;
   /**
    * The hash of the resource (if applicable).
    */
   hash?: string | null;
-  /**
-   * A URI that identifies the resource as referenced from the manifest.
-   *
-   * This may be a JUMBF URI, a file path, a URL or any other string. Relative JUMBF URIs will be resolved with the manifest label. Relative file paths will be resolved with the base path if provided.
-   */
-  identifier: string;
   [k: string]: unknown;
 }
 export interface AssetType {
@@ -240,125 +250,38 @@ export interface AssetType {
   [k: string]: unknown;
 }
 /**
- * A `HashedUri` provides a reference to content available within the same manifest store.
+ * A `HashedUri` provides a reference to content available within the same
+ * manifest store.
  *
- * This is described in [§8.3, URI References], of the C2PA Technical Specification.
+ * This is described in [§8.3, URI References], of the C2PA Technical
+ * Specification.
  *
  * [§8.3, URI References]: https://c2pa.org/specifications/specifications/2.1/specs/C2PA_Specification.html#_uri_references
  */
 export interface HashedUri {
-  /**
-   * A string identifying the cryptographic hash algorithm used to compute the hash
-   */
-  alg?: string | null;
-  /**
-   * Byte string containing the hash value
-   */
-  hash: number[];
   /**
    * JUMBF URI reference
    */
   url: string;
-  [k: string]: unknown;
-}
-/**
- * An `Ingredient` is any external asset that has been used in the creation of an asset.
- */
-export interface Ingredient {
-  /**
-   * The active manifest label (if one exists).
-   *
-   * If this ingredient has a [`ManifestStore`], this will hold the label of the active [`Manifest`].
-   *
-   * [`Manifest`]: crate::Manifest [`ManifestStore`]: crate::ManifestStore
-   */
-  active_manifest?: string | null;
-  /**
-   * A reference to the actual data of the ingredient.
-   */
-  data?: ResourceRef | null;
-  /**
-   * Additional information about the data's type to the ingredient V2 structure.
-   */
-  data_types?: AssetType[] | null;
-  /**
-   * Additional description of the ingredient.
-   */
-  description?: string | null;
-  /**
-   * Document ID from `xmpMM:DocumentID` in XMP metadata.
-   */
-  document_id?: string | null;
-  /**
-   * The format of the source file as a MIME type.
-   */
-  format?: string | null;
-  /**
-   * An optional hash of the asset to prevent duplicates.
-   */
-  hash?: string | null;
-  /**
-   * URI to an informational page about the ingredient or its data.
-   */
-  informational_URI?: string | null;
-  /**
-   * Instance ID from `xmpMM:InstanceID` in XMP metadata.
-   */
-  instance_id?: string | null;
-  /**
-   * The ingredient's label as assigned in the manifest.
-   */
-  label?: string | null;
-  /**
-   * A [`ManifestStore`] from the source asset extracted as a binary C2PA blob.
-   *
-   * [`ManifestStore`]: crate::ManifestStore
-   */
-  manifest_data?: ResourceRef | null;
-  /**
-   * Any additional [`Metadata`] as defined in the C2PA spec.
-   *
-   * [`Metadata`]: crate::Metadata
-   */
-  metadata?: AssertionMetadata | null;
-  ocsp_responses?: ResourceRef[] | null;
-  /**
-   * URI from `dcterms:provenance` in XMP metadata.
-   */
-  provenance?: string | null;
-  /**
-   * Set to `ParentOf` if this is the parent ingredient.
-   *
-   * There can only be one parent ingredient in the ingredients.
-   */
-  relationship?: Relationship & string;
-  resources?: ResourceStore;
-  /**
-   * A thumbnail image capturing the visual state at the time of import.
-   *
-   * A tuple of thumbnail MIME format (for example `image/jpeg`) and binary bits of the image.
-   */
-  thumbnail?: ResourceRef | null;
-  /**
-   * A human-readable title, generally source filename.
-   */
-  title?: string | null;
   /**
-   * Validation results (Ingredient.V3)
+   * A string identifying the cryptographic hash algorithm used to compute
+   * the hash
    */
-  validation_results?: ValidationResults | null;
+  alg?: string | null;
   /**
-   * Validation status (Ingredient v1 & v2)
+   * Byte string containing the hash value
    */
-  validation_status?: ValidationStatus[] | null;
+  hash: number[];
   [k: string]: unknown;
 }
 /**
  * The AssertionMetadata structure can be used as part of other assertions or on its own to reference others
  */
 export interface AssertionMetadata {
-  dataSource?: DataSource | null;
+  reviewRatings?: ReviewRating[] | null;
   dateTime?: DateT | null;
+  reference?: HashedUri | null;
+  dataSource?: DataSource | null;
   localizations?:
     | {
         [k: string]: {
@@ -366,9 +289,18 @@ export interface AssertionMetadata {
         };
       }[]
     | null;
-  reference?: HashedUri | null;
   regionOfInterest?: RegionOfInterest | null;
-  reviewRatings?: ReviewRating[] | null;
+  [k: string]: unknown;
+}
+/**
+ * A rating on an Assertion.
+ *
+ * See <https://c2pa.org/specifications/specifications/2.2/specs/C2PA_Specification.html#_review_ratings>.
+ */
+export interface ReviewRating {
+  explanation: string;
+  code?: string | null;
+  value: number;
   [k: string]: unknown;
 }
 /**
@@ -376,137 +308,124 @@ export interface AssertionMetadata {
  */
 export interface DataSource {
   /**
-   * A list of [`Actor`]s associated with this source.
+   * A value from among the enumerated list indicating the source of the assertion.
    */
-  actors?: Actor[] | null;
+  type: string;
   /**
    * A human-readable string giving details about the source of the assertion data.
    */
   details?: string | null;
   /**
-   * A value from among the enumerated list indicating the source of the assertion.
+   * A list of [`Actor`]s associated with this source.
    */
-  type: string;
+  actors?: Actor[] | null;
   [k: string]: unknown;
 }
 /**
  * Identifies a person responsible for an action.
  */
 export interface Actor {
-  /**
-   * List of references to W3C Verifiable Credentials.
-   */
-  credentials?: HashedUri[] | null;
   /**
    * An identifier for a human actor, used when the "type" is `humanEntry.identified`.
    */
   identifier?: string | null;
+  /**
+   * List of references to W3C Verifiable Credentials.
+   */
+  credentials?: HashedUri[] | null;
   [k: string]: unknown;
 }
 /**
  * A region of interest within an asset describing the change.
  *
- * This struct can be used from [`Action::changes`][crate::assertions::Action::changes], [`AssertionMetadata::region_of_interest`][crate::assertions::AssertionMetadata::region_of_interest], or [`SoftBindingScope::region`][crate::assertions::soft_binding::SoftBindingScope::region].
+ * This struct can be used from [`Action::changes`][crate::assertions::Action::changes],
+ * [`AssertionMetadata::region_of_interest`][crate::assertions::AssertionMetadata::region_of_interest], or
+ * [`SoftBindingScope::region`][crate::assertions::soft_binding::SoftBindingScope::region].
  */
 export interface RegionOfInterest {
   /**
-   * A free-text string.
-   */
-  description?: string | null;
-  /**
-   * A free-text string representing a machine-readable, unique to this assertion, identifier for the region.
-   */
-  identifier?: string | null;
-  /**
-   * Additional information about the asset.
+   * A range describing the region of interest for the specific asset.
    */
-  metadata?: AssertionMetadata | null;
+  region: Range[];
   /**
    * A free-text string representing a human-readable name for the region which might be used in a user interface.
    */
   name?: string | null;
   /**
-   * A range describing the region of interest for the specific asset.
-   */
-  region: Range[];
-  /**
-   * A value from our controlled vocabulary or an entity-specific value (e.g., com.litware.coolArea) that represents the role of a region among other regions.
+   * A free-text string representing a machine-readable, unique to this assertion, identifier for the region.
    */
-  role?: Role | null;
+  identifier?: string | null;
   /**
-   * A value from a controlled vocabulary such as <https://cv.iptc.org/newscodes/imageregiontype/> or an entity-specific value (e.g., com.litware.newType) that represents the type of thing(s) depicted by a region.
+   * A value from a controlled vocabulary such as <https://cv.iptc.org/newscodes/imageregiontype/> or an entity-specific
+   * value (e.g., com.litware.newType) that represents the type of thing(s) depicted by a region.
    *
    * Note this field serializes/deserializes into the name `type`.
    */
   type?: string | null;
-  [k: string]: unknown;
-}
-/**
- * A spatial, temporal, frame, or textual range describing the region of interest.
- */
-export interface Range {
   /**
-   * A frame range.
+   * A value from our controlled vocabulary or an entity-specific value (e.g., com.litware.coolArea) that represents
+   * the role of a region among other regions.
    */
-  frame?: Frame | null;
+  role?: Role | null;
   /**
-   * A item identifier.
+   * A free-text string.
    */
-  item?: Item | null;
+  description?: string | null;
   /**
-   * A spatial range.
+   * Additional information about the asset.
    */
-  shape?: Shape | null;
+  metadata?: AssertionMetadata | null;
+  [k: string]: unknown;
+}
+/**
+ * A spatial, temporal, frame, or textual range describing the region of interest.
+ */
+export interface Range {
   /**
-   * A textual range.
+   * The type of range of interest.
    */
-  text?: Text | null;
+  type: "spatial" | "temporal" | "frame" | "textual" | "identified";
+  /**
+   * A spatial range.
+   */
+  shape?: Shape | null;
   /**
    * A temporal range.
    */
   time?: Time | null;
   /**
-   * The type of range of interest.
+   * A frame range.
    */
-  type: RangeType;
-  [k: string]: unknown;
-}
-/**
- * A frame range representing starting and ending frames or pages.
- *
- * If both `start` and `end` are missing, the frame will span the entire asset.
- */
-export interface Frame {
+  frame?: Frame | null;
   /**
-   * The end of the frame inclusive or the end of the asset if not present.
+   * A textual range.
    */
-  end?: number | null;
+  text?: Text | null;
   /**
-   * The start of the frame or the end of the asset if not present.
-   *
-   * The first frame/page starts at 0.
+   * A item identifier.
    */
-  start?: number | null;
+  item?: Item | null;
   [k: string]: unknown;
 }
 /**
- * Description of the boundaries of an identified range.
+ * A spatial range representing rectangle, circle, or a polygon.
  */
-export interface Item {
+export interface Shape {
   /**
-   * The container-specific term used to identify items, such as "track_id" for MP4 or "item_ID" for HEIF.
+   * The type of shape.
    */
-  identifier: string;
+  type: "rectangle" | "circle" | "polygon";
   /**
-   * The value of the identifier, e.g. a value of "2" for an identifier of "track_id" would imply track 2 of the asset.
+   * The type of unit for the shape range.
    */
-  value: string;
-  [k: string]: unknown;
-}
-/**
- * A spatial range representing rectangle, circle, or a polygon.
- */
-export interface Shape {
+  unit: "pixel" | "percent";
+  origin: Coordinate;
+  /**
+   * The width for rectangles or diameter for circles.
+   *
+   * This field can be ignored for polygons.
+   */
+  width?: number | null;
   /**
    * The height of a rectnagle.
    *
@@ -519,36 +438,32 @@ export interface Shape {
    * The default value is true.
    */
   inside?: boolean | null;
-  /**
-   * THe origin of the coordinate in the shape.
-   */
-  origin: Coordinate;
-  /**
-   * The type of shape.
-   */
-  type: ShapeType;
-  /**
-   * The type of unit for the shape range.
-   */
-  unit: UnitType;
   /**
    * The vertices of the polygon.
    *
    * This field can be ignored for rectangles and circles.
    */
-  vertices?: Coordinate[] | null;
+  vertices?: Coordinate1[] | null;
+  [k: string]: unknown;
+}
+/**
+ * THe origin of the coordinate in the shape.
+ */
+export interface Coordinate {
+  /**
+   * The coordinate along the x-axis.
+   */
+  x: number;
   /**
-   * The width for rectangles or diameter for circles.
-   *
-   * This field can be ignored for polygons.
+   * The coordinate along the y-axis.
    */
-  width?: number | null;
+  y: number;
   [k: string]: unknown;
 }
 /**
  * An x, y coordinate used for specifying vertices in polygons.
  */
-export interface Coordinate {
+export interface Coordinate1 {
   /**
    * The coordinate along the x-axis.
    */
@@ -559,6 +474,42 @@ export interface Coordinate {
   y: number;
   [k: string]: unknown;
 }
+/**
+ * A temporal range representing a starting time to an ending time.
+ */
+export interface Time {
+  /**
+   * The type of time.
+   */
+  type?: "npt";
+  /**
+   * The start time or the start of the asset if not present.
+   */
+  start?: string | null;
+  /**
+   * The end time or the end of the asset if not present.
+   */
+  end?: string | null;
+  [k: string]: unknown;
+}
+/**
+ * A frame range representing starting and ending frames or pages.
+ *
+ * If both `start` and `end` are missing, the frame will span the entire asset.
+ */
+export interface Frame {
+  /**
+   * The start of the frame or the end of the asset if not present.
+   *
+   * The first frame/page starts at 0.
+   */
+  start?: number | null;
+  /**
+   * The end of the frame inclusive or the end of the asset if not present.
+   */
+  end?: number | null;
+  [k: string]: unknown;
+}
 /**
  * A textual range representing multiple (possibly discontinuous) ranges of text.
  */
@@ -573,26 +524,37 @@ export interface Text {
  * One or two [`TextSelector`][TextSelector] identifiying the range to select.
  */
 export interface TextSelectorRange {
+  selector: TextSelector;
   /**
    * The end of the text range.
    */
-  end?: TextSelector | null;
-  /**
-   * The start (or entire) text range.
-   */
-  selector: TextSelector;
+  end?: TextSelector1 | null;
   [k: string]: unknown;
 }
 /**
- * Selects a range of text via a fragment identifier.
- *
- * This is modeled after the W3C Web Annotation selector model.
+ * The start (or entire) text range.
  */
 export interface TextSelector {
+  /**
+   * Fragment identifier as per RFC3023 (XML) or ISO 32000-2 (PDF), Annex O.
+   */
+  fragment: string;
+  /**
+   * The start character offset or the start of the fragment if not present.
+   */
+  start?: number | null;
   /**
    * The end character offset or the end of the fragment if not present.
    */
   end?: number | null;
+  [k: string]: unknown;
+}
+/**
+ * Selects a range of text via a fragment identifier.
+ *
+ * This is modeled after the W3C Web Annotation selector model.
+ */
+export interface TextSelector1 {
   /**
    * Fragment identifier as per RFC3023 (XML) or ISO 32000-2 (PDF), Annex O.
    */
@@ -601,54 +563,148 @@ export interface TextSelector {
    * The start character offset or the start of the fragment if not present.
    */
   start?: number | null;
+  /**
+   * The end character offset or the end of the fragment if not present.
+   */
+  end?: number | null;
   [k: string]: unknown;
 }
 /**
- * A temporal range representing a starting time to an ending time.
+ * Description of the boundaries of an identified range.
  */
-export interface Time {
-  /**
-   * The end time or the end of the asset if not present.
-   */
-  end?: string | null;
+export interface Item {
   /**
-   * The start time or the start of the asset if not present.
+   * The container-specific term used to identify items, such as "track_id" for MP4 or "item_ID" for HEIF.
    */
-  start?: string | null;
+  identifier: string;
   /**
-   * The type of time.
+   * The value of the identifier, e.g. a value of "2" for an identifier of "track_id" would imply track 2 of the asset.
    */
-  type?: TimeType & string;
+  value: string;
   [k: string]: unknown;
 }
 /**
- * A rating on an Assertion.
- *
- * See <https://c2pa.org/specifications/specifications/2.2/specs/C2PA_Specification.html#_review_ratings>.
+ * An `Ingredient` is any external asset that has been used in the creation of an asset.
  */
-export interface ReviewRating {
-  code?: string | null;
-  explanation: string;
-  value: number;
+export interface Ingredient {
+  /**
+   * A human-readable title, generally source filename.
+   */
+  title?: string | null;
+  /**
+   * The format of the source file as a MIME type.
+   */
+  format?: string | null;
+  /**
+   * Document ID from `xmpMM:DocumentID` in XMP metadata.
+   */
+  document_id?: string | null;
+  /**
+   * Instance ID from `xmpMM:InstanceID` in XMP metadata.
+   */
+  instance_id?: string | null;
+  /**
+   * URI from `dcterms:provenance` in XMP metadata.
+   */
+  provenance?: string | null;
+  /**
+   * A thumbnail image capturing the visual state at the time of import.
+   *
+   * A tuple of thumbnail MIME format (for example `image/jpeg`) and binary bits of the image.
+   */
+  thumbnail?: ResourceRef | null;
+  /**
+   * An optional hash of the asset to prevent duplicates.
+   */
+  hash?: string | null;
+  /**
+   * Set to `ParentOf` if this is the parent ingredient.
+   *
+   * There can only be one parent ingredient in the ingredients.
+   */
+  relationship?: "parentOf" | "componentOf" | "inputTo";
+  /**
+   * The active manifest label (if one exists).
+   *
+   * If this ingredient has a [`ManifestStore`],
+   * this will hold the label of the active [`Manifest`].
+   *
+   * [`Manifest`]: crate::Manifest
+   * [`ManifestStore`]: crate::ManifestStore
+   */
+  active_manifest?: string | null;
+  /**
+   * Validation status (Ingredient v1 & v2)
+   */
+  validation_status?: ValidationStatus[] | null;
+  /**
+   * Validation results (Ingredient.V3)
+   */
+  validation_results?: ValidationResults | null;
+  /**
+   * A reference to the actual data of the ingredient.
+   */
+  data?: ResourceRef | null;
+  /**
+   * Additional description of the ingredient.
+   */
+  description?: string | null;
+  /**
+   * URI to an informational page about the ingredient or its data.
+   */
+  informational_URI?: string | null;
+  /**
+   * Any additional [`Metadata`] as defined in the C2PA spec.
+   *
+   * [`Metadata`]: crate::Metadata
+   */
+  metadata?: AssertionMetadata | null;
+  /**
+   * Additional information about the data's type to the ingredient V2 structure.
+   */
+  data_types?: AssetType[] | null;
+  /**
+   * A [`ManifestStore`] from the source asset extracted as a binary C2PA blob.
+   *
+   * [`ManifestStore`]: crate::ManifestStore
+   */
+  manifest_data?: ResourceRef | null;
+  /**
+   * The ingredient's label as assigned in the manifest.
+   */
+  label?: string | null;
+  ocsp_responses?: ResourceRef[] | null;
   [k: string]: unknown;
 }
 /**
- * Resource store to contain binary objects referenced from JSON serializable structures
+ * A `ValidationStatus` struct describes the validation status of a
+ * specific part of a manifest.
+ *
+ * See <https://c2pa.org/specifications/specifications/2.2/specs/C2PA_Specification.html#_existing_manifests>.
  */
-export interface ResourceStore {
-  label?: string | null;
-  resources: {
-    [k: string]: number[];
-  };
+export interface ValidationStatus {
+  code: string;
+  url?: string | null;
+  explanation?: string | null;
+  success?: boolean | null;
   [k: string]: unknown;
 }
 /**
  * A map of validation results for a manifest store.
  *
- * The map contains the validation results for the active manifest and any ingredient deltas. It is normal for there to be many
+ * The map contains the validation results for the active manifest and any ingredient deltas.
+ * It is normal for there to be many
  */
 export interface ValidationResults {
+  /**
+   * Validation status codes for the ingredient's active manifest. Present if ingredient is a C2PA
+   * asset. Not present if the ingredient is not a C2PA asset.
+   */
   activeManifest?: StatusCodes | null;
+  /**
+   * List of any changes/deltas between the current and previous validation results for each ingredient's
+   * manifest. Present if the the ingredient is a C2PA asset.
+   */
   ingredientDeltas?: IngredientDeltaValidationResult[] | null;
   [k: string]: unknown;
 }
@@ -656,21 +712,15 @@ export interface ValidationResults {
  * Contains a set of success, informational, and failure validation status codes.
  */
 export interface StatusCodes {
-  failure: ValidationStatus[];
-  informational: ValidationStatus[];
+  /**
+   * An array of validation success codes. May be empty.
+   */
   success: ValidationStatus[];
-  [k: string]: unknown;
-}
-/**
- * A `ValidationStatus` struct describes the validation status of a specific part of a manifest.
- *
- * See <https://c2pa.org/specifications/specifications/2.2/specs/C2PA_Specification.html#_existing_manifests>.
- */
-export interface ValidationStatus {
-  code: string;
-  explanation?: string | null;
-  success?: boolean | null;
-  url?: string | null;
+  /**
+   * An array of validation informational codes. May be empty.
+   */
+  informational: ValidationStatus[];
+  failure: ValidationStatus[];
   [k: string]: unknown;
 }
 /**
@@ -681,9 +731,41 @@ export interface IngredientDeltaValidationResult {
    * JUMBF URI reference to the ingredient assertion
    */
   ingredientAssertionURI: string;
+  validationDeltas: StatusCodes1;
+  [k: string]: unknown;
+}
+/**
+ * Contains a set of success, informational, and failure validation status codes.
+ */
+export interface StatusCodes1 {
+  /**
+   * An array of validation success codes. May be empty.
+   */
+  success: ValidationStatus[];
+  /**
+   * An array of validation informational codes. May be empty.
+   */
+  informational: ValidationStatus[];
+  failure: ValidationStatus[];
+  [k: string]: unknown;
+}
+/**
+ * Defines an assertion that consists of a label that can be either
+ * a C2PA-defined assertion label or a custom label in reverse domain format.
+ */
+export interface AssertionDefinition {
+  /**
+   * An assertion label in reverse domain format
+   */
+  label: string;
+  data: unknown;
+  /**
+   * The kind of assertion data, either Cbor or Json (defaults to Cbor)
+   */
+  kind?: ManifestAssertionKind | null;
   /**
-   * Validation results for the ingredient's active manifest
+   * True if this assertion is attributed to the signer (defaults to false)
    */
-  validationDeltas: StatusCodes;
+  created?: boolean;
   [k: string]: unknown;
 }