<?xml version="1.0" encoding="utf-8"?> encoding="UTF-8"?>

<!DOCTYPE rfc [
<!ENTITY nbsp "&#160;">
<!ENTITY zwsp "&#8203;">
<!ENTITY nbhy "&#8209;">
<!ENTITY wj "&#8288;">
]>
<?xml-stylesheet type="text/xsl" href="rfc2629.xslt"?>
<?rfc toc="yes"?>
<?rfc tocompact="yes"?>
<?rfc tocdepth="4"?>
<?rfc compact="yes"?>
<?rfc subcompact="yes"?>
<?rfc sortrefs="yes"?>
<?rfc symrefs="yes"?>
<?rfc iprnotified="no"?>

<rfc xmlns:xi="http://www.w3.org/2001/XInclude" submissionType="IETF" category="std" consensus="true" docName="draft-ietf-calext-jscontact-vcard-13" docName="draft-ietf-calext-jscontact-vcard-14" number="9555" ipr="pre5378Trust200902" tocInclude="true" tocDepth="4" sortRefs="true" symRefs="true" updates="6350" obsoletes="" xml:lang="en" version="3">

  <!-- xml2rfc v2v3 conversion 3.12.10 -->
  <front>
    <title abbrev="jscontact-vcard">JSContact: abbrev="JSContact: Converting from and to vCard">JSContact: Converting from and to vCard</title>
    <seriesInfo name="Internet-Draft" value="draft-ietf-calext-jscontact-vcard-13"/> name="RFC" value="9555"/>
    <author fullname="Mario Loffredo" initials="M." surname="Loffredo">
      <organization>IIT-CNR/Registro.it</organization>
      <address>
        <postal>
          <street>Via Moruzzi,1</street> Moruzzi, 1</street>
          <city>Pisa</city>
          <country>IT</country>
          <country>Italy</country>
          <code>56124</code>
        </postal>
        <email>mario.loffredo@iit.cnr.it</email>
        <uri>https://www.iit.cnr.it</uri>
      </address>
    </author>
    <author fullname="Robert Stepanek" initials="R." surname="Stepanek">
      <organization>Fastmail</organization>
      <address>
        <postal>
          <street>PO
	  <extaddr>PO Box 234, Collins St 234</extaddr>
          <street>Collins St. West</street>
          <city>Melbourne</city>
          <country>AU</country>
          <code>VIC 8007</code>
	  <region>VIC</region>
          <code>8007</code>
	  <country>Australia</country>
        </postal>
        <email>rsto@fastmailteam.com</email>
        <uri>https://www.fastmail.com</uri>
      </address>
    </author>
    <date year="2023" month="September" day="18"/>
    <area>Applications</area> year="2024" month="April"/>
    <area>art</area>
    <workgroup>calext</workgroup>
    <keyword>JSON</keyword>
    <keyword>contacts</keyword>
    <keyword>vCard</keyword>
    <keyword>jCard</keyword>
    <abstract>
      <t>This document defines how to convert contact information between the JSContact and vCard data formats.  To achieve this, it updates RFC I-D.ietf-calext-jscontact (JSContact) by registering new  It defines conversion rules for every JSContact properties.  Similarly, it updates RFC 6350 (vCard) by registering and vCard element registered at IANA at the time of publication.  It also defines new JSContact properties as well as vCard properties and parameters.</t> parameters, to support converting arbitrary or unknown JSContact and vCard elements.</t>
    </abstract>
  </front>
  <middle>
    <section>
      <name>Introduction</name>
      <section>
        <name>Motivation</name>
        <t>The JSContact data model and format <xref target="I-D.ietf-calext-jscontact"/> target="RFC9553"/> aims to be an alternative to the widely used vCard standard <xref target="RFC6350"/> standard and jCard format <xref target="RFC7095"/>.</t>
        <t>While applications might prefer JSContact to exchange contact card data with other systems, they are likely to interoperate with services and clients that only support vCard or jCard.  Similarly, existing contact data providers and consumers already using vCard or jCard might also want to represent their contact data also in JSContact.</t>
        <t>To achieve this, this document defines standard rules to convert contact data between JSContact and vCard (and consequently jCard). </t>
      </section>
      <section anchor="notational-conventions" numbered="true" toc="default">
        <name>Notational Conventions</name>
        <t>The key words "<bcp14>MUST</bcp14>", "<bcp14>MUST NOT</bcp14>", "<bcp14>REQUIRED</bcp14>", "<bcp14>SHALL</bcp14>", "<bcp14>SHALL NOT</bcp14>", "<bcp14>SHOULD</bcp14>", "<bcp14>SHOULD NOT</bcp14>", "<bcp14>RECOMMENDED</bcp14>", "<bcp14>NOT RECOMMENDED</bcp14>", "<bcp14>MAY</bcp14>", and "<bcp14>OPTIONAL</bcp14>" in this document are to be interpreted as described in BCP 14 BCP 14 <xref target="RFC2119" format="default" sectionFormat="of" derivedContent="RFC2119"/> <xref target="RFC8174" format="default" sectionFormat="of" derivedContent="RFC8174"/> when, and only when, they appear in all capitals, as shown here.</t>
      </section>
      <section anchor="abnf-notations">
        <name>ABNF Notations</name>
        <t>The ABNF definitions in this document use the notations of <xref target="RFC5234"/>. ABNF rules not defined in this document either are defined in either <xref target="RFC5234"/> (such as the ABNF for CRLF, WSP, DQUOTE, VCHAR, ALPHA, and DIGIT) or <xref target="RFC6350"/>.
    </t>
      </section>
    </section>
    <section anchor="vcard-jscontact-conversion">
      <name>Converting vCard to JSContact</name>
      <t>This section contains the conversion rules from the vCard to the JSContact Card.  It follows the same structure as the vCard v4 <xref target="RFC6350">vCard v4</xref>. target="RFC6350"/>.  Properties and parameters of vCard extension RFCs, including the those described in "vCard Format Extension for JSContact" <xref target="I-D.ietf-calext-vcard-jscontact-extensions">vCard JSContact Extension</xref> are target="RFC9554"/>, have been added to the appropriate subsections.</t>
      <section>
        <name>General rules</name> Rules</name>
        <section>
          <name>The <tt>uid</tt> property</name> Card uid Property</name>
          <t>The UID property (<xref target="RFC6350" derivedContent="RFC6350" section="6.7.6" sectionFormat="of"/>) in vCard is optional, but the <tt>uid</tt> Card object's uid property in JSContact (<xref target="RFC9553" derivedContent="RFC9553" section="2.1.9" sectionFormat="of"/>) is mandatory.  Implementations that convert a vCard without a UID property <bcp14>MUST</bcp14> generate a unique identifier as a value for the <tt>uid</tt> uid property.  This value <bcp14>SHOULD</bcp14> be the same when converting the same vCard multiple times, but how to achieve this is implementation-specific.</t>
        </section>
        <section>
          <name>Choosing identifiers</name> Identifiers</name>
          <t>Multivalued properties in JSContact typically are typically represented as a JSON object where the object keys are of the <tt>Id</tt> Id type (<xref target="RFC9553" derivedContent="RFC9553" section="1.4.1" sectionFormat="of"/>) and the object values are the converted vCard property.  In the absence of the PROP-ID parameter (see <xref target="vcard-param-propid"/>), implementations are free to choose any identifier as key for such entries.  Whatever identifier generation scheme implementations use, they <bcp14>MUST</bcp14> generate values that are valid according to the definition of the <tt>Id</tt> Id type in <xref target="I-D.ietf-calext-jscontact"/>. target="RFC9553"/>.  For example, this could be an incrementing number across all <tt>Id</tt>s identifier keys in the Card object or only unique within one JSON object.</t>
        </section>
      </section>
      <section anchor="vcard-types">
        <name>vCard Value Data Types</name>
        <section>
          <name>BOOLEAN</name>
          <t>This
          <t>The BOOLEAN type (<xref target="RFC6350" derivedContent="RFC6350" section="4.4" sectionFormat="of"/>) converts to the JSContact <tt>Boolean</tt> type.</t> Boolean type (<xref target="RFC9553" derivedContent="RFC9553" section="1.3.2" sectionFormat="of"/>).</t>
        </section>
        <section anchor="vcard-type-datetime">
          <name>DATE, TIME, DATE-TIME, DATE-AND-OR-TIME, and TIMESTAMP</name>
          <t>The TIMESTAMP type generally (<xref target="RFC6350" derivedContent="RFC6350" section="4.3.5" sectionFormat="of"/>) converts to the <tt>UTCDateTime</tt>. It UTCDateTime type (<xref target="RFC9553" derivedContent="RFC9553" section="1.4.5" sectionFormat="of"/>), except for anniversaries. For anniversaries, it converts to the <tt>Timestamp</tt> Timestamp type for anniversaries.</t> (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.1" sectionFormat="of"/>).</t>
	  <t>The DATE type (<xref target="RFC6350" derivedContent="RFC6350" section="4.3.1" sectionFormat="of"/>) converts to the <tt>PartialDate</tt> type, which only is relevant a PartialDate object (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.1" sectionFormat="of"/>) when used for anniversaries.  This does not apply to an anniversary, unless the DATE values that value only define contains a month or a day.</t> day (but not both).</t>
	  <t>The TIME, DATE-TIME, DATE-AND-OR-TIME following temporal types and DATE type values that only define a month or day do not convert to a JSContact datetime type.  Instead, vCard properties or parameters having such values value types convert to the properties as defined in <xref target="new-jscontact"/>.</t>
	  <ul>
		  <li>TIME (<xref target="RFC6350" derivedContent="RFC6350" section="4.3.2" sectionFormat="of"/>)</li>
		  <li>DATE-TIME (<xref target="RFC6350" derivedContent="RFC6350" section="4.3.3" sectionFormat="of"/>)</li>
		  <li>DATE-AND-OR-TIME (<xref target="RFC6350" derivedContent="RFC6350" section="4.3.4" sectionFormat="of"/>)</li>
		  <li>DATE type values that only define a month or day (but not both)</li>
  </ul>
        </section>
        <section>
          <name>INTEGER</name>
          <t>This
          <t>The INTEGER type (<xref target="RFC6350" derivedContent="RFC6350" section="4.5" sectionFormat="of"/>) converts to the JSContact <tt>Int</tt> Int and <tt>UnsignedInt</tt> types.</t> UnsignedInt types (<xref target="RFC9553" derivedContent="RFC9553" section="1.4.2" sectionFormat="of"/>).</t>
        </section>
        <section>
          <name>FLOAT</name>
          <t>This
          <t>The FLOAT type (<xref target="RFC6350" derivedContent="RFC6350" section="4.6" sectionFormat="of"/>) converts to the JSContact <tt>Number</tt> type.</t> Number type (<xref target="RFC9553" derivedContent="RFC9553" section="1.3.2" sectionFormat="of"/>).</t>
        </section>
        <section>
          <name>LANGUAGE-TAG</name>
          <t>This
          <t>The LANGUAGE-TAG type (<xref target="RFC6350" derivedContent="RFC6350" section="4.8" sectionFormat="of"/>) converts to the JSContact <tt>String</tt> type.</t> String type (<xref target="RFC9553" derivedContent="RFC9553" section="1.3.2" sectionFormat="of"/>).  The value <bcp14>MUST</bcp14> be a language tag as defined in <xref target="RFC5646"/>.</t>
        </section>
        <section>
          <name>TEXT</name>
          <t>This
          <t>The TEXT type (<xref target="RFC6350" derivedContent="RFC6350" section="4.1" sectionFormat="of"/>) converts to the JSContact <tt>String</tt> type.</t> String type (<xref target="RFC9553" derivedContent="RFC9553" section="1.3.2" sectionFormat="of"/>).</t>
        </section>
        <section>
          <name>URI</name>
          <t>This
          <t>The URI type (<xref target="RFC6350" derivedContent="RFC6350" section="4.2" sectionFormat="of"/>) converts to the JSContact <tt>String</tt> type.</t> String type (<xref target="RFC9553" derivedContent="RFC9553" section="1.3.2" sectionFormat="of"/>).  The value <bcp14>MUST</bcp14> be a URI as defined in <xref target="RFC3986" sectionFormat="of" section="3"/></t>
        </section>
        <section>
          <name>UTC-OFFSET</name>
          <t>This
          <t>The UTC-OFFSET type (<xref target="RFC6350" derivedContent="RFC6350" section="4.7" sectionFormat="of"/>) either converts to a <tt>String</tt> String value containing an IANA TimeZone Time Zone Database entry name (see <xref target="vcard-prop-tz"/>), target="vcard-prop-tz"/>) or it does not convert to any JSContact type.  For the latter, vCard properties or parameters having such values <bcp14>MAY</bcp14> convert to JSContact as defined in <xref target="new-jscontact"/>. </t>
        </section>
      </section>
      <section anchor="vcard-parameters">
        <name>vCard Parameters</name>
        <t>This section contains the conversion rules for vCard parameters.  A rule typically only applies only for specific vCard properties.  To convert a vCard parameter on an arbitrary vCard property, see <xref target="jscontact-prop-vcardparams"/>.</t>
        <section anchor="vcard-param-altid">
          <name>ALTID</name>
          <t>This
          <t>The ALTID parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.4" sectionFormat="of"/>) does not convert to an IANA-registered property in JSContact, but several conversion rules make use of this parameter to combine multiple vCard properties into a single JSContact object instance.  For an example of this this, see <xref target="vcard-prop-adr"/>.  To preserve the verbatim value of the ALTID parameter, set the JSContact properties defined in <xref target="new-jscontact"/>.</t>
        </section>
        <section anchor="vcard-param-author">
          <name>AUTHOR</name>
	  <t>The AUTHOR parameter value of (<xref target="RFC9554" derivedContent="RFC9554" section="4.1" sectionFormat="of"/>) on a vCard NOTE property converts to the <tt>uri</tt> Author object's uri property of the (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.3" sectionFormat="of"/>).  That Author object for this note.</t>
          <t>Note: This parameter is defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</t> set as the value of the Note object's author property (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.3" sectionFormat="of"/>).</t>
        </section>
        <section anchor="vcard-param-author-name">
          <name>AUTHOR-NAME</name>
          <t>The AUTHOR-NAME parameter value of (<xref target="RFC9554" derivedContent="RFC9554" section="4.2" sectionFormat="of"/>) on a vCard NOTE property converts to the <tt>name</tt> Author object's name property of the (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.3" sectionFormat="of"/>).  That Author object for this note.</t>
          <t>Note: This parameter is defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</t> set as the value of the Note object's author property.</t>
        </section>
        <section anchor="vcard-param-calscale">
          <name>CALSCALE</name>
          <t>This
          <t>The CALSCALE parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.8" sectionFormat="of"/>) set on a BDAY, DEATHDATE DEATHDATE, or ANNIVERSARY property converts to the <tt>calendarScale</tt> PartialDate object's calendarScale property of (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.1" sectionFormat="of"/>).</t>
        </section>
        <section anchor="vcard-param-cc">
          <name>CC</name>
          <t>The CC parameter (<xref target="RFC8605" derivedContent="RFC8605" section="3.1" sectionFormat="of"/>) on an ADR property converts to the <tt>PartialDate</tt> object type.</t> Address object's countryCode property (<xref target="RFC9553" derivedContent="RFC9553" section="2.5.1.1" sectionFormat="of"/>).</t>
        </section>
        <section anchor="vcard-param-created">
          <name>CREATED</name>
          <t>The CREATED parameter value of (<xref target="RFC9554" derivedContent="RFC9554" section="4.3" sectionFormat="of"/>) on a vCard NOTE property converts to the <tt>created</tt> property of the Note object.</t>
          <t>Note: This parameter is defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</t> object's created property (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.3" sectionFormat="of"/>).</t>
        </section>
        <section anchor="vcard-param-derived">
          <name>DERIVED</name>
          <t>If this
          <t>The DERIVED parameter (<xref target="RFC9554" derivedContent="RFC9554" section="4.4" sectionFormat="of"/>) does not convert to JSContact.  If the DERIVED parameter is set to <tt>true</tt> "true" on a vCard property, then implementations <bcp14>MAY</bcp14> choose to not to convert that property.  Note: This parameter is defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</t> property.</t>
        </section>
        <section anchor="vcard-param-geo">
          <name>GEO</name>
          <t>This
          <t>The GEO parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.10" sectionFormat="of"/>) set on an ADR property converts to the JSContact <tt>coordinates</tt> Address object's coordinates property of the <tt>Address</tt> object that represents the vCard ADR.</t> (<xref target="RFC9553" derivedContent="RFC9553" section="2.5.1.1" sectionFormat="of"/>).</t>
        </section>
        <section anchor="vcard-param-group">
          <name>GROUP</name>
          <t>This
          <t>The GROUP parameter (<xref target="RFC7095" derivedContent="RFC7095" section="7.1" sectionFormat="of"/>) does not convert to JSContact.  It exclusively is for use in jCard (see <xref target="RFC7095" section="7.1"/>).  It and <bcp14>MUST NOT</bcp14> be set in a vCard.  Preserving vCard.</t>
<t>Preserving the exact group name when converting from vCard to JSContact and back to vCard is not necessary.  Any group identifiers will do, as long as the resulting vCard groups its properties equally to the original vCard.  Implementations that still wish to preserve the exact property group name of a vCard property <bcp14>MAY</bcp14> set the <tt>group</tt> jCard "group" parameter in the JSContact properties <tt>vCardProps</tt> vCardProps or <tt>vCardParams</tt> vCardParams as defined in <xref target="new-jscontact"/>.</t>
          <figure anchor="group_conversion_params">
            <name>An example how
            <name>Example of How to preserve Preserve the group name Group Name in <tt>vCardParams</tt> vCardParams during conversion.</name>
            <artwork><![CDATA[ Conversion</name>

            <sourcecode type="text/plain"><![CDATA[
item1.TEL;VALUE=uri:tel:+1-555-555-5555
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"phones": {
  "p1": {
    "number": "tel:+1-555-555-5555",
    "vCardParams" : {
     "group" : "item1"
    }
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
          <figure anchor="group_conversion_props">
            <name>An example how
            <name>Example of How to preserve Preserve the group name Group Name in <tt>vCardProps</tt> vCardProps during conversion.</name>
            <artwork><![CDATA[ Conversion</name>
            <sourcecode type="text/plain"><![CDATA[
item2.X-FOO:bar
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"vCardProps": [
  ["x-foo", {
    "group": "item2"
  }, "unknown", "bar"]
]
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-param-index">
          <name>INDEX</name>
          <t>This
          <t>The INDEX parameter (<xref target="RFC6715" derivedContent="RFC6715" section="3.1" sectionFormat="of"/>) set on the EXPERTISE, HOBBY, INTEREST INTEREST, and ORG-DIRECTORY properties defined in <xref target="RFC6715"/> converts to the JSContact <tt>listAs</tt> property of the <tt>PersonalInfo</tt> PersonalInfo (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.4" sectionFormat="of"/>) and <tt>Directory</tt> objects.</t> Directory (<xref target="RFC9553" derivedContent="RFC9553" section="2.6.2" sectionFormat="of"/>) objects' listAs property.</t>
        </section>
        <section anchor="vcard-param-language">
          <name>LANGUAGE</name>
          <t>This
          <t>The LANGUAGE parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.1" sectionFormat="of"/>) converts to an entry in the <tt>localizations</tt> Card object's localizations property (<xref target="RFC9553" derivedContent="RFC9553" section="2.7.1" sectionFormat="of"/>) for the that vCard property that on which this parameter is set on.  The value of the LANGUAGE parameter defines the language tag key in the <tt>localizations</tt> localizations property.</t>
          <t>This specification does not define a single standard conversion rule for how to convert the property values.  Instead, building the localizations value is implementation-specific.</t>
          <t>Two options to populate the localizations property are:</t>
          <ul>
            <li>One Patch Per per Property: For each vCard property with a LANGUAGE parameter, set the complete path in the PatchObject to the JSContact property that the vCard property converts to.  The value of the patch is the converted property value.  This is simple to process and adequate if the vCard only contains a few properties with the LANGUAGE parameter.</li>
            <li>Bundle Patches by Parent: If a PatchObject contains multiple paths that have the same parent paths, then it might be possible to combine these patches into one patch that patches the parent property.  This is possible if the property in the Card is patched in its entirety.</li>
          </ul>
          <t>Generally, localizations only localize properties that are present in the non-localized version of this Card.  <xref target="language-patch-dominant-language"/> illustrates this.</t>
          <figure anchor="language-patch-dominant-language">
            <name>LANGUAGE conversion example: one dominant language</name>
            <artwork><![CDATA[ Conversion Example: One Dominant Language</name>
            <sourcecode type="text/plain"><![CDATA[
FN;LANGUAGE=EN:John Doe
TITLE;LANGUAGE=EN:Boss
TITLE;LANGUAGE=fr:Patron
TITLE;ALTID=1;LANGUAGE=EN:Boss
TITLE;ALTID=1;LANGUAGE=fr:Patron
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"language": "en",
"name": {
  "full": "John Doe"
},
"titles": {
  "t1": {
    "name": "Boss"
  }
},
"localizations": {
  "fr": {
    "titles/t1/name": "Patron"
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
          <t>As a special case, if one or more vCard properties of the same type do not have the LANGUAGE parameter set, then choose add them to the non-localized Card.  Convert any with LANGUAGE parameters to the localizations property.  <xref target="language-patch-no-language"/> illustrates this.</t>
          <figure anchor="language-patch-no-language">
            <name>LANGUAGE conversion example: property Conversion Example: Property without language</name>
            <artwork><![CDATA[ Language</name>
            <sourcecode type="text/plain"><![CDATA[
FN:John Doe
TITLE:Boss
TITLE;LANGUAGE=fr:Patron
TITLE;ALTID=1:Boss
TITLE;ALTID=1;LANGUAGE=fr:Patron
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"name": {
  "full": "John Doe"
},
"titles": {
  "t1": {
    "name": "Boss"
  }
},
"localizations": {
  "fr": {
    "titles/t1/name": "Patron"
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
          <t>As the least preferred option, <xref target="language-patch-no-dominant"/> illustrates how all vCard properties of the same type have the LANGUAGE parameter set, but none of their language tags match the language of the main Card.  In this case, implementations <bcp14>MAY</bcp14> choose to add the localized vCard properties only to the localizations object.</t>
        </section>
        <section anchor="vcard-param-label">
          <name>LABEL</name>
          <t>The following example uses non-ASCII characters to demonstrate multilingual content.  The ASCII-formatted version of this specification might not show the correct characters.  Please refer LABEL parameter (<xref target="RFC6350" derivedContent="RFC6350" section="6.3.1" sectionFormat="of"/>) on an ADR property converts to the HTML or PDF versions instead.</t>
          <figure anchor="language-patch-no-dominant">
            <name>LANGUAGE conversion example: conflicting LANGUAGE Address object's full property and parameter values</name>
            <artwork><![CDATA[
LANGUAGE:es
FN:Gabriel García Márquez
TITLE;LANGUAGE=en:Boss
TITLE;LANGUAGE=fr:Patron

"language": "es",
"name" {
  "full": "Gabriel García Márquez"
},
"localizations": {
  "en": {
    "titles": {
      "t1": {
        "name": "Novelist"
      }
  },
  "fr": {
    "titles": {
      "t1": {
        "name": "Écrivain"
      }
  }
}
]]></artwork>
          </figure> (<xref target="RFC9553" derivedContent="RFC9553" section="2.5.1.1" sectionFormat="of"/>).</t>
        </section>
        <section anchor="vcard-param-level">
          <name>LEVEL</name>
          <t>The LEVEL parameter <xref target="RFC6715"/> (<xref target="RFC6715" derivedContent="RFC6715" section="3.2" sectionFormat="of"/>) converts to the <tt>level</tt> PersonalInfo object's level property of the <tt>PersonalInfo</tt> type. (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.4" sectionFormat="of"/>).  If this parameter is set on the EXPERTISE property, then its values convert as: as follows:
      </t>
          <ul spacing="compact">
            <li>"beginner" converts to "low";</li>
            <li>"average" converts to "medium";</li> "medium"; and</li>
            <li>"expert" converts to "high".</li>
          </ul>
          <t>In all other cases cases, the values convert verbatim, but lowercase <bcp14>MUST</bcp14> be used for the JSContact value.</t>
        </section>
        <section anchor="vcard-param-mediatype">
          <name>MEDIATYPE</name>
          <t>This
          <t>The MEDIATYPE parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.7" sectionFormat="of"/>) converts to the <tt>mediaType</tt> Resource object's mediaType property of the <tt>Resource</tt> object type.</t> (<xref target="RFC9553" derivedContent="RFC9553" section="1.4.4" sectionFormat="of"/>).</t>
        </section>
        <section anchor="vcard-param-phonetic">
          <name>PHONETIC</name>
          <t>This
	  <t>The PHONETIC parameter as well as (<xref target="RFC9554" derivedContent="RFC9554" section="4.6" sectionFormat="of"/>) converts to the Name (<xref target="RFC9553" derivedContent="RFC9553" section="2.2.1" sectionFormat="of"/>) and Address (<xref target="RFC9553" derivedContent="RFC9553" section="2.5.1" sectionFormat="of"/>) objects' phoneticSystem property unless the <xref target="vcard-param-script">SCRIPT</xref> parameter set on a N or ADR value is "script", in which case the phoneticSystem property convert to JSContact as follows:</t>
          <t>the values is not set.</t>
	  <t>The value of the <tt>phonetic</tt>, <tt>phoneticScript</tt> and <tt>phoneticSystem</tt> properties of SCRIPT parameter converts to the NameComponent and Name or AddressComponent and Address object types, respectively.</t> phoneticScript property (see <xref target="vcard-param-script"/>).</t>
          <t>The related N or ADR property is defined by the vCard ALTID parameter. The conversion rules for the <xref target="vcard-prop-n">N</xref> and <xref target="vcard-prop-adr">ADR</xref> properties define how the vCard components convert to JSContact.</t>
          <t>The value component values of the PHONETIC parameter converts to the <tt>phoneticSystem</tt> property unless it is <tt>script</tt>, in on which case the <tt>phoneticSystem</tt> property is not set.  The value of the SCRIPT PHONETIC parameter converts to the <tt>phoneticScript</tt> property.</t>
          <t>The values of the components in the property value is set convert to values the <tt>phonetic</tt> properties for the respective NameComponent or AddressComponent.</t> AddressComponent objects' phonetic properties.</t>
          <t>If more than one property having has the PHONETIC parameter set and relates to the same property, then they convert to the Card <tt>localizations</tt> object's localizations property according to their LANGUAGE parameter values as outlined in <xref target="vcard-param-language"/>.</t>
          <figure anchor="phonetic_conversion">
            <name>PHONETIC conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
LANGUAGE=zh-Hant
N;ALTID=1;LANGUAGE=zh-Hant:孫;中山;文,逸仙;;
N;ALTID=1;PHONETIC=jyut;
  SCRIPT=Latn;LANGUAGE=yue:syun1;zung1saan1;man4,jat6sin1;;
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"language": "zh-Hant",
"name": {
  "components": [
    { "kind": "surname", "value": "孫" },
    { "kind": "given", "value": "中山" },
    { "kind": "given2", "value": "文" },
    { "kind": "given2", "value": "逸仙" }
  ]
},
"localizations": {
  "yue": {
    "name/phoneticSystem": "jyut",
    "name/phoneticScript": "Latn",
    "name/components/0/phonetic": "syun1",
    "name/components/1/phonetic": "zung1saan1",
    "name/components/2/phonetic": "man4",
    "name/components/3/phonetic": "jat6sin1"
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-param-pid">
          <name>PID</name>
          <t>This
          <t>The PID parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.5" sectionFormat="of"/>) converts to an entry in the <tt>vCardParams</tt> property, vCardParams property; see <xref target="jscontact-prop-vcardparams"/>.</t>
        </section>
        <section anchor="vcard-param-pref">
          <name>PREF</name>
          <t>This
          <t>The PREF parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.3" sectionFormat="of"/>) converts to the <tt>pref</tt> property.</t> pref property of the derived JSContact object.</t>
        </section>
        <section anchor="vcard-param-propid">
          <name>PROP-ID</name>
	  <t>The PROP-ID parameter value of a vCard property (<xref target="RFC9554" derivedContent="RFC9554" section="4.7" sectionFormat="of"/>) converts to the <tt>Id</tt> Id-typed key of the derived JSContact property to which the vCard property converts.</t> object.</t>
          <figure anchor="propid_conversion">
            <name>PROP-ID conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
TEL;PROP-ID=PHONE-A;VALUE=uri;PREF=1;TYPE="voice,home"
  :tel:+1-555-555-5555;ext=5555
TEL;PROP-ID=PHONE-B;VALUE=uri;TYPE=home
  :tel:+33-01-23-45-67
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"phones": {
  "PHONE-A": {
    "contexts": { "private": true },
    "features": { "voice": true },
    "number": "tel:+1-555-555-5555;ext=5555",
    "pref": 1
  },
  "PHONE-B": {
    "contexts": { "private": true },
    "number": "tel:+33-01-23-45-67"
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
          <t>Note: This parameter is defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</t>
        </section>
        <section anchor="vcard-param-script">
          <name>SCRIPT</name>
          <t>See
          <t>The SCRIPT parameter (<xref target="RFC9554" derivedContent="RFC9554" section="4.8" sectionFormat="of"/>) converts to the Name (<xref target="RFC9553" derivedContent="RFC9553" section="2.2.1" sectionFormat="of"/>) or Address (<xref target="RFC9553" derivedContent="RFC9553" section="2.5.1" sectionFormat="of"/>) objects' phoneticScript property.</t>
          <t>Also see <xref target="vcard-param-phonetic"/>.</t>
        </section>
        <section anchor="vcard-param-service-type">
          <name>SERVICE-TYPE</name>
          <t>This
	  <t>The SERVICE-TYPE parameter (<xref target="RFC9554" derivedContent="RFC9554" section="4.9" sectionFormat="of"/>) converts to the <tt>service</tt> OnlineService object's service property of the <tt>OnlineService</tt> object type.  Note: This parameter is defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</t> (<xref target="RFC9553" derivedContent="RFC9553" section="2.3.2" sectionFormat="of"/>).</t>
        </section>
        <section anchor="vcard-param-sortas">
          <name>SORT-AS</name>
          <t>This
          <t>The SORT-AS parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.9" sectionFormat="of"/>) converts to the <tt>sortAs</tt> properties defined for the <tt>Name</tt>, <tt>Organization</tt> Name, Organization, and <tt>OrgUnit</tt> object types.</t> OrgUnit objects' sortAs properties.</t>
        </section>
        <section anchor="vcard-param-type">
          <name>TYPE</name>
          <t>This

          <t>The TYPE parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.6" sectionFormat="of"/>) converts to either the <tt>contexts</tt> contexts property or the kind property, as well as property-specific <tt>kind</tt> property values defined in later sections. If not specified otherwise for a specific JSContact property, specified, the vCard <tt>home</tt> "home" and <tt>work</tt> "work" parameter values convert to the JSContact <tt>private</tt> "private" and <tt>work</tt> "work" contexts, respectively.</t>
        </section>
        <section anchor="vcard-param-tz">
          <name>TZ</name>
          <t>This
          <t>The TZ parameter set (<xref target="RFC6350" derivedContent="RFC6350" section="5.11" sectionFormat="of"/>) on an ADR property converts to the JSContact <tt>timeZone</tt> Address object's timeZone property of the <tt>Address</tt> object that represents the vCard ADR. (<xref target="RFC9553" derivedContent="RFC9553" section="2.5.1.1" sectionFormat="of"/>).  Also see the conversion of the TZ property in <xref target="vcard-prop-tz"/>.</t>
        </section>
        <section anchor="vcard-param-username">
          <name>USERNAME</name>
          <t>This
	  <t>The USERNAME parameter (<xref target="RFC9554" derivedContent="RFC9554" section="4.10" sectionFormat="of"/>) converts to the <tt>user</tt> OnlineService object's user property of the <tt>OnlineService</tt> object type.  Note: This parameter is defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</t> (<xref target="RFC9553" derivedContent="RFC9553" section="2.3.2" sectionFormat="of"/>).</t>
        </section>
        <section anchor="vcard-param-value">
          <name>VALUE</name>
          <t>This
          <t>The VALUE parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.2" sectionFormat="of"/>) does not convert to an IANA-registered property in JSContact.  To preserve properties with experimental values, see Sections <xref target="jscontact-prop-vcardparams"/> target="jscontact-prop-vcardprops" format="counter"/> and <xref target="jscontact-prop-vcardprops"/>.</t> target="jscontact-prop-vcardparams" format="counter"/>.</t>
        </section>
      </section>
      <section>
        <name>General Properties</name>
        <section>
          <name>BEGIN and END</name>
          <t>These
          <t>The BEGIN and END properties do not convert to IANA-registered properties in JSContact.</t>
        </section>
        <section anchor="vcard-prop-kind">
          <name>KIND</name>
          <t>The KIND property (<xref target="RFC6350" derivedContent="RFC6350" section="6.1.4" sectionFormat="of"/>) converts to the <tt>kind</tt> kind property (<xref target="kind_conversion"/>).  Allowed values are those described in Section 6.1.4 of <xref target="RFC6350"/> target="RFC6350" sectionFormat="of" section="6.1.4"/> and extended with the values declared in <xref target="RFC6473"/> and <xref target="RFC6869"/>.</t>
          <figure anchor="kind_conversion">
            <name>KIND conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
KIND:individual
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"kind": "individual"
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-source">
          <name>SOURCE</name>
          <t>The SOURCE property (<xref target="RFC6350" derivedContent="RFC6350" section="6.1.3" sectionFormat="of"/>) converts to a Directory object (<xref target="RFC9553" derivedContent="RFC9553" section="2.6.2" sectionFormat="of"/>) in the <tt>directories</tt> Card object's directories property (<xref target="source_conversion"/>).  The <tt>kind</tt> Directory object's kind property is set to <tt>entry</tt>. "entry".  The <tt>uri</tt> uri property is set to the SOURCE property value.</t>
          <t>The PREF and MEDIATYPE parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="source_conversion">
            <name>SOURCE conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
SOURCE:https://dir.example.com/addrbook/jdoe/Jean%20Dupont.vcf
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"directories": {
   "ENTRY-1": {
     "kind": "entry",
     "uri": "https://dir.example.com/addrbook/jdoe/Jean%20Dupont.vcf"
   }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-xml">
          <name>XML</name>
          <t>This
          <t>The XML property (<xref target="RFC6350" derivedContent="RFC6350" section="6.1.5" sectionFormat="of"/>) converts to an entry in the <tt>vCardProps</tt> property, vCardProps property; see <xref target="jscontact-prop-vcardprops"/>.</t>
        </section>
      </section>
      <section>
        <name>Identification Properties</name>
        <section anchor="vcard-prop-anniversary">
          <name>BDAY,
	<name>ANNIVERSARY, BDAY, BIRTHPLACE, DEATHDATE, DEATHPLACE, ANNIVERSARY</name>
          <t>The BDAY and ANNIVERSARY DEATHPLACE</name>
	<t>The following properties and the extensions BIRTHPLACE, DEATHDATE, DEATHPLACE described in <xref target="RFC6474"/> are represented as <tt>Anniversary</tt> all convert to Anniversary objects included in the <tt>anniversaries</tt> Card object's anniversaries property (<xref target="anniversary_conversion"/>):</t>
		<ul spacing="compact">
            <li>
			<li>ANNIVERSARY (<xref target="RFC6350" derivedContent="RFC6350" section="6.2.6" sectionFormat="of"/>)</li>
			<li>BDAY (<xref target="RFC6350" derivedContent="RFC6350" section="6.2.5" sectionFormat="of"/>)</li>
			<li>BIRTHPLACE (<xref target="RFC6474" derivedContent="RFC6474" section="2.1" sectionFormat="of"/>)</li>
			<li>DEATHDATE (<xref target="RFC6474" derivedContent="RFC6474" section="2.3" sectionFormat="of"/>)</li>
			<li>DEATHPLACE (<xref target="RFC6474" derivedContent="RFC6474" section="2.2" sectionFormat="of"/>)</li>
	</ul>

            <t>BDAY and BIRTHPLACE convert to <tt>date</tt> an Anniversary object (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.1" sectionFormat="of"/>) having the date and <tt>place</tt> where <tt>kind</tt> place properties set.  The kind poperty is set to "birth";</t>
              <t/>
            </li>
            <li> "birth".
            </t>
            <t>DEATHDATE and DEATHPLACE convert to <tt>date</tt> an Anniversary object having the date and <tt>place</tt> where <tt>kind</tt> place properties set.  The Anniversary object's kind property is set to "death";</t>
              <t/>
            </li>
            <li>ANNIVERSARY "death".
            </t>
            <t>ANNIVERSARY converts to <tt>date</tt> where <tt>kind</tt> the Anniversary object's date property.  The Anniversary object's kind property is "wedding".</li>
          </ul>
          <t>Both birth and death places are represented as instances of set to "wedding".</t>
          <t>If the <tt>Address</tt> object.</t>
          <t>The BIRTHPLACE and or DEATHPLACE properties that are represented as geo URIs convert property value is of type URI using the "geo:" URI scheme, then it converts to <tt>Address</tt> instances including only the <tt>coordinates</tt> Address object's coordinates property.  If the URI value type is not a geo URI, TEXT, then it converts to the place is ignored.</t> Address object's full property.  Otherwise, it converts to the vCardProps property; see <xref target="jscontact-prop-vcardprops"/>.</t>
          <t>The ALTID and LANGUAGE parameters of both the BIRTHPLACE and DEATHPLACE properties convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="anniversary_conversion">
            <name>BDAY,
            <name>ANNIVERSARY, BDAY, BIRTHPLACE, DEATHDATE, DEATHPLACE, ANNIVERSARY conversion example</name>
            <artwork><![CDATA[ and DEATHPLACE Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
BDAY:19531015T231000Z
BIRTHPLACE:
 123 Main Street\nAny Town, CA 91921-1234\nU.S.A.
DEATHDATE:19960415
DEATHPLACE:
 5 Court Street\nNew England, ND 58647\nU.S.A.
ANNIVERSARY:19860201
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"anniversaries": {
  "ANNIVERSARY-1" : {
    "kind": "birth",
    "date": {
      "@type": "Timestamp",
      "utc": "1953-10-15T23:10:00Z"
    },
    "place": {
      "full":
         "123 Main Street\nAny Town, CA 91921-1234\nU.S.A."
    }
  },
  "ANNIVERSARY-2" : {
    "kind": "death",
    "date": {
      "year": 1996,
      "month": 4,
      "year": 15
    },
    "place": {
      "full": "5 Court Street\nNew England, ND 58647\nU.S.A."
    }
  },
  "ANNIVERSARY-3" : {
    "kind": "wedding",
    "date": {
      "year": 1986,
      "month": 2,
      "day": 1
    }
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-fn">
          <name>FN</name>
          <t>The FN property (<xref target="RFC6350" derivedContent="RFC6350" section="6.2.1" sectionFormat="of"/>) converts to the Name object in the <tt>name</tt> property.  Its value converts to the Name object <tt>full</tt> object's full property (<xref target="fn_conversion"/>).  If the LANGUAGE parameter is set, then the FN property converts as outlined in <xref target="vcard-param-language"/>.  In the unexpected case that where the vCard contains more than one FN property without the LANGUAGE parameter, then convert the FN property that has the least parameters set to the <tt>full</tt> property. parameters.  If multiple such FN properties are present, choose any of them.  All other FN properties convert to the <xref target="jscontact-prop-vcardprops"><tt>vCardProps</tt></xref> target="jscontact-prop-vcardprops">vCardProps</xref> property.</t>
          <figure anchor="fn_conversion">
            <name>FN conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
FN:John Q. Public, Esq.
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"name": {
  "full": "John Q. Public, Esq.", Esq."
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-gender">
          <name>GENDER</name>
          <t>This
          <t>The GENDER property (<xref target="RFC6350" derivedContent="RFC6350" section="6.2.7" sectionFormat="of"/>) does not map convert to an IANA-registered property in JSContact.  To convert this property, see <xref target="jscontact-prop-vcardprops"/>.  Note  Alternatively, the alternative JSContact <tt>speakToAs</tt> Card object's speakToAs property which defines how to address and refer to an individual represented by the card, Card, as do the newly defined vCard GRAMGENDER and PRONOUNS properties of <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</t> target="RFC9554"/>.</t>
        </section>
        <section anchor="vcard-prop-gramgender">
          <name>GRAMGENDER and PRONOUNS</name>
          <t>The GRAMGENDER property (<xref target="RFC9554" derivedContent="RFC9554" section="3.2" sectionFormat="of"/>) converts to the <tt>grammaticalGender</tt> SpeakToAs object's grammaticalGender property of the <tt>SpeakToAs</tt> object (<xref target="grammatical_gender_pronouns_conversion"/>).</t>
          <t>The PRONOUNS property (<xref target="RFC9554" derivedContent="RFC9554" section="3.4" sectionFormat="of"/>) converts to an entry in the <tt>pronouns</tt> SpeakToAs object's pronouns property of the <tt>SpeakToAs</tt> object (<xref target="grammatical_gender_pronouns_conversion"/>).</t>
          <figure anchor="grammatical_gender_pronouns_conversion">
            <name>GRAMGENDER and PRONOUNS conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
GRAMGENDER:NEUTER
PRONOUNS;PREF=2:they/them
PRONOUNS;PREF=1:xe/xir
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"speakToAs": {
  "grammaticalGender": "neuter",
  "pronouns": {
    "PRONOUNS-1": {
      "pronouns": "they/them",
      "pref": 2
    },
    "PRONOUNS-2": {
      "pronouns": "xe/xir",
      "pref": 1
    }
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-n">
          <name>N</name>
          <t>The N property (<xref target="RFC6350" derivedContent="RFC6350" section="6.2.2" sectionFormat="of"/>) converts to the a Name object (<xref target="RFC9553" derivedContent="RFC9553" section="2.2.1" sectionFormat="of"/>) in the <tt>name</tt> Card object's name property.
	  Each component in the N property structured value converts to a NameComponent in the Name <tt>components</tt> object's components property.  The following table shows this relation:</t>
          <table anchor="n_kind_conversion">
            <name>N components conversion</name> Components Conversion</name>
            <thead>
              <tr>
                <th align="left">N component</th>
                <th align="left">NameComponent kind</th>
                <th align="left">Remarks</th>
              </tr>
            </thead>
            <tbody>
              <tr>
                <td align="left">Family name</td>
                <td align="left">surname</td>
                <td align="left">To vCard: add any <tt>surname2</tt> "surname2" NameComponent value in here, to the Family name component, after all <tt>surname</tt> "surname" values.<br/>From vCard: ignore any value that also occurs in the Secondary surname component.</td>
              </tr>
              <tr>
                <td align="left">Given name</td>
                <td align="left">given</td>
                <td align="left"/>
              </tr>
              <tr>
                <td align="left">Additional name</td>
                <td align="left">given2</td>
                <td align="left"/>
              </tr>
              <tr>
                <td align="left">Honorific prefix</td>
                <td align="left">title</td>
                <td align="left"/>
              </tr>
              <tr>
                <td align="left">Honorific suffix</td>
                <td align="left">credential</td>
                <td align="left">To vCard: add any <tt>generation</tt> "generation" NameComponent value also in here.<br/>From to the Honorific suffix component.<br/>From vCard: ignore any value that also occurs in the Generation component.</td>
              </tr>
              <tr>
                <td align="left">Secondary surname</td>
                <td align="left">surname2</td>
                <td align="left"/>
              </tr>
              <tr>
                <td align="left">Generation</td>
                <td align="left">generation</td>
                <td align="left"/>
              </tr>
            </tbody>
          </table>
          <t>If the <xref target="vcard-param-jscomps">JSCOMPS</xref> parameter is set, then the Name <tt>isOrdered</tt> object's isOrdered property value is "true", and the <tt>defaultSeparator</tt> defaultSeparator property and any separator name components "separator" NameComponent objects are set according to the parameter value.  The <tt>components</tt> list order in the components property <bcp14>MUST</bcp14> adhere to the order of the JSCOMPS parameter value.</t>
          <t>If the JSCOMPS parameter is not set, then the Name <tt>isOrdered</tt> object's isOrdered property value is "false" "false", and the <tt>defaultSeparator</tt> defaultSeparator property <bcp14>MUST NOT</bcp14> be set.  The <tt>components</tt> list order in the components property <bcp14>MUST</bcp14> follow the order of values in the N structured value when read from left to right.</t>
          <t>If the SORT-AS parameter is set, then its structured value converts to the Name <tt>sortAs</tt> object's sortAs property according to <xref target="n_kind_conversion"/>.  An empty or non-existent component value indicates that no sort is defined for this kind.</t>
          <figure anchor="n_conversion">
            <name>N conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
N;SORT-AS="Stevenson,John Philip":Stevenson;John;Philip,Paul;Dr.;Jr.,M.D.,A.C.P.;;Jr. Philip":
 Stevenson;John;Philip,Paul;Dr.;Jr.,M.D.,A.C.P.;;Jr.
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"name": {
  "components":[
    { "kind": "surname", "value": "Stevenson" },
    { "kind": "given", "value": "John" },
    { "kind": "given2", "value": "Philip" },
    { "kind": "given2", "value": "Paul" },
    { "kind": "title", "value": "Dr." },
    { "kind": "credential", "value": "M.D." },
    { "kind": "credential", "value": "A.C.P." },
    { "kind": "generation", "value": "Jr." }
  ],
  "sortAs": {
    "surname": "Stevenson",
    "given": "John Philip"
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
          <t>See <xref target="vcard-param-jscomps-examples"/> for examples of using the JSCOMPS parameter for vCard structured vCard-structured property values.</t>
        </section>
        <section anchor="vcard-prop-nickname">
          <name>NICKNAME</name>
          <t>A
          <t>The NICKNAME property (<xref target="RFC6350" derivedContent="RFC6350" section="6.2.3" sectionFormat="of"/>) converts to a Nickname object (<xref target="RFC9553" derivedContent="RFC9553" section="2.2.2" sectionFormat="of"/>) in the <tt>nicknames</tt> Card object's nicknames property (<xref target="nickname_conversion"/>).  The <tt>name</tt> name property is set to the NICKNAME property value.</t>
          <t>The PREF and TYPE parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="nickname_conversion">
            <name>NICKNAME conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
NICKNAME:Johnny
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"nicknames": {
   "NICK-1": {
    "name": "Johnny"
   }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-photo">
          <name>PHOTO</name>
          <t>A
          <t>The PHOTO property (<xref target="RFC6350" derivedContent="RFC6350" section="6.2.4" sectionFormat="of"/>) converts to an entry a Media object (<xref target="RFC9553" derivedContent="RFC9553" section="2.6.4" sectionFormat="of"/>) in the <tt>media</tt> Card object's media property (<xref target="photo_conversion"/>).  The entry value is a <tt>Media</tt> object whose <tt>kind</tt> Media object's kind property is set to <tt>photo</tt> "photo" and <tt>uri</tt> the uri property is set to the PHOTO value.</t>
          <t>The PREF and MEDIATYPE parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="photo_conversion">
            <name>PHOTO conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
PHOTO:https://www.example.com/pub/photos/jqpublic.gif
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"media": {
   "PHOTO-1": {
     "kind": "photo",
     "uri": "https://www.example.com/pub/photos/jqpublic.gif"
   }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
      </section>
      <section>
        <name>Delivery Addressing Properties</name>
        <section anchor="vcard-prop-adr">
          <name>ADR</name>
          <t>The ADR property (<xref target="RFC6350" derivedContent="RFC6350" section="6.3.1" sectionFormat="of"/>) converts to an Address object (<xref target="RFC9553" derivedContent="RFC9553" section="2.5.1.1" sectionFormat="of"/>) in the <tt>addresses</tt> Card object's addresses property.  Each component in the ADR ADR-structured property structured value converts to an AddressComponent in the Address <tt>components</tt> object's components property.</t>
          <t><xref target="I-D.ietf-calext-vcard-jscontact-extensions"/> target="RFC9554"/> defines new component components for the ADR property.  Implementations <bcp14>SHOULD</bcp14> set these new components, even if all their values are the empty string.</t>
          <t>The following table shows how the ADR component and AddressComponent kind relate:</t>
          <table anchor="adr_kind_conversion">
            <name>ADR components conversion</name> Components Conversion</name>
            <thead>
              <tr>
                <th align="left">ADR component</th>
                <th align="left">AddressComponent kind</th>
                <th align="left">Remarks</th>
              </tr>
            </thead>
            <tbody>
              <tr>
                <td align="left">post office box</td>
                <td align="left">postOfficeBox</td>
                <td align="left"><xref target="RFC6350"/> recommends that this component not be set, but this now is now disputable given the new components.  Instead, set this component and use the new ADR value format defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</td> target="RFC9554"/>.</td>
              </tr>
              <tr>
                <td align="left">extended address</td>
                <td align="left">apartment (see Remarks)</td> align="left">apartment</td>
                <td align="left"><t>To vCard: Set set the values of the following components:</t>
                <ul>
                  <li>room</li>
                  <li>floor</li>
                  <li>apartment</li>
                  <li>building</li>
                </ul>
                <t>From vCard: Ignore ignore if the ADR structured value is of the format defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.  Otherwise target="RFC9554"/>.  Otherwise, convert to <tt>apartment</tt>.</t></td> "apartment".</t></td>
              </tr>
              <tr>
                <td align="left">street address</td>
                <td align="left">name (see Remarks)</td> align="left">name</td>
                <td align="left"><t>To vCard: Set set the values of the following components:</t>
                <ul>
                  <li>number</li>
                  <li>name</li>
                  <li>block</li>
                  <li>direction</li>
                  <li>landmark</li>
                  <li>subdistrict</li>
                  <li>district</li>
                </ul>
                <t>From vCard: Ignore ignore if the ADR structured value is of the format defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.  Otherwise target="RFC9554"/>.  Otherwise, convert to <tt>name</tt>.</t></td> "name".</t></td>
            </tr>
              <tr>
                <td align="left">locality</td>
                <td align="left">locality</td>
                <td align="left"/>
              </tr>
              <tr>
                <td align="left">region</td>
                <td align="left">region</td>
                <td align="left"/>
              </tr>
              <tr>
                <td align="left">postal code</td>
                <td align="left">postcode</td>
                <td align="left"/>
              </tr>
              <tr>
                <td align="left">apartment</td>
                <td align="left">apartment</td>
                <td>Defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</td> target="RFC9554"/>.</td>
              </tr>
              <tr>
                <td align="left">block</td>
                <td align="left">block</td>
                <td>Defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</td> target="RFC9554"/>.</td>
              </tr>
              <tr>
                <td align="left">building</td>
                <td align="left">building</td>
                <td>Defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</td> target="RFC9554"/>.</td>
              </tr>
              <tr>
                <td align="left">direction</td>
                <td align="left">direction</td>
                <td>Defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</td> target="RFC9554"/>.</td>
              </tr>
              <tr>
                <td align="left">district</td>
                <td align="left">district</td>
                <td>Defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</td> target="RFC9554"/>.</td>
              </tr>
              <tr>
                <td align="left">floor</td>
                <td align="left">floor</td>
                <td>Defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</td> target="RFC9554"/>.</td>
              </tr>
              <tr>
                <td align="left">landmark</td>
                <td align="left">landmark</td>
                <td>Defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</td> target="RFC9554"/>.</td>
              </tr>
              <tr>
                <td align="left">room</td>
                <td align="left">room</td>
                <td>Defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</td> target="RFC9554"/>.</td>
              </tr>
              <tr>
                <td align="left">street number</td>
                <td align="left">number</td>
                <td>Defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</td> target="RFC9554"/>.</td>
              </tr>
              <tr>
                <td align="left">subdistrict</td>
                <td align="left">subdistrict</td>
                <td>Defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</td> target="RFC9554"/>.</td>
              </tr>
            </tbody>
          </table>
          <t>If the <xref target="vcard-param-jscomps">JSCOMPS</xref> parameter is set, then the Address <tt>isOrdered</tt> object's isOrdered property value is "true", and the <tt>defaultSeparator</tt> defaultSeparator property and any separator name components are set according to the parameter value.  The <tt>components</tt> list order in the components property <bcp14>MUST</bcp14> adhere to the order of the JSCOMPS parameter value.</t>
          <t>If the JSCOMPS parameter is not set, then the Address <tt>isOrdered</tt> object's isOrdered property value is "false" "false", and the <tt>defaultSeparator</tt> defaultSeparator property <bcp14>MUST NOT</bcp14> be set.  The <tt>components</tt> list order in the components property <bcp14>MUST</bcp14> follow the order of values in the ADR structured value when read from left to right.</t>
          <t>The
	  <ul empty="true">
          <li>The LABEL parameter converts to the Address <tt>full</tt> property.</t>
          <t>The object's full property.</li>
          <li>The GEO parameter converts to the Address <tt>coordinates</tt> property.</t>
          <t>The object's coordinates property.</li>
          <li>The TZ parameter converts to the Address <tt>timeZone</tt> property.</t>
          <t>The object's timeZone property.</li>
          <li>The CC parameter as defined in <xref target="RFC8605"/> converts to the Address <tt>countryCode</tt> property.</t> object's countryCode property.</li>
	  </ul>
          <t>The PREF and TYPE parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.  The ADR-specific values of the TYPE parameter defined in Sections 5.1 <xref target="RFC9554" sectionFormat="bare" section="5.1"/> and 5.2 <xref target="RFC9554" sectionFormat="bare" section="5.2"/> of <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/> target="RFC9554"/> convert to the corresponding entries of the <tt>contexts</tt> contexts property as defined in Section 2.5.1 of <xref target="I-D.ietf-calext-jscontact"/>.</t> target="RFC9553" sectionFormat="of" section="2.5.1"/>.</t>
          <t>The ALTID and LANGUAGE parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.  Each possible language-dependent alternative is represented as converts to an entry of the PatchObject map where the key references the <tt>full</tt> full property.</t>
          <figure anchor="adr_conversion">
            <name>ADR conversion example</name>
            <artwork><![CDATA[
ADR;TYPE=work;CC=US:;;54321 Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
ADR;TYPE=work;CC=US:
 ;;54321 Oak St;Reston;VA;20190;USA;;;;Oak St;54321;;;;; St;Reston;VA;20190;USA;;;;54321;Oak St;;;;;;
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"addresses": {
  "ADDR-1" : {
    "contexts": { "work": true },
    "components": [
      { "kind": "number", "value": "54321" },
      { "kind": "name", "value": "Oak St" },
      { "kind": "locality", "value": "Reston" },
      { "kind": "region", "value": "VA" },
      { "kind": "postcode", "value": "20190" },
      { "kind": "country", "value": "USA" }
    ],
    "countryCode": "US", "US"
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
          <t>See <xref target="vcard-param-jscomps-examples"/> for examples of using the JSCOMPS parameter for vCard structured vCard-structured property values.</t>
        </section>
      </section>
      <section>
        <name>Communications Properties</name>
        <section anchor="vcard-prop-email">
          <name>EMAIL</name>
          <t>An
          <t>The EMAIL property (<xref target="RFC6350" derivedContent="RFC6350" section="6.4.2" sectionFormat="of"/>) converts to an entry EmailAddress object (<xref target="RFC9553" derivedContent="RFC9553" section="2.3.1" sectionFormat="of"/>) in the <tt>emails</tt> Card object's emails property (<xref target="email_conversion"/>).  The entry value is an <tt>EmailAddress</tt> object.  The <tt>address</tt> EmailAddress object's address property is set to the EMAIL value.</t>
          <t>The PREF and TYPE parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="email_conversion">
            <name>EMAIL conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
EMAIL;TYPE=work:jqpublic@xyz.example.com
EMAIL;PREF=1:jane_doe@example.com
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"emails": {
  "EMAIL-1": {
    "contexts": { "work": true },
    "address": "jqpublic@xyz.example.com"
  },
  "EMAIL-2": {
    "address": "jane_doe@example.com",
    "pref": 1
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-impp">
          <name>IMPP</name>
          <t>An
          <t>The IMPP property (<xref target="RFC6350" derivedContent="RFC6350" section="6.4.3" sectionFormat="of"/>) converts to an entry OnlineService object (<xref target="RFC9553" derivedContent="RFC9553" section="2.3.2" sectionFormat="of"/>) in the <tt>onlineServices</tt> Card object's onlineServices property (<xref target="impp_conversion"/>).  The entry value is an <tt>OnlineService</tt> object.  The <tt>vCardName</tt> vCardName property is set to "impp" "impp", and the <tt>uri</tt> uri property is set to the IMPP value.</t>
          <t>The SERVICE-TYPE, USERNAME, PREF PREF, and TYPE parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="impp_conversion">
            <name>IMPP conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
IMPP;PREF=1:xmpp:alice@example.com
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"onlineServices": {
  "OS-1": {
    "uri": "xmpp:alice@example.com",
    "pref": 1,
    "vCardName": "impp"
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-lang">
          <name>LANG</name>
          <t>A
          <t>The LANG property (<xref target="RFC6350" derivedContent="RFC6350" section="6.4.4" sectionFormat="of"/>) converts to an entry a LanguagePref object (<xref target="RFC9553" derivedContent="RFC9553" section="2.3.4" sectionFormat="of"/>) in the <tt>preferredLanguages</tt> Card object's preferredLanguages property (<xref target="lang_conversion"/>).  The entry value is an <tt>LanguagePref</tt> object.  The LanguagePref <tt>language</tt> LANG property value is converts to the LANG LanguagePref object's language property value.</t>
          <t>The PREF and TYPE parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="lang_conversion">
            <name>LANG conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
LANG;TYPE=work;PREF=1:en
LANG;TYPE=work;PREF=2:fr
LANG;TYPE=home:fr
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"preferredLanguages": {
  "LANG-1": {
    "language": "en",
    "contexts": { "work": true },
    "pref": 1
  },
  "LANG-2": {
    "language": "fr",
    "contexts": { "work": true },
    "pref": 2
  },
  "LANG-3": {
    "language": "fr",
    "contexts": { "private": true }
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-language">
          <name>LANGUAGE</name>
	  <t>The LANGUAGE property (<xref target="RFC9554" derivedContent="RFC9554" section="3.3" sectionFormat="of"/>) converts to the <tt>language</tt> Card object's language property (<xref target="languageprop_conversion"/>).</t>
          <figure anchor="languageprop_conversion">
            <name>LANGUAGE conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
LANGUAGE:de-AT
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"language": "de-AT"
]]></artwork>
]]></sourcecode>
          </figure>
          <t>Note: This property is defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</t>
        </section>
        <section anchor="vcard-prop-socialprofile">
          <name>SOCIALPROFILE</name>
          <t>A
	  <t>The SOCIALPROFILE property (<xref target="RFC9554" derivedContent="RFC9554" section="3.5" sectionFormat="of"/>) converts to an entry OnlineService object (<xref target="RFC9553" derivedContent="RFC9553" section="2.3.2" sectionFormat="of"/>) in the <tt>onlineServices</tt> Card object's onlineServices property (<xref target="socialprofile_conversion"/>).  The entry value is an <tt>OnlineService</tt> object.  The <tt>vCardName</tt> vCardName property is set to "socialprofile" "socialprofile", or it can be omitted.  If the value type of the SOCIALPROFILE property value is of type URI, then the <tt>uri</tt> OnlineService object's uri property is set to the SOCIALPROFILE value.  Otherwise, set; otherwise, the <tt>user</tt> user property is set to the SOCIALPROFILE value.</t> set.</t>
          <t>The SERVICE-TYPE, USERNAME, PREF PREF, and TYPE parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="socialprofile_conversion">
            <name>SOCIALPROFILE conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
SOCIALPROFILE;SERVICE-TYPE=Mastodon:https://example.com/@foo
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"onlineServices": {
  ...
  "OS-1": {
    "service": "Mastodon",
    "uri": "https://example.com/@foo"
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
          <t>Note: This property is defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</t>
        </section>
        <section anchor="vcard-prop-tel">
          <name>TEL</name>
          <t>A
          <t>The TEL property (<xref target="RFC6350" derivedContent="RFC6350" section="6.4.1" sectionFormat="of"/>) converts to an entry a Phone object (<xref target="RFC9553" derivedContent="RFC9553" section="2.3.3" sectionFormat="of"/>) in the <tt>phones</tt> Card object's phones property (<xref target="tel_conversion"/>).  The entry value is a <tt>Phone</tt> object.</t> target="tel_conversion"/>).</t>
          <t>The TEL-specific values of the TYPE parameter convert to the <tt>features</tt> features property keys as outlined in table <xref target="tel_type_conversion"/>.  Note that <xref target="RFC6350" sectionFormat="of" section="6.4.1"/> defines the default TYPE of TEL type to be <tt>voice</tt>, "voice", but the default Phone features property is absent by default.  Accordingly, an implementation <bcp14>SHOULD</bcp14> only set the Phone <tt>features</tt> object's features property if the TEL property actually has a TEL-specific TYPE parameter set.</t>
          <table anchor="tel_type_conversion">
            <name>TEL TYPE conversion</name> Conversion</name>
            <thead>
              <tr>
                <th align="left">TYPE value</th>
                <th align="left">Phone feature</th>
              </tr>
            </thead>
            <tbody>
              <tr>
                <td align="left">cell</td>
                <td align="left">mobile</td>
              </tr>
              <tr>
                <td align="left">fax</td>
                <td align="left">fax</td>
              </tr>
              <tr>
                <td align="left">main-number</td>
                <td align="left">main-number</td>
              </tr>
              <tr>
                <td align="left">pager</td>
                <td align="left">pager</td>
              </tr>
              <tr>
                <td align="left">text</td>
                <td align="left">text</td>
              </tr>
              <tr>
                <td align="left">textphone</td>
                <td align="left">textphone</td>
              </tr>
              <tr>
                <td align="left">video</td>
                <td align="left">video</td>
              </tr>
              <tr>
                <td align="left">voice</td>
                <td align="left">voice</td>
              </tr>
            </tbody>
          </table>
          <t>The value of the TEL property converts to the Phone <tt>number</tt> object's number property.</t>

          <t>The PREF and TYPE parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="tel_conversion">
            <name>TEL conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
TEL;VALUE=uri;PREF=1;TYPE="voice,home":tel:+1-555-555-5555;ext=5555
TEL;VALUE=uri;TYPE=home:tel:+33-01-23-45-67
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"phones": {
  "PHONE-1": {
    "contexts": { "private": true },
    "features": { "voice": true },
    "number": "tel:+1-555-555-5555;ext=5555",
    "pref": 1
  },
  "PHONE-2": {
    "contexts": { "private": true },
    "number": "tel:+33-01-23-45-67"
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
      </section>
      <section>
        <name>Geographical Properties</name>
        <section anchor="vcard-prop-geo">
          <name>GEO</name>
          <t>This
          <t>The GEO property (<xref target="RFC6350" derivedContent="RFC6350" section="6.5.2" sectionFormat="of"/>) converts to the <tt>coordinates</tt> Address object's coordinates property of the <tt>Address</tt> object. (<xref target="RFC9553" derivedContent="RFC9553" section="2.5.1" sectionFormat="of"/>).  Also see <xref target="combine-geo-props"/> to determine which <tt>Address</tt> Address object instance to convert to.</t>
        </section>
        <section anchor="vcard-prop-tz">
          <name>TZ</name>
          <t>The TZ property (<xref target="RFC6350" derivedContent="RFC6350" section="6.5.1" sectionFormat="of"/>) converts an Address object (<xref target="RFC9553" derivedContent="RFC9553" section="2.5.1" sectionFormat="of"/>) in the Card object's addresses property.</t>
          <t>A value of type TEXT converts to the <tt>timeZone</tt> property in the <tt>Address</tt> object.</t> Address object's timeZone property.</t>
          <t>A value of type UTC-OFFSET converts to the <tt>timeZone</tt> Address object's timeZone property in the <tt>Address</tt> object if the offset has zero minutes and the hour offset is in the range between -12 &lt;= 14:</t> and +14, both inclusively. Note that:</t>
          <ul>
            <li>If the hour offset is zero, use the time zone name <tt>Etc/UTC</tt>.</li>
            <li>Otherwise "Etc/UTC".</li>
            <li>Otherwise, construct the time zone name with <tt>Etc/GMT</tt> "Etc/GMT" suffixed with the string representation of the reversed sign hour offset, including the sign but excluding leading zeros and minutes.  For example, the UTC offset value <tt>-0500</tt> "-0500" converts to <tt>Etc/GMT+5</tt>.</li> "Etc/GMT+5".</li>
          </ul>
          <t>For such property values, also see <xref target="combine-geo-props"/> to determine which <tt>Address</tt> Address object instance to convert to.</t>
          <t>Any other value of type UTC-OFFSET or URI does not convert to an IANA-registered property in JSContact.  To convert such property, see <xref target="jscontact-prop-vcardprops"/>.</t>
        </section>
        <section anchor="combine-geo-props">
          <name>Combining geographical properties</name> Geographical Properties</name>
          <t>In vCard vCard, the properties ADR, GEO GEO, and TZ occur independently of each other.  In JSContact, they all convert to properties of an <tt>Address</tt> Address object.  It is implementation-specific if these vCard properties convert to <em>separate</em> address instances in JSContact, JSContact or if some or all of them convert to the <em>same</em> address.  That being said, implementations <bcp14>MUST</bcp14> convert the properties to the <em>same</em> address for the following cases:</t>
          <ul>
            <li>The GROUP parameter values of the properties match.</li>
            <li>The GROUP parameters are not set, but they are set on any other ADR, GEO GEO, and TZ properties.</li>
          </ul>
        </section>
      </section>
      <section>
        <name>Organizational Properties</name>
        <section anchor="vcard-prop-contact-uri">
          <name>CONTACT-URI</name>
          <t>A
          <t>The CONTACT-URI property as defined (<xref target="RFC8605" derivedContent="RFC8605" section="2.1" sectionFormat="of"/>) converts to a Link object (<xref target="RFC9553" derivedContent="RFC9553" section="2.6.3" sectionFormat="of"/>) in <xref target="RFC8605"/> is represented as an entry of the <tt>links</tt> Card object's links property (<xref target="contact_uri_conversion"/>).  The entry value is a <tt>Link</tt> object whose  <tt>kind</tt> Link object's kind property is set to <tt>contact</tt> "contact" and <tt>uri</tt> the uri property is set to the CONTACT-URI property value.</t>
          <t>The PREF and TYPE parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="contact_uri_conversion">
            <name>CONTACT-URI conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
CONTACT-URI;PREF=1:mailto:contact@example.com
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"links": {
  "CONTACT-1": {
    "kind": "contact",
    "uri": "mailto:contact@example.com",
    "pref": 1
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-logo">
          <name>LOGO</name>
          <t>A
          <t>The LOGO property (<xref target="RFC6350" derivedContent="RFC6350" section="6.6.3" sectionFormat="of"/>) converts to an entry a Media object (<xref target="RFC9553" derivedContent="RFC9553" section="2.6.4" sectionFormat="of"/>) in the <tt>media</tt> Card object's media property (<xref target="logo_conversion"/>).  The entry value is a <tt>Media</tt> object whose <tt>kind</tt> Media object's kind property is set to <tt>logo</tt> "logo" and <tt>uri</tt> the uri property is set to the LOGO property value.</t>
          <t>The PREF and TYPE parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="logo_conversion">
            <name>LOGO conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
LOGO:https://www.example.com/pub/logos/abccorp.jpg
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"media": {
  "LOGO-1": {
    "kind": "logo",
    "uri": "https://www.example.com/pub/logos/abccorp.jpg"
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-member">
          <name>MEMBER</name>
	  <t>The uids of the contact cards composing the group are included in MEMBER property (<xref target="RFC6350" derivedContent="RFC6350" section="6.6.5" sectionFormat="of"/>) converts to the <tt>members</tt> Card object's members property (<xref target="group_example"/>).</t>
          <t>In this case, target="group_example"/>).  Each MEMBER property value is a key in the members property.  The PREF parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.3" sectionFormat="of"/>) does not have a JSContact counterpart; however, the implementors <bcp14>MAY</bcp14> insert the map entries by order of preference.</t> convert to JSContact.</t>
          <figure anchor="group_example">
            <name>Group example</name>
            <artwork><![CDATA[ Example</name>
            <sourcecode type="text/plain"><![CDATA[
KIND:group
FN:The Doe family
MEMBER:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af
MEMBER:urn:uuid:b8767877-b4a1-4c70-9acc-505d3819e519
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"kind": "group",
"name": {
  "full": "The Doe family"
},
"uid": "urn:uuid:ab4310aa-fa43-11e9-8f0b-362b9e155667",
"members": {
  "urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af": true,
  "urn:uuid:b8767877-b4a1-4c70-9acc-505d3819e519": true
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-org">
          <name>ORG</name>
          <t>An
          <t>The ORG property (<xref target="RFC6350" derivedContent="RFC6350" section="6.6.4" sectionFormat="of"/>) converts to an entry Organization object (<xref target="RFC9553" derivedContent="RFC9553" section="2.2.3" sectionFormat="of"/>) in the <tt>organizations</tt> Card object's organizations property (<xref target="org_conversion"/>).  The entry value is an <tt>Organization</tt> object whose <tt>name</tt> Organization object's name property contains is set to the ORG property organizational name, and the <tt>units</tt> name component.  The Organization object's units property is an array of <tt>OrgUnit</tt> OrgUnit objects that each containing the contain an organizational unit name in component value of the <tt>name</tt> property.</t> ORG property value.</t>
          <t>Implementations <bcp14>MAY</bcp14> allow representation of organizational units without the organizational name.  In this case, the first component of the ORG value <bcp14>MUST</bcp14> be an empty string (e.g.,  ORG:;DepartmentA).</t>
          <t>The ALTID, ALTID and LANGUAGE parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <t>The first item of the comma-separated SORT-AS parameter value converts to the <tt>sortAs</tt> sortAs property of the <tt>Organization</tt> Organization object.  The subsequent items convert to the <tt>sortAs</tt> sortAs property of the corresponding <tt>OrgUnit</tt> OrgUnit object.</t>
          <t>The TYPE parameter converts according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="org_conversion">
            <name>ORG conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
ORG;SORT-AS="ABC":ABC\, Inc.;North American Division;Marketing
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"organizations": {
  "ORG-1": {
    "name": "ABC, Inc.",
    "units":[
      { "name": "North American Division" },
      { "name": "Marketing" }
    ],
    "sortAs": "ABC"
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-related">
          <name>RELATED</name>
          <t>This
          <t>The RELATED property (<xref target="RFC6350" derivedContent="RFC6350" section="6.6.6" sectionFormat="of"/>) converts to an entry in the <tt>relatedTo</tt> Card object's relatedTo property (<xref target="related_conversion"/>).  The property value converts to the key in the <tt>relatedTo</tt> relatedTo property.  The TYPE parameters convert to the <tt>relation</tt> of the <tt>Relation</tt> object value. Relation object's relation property (<xref target="RFC9553" derivedContent="RFC9553" section="2.1.8" sectionFormat="of"/>).  Any other parameters convert as defined in <xref target="jscontact-prop-vcardparams"/>.</t>
          <figure anchor="related_conversion">
            <name>RELATED conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
RELATED;TYPE=friend:urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6
RELATED;TYPE=contact:https://example.com/directory/john.vcf
RELATED;VALUE=text:Please contact my deputy John for any inquiries.
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"relatedTo" : {
  "urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6" : {
    "relation" : {
      "friend" : true
    }
  },
  "https://example.com/directory/john.vcf" : {
    "relation" : {
      "contact" : true
    }
  },
  "Please contact my deputy John for any inquiries." : {
    "relation" : { }
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-title">
          <name>TITLE and ROLE</name>
          <t>Both
          <t>The TITLE (<xref target="RFC6350" derivedContent="RFC6350" section="6.6.1" sectionFormat="of"/>) and ROLE (<xref target="RFC6350" derivedContent="RFC6350" section="6.6.2" sectionFormat="of"/>) properties are represented as entries of convert to a Title object (<xref target="RFC9553" derivedContent="RFC9553" section="2.2.5" sectionFormat="of"/>) in the <tt>titles</tt> Card object's titles property (<xref target="title_role_conversion"/>).  The entry value is a <tt>Title</tt> object whose <tt>kind</tt> Title object's kind property is set to <tt>title</tt> "title" or <tt>role</tt> "role" for the TITLE and ROLE vCard properties, respectively.  The <tt>name</tt> name property is set to the vCard property value.</t>
          <t>The value of the <tt>organization</tt> organizationId property can be derived if the TITLE or ROLE property is a member of a vCard property group and if exactly one other ORG property also is also a part of that group.</t>
          <t>The ALTID and LANGUAGE parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="title_role_conversion">
            <name>TITLE and ROLE conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
TITLE:Research Scientist
group1.ROLE:Project Leader
group1.ORG:ABC, Inc.
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"titles": {
  "TITLE-1": {
    "kind": "title",
    "name": "Project Leader" "Research Scientist"
  },
  "TITLE-2": {
    "kind": "role",
    "name": "Research Scientist",
    "organization": "Project Leader",
    "organizationId": "ORG-1"
  }
},
"organizations": {
  "ORG-1": {
    "name": "ABC, Inc."
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
      </section>
      <section>
        <name>Personal Information Properties</name>
        <section anchor="vcard-prop-expertise">
          <name>EXPERTISE</name>
          <t>An
          <t>The EXPERTISE property as defined in <xref target="RFC6715"/> is represented as (<xref target="RFC6715" derivedContent="RFC6715" section="2.1" sectionFormat="of"/>) converts to a <tt>PersonalInfo</tt> PersonalInfo object (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.4" sectionFormat="of"/>) in the <tt>personalInfo</tt> Card object's personalInfo property (<xref target="expertise_conversion"/>).  The <tt>kind</tt> PersonalInfo object's kind property is set to "expertise".</t>
          <t>The INDEX parameter converts and LEVEL parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="expertise_conversion">
            <name>EXPERTISE conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
EXPERTISE;LEVEL=beginner;INDEX=2:Chinese literature
EXPERTISE;INDEX=1;LEVEL=expert:chemistry
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"personalInfo": {
  "PERSINFO-1" : {
    "kind": "expertise",
    "value": "Chinese literature",
     "level": "low",
     "listAs": 2
  },
  "PERSINFO-2" : {
    "kind": "expertise",
    "value": "chemistry",
    "level": "high",
    "listAs": 1
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-hobby">
          <name>HOBBY</name>
          <t>A
          <t>The HOBBY property as defined in <xref target="RFC6715"/> is represented as (<xref target="RFC6715" derivedContent="RFC6715" section="2.2" sectionFormat="of"/>) converts to a <tt>PersonalInfo</tt> PersonalInfo object (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.4" sectionFormat="of"/>) in the <tt>personalInfo</tt> Card object's personalInfo property (<xref target="hobby_conversion"/>).  The <tt>kind</tt> PersonalInfo object's kind property is set to "hobby".</t>
          <t>The INDEX parameter converts and LEVEL parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="hobby_conversion">
            <name>HOBBY conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
HOBBY;INDEX=1;LEVEL=high:reading
HOBBY;INDEX=2;LEVEL=high:sewing
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"personalInfo": {
  "PERSINFO-1" : {
    "kind": "hobby",
    "value": "reading",
    "level": "high",
    "listAs": 1
  },
  "PERSINFO-2" : {
    "kind": "hobby",
    "value": "sewing",
    "level": "high",
    "listAs": 2
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-interest">
          <name>INTEREST</name>
          <t>An
          <t>The INTEREST property as defined in <xref target="RFC6715"/> is represented as (<xref target="RFC6715" derivedContent="RFC6715" section="2.3" sectionFormat="of"/>) converts to a <tt>PersonalInfo</tt> PersonalInfo object (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.4" sectionFormat="of"/>) in the <tt>personalInfo</tt> Card object's personalInfo property (<xref target="interest_conversion"/>).  The <tt>kind</tt> PersonalInfo object's kind property is set to "interest".</t>
          <t>The INDEX parameter converts and LEVEL parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="interest_conversion">
            <name>INTEREST conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
INTEREST;INDEX=1;LEVEL=medium:r&b music
INTEREST;INDEX=2;LEVEL=high:rock&roll music
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"personalInfo": {
  "PERSINFO-1" : {
    "kind": "interest",
    "value": "r&b music",
    "level": "medium",
    "listAs": 1
  },
  "PERSINFO-2" : {
    "kind": "interest",
    "value": "rock&roll music",
    "level": "high",
    "listAs": 2
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-org-directory">
          <name>ORG-DIRECTORY</name>
          <t>The ORG-DIRECTORY property (<xref target="RFC6715" derivedContent="RFC6715" section="2.4" sectionFormat="of"/>) <xref target="RFC6715"/> converts to a Directory object (<xref target="RFC9553" derivedContent="RFC9553" section="2.6.2" sectionFormat="of"/>) in the <tt>directories</tt> Card object's directories property (<xref target="org_directory_conversion"/>).  The <tt>kind</tt> Directory object's kind property is set to <tt>directory</tt>. "directory".  The <tt>uri</tt> uri property is set to the ORG-DIRECTORY property value.</t>
          <t>The INDEX, PREF PREF, and TYPE parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="org_directory_conversion">
            <name>ORG-DIRECTORY conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
ORG-DIRECTORY;INDEX=1:https://directory.mycompany.example.com
ORG-DIRECTORY;PREF=1:ldap://ldap.tech.example/o=Tech,ou=Engineering
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"directories": {
  "DIRECTORY-1": {
    "kind": "directory",
    "uri": "https://directory.mycompany.example.com",
    "listAs": 1
  },
  "DIRECTORY-2": {
    "kind": "directory",
    "uri": "ldap://ldap.tech.example/o=Tech,ou=Engineering",
    "pref": 1
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
      </section>
      <section>

        <name>Explanatory Properties</name>
        <section anchor="vcard-prop-categories">
          <name>CATEGORIES</name>
          <t>A
          <t>The CATEGORIES property (<xref target="RFC6350" derivedContent="RFC6350" section="6.7.1" sectionFormat="of"/>) converts to a set of entries of the <tt>keywords</tt> Card object's keywords property (<xref target="categories_conversion"/>).  The keys are the comma-separated text values of the CATEGORIES property.</t>
          <t>In this case, the PREF parameter does not have a JSContact counterpart; however, the implementors <bcp14>MAY</bcp14> insert the map entries by order of preference.</t>
          <figure anchor="categories_conversion">
            <name>CATEGORIES conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
CATEGORIES:internet,IETF,Industry,Information Technology
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"keywords": {
  "internet": true,
  "IETF": true,
  "Industry": true,
  "Information Technology": true
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-pid">
          <name>CLIENTPIDMAP and PID Parameter</name>
          <t>These convert anchor="vcard-prop-clientpidmap">
          <name>CLIENTPIDMAP</name>
          <t>The CLIENTPIDMAP property (<xref target="RFC6350" derivedContent="RFC6350" section="6.7.7" sectionFormat="of"/>) converts to the <xref target="jscontact-prop-vcardprops"><tt>vCardProps</tt></xref> and <xref target="jscontact-prop-vcardparams"><tt>vCardParams</tt></xref> properties.</t> target="jscontact-prop-vcardprops">vCardProps</xref> property.</t>
        </section>
        <section anchor="vcard-prop-created">
          <name>CREATED</name>
	  <t>The CREATED property (<xref target="RFC9554" derivedContent="RFC9554" section="3.1" sectionFormat="of"/>) converts to the <tt>created</tt> Card object's created property (<xref target="created_conversion"/>).</t>
          <figure anchor="created_conversion">
            <name>CREATED conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
CREATED:19940930T143510Z
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"created": "1994-09-30T14:35:10Z"
]]></artwork>
]]></sourcecode>
          </figure>
          <t>Note: This property is defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</t>
        </section>
        <section anchor="vcard-prop-note">
          <name>NOTE</name>
          <t>A
          <t>The NOTE property (<xref target="RFC6350" derivedContent="RFC6350" section="6.7.2" sectionFormat="of"/>) converts to a <tt>Note</tt> Note object (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.3" sectionFormat="of"/>) in the <tt>notes</tt> map Card object's notes property (<xref target="notes_conversion"/>).</t>
          <t>The ALTID and LANGUAGE parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="notes_conversion">
            <name>NOTE conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
NOTE;CREATED=20221123T150132Z;AUTHOR-NAME="John":
  Office hours are from 0800 to 1715 EST\, Mon-Fri.
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"notes": {
  "NOTE-1" : {
     "note": "Office hours are from 0800 to 1715 EST, Mon-Fri.",
     "created": "2022-11-23T15:01:32Z",
     "author": {
       "name": "John"
     }
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-prodid">
          <name>PRODID</name>
          <t>The PRODID property (<xref target="RFC6350" derivedContent="RFC6350" section="6.7.3" sectionFormat="of"/>) converts to the <tt>prodId</tt> Card object's prodId property (<xref target="prodid_conversion"/>).</t>
          <figure anchor="prodid_conversion">
            <name>PRODID conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
PRODID:ACME Contacts App version 1.23.5
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"prodId": "ACME Contacts App version 1.23.5"
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-rev">
          <name>REV</name>
          <t>The REV property (<xref target="RFC6350" derivedContent="RFC6350" section="6.7.4" sectionFormat="of"/>) converts to the <tt>updated</tt> Card object's updated property (<xref target="rev_conversion"/>).</t>
          <figure anchor="rev_conversion">
            <name>REV conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
REV:19951031T222710Z
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"updated": "1995-10-31T22:27:10Z"
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-sound">
          <name>SOUND</name>
          <t>A
          <t>The SOUND property (<xref target="RFC6350" derivedContent="RFC6350" section="6.7.5" sectionFormat="of"/>) converts to an entry a Media object (<xref target="RFC9553" derivedContent="RFC9553" section="2.6.4" sectionFormat="of"/>) in the <tt>media</tt> Card object's media property (<xref target="sound_conversion"/>).  The entry value is a <tt>Media</tt> object whose <tt>kind</tt> Media object's kind property is set to <tt>sound</tt> "sound" and <tt>uri</tt> the uri property is set to the SOUND value.</t>
          <t>The PREF and TYPE parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="sound_conversion">
            <name>SOUND conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
SOUND:CID:JOHNQPUBLIC.19960229T080000.xyzMail@example.com
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"media": {
  ...
  "SOUND-1": {
    "kind": "sound",
    "uri": "CID:JOHNQPUBLIC.19960229T080000.xyzMail@example.com"
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>

        <section anchor="vcard-prop-uid">
          <name>UID</name>
          <t>The UID property corresponds (<xref target="RFC6350" derivedContent="RFC6350" section="6.7.6" sectionFormat="of"/>) converts to the <tt>uid</tt> Card object's uid property (<xref target="uid_conversion"/>).</t>
          <figure anchor="uid_conversion">
            <name>UID conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
UID:urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"uid": "urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6"
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-url">
          <name>URL</name>
          <t>A
          <t>The URL property (<xref target="RFC6350" derivedContent="RFC6350" section="6.7.8" sectionFormat="of"/>) converts to an entry a Link object (<xref target="RFC9553" derivedContent="RFC9553" section="2.6.3" sectionFormat="of"/>) in the <tt>links</tt> Card object's links property (<xref target="url_conversion"/>).  The entry value is a <tt>Link</tt> object whose <tt>uri</tt> Link object's uri property is set to the URL value.</t>
          <t>The PREF and TYPE parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="url_conversion">
            <name>URL conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
URL:https://example.org/restaurant.french/~chezchic.html
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"links": {
  "LINK-1": {
    "uri": "https://example.org/restaurant.french/~chezchic.html"
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-version">
          <name>VERSION</name>
          <t>This
          <t>The VERSION property (<xref target="RFC6350" derivedContent="RFC6350" section="6.7.9" sectionFormat="of"/>) converts to an entry in the <xref target="jscontact-prop-vcardprops"><tt>vCardProps</tt></xref> target="jscontact-prop-vcardprops">vCardProps</xref> property.</t>
        </section>
        <section anchor="vcard-prop-xablabel">
          <name>X-ABLabel</name>
          <t>This
          <t>The X-ABLabel property is experimental but widely in use in existing vCard data.  It converts to the <tt>label</tt> label property of a JSContact object type. object.
	  The X-ABLabel property is preceded by a vCard property group name, and the label converts to the JSContact object object, which got was converted from a vCard property having of the same group.</t>
          <t>The group name is not preserved, preserved; implementations are free to choose any unique group name when converting back to vCard.  For an example on how to preserve the group name name, see <xref target="vcard-param-group"/>.</t>
          <figure anchor="xablabel_conversion">
            <name>X-ABLabel conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
item1.TEL;VALUE=uri:tel:+1-555-555-5555
item1.X-ABLabel:foo
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"phones": {
  "p1": {
    "number": "tel:+1-555-555-5555",
    "label": "foo"
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
      </section>
      <section>
        <name>Security Properties</name>
        <section anchor="vcard-prop-key">
          <name>KEY</name>
          <t>A
          <t>The KEY property (<xref target="RFC6350" derivedContent="RFC6350" section="6.8.1" sectionFormat="of"/>) converts to an entry a CryptoKey object (<xref target="RFC9553" derivedContent="RFC9553" section="2.6.1" sectionFormat="of"/>) in the <tt>cryptoKeys</tt> Card object's cryptoKeys property (<xref target="key_conversion"/>).  The entry value is a <tt>CryptoKey</tt> object whose <tt>uri</tt> CryptoKey object's uri property is set to the KEY property value.</t>
          <t>The PREF and TYPE parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="key_conversion">
            <name>KEY conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
KEY:https://www.example.com/keys/jdoe.cer
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"cryptoKeys": {
  "KEY-1": {
    "uri": "https://www.example.com/keys/jdoe.cer"
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
      </section>
      <section>
        <name>Calendar Properties</name>
        <section anchor="vcard-prop-caladruri">
          <name>CALADRURI</name>
          <t>A
          <t>The CALADRURI property (<xref target="RFC6350" derivedContent="RFC6350" section="6.9.2" sectionFormat="of"/>) converts to an entry a SchedulingAddress object (<xref target="RFC9553" derivedContent="RFC9553" section="2.4.2" sectionFormat="of"/>) in the <tt>schedulingAddresses</tt> Card object's schedulingAddresses property (<xref target="caladruri_conversion"/>).  The entry value is a <tt>SchedulingAddress</tt> object whose <tt>uri</tt> SchedulingAddress object's uri property is set to the CALADRURI value.</t>
          <t>The PREF parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.3" sectionFormat="of"/>) converts according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="caladruri_conversion">
            <name>CALADRURI conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
CALADRURI;PREF=1:mailto:janedoe@example.com
CALADRURI:https://example.com/calendar/jdoe
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"schedulingAddresses": {
  "SCHEDULING-1": {
    "uri": "mailto:janedoe@example.com",
    "pref": 1
  },
  "SCHEDULING-2": {
    "uri": "https://example.com/calendar/jdoe"
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-caluri">
          <name>CALURI</name>
          <t>A
          <t>The CALURI property (<xref target="RFC6350" derivedContent="RFC6350" section="6.9.3" sectionFormat="of"/>) converts to an entry a Calendar object (<xref target="RFC9553" derivedContent="RFC9553" section="2.4.1" sectionFormat="of"/>) in the <tt>calendars</tt> Card object's calendars property (<xref target="caluri_conversion"/>).  The entry value is a <tt>Calendar</tt> object whose <tt>kind</tt> Calendar object's kind property is set to <tt>calendar</tt> "calendar" and <tt>uri</tt> the uri property is set to the CALURI value.</t>
          <t>The PREF and TYPE parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="caluri_conversion">
            <name>CALURI conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
CALURI;PREF=1:https://cal.example.com/calA
CALURI;MEDIATYPE=text/calendar:https://ftp.example.com/calA.ics
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"calendars": {
  "CAL-1": {
    "kind": "calendar",
    "uri": "https://cal.example.com/calA",
    "pref": 1
  },
  "CAL-2": {
    "kind": "calendar",
    "uri": "https://ftp.example.com/calA.ics",
    "mediaType": "text/calendar"
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
        <section anchor="vcard-prop-fburl">
          <name>FBURL</name>
          <t>An
          <t>The FBURL property (<xref target="RFC6350" derivedContent="RFC6350" section="6.9.1" sectionFormat="of"/>) converts to an entry a Calendar object (<xref target="RFC9553" derivedContent="RFC9553" section="2.4.1" sectionFormat="of"/>) in the <tt>calendars</tt> Card object's calendars property (<xref target="fburl_conversion"/>).  The entry value is a <tt>Calendar</tt> object whose <tt>kind</tt> Calendar object's kind property is set to <tt>freeBusy</tt> "freeBusy" and <tt>uri</tt> the uri property is set to the FBURL value.</t>
          <t>The PREF and TYPE parameters convert according to the rules as defined in <xref target="vcard-parameters"/>.</t>
          <figure anchor="fburl_conversion">
            <name>FBURL conversion example</name>
            <artwork><![CDATA[ Conversion Example</name>
            <sourcecode type="text/plain"><![CDATA[
FBURL;PREF=1:https://www.example.com/busy/janedoe
FBURL;MEDIATYPE=text/calendar:https://example.com/busy/project-a.ifb
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"calendars": {
  "FBURL-1": {
    "kind": "freeBusy",
    "uri": "https://www.example.com/busy/janedoe",
    "pref": 1
  },
  "FBURL-2": {
    "kind": "freeBusy",
    "uri": "https://example.com/busy/project-a.ifb",
    "mediaType": "text/calendar"
  }
}
]]></artwork>
]]></sourcecode>
          </figure>
        </section>
      </section>
      <section anchor="vcard-extended">
        <name>Extended Properties and Parameters</name>
        <t>These
        <t>Extended properties and parameters convert as specified in <xref target="new-jscontact"/>.</t>
      </section>
      <section anchor="new-jscontact">
        <name>New JSContact properties</name> Properties</name>
        <t>vCards may contain properties or parameters for which no IANA-registered JSContact property is defined.  For example, a vCard may contain properties and parameters of which the semantics or purposes are unknown to the implementation; see <xref target="RFC6350" sectionFormat="of" section="6.10"/>.</t>
        <t>This section defines JSContact properties by which such vCard properties and parameters <bcp14>MAY</bcp14> be represented in JSContact.  Implementations <bcp14>MAY</bcp14> choose to convert differently if they deem that more appropriate.</t>
        <section anchor="jscontact-prop-vcardprops">
          <name>Property <tt>vCardProps</tt></name>
          <name>vCardProps</name>
          <dl>
            <dt>Name:</dt>
            <dd>
              <tt>vCardProps</tt>
            </dd>
            <dt>Type:</dt>
            <dd><tt>JCardProp[]</tt>, where <tt>JCardProp</tt> denotes a jCard-encoded
            <dt>vCardProps: JCardProp[] (optional).</dt>
            <dd>Contains vCard property as defined in <xref target="RFC7095" section="3.3"/>.
</dd>
            <dt>Definition:</dt>
            <dd>This property is set on a JSContact object that represents a vCard.  It contains properties that are set in the vCard represented by this JSContact object.  Each entry in this list typically represents  The JCardProp type denotes a jCard-encoded vCard property for which no conversion to an IANA-registered JSContact property is defined.</dd> as defined in <xref target="RFC7095" sectionFormat="of" section="3.3"/>.</dd>
            <dt>Example:</dt>
            <dd>
              <t>This illustrates how to convert a vCard extension property:</t>
              <figure anchor="props_conversion">
                <name>JSContact <tt>vCardProps</tt> example</name>
                <artwork><![CDATA[ vCardProps Example</name>
                <sourcecode type="text/plain"><![CDATA[
item1.X-FOO;X-BAR=Hello:World!
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"vCardProps": [
  ["x-foo", {
    "x-bar": "Hello",
    "group": "item1"
  }, "unknown", "World!"]
]
]]></artwork>
]]></sourcecode>
              </figure>
            </dd>
          </dl>
        </section>
        <section anchor="jscontact-prop-vcardparams">
          <name>Property <tt>vCardParams</tt></name>
          <name>vCardParams</name>
          <dl>
            <dt>Name:</dt>
            <dd>
              <tt>vCardParams</tt>
            </dd>
            <dt>Type:</dt>
            <dd>
              <tt>String[String|String[]]</tt>
            </dd>
            <dt>Definition:</dt>
            <dd>This property is
            <dt>vCardParams: String[String|String[]] (optional).</dt>
            <dd>Contains vCard parameters that are set on a JSContact object that represents a the vCard property.  Its property represented by this JSContact object.  The value <bcp14>MUST</bcp14> be a JSON object containing vCard property parameters, defined parameters as array element 2 defined in <xref target="RFC7095" sectionFormat="of" section="3.3"/>.  Each entry represents a parameter of the vCard property that converts to the JSContact object.</dd>
            <dt>Example:</dt>
            <dd>
              <t>This illustrates how to convert a vCard extension parameter:</t>
              <figure anchor="params_conversion">
                <name>JSContact <tt>vCardParams</tt> example</name>
                <artwork><![CDATA[ vCardParams Example</name>
                <sourcecode type="text/plain"><![CDATA[
EMAIL;X-FOO=Bar:jane_doe@example.com
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"emails": {
  "email1": {
    "address": "jane_doe@example.com",
    "vCardParams": {
      "x-foo": "Bar"
    }
  }
}
]]></artwork>
]]></sourcecode>
              </figure>
            </dd>
          </dl>
        </section>
        <section anchor="jscontact-prop-vcardname">
          <name>Property <tt>vCardName</tt></name>
          <name>vCardName</name>
          <dl>
            <dt>Name:</dt>
            <dd>
              <tt>vCardName</tt>
            </dd>
            <dt>Type:</dt>
            <dd>
              <tt>String</tt>
            </dd>
            <dt>Definition:</dt>
            <dd>This property is set on a JSContact object that represents a vCard property or parameter and its value contains
            <dt>vCardName: String (optional).</dt>
            <dd>Contains the name of that the vCard element.  This element that is represented by this JSContact object.  For example, this allows to preserve the name of a vCard element property when multiple elements vCard properties convert the same JSContact object type.  The case-insensitive value <bcp14>MUST</bcp14> be valid according to the <tt>name</tt> "name" ABNF defined in <xref target="RFC6350" sectionFormat="of" section="3.3"/>.</dd>
            <dt>Example:</dt>

            <dd>
              <t>Both vCard IMPP and SOCIALPROFILE convert to an OnlineService object (<xref target="RFC9553" derivedContent="RFC9553" section="2.3.2" sectionFormat="of"/>) in JSContact.  The <tt>vCardName</tt> vCardName property value indicates that the vCard source element was IMPP:</t> IMPP as follows:</t>
              <figure anchor="example-vcardname">
                <name>JSContact <tt>vCardName</tt> example</name>
                <artwork><![CDATA[ vCardName Example</name>
                <sourcecode type="text/plain"><![CDATA[
IMPP:xmpp:alice@example.com
]]></sourcecode>
            <sourcecode type="json"><![CDATA[
"onlineServices": {
  "os1": {
    "uri": "xmpp:alice@example.com",
    "vCardName": "impp"
  },
}
]]></artwork>
]]></sourcecode>
              </figure>
            </dd>
          </dl>
        </section>
      </section>
    </section>
    <section anchor="convert-jscontact-to-vcard">
      <name>Converting JSContact to vCard</name>
      <section>
        <name>Conversion Rules</name>
        <t>A <tt>Card</tt> Card object converts to vCard by applying the reverse rules of converting vCard to JSContact.  In addition to those listed in <xref target="convert_jscontact_to_vcard-reverse-rules"/>, the following rules apply:</t>
        <ul>
          <li>Multivalued JSContact properties convert to separate instances of their equivalent vCard property, and for each of the PROP-ID parameter parameters <bcp14>MUST</bcp14> be set to the <tt>Id</tt> Id-typed key of the converted value (see <xref target="vcard-param-propid"/>).</li>
          <li>
            <t>The <tt>full</tt> full property of the <tt>name</tt> name property in JSContact is optional, but the FN property is mandatory in vCard.  The following rules apply:</t>
            <ul>
              <li>If the Name <tt>full</tt> object's full property is set, then implementations <bcp14>MUST</bcp14> use its value for the vCard FN property.</li>
              <li>If the Name <tt>full</tt> object's full property is not set, then implementations <bcp14>SHOULD</bcp14> derive the full name from the Name <tt>components</tt> object's components property values.  If the <tt>isOrdered</tt> isOrdered property is true, "true", then this can be done by concatenating the name component values.  Otherwise, or alternatively, an implementation can choose any other heuristic to generate the full name from its components, components such as <xref target="CLDRPersonName"/>.  Implementations <bcp14>MUST</bcp14> set the DERIVED parameter on the FN property.</li>
              <li>Otherwise, they <bcp14>MUST</bcp14> set the FN property <bcp14>MUST</bcp14> be set to the empty value.</li>
            </ul>
          </li>
          <li>Vendor-specific and unknown properties convert to vCard as outlined in <xref target="jscontact-convert-unknown"/>.</li>
        </ul>
        <section anchor="jscontact-convert-unknown">
          <name>Converting unknown properties</name> Unknown Properties</name>
          <t>JSContact object types objects may contain properties for which no IANA-registered vCard property is defined.  For example, a JSContact object may contain vendor-specific properties of which the semantics or purpose are unknown.</t>
          <t>This specification defines the new <xref target="vcard-prop-jsprop"><tt>JSPROP</tt></xref> target="vcard-prop-jsprop">JSPROP</xref> vCard property and <xref target="vcard-param-jsptr"><tt>JSPTR</tt></xref> target="vcard-param-jsptr">JSPTR</xref> vCard parameter by which such JSContact properties <bcp14>MAY</bcp14> be represented in vCard.  Implementations <bcp14>MAY</bcp14> choose to convert differently if they deem that more appropriate.</t>
        </section>
      </section>
      <section anchor="new-vcard-props">
        <name>New vCard Properties</name>
        <section anchor="vcard-prop-jsprop">
          <name>JSPROP</name>
          <dl>
            <dt>Property name:</dt>
            <dd>JSPROP</dd>
            <dt>Purpose:</dt>
            <dd>This property represents
            <dd>Represents a JSContact property in vCard.</dd>
            <dt>Value type:</dt>
            <dd>TEXT,
            <dd>TEXT; also see Format Definition "Format definition" below for value restrictions.</dd>
            <dt>Conformance:</dt>
            <dd>The property can
            <dd>Can be specified multiple times in a vCard.</dd>
            <dt>Property parameters:</dt>
            <dd>
          The JSPTR parameter <bcp14>MUST</bcp14> be set for this property.
          Other IANA-registered and experimental property parameters can be specified on this property.
        </dd>
            <dt>Description:</dt>
            <dd>
		    <t>This property converts an arbitrary JSContact property from and to vCard.  The vCard property value is the JSON-encoded value of the JSContact property, represented as a TEXT value.  The format of the JSON value <bcp14>MUST</bcp14> be compact, e.g., without insignificant whitespace. whitespace as defined in <xref target="RFC8259" format="default" sectionFormat="of" derivedContent="RFC8259" section="2"/>.  The value of the JSPTR parameter points to the JSContact property within the Card.</t>
                <t>The root of the JSON pointer is always the Card object that this vCard converts to, irrespective if the JSON pointer starts with the SOLIDUS (U+002F) character.  The pointer <bcp14>MUST NOT</bcp14> reference into an array.</t>
                <t>All JSPROP properties in a vCard together form a PatchObject as defined in <xref target="I-D.ietf-calext-jscontact"/>. target="RFC9553"/>.  The value of its JSPTR parameter corresponds to a key in the PatchObject, PatchObject; the value of the JSPROP property corresponds to the value for that key.  When converting from vCard to JSContact, the PatchObject <bcp14>MUST</bcp14> only be applied after all other vCard properties have already been converted.  The PatchObject <bcp14>MUST</bcp14> be valid, including the restriction that an invalid PatchObject <bcp14>MUST NOT</bcp14> be applied.</t>
            </dd>
            <dt>Format definition:</dt>
            <dd>
              <t>This property is defined by the following notation:</t>

           <sourcecode name="" type="abnf"><![CDATA[
jsprop = "JSPROP" jsprop-param ":" TEXT

jsprop-param  = *(
            ; The following are MANDATORY and MUST NOT
            ; occur more than once
            ( ";" jsptr-param ) /    ; see next section
            ( ";" "VALUE" "=" "TEXT")
            ;
            ; The following is OPTIONAL, OPTIONAL
            ; and MAY occur more than once.
            ;
            (";" other-param)
            ;
            )
]]></sourcecode>
            </dd>
            <dt anchor="vcard-prop-jsprop-examples">Example(s):</dt>
            <dd>
              <t>This illustrates how to convert a property at the top-level top level in a Card object that is unknown to the implementation.</t>
              <figure anchor="jscontact-prop-unknown">
                <name>Unknown property example</name>
                <artwork><![CDATA[ Property Example</name>
                <sourcecode type="json"><![CDATA[
"someUnknownProperty": true
]]></sourcecode>
            <sourcecode type="text/plain"><![CDATA[
JSPROP;JSPTR="someUnknownProperty":true
]]></artwork>
]]></sourcecode>
              </figure>
              <t>This illustrates how to convert a vendor-specific property at the top-level top level of a Card object.  Note the required use of quoted string for the JSPTR value value, which allows the path to include the COLON (U+003A) character.</t>
              <figure anchor="jscontact-prop-vendor-specific">
                <name>Vendor-specific property conversion example</name>
                <artwork><![CDATA[
                <name>Vendor-Specific Property Conversion Example</name>
                <sourcecode type="json"><![CDATA[
"example.com:foo": {
  "bar": 1234
}
]]></sourcecode>
            <sourcecode type="text/plain"><![CDATA[
JSPROP;JSPTR="example.com:foo":{"bar":1234}
]]></artwork>
]]></sourcecode>
              </figure>
              <t>This illustrates how to convert a vendor-specific property at a nested level in a Card object using a path relative to the Card object.  Although not recommended, the property name includes the SOLIDUS (U+002F) character character, which requires escaping in the JSON pointer.</t>
              <figure anchor="jscontact-prop-nested">
                <name>Nested vendor-specific property example Vendor-Specific Property Example with path relative a Path Relative to Card</name>
                <artwork><![CDATA[
                <sourcecode type="json"><![CDATA[
"phones": {
  "phone1": {
    "number": "tel:+33-01-23-45-67" "tel:+33-01-23-45-67",
    "example.com:foo/bar": "tux hux"
  }
}
]]></sourcecode>
            <sourcecode type="text/plain"><![CDATA[
TEL:tel:+33-01-23-45-67
JSPROP;JSPTR="phones/phone1/example.com:foo~1bar":
 "tux hux"
]]></artwork>
]]></sourcecode>
              </figure>
            </dd>
          </dl>
        </section>
      </section>
      <section>
        <name>New vCard Parameter</name> Parameters</name>
        <section anchor="vcard-param-jscomps">
          <name>JSCOMPS</name>
          <dl>
            <dt>Parameter name:</dt>
            <dd>JSCOMPS</dd>
            <dt>Purpose:</dt>
            <dd>This parameter defines
            <dd>Defines the order and separators for the elements of a structured property value.</dd>
            <dt>Description:</dt>
            <dd>
              <t>The JSCOMPS parameter value facilitates converting name and address components between JSContact and vCard.  It preserves the order of the components of the JSContact property and contains the verbatim values of separator components.</t>
              <t>If this parameter is set and its value is valid (see later), then implementations <bcp14>MUST</bcp14> set the <tt>isOrdered</tt> isOrdered property of the Name or Address object to "true". Otherwise, they <bcp14>MUST</bcp14> set the <tt>isOrdered</tt> isOrdered property value to "false".</t>
              <t>The JSCOMPS parameter value is a structured type value. Its value <bcp14>MUST</bcp14> be quoted.  The parameter value consists of a sequence of entries, separated by the SEMICOLON character (U+003B).  The first entry defines the value of the <tt>defaultSeparator</tt> defaultSeparator property.  If it is the empty string string, then no default separator is defined. Otherwise, the first entry <bcp14>MUST</bcp14> be a separator entry.  All following entries processed in order result in an ordered list of JSContact components, components and <bcp14>MUST</bcp14> be one of two the following two kinds:</t>
              <ol>
                <li>
                  <t>A positional.  This refers to a component value in the vCard structured value value.  A position consists of the numeric index of a component in the structured value, optionally followed by a COMMA (U+002C) character and the non-zero index of a value within that component.  The zero index selects the first component or value, respectively.  The second index by default is zero, zero by default, in which case it <bcp14>MUST</bcp14> be omitted (as well as the leading COMMA).</t>
                  <t>The resulting JSContact component is formed by determining its kind by the position in the vCard structured value.  The component value is the verbatim value of the vCard component.  Figures <xref target="vcard-param-jscomps-example-positional"/> target="vcard-param-jscomps-example-positional" format="counter"/> and <xref target="vcard-param-jscomps-example-n-secondary-index"/> target="vcard-param-jscomps-example-n-secondary-index" format="counter"/> illustrate this by example.</t>
                </li>
                <li>
                  <t>A separator.  This contains the verbatim value of a separator component.  It starts with the LATIN SMALL LETTER S (U+0073) character, followed by the COMMA (U+002C), (U+002C) character, followed by zero or more "param-value" characters (see <xref target="RFC6350" section="3.3"><tt>param-value</tt></xref> characters, sectionFormat="of" section="3.3"/>), where the COMMA (U+002c) (U+002C) and SEMICOLON (U+003B) character characters <bcp14>MUST</bcp14> be escaped according to the rules defined in <xref target="RFC6350" sectionFormat="of" section="3.4"/>.  <xref target="vcard-param-jscomps-example-separator"/> illustrates this by example.</t>
                  <t>The resulting JSContact component is formed by setting its kind to <tt>separator</tt> "separator" and its value to the verbatim value of the entry.</t>
                </li>
              </ol>
              <t>A JSCOMPS parameter value is valid if and only if:</t>
              <ul>
                <li>All indexes in the positional entries refer to an existing component value in the vCard property value.</li>
                <li>
                  <t>The count of positional entries equals the count of deduplicated component values.  Deduplication is required because some values may occur in both their designated and backwards-compatible components in the vCard property value:</t>
                  <ul>
                    <li>A value that occurs in both the N property secondary surname component and the family name component only counts once.</li>
                    <li>A value that occurs in both the N property generation component and the honorific suffix component only counts once.</li>
                    <li>A value in the ADR property street address component does not count if the ADR property value contains a value in one of the new components defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</li> target="RFC9554"/>.</li>
                    <li>All other values count once each.</li>
                  </ul>
                </li>
              </ul>
            </dd>
            <dt>Format definition:</dt>
            <dd>
            <sourcecode name="" type="abnf"><![CDATA[
jscomps-param      = "JSCOMPS" "=" DQUOTE (
                        (jscomps-entry-sep / "") [jscomps-entry-sep ] ";"
                                   jscomps-entrylist
                      ) DQUOTE

jscomps-entrylist  = jscomps-entry *(";" jscomps-entry)
jscomps-entry      = jscomps-entry-pos / jscomps-entry-sep
jscomps-entry-pos  = 1*DIGIT [ "," 1*DIGIT ]
jscomps-entry-sep  = "s" "," jscomps-entry-verb
jscomps-entry-verb = *QSAFE-CHAR ; encode according to RFC 6868
]]></sourcecode>
            </dd>
            <dt anchor="vcard-param-jscomps-examples">Example(s):</dt>
            <dd>
              <t>The following example demonstrates the use of positional entries for the name "Jane Doe".  The given name is ordered before the surname.  No secondary index is required for either positional because both are zero.</t>
              <figure anchor="vcard-param-jscomps-example-positional">
                <name>Example for positional entries</name> of a Secondary Positional Index</name>
                <sourcecode name=""><![CDATA[ name="json"><![CDATA[
"name": {
  "components": [
    { "kind": "given", "value": "Jane" },
    { "kind": "surname", "value": "Doe" }
  ],
  "isOrdered": true
}
]]></sourcecode>
            <sourcecode type="text/plain"><![CDATA[
N;JSCOMPS=";1;0":Doe;Jane;;;;;;
FN;DERIVED=TRUE:Jane Doe
]]></sourcecode>
              </figure>
              <t>The following example demonstrates a secondary positional index.  The "Jr." generation marker only counts once because it occurs in both the designated generation component and the backwards-compatible honorific suffixes component.</t>

              <figure anchor="vcard-param-jscomps-example-n-secondary-index">
                <name>Example for positional entries</name> of Positional Entries</name>
                <sourcecode name=""><![CDATA[ name="json"><![CDATA[
"name": {
  "components": [
    { "kind": "given", "value": "John" },
    { "kind": "given2", "value": "Philip" },
    { "kind": "given2", "value": "Paul" },
    { "kind": "surname", "value": "Stevenson" },
    { "kind": "generation", "value": "Jr." },
    { "kind": "credential", "value": "M.D." }
  ],
  "isOrdered": true
}

N;JSCOMPS=";1;2;2,1;0;6;4,1":Stevenson;John;Philip,Paul;;Jr.,M.D.;;Jr.
]]></sourcecode>
            <sourcecode type="text/plain"><![CDATA[
N;JSCOMPS=";1;2;2,1;0;6;4,1":
 Stevenson;John;Philip,Paul;;Jr.,M.D.;;Jr.
]]></sourcecode>
              </figure>
              <t>The following example demonstrates the use of separator entries for the (shortened for brevity) address "54321 Oak St, Reston". The first entry defines the default separator to be ", ".  The second and fourth positional entries are separated with the separator value " ".  For backwards-compatibility, backwards compatibility, the street address component of the ADR property contains both the street number and name, but it is not referred to in the JSCOMPS parameter and does not contribute to the count of values.</t>
              <figure anchor="vcard-param-jscomps-example-separator">
                <name>Example for separator entries</name> of Separator Entries</name>
                <sourcecode name=""><![CDATA[ name="json"><![CDATA[
"addresses": {
  "a1": {
    "components": [
      { "kind": "number", "value": "54321" },
      { "kind": "separator", "value": " " },
      { "kind": "name", "value": "Oak St" },
      { "kind": "locality", "value": "Reston" }
    ],
    "defaultSeparator": ", ",
    "isOrdered": true
  }
}
]]></sourcecode>
            <sourcecode type="text/plain"><![CDATA[
ADR;JSCOMPS="s,\, ;11;s, ;10;3":;;54321 ;10;3":
 ;;54321 Oak St;Reston;;;;;;;Oak St;54321;;;;;;
]]></sourcecode>
              </figure>
            </dd>
          </dl>
        </section>
        <section anchor="vcard-param-jsptr">
          <name>JSPTR</name>
          <dl>
            <dt>Parameter name:</dt>
            <dd>JSPTR</dd>
            <dt>Purpose:</dt>
            <dd>
              This

	    <dd>This parameter contains is set on a <xref target="vcard-prop-jsprop">JSPROP</xref> property.  Its value is a JSON pointer <xref target="RFC6901"/> that relates the vCard <xref target="vcard-prop-jsprop">JSPROP</xref> property points to a the JSContact property that has the value of the JSPROP property.
        </dd>
            <dt>Description:</dt>
            <dd>
              <t>This parameter has a single value that <bcp14>MUST</bcp14> be a valid JSON pointer as defined in <xref target="RFC6901"/>.  Note that the value <bcp14>MUST</bcp14> be quoted according to the <tt>param-value</tt> "param-value" ABNF in <xref target="RFC6350"/>.</t>
            </dd>
            <dt>Format definition:</dt>
            <dd>
             <sourcecode name="" type="abnf"><![CDATA[
jsptr-param  = "JSPTR" "=" param-value
             ; also see param-value in RFC 6350, section Section 3.3
]]></sourcecode>
            </dd>
            <dt>Example(s):</dt>
            <dd>
              <t>This illustrates a simple example.  For further examples examples, see <xref target="vcard-prop-jsprop-examples"/>.</t>
              <sourcecode name=""><![CDATA[ name="" type="text/plain"><![CDATA[
JSPROP;JSPTR="example.com:foo":"bar"
]]></sourcecode>
            </dd>
          </dl>
        </section>
      </section>
    </section>
    <section anchor="security-considerations">
      <name>Security Considerations</name>
      <t>This specification defines how to convert between the JSContact and vCard formats.

      The security considerations for parsing and formatting such data apply and are outlined in <xref target="I-D.ietf-calext-jscontact" section="5"/> target="RFC9553" sectionFormat="of" section="4"/> and <xref target="RFC6350" sectionFormat="of" section="9"/>.</t>
    </section>
    <section>
      <name>Acknowledgements</name>
      <t>The definition and examples of the <xref target="vcard-param-phonetic">PHONETIC</xref> and <xref target="vcard-param-script">SCRIPT</xref> parameters are based on the initial version of <xref target="I-D.calconnect-vobject-i18n"/>.</t>
    </section>
    <section anchor="IANA">
      <!-- All drafts are required to have an IANA considerations section.  See RFC 8126 for a guide.-->
      <name>IANA Considerations</name>
      <section>
        <name>New vCard Properties</name> Property</name>
        <t>IANA is requested to add has added the following entries entry to the "vCard Properties" registry, as defined in Section 10.3.1. of <xref target="RFC6350"/>.</t> target="RFC6350" sectionFormat="of" section="10.3.1"/>.</t>
        <table anchor="new_properties">
          <name>New vCard Properties</name> Property</name>
          <thead>
            <tr>
              <th align="left">Namespace</th>
              <th align="left">Property</th>
              <th align="left">Reference</th>
            </tr>
          </thead>
          <tbody>
            <tr>
              <td/>
              <td align="left">JSPROP</td>
              <td align="left">This document, align="left">RFC 9555, <xref target="vcard-prop-jsprop"/></td>
            </tr>
          </tbody>
        </table>
      </section>
      <section>
        <name>New vCard Parameters</name> Parameter</name>
        <t>IANA is requested to add has added the following entries entry to the "vCard Parameters" registry, as defined in Section 10.3.2. of <xref target="RFC6350"/>.</t> target="RFC6350" sectionFormat="of" section="10.3.2"/>.</t>
        <table anchor="new_parameters">
          <name>New vCard Parameters</name> Parameter</name>
          <thead>
            <tr>
              <th align="left">Namespace</th>
              <th align="left">Parameter</th>
              <th align="left">Reference</th>
            </tr>
          </thead>
          <tbody>
            <tr>
              <td/>
              <td align="left">JSPTR</td>
              <td align="left">This document, align="left">RFC 9555, <xref target="vcard-param-jsptr"/></td>
            </tr>
          </tbody>
        </table>
      </section>
      <section>
        <name>New JSContact Properties</name>
        <t>IANA is requested to add has added the following entries to the "JSContact Properties" registry.  The  Note that the Since Version for all properties is 1.0.  The 1.0, the Until Version for all properties is not set.  All RFC section references are for this document.  The change controller set, and the Change Controller is IETF for all of these properties is IETF.</t> properties.</t>

        <table anchor="tab-iana-property-registry" align="center">
          <name>Initial Contents of the "JSContact Properties"
          <name>JSContact Properties Registry</name>
          <thead>
            <tr>
              <th align="left">Property Name</th>
              <th align="left">Property Type</th>
              <th align="left">Property Context</th>
	       <th align="left">Intended Usage</th>
              <th align="left">Reference or Description</th>
              <th align="left">Intended Usage</th>
            </tr>
          </thead>
          <!-- Everything in here should be sorted alphabetically: table entries by property name, the references for each property alphabetically by the object type or property they refer to -->
          <tbody>
            <tr>
              <td align="left">vCardName</td>
              <td align="left">String</td>
              <td align="left">Any JSContact object</td>
              <td align="left"> align="left">common</td>
              <td align="left">RFC 9555,
                <xref target="jscontact-prop-vcardname" format="default"/>
              </td>
              <td align="left">common</td> format="default"/></td>
              </tr>
            <tr>
              <td align="left">vCardParams</td>
              <td align="left">String[String]</td> align="left">String[String|String[]]</td>
              <td align="left">Any JSContact object</td>
	      <td align="left"> align="left">common</td>
              <td align="left">RFC 9555,
                <xref target="jscontact-prop-vcardparams" format="default"/>
              </td>
              <td align="left">common</td>
            </tr>
            <tr>
              <td align="left">vCardProps</td>
              <td align="left">JCardProp[]</td>
              <td align="left">Card</td>
	      <td align="left"> align="left">common</td>
              <td align="left">RFC 9555,
                <xref target="jscontact-prop-vcardprops" format="default"/>
              </td>
              <td align="left">common</td>
            </tr>
          </tbody>
        </table>
      </section>
      <section>
        <name>New JSContact Types</name> Type</name>
        <t>IANA is requested to add has added the following entries entry to the "JSContact Types" registry.    The Note that the Since Version for all properties is 1.0.  The 1.0, the Until Version for all properties is not set.  All RFC section references are set, and the Change Controller is IETF for this document.  The change controller for all these properties is IETF.</t> type.</t>
        <table anchor="tab-iana-jscontact-type-registry" align="left">
          <name>Additional Contents of the "JSContact Types"
          <name>JSContact Types Registry</name>
          <thead>
            <tr>
              <th align="left">Type Name</th>
	      <th align="left">Intended Usage</th>
              <th align="left">Reference or Description</th>
              <th align="left">Intended Usage</th>
            </tr>
          </thead>
          <tbody>
            <tr>
              <td align="left">JCardProp</td>
	      <td align="left"> align="left">common</td>
              <td align="left">RFC 9555,
                <xref target="jscontact-prop-vcardprops" format="default"/>
              </td>
              <td align="left">common</td>
            </tr>
          </tbody>
        </table>
      </section>
    </section>
    <section anchor="impl-status">
      <name>Implementation Status</name>
      <t>NOTE: Please remove this section and the reference to RFC 7942 prior to publication as an RFC.</t>
      <t>This section records the status of known implementations of the protocol as defined in this specification at the time of posting of this Internet-Draft, and is based on a proposal described in <xref target="RFC7942"/>.  The description of implementations in this section is intended to assist the IETF in its decision processes in progressing drafts to RFCs.  Please note that the listing of any individual implementation here does not imply endorsement by the IETF.  Furthermore, no effort has been spent to verify the information presented here that was supplied by IETF contributors.  This is not intended as, and must not be construed to be, a catalog of available implementations or their features.  Readers are advised to note that other implementations may exist.</t>
      <t>According to RFC 7942, "this will allow reviewers and working groups to assign due consideration to documents that have the benefit of running code, which may serve as evidence of valuable experimentation and feedback that have made the implemented protocols more mature.  It is up to the individual working groups to use this information as they see fit".</t>
      <section anchor="it-cnr-iit">
        <name>CNR</name>
        <ul spacing="compact">
          <li>Responsible Organization: National Research Council (CNR) of Italy</li>
          <li>Location: https://github.com/consiglionazionaledellericerche/jscontact-tools</li>
          <li>Description: This implementation includes tools for JSContact creation, validation, serialization/deserialization, and conversion from vCard, xCard and jCard.</li>
          <li>Level of Maturity: This is an "alpha" test implementation.</li>
          <li>Coverage: This implementation includes all features described in this specification.</li>
          <li>Contact Information: Mario Loffredo, mario.loffredo@iit.cnr.it</li>
        </ul>
      </section>
    </section>
  </middle>
  <back>

<displayreference target="I-D.calconnect-vobject-i18n" to="vOBJECT"/>

    <references>
      <name>References</name>
      <references>
        <name>Normative References</name>

<!-- [I-D.ietf-calext-jscontact] in EDIT state as of 2/12/24; companion document RFC 9553 -->
<reference anchor="RFC9553" target="https://www.rfc-editor.org/info/rfc9553">
<front>
<title>JSContact: A JSON Representation of Contact Data</title>
<author initials='R' surname='Stepanek' fullname='Robert Stepanek'>
    <organization />
</author>
<author initials='M' surname='Loffredo' fullname='Mario Loffredo'>
    <organization />
</author>
<date month='March' year='2024' />
</front>
<seriesInfo name="RFC" value="9553"/>
<seriesInfo name="DOI" value="10.17487/RFC9553"/>
</reference>

<!-- [I-D.ietf-calext-vcard-jscontact-extensions] in REF state as of 2/12/24; companion document RFC 9554 -->
<reference anchor="RFC9554" target="https://www.rfc-editor.org/info/rfc9554">
<front>
<title>vCard Format Extension for JSContact</title>
<author initials="R." surname="Stepanek" fullname="Robert Stepanek">
<organization>Fastmail</organization>
</author>
<author initials="M." surname="Loffredo" fullname="Mario Loffredo">
<organization>IIT-CNR</organization>
</author>
<date month="March" year="2024"/>
</front>
<seriesInfo name="RFC" value="9554"/>
<seriesInfo name="DOI" value="10.17487/RFC9554"/>
</reference>

        <xi:include href="https://datatracker.ietf.org/doc/bibxml3/draft-ietf-calext-jscontact.xml"/> href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.2119.xml"/>
        <xi:include href="https://datatracker.ietf.org/doc/bibxml3/draft-ietf-calext-vcard-jscontact-extensions.xml"/> href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.3986.xml"/>
        <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.2119.xml"/> href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.5234.xml"/>
        <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.5234.xml"/> href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.5646.xml"/>
        <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.6350.xml"/> href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.6350.xml"/>
        <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.6473.xml"/> href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.6473.xml"/>
        <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.6474.xml"/> href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.6474.xml"/>
        <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.6715.xml"/> href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.6715.xml"/>
        <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.6869.xml"/> href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.6869.xml"/>
        <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.6901.xml"/> href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.6901.xml"/>
        <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.7095.xml"/> href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.7095.xml"/>
        <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.7942.xml"/> href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8174.xml"/>
        <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.8174.xml"/> href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8259.xml"/>
      </references>
      <references>
        <name>Informative References</name>

<!--[I-D.calconnect-vobject-i18n] IESG state Expired. Entered the long way to get the correct initials-->
<reference anchor="I-D.calconnect-vobject-i18n" target="https://datatracker.ietf.org/doc/html/draft-calconnect-vobject-i18n-00">
  <front>
    <title>vObject Internationalization</title>
    <author fullname="Ronald Henry Tse" initials="R." surname="Tse">
      <organization>Ribose</organization>
    </author>
    <author fullname="Peter Tam" initials="P." surname="Tam">
      <organization>Ribose</organization>
    </author>
    <author fullname="Michael Douglass" initials="M." surname="Douglass">
      <organization>Spherical Cow Group</organization>
    </author>
    <date day="7" month="June" year="2018"/>
  </front>
  <seriesInfo name="Internet-Draft" value="draft-calconnect-vobject-i18n-00"/>
</reference>

        <xi:include href="https://datatracker.ietf.org/doc/bibxml3/draft-calconnect-vobject-i18n.xml"/>
        <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.8605.xml"/> href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8605.xml"/>

     <reference anchor="CLDRPersonName" target="https://www.unicode.org/reports/tr35/tr35-personNames.html">
        <front>
          <title>Technical Standard #35: Unicode
          <title>Unicode Locale Data Markup Language (LDML) Part 8: Person Names, Version 43.1</title> Names</title>
          <author fullname="M. Davis">
            <organization/>
          </author>
          <author fullname="P. Edberg">
            <organization/>
          </author>
          <author fullname="R. Gillam">
            <organization/>
          </author>
          <author fullname="A. Kolisnychenko">
            <organization/>
          </author>
          <author fullname="M. McKenna">
            <organization/>
          </author>
          <author fullname="others">
            <organization/>
	  <author>
          <organization>other CLDR committee members</organization>
          </author>
          <date year="2023" month="July"/>
        </front>
	<seriesInfo name="Unicode Technical Standard" value="#35"/>
	<seriesInfo name="Version" value="44.1"/>
      </reference>
      </references>
    </references>
    <section anchor="convert_jscontact_to_vcard-reverse-rules">
      <name>Reverse Rules of Converting a vCard to a JSContact Card</name>
      <t><xref target="table_convert_jscontact_to_vcard"/> lists the relevant document sections for each JSContact object type and property.</t>
      <table anchor="table_convert_jscontact_to_vcard">
        <name>Conversion rules by Rules for JSContact property</name> Types and Properties</name>
        <thead>
          <tr>
            <th align="left">JSContact Type</th>
            <th align="left">Property Name</th>
            <th align="left">Relevant Section(s)</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td>Address</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>Address</td>
            <td>components</td>
            <td><xref target="vcard-prop-adr"/>,
            <td>Sections <xref target="vcard-prop-adr" format="counter"/> and
              <xref target="vcard-param-jscomps"/></td> target="vcard-param-jscomps" format="counter"/></td>
          </tr>
          <tr>
            <td>Address</td>
            <td>contexts</td>
            <td>
              <xref target="vcard-param-type"/>
            </td>
          </tr>
          <tr>
            <td>Address</td>
            <td>coordinates</td>
            <td><xref target="vcard-param-geo"/>,
            <td>Sections <xref target="vcard-param-geo" format="counter"/> and <xref target="vcard-prop-geo"/></td> target="vcard-prop-geo" format="counter"/></td>
          </tr>
          <tr>
            <td>Address</td>
            <td>country</td>
            <td>
              <xref target="vcard-prop-adr"/>
            </td>
          </tr>
          <tr>
            <td>Address</td>
            <td>countryCode</td>
            <td>
              <xref target="vcard-prop-adr"/>
            </td>
          </tr>
          <tr>
            <td>Address</td>
            <td>defaultSeparator</td>
            <td><xref target="vcard-prop-adr"/>,
            <td>Sections <xref target="vcard-prop-adr" format="counter"/> and
              <xref target="vcard-param-jscomps"/></td> target="vcard-param-jscomps" format="counter"/></td>
          </tr>
          <tr>
            <td>Address</td>
            <td>full</td>
            <td>
              <xref target="vcard-prop-adr"/>
            </td>
          </tr>
          <tr>
            <td>Address</td>
            <td>isOrdered</td>
            <td><xref target="vcard-prop-adr"/>,
            <td>Sections <xref target="vcard-prop-adr" format="counter"/> and
              <xref target="vcard-param-jscomps"/></td> target="vcard-param-jscomps" format="counter"/></td>
          </tr>
          <tr>
            <td>Address</td>
            <td>locality</td>
            <td>
              <xref target="vcard-prop-adr"/>
            </td>
          </tr>
          <tr>
            <td>Address</td>
            <td>phoneticScript</td>
            <td>
            <td>Sections
<xref target="vcard-param-phonetic"/>, target="vcard-param-phonetic" format="counter"/> and
<xref target="vcard-param-script"/> target="vcard-param-script" format="counter"/>
</td>
          </tr>
          <tr>
            <td>Address</td>
            <td>phoneticSystem</td>
            <td><xref target="vcard-param-phonetic"/></td>
          </tr>
          <tr>
            <td>Address</td>
            <td>postcode</td>
            <td>
              <xref target="vcard-prop-adr"/>
            </td>
          </tr>
          <tr>
            <td>Address</td>
            <td>pref</td>
            <td>
              <xref target="vcard-param-pref"/>
            </td>
          </tr>
          <tr>
            <td>Address</td>
            <td>region</td>
            <td>
              <xref target="vcard-prop-adr"/>
            </td>
          </tr>
          <tr>
            <td>Address</td>
            <td>timeZone</td>
            <td><xref target="vcard-param-tz"/>,
            <td>Sections <xref target="vcard-param-tz" format="counter"/> and <xref target="vcard-prop-tz"/></td> target="vcard-prop-tz" format="counter"/></td>
          </tr>
          <tr>
            <td>AddressComponent</td>
            <td>phonetic</td>
            <td><xref target="vcard-param-phonetic"/></td>
          </tr>
          <tr>
            <td>Anniversary</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>Anniversary</td>
            <td>date</td>
            <td>
              <xref target="vcard-prop-anniversary"/>
            </td>
          </tr>
          <tr>
            <td>Anniversary</td>
            <td>kind</td>
            <td>
              <xref target="vcard-prop-anniversary"/>
            </td>
          </tr>
          <tr>
            <td>Anniversary</td>
            <td>place</td>
            <td>
              <xref target="vcard-prop-anniversary"/>
            </td>
          </tr>
          <tr>
            <td>Author</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>Author</td>
            <td>name</td>
            <td>
              <xref target="vcard-param-author-name"/>
            </td>
          </tr>
          <tr>
            <td>Author</td>
            <td>uri</td>
            <td>
              <xref target="vcard-param-author"/>
            </td>
          </tr>
          <tr>
            <td>Calendar</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>Calendar</td>
            <td>contexts</td>
            <td>
              <xref target="vcard-param-type"/>
            </td>
          </tr>

          <tr>
            <td>Calendar</td>
             <td>kind</td>
            <td><xref target="vcard-prop-caladruri"/>,
            <td>Sections <xref target="vcard-prop-caluri" format="counter"/> and <xref target="vcard-prop-fburl"/></td> target="vcard-prop-fburl" format="counter"/></td>
          </tr>
          <tr>
            <td>Calendar</td>
            <td>label</td>
            <td>
              <xref target="vcard-prop-xablabel"/>
            </td>
          </tr>
          <tr>
            <td>Calendar</td>
            <td>mediaType</td>
            <td>
              <xref target="vcard-param-mediatype"/>
            </td>
          </tr>
          <tr>
            <td>Calendar</td>
            <td>pref</td>
            <td>
              <xref target="vcard-param-pref"/>
            </td>
          </tr>
          <tr>
            <td>Calendar</td>
            <td>uri</td>
            <td><xref target="vcard-prop-caladruri"/>,
            <td>Sections <xref target="vcard-prop-caluri" format="counter"/> and <xref target="vcard-prop-fburl"/></td> target="vcard-prop-fburl" format="counter"/></td>
          </tr>
          <tr>
            <td>Card</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>Card</td>
            <td>@version</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>Card</td>
            <td>addresses</td>
            <td>
              <xref target="vcard-prop-adr"/>
            </td>
          </tr>
          <tr>
            <td>Card</td>
            <td>anniversaries</td>
            <td>
              <xref target="vcard-prop-anniversary"/>
            </td>
          </tr>
          <tr>
            <td>Card</td>
            <td>calendars</td>
            <td><xref target="vcard-prop-caladruri"/>,
            <td>Sections <xref target="vcard-prop-caluri" format="counter"/> and <xref target="vcard-prop-fburl"/></td> target="vcard-prop-fburl" format="counter"/></td>
          </tr>
          <tr>
            <td>Card</td>
            <td>created</td>
            <td>
              <xref target="vcard-prop-created"/>
            </td>
          </tr>
          <tr>
            <td>Card</td>
            <td>directories</td>
            <td><xref target="vcard-prop-source"/>,
            <td>Sections <xref target="vcard-prop-source" format="counter"/> and <xref target="vcard-prop-org-directory"/></td> target="vcard-prop-org-directory" format="counter"/></td>
          </tr>
          <tr>
            <td>Card</td>
            <td>emails</td>
            <td>
              <xref target="vcard-prop-email"/>
            </td>
          </tr>
          <tr>
            <td>Card</td>
            <td>keywords</td>
            <td>
              <xref target="vcard-prop-categories"/>
            </td>
          </tr>
          <tr>
            <td>Card</td>
            <td>kind</td>
            <td>
              <xref target="vcard-prop-kind"/>
            </td>
          </tr>
          <tr>
            <td>Card</td>
            <td>language</td>
            <td>
              <xref target="vcard-prop-language"/>
            </td>
          </tr>
          <tr>
            <td>Card</td>
            <td>links</td>
            <td><xref target="vcard-prop-contact-uri"/>,
            <td>Sections <xref target="vcard-prop-url"/></td> target="vcard-prop-contact-uri" format="counter"/> and <xref target="vcard-prop-url" format="counter"/></td>
          </tr>
          <tr>
            <td>Card</td>
            <td>localizations</td>
            <td>
              <xref target="vcard-param-language"/>
            </td>
          </tr>
          <tr>
            <td>Card</td>
            <td>media</td>
            <td><xref target="vcard-prop-photo"/>,
            <td>Sections <xref target="vcard-prop-photo" format="counter"/>, <xref target="vcard-prop-logo"/>, target="vcard-prop-logo" format="counter"/>, and <xref target="vcard-prop-sound"/></td> target="vcard-prop-sound" format="counter"/></td>
          </tr>
          <tr>
            <td>Card</td>
            <td>members</td>
            <td>
              <xref target="vcard-prop-member"/>
            </td>
          </tr>
          <tr>
            <td>Card</td>
            <td>name</td>
            <td>
              <xref target="vcard-prop-n"/>
            </td>
          </tr>
          <tr>
            <td>Card</td>
            <td>nicknames</td>
            <td>
              <xref target="vcard-prop-n"/> target="vcard-prop-nickname"/>
            </td>
          </tr>
          <tr>
            <td>Card</td>
            <td>notes</td>
            <td>
              <xref target="vcard-prop-note"/>
            </td>
          </tr>
          <tr>
            <td>Card</td>
            <td>onlineServices</td>
            <td>
              <xref target="vcard-prop-impp"/>
            </td>
          </tr>
          <tr>
            <td>Card</td>
            <td>organizations</td>
            <td>
              <xref target="vcard-prop-org"/>
            </td>
          </tr>
          <tr>
            <td>Card</td>
            <td>personalInfo</td>
            <td><xref target="vcard-prop-expertise"/>,
            <td>Sections <xref target="vcard-prop-hobby"/>, target="vcard-prop-expertise" format="counter"/>, <xref target="vcard-prop-interest"/></td> target="vcard-prop-hobby" format="counter"/>, and <xref target="vcard-prop-interest" format="counter"/></td>
          </tr>
          <tr>
            <td>Card</td>
            <td>phones</td>
            <td>
              <xref target="vcard-prop-tel"/>
            </td>
          </tr>
          <tr>
            <td>Card</td>
            <td>preferredLanguages</td>
            <td>
              <xref target="vcard-prop-lang"/>
            </td>
          </tr>
          <tr>
            <td>Card</td>
            <td>prodId</td>
            <td>
              <xref target="vcard-prop-prodid"/>
            </td>
          </tr>
          <tr>
            <td>Card</td>
            <td>relatedTo</td>
            <td>
              <xref target="vcard-prop-related"/>
            </td>
          </tr>
          <tr>
            <td>Card</td>
            <td>schedulingAddresses</td>
            <td>
              <xref target="vcard-prop-caladruri"/>
            </td>
          </tr>
          <tr>
            <td>Card</td>
            <td>speakToAs</td>
            <td>
              <xref target="vcard-prop-gramgender"/>
            </td>
          </tr>
          <tr>
            <td>Card</td>
            <td>titles</td>
            <td>
              <xref target="vcard-prop-title"/>
            </td>
          </tr>
          <tr>
            <td>Card</td>
            <td>uid</td>
            <td>
              <xref target="vcard-prop-uid"/>
            </td>
          </tr>
          <tr>
            <td>Card</td>
            <td>updated</td>
            <td>
              <xref target="vcard-prop-rev"/>
            </td>
          </tr>
          <tr>
            <td>CryptoKey</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>CryptoKey</td>
            <td>contexts</td>
            <td>
              <xref target="vcard-param-type"/>
            </td>
          </tr>
          <tr>
            <td>CryptoKey</td>
            <td>kind</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>CryptoKey</td>
            <td>label</td>
            <td>
              <xref target="vcard-prop-xablabel"/>
            </td>
          </tr>
          <tr>
            <td>CryptoKey</td>
            <td>mediaType</td>
            <td>
              <xref target="vcard-param-mediatype"/>
            </td>
          </tr>
          <tr>
            <td>CryptoKey</td>
            <td>pref</td>
            <td>
              <xref target="vcard-param-pref"/>
            </td>
          </tr>
          <tr>
            <td>CryptoKey</td>
            <td>uri</td>
            <td>
              <xref target="vcard-prop-key"/>
            </td>
          </tr>
          <tr>
            <td>Directory</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>Directory</td>
            <td>contexts</td>
            <td>
              <xref target="vcard-param-type"/>
            </td>
          </tr>
          <tr>
            <td>Directory</td>
            <td>kind</td>
            <td><xref target="vcard-prop-source"/>,
            <td>Sections <xref target="vcard-prop-org-directory"/></td> target="vcard-prop-source" format="counter"/> and <xref target="vcard-prop-org-directory" format="counter"/></td>
          </tr>
          <tr>
            <td>Directory</td>
            <td>label</td>
            <td>
              <xref target="vcard-prop-xablabel"/>
            </td>
          </tr>
          <tr>
            <td>Directory</td>
            <td>listAs</td>
            <td>
              <xref target="vcard-param-index"/>
            </td>
          </tr>
          <tr>
            <td>Directory</td>
            <td>mediaType</td>
            <td>
              <xref target="vcard-param-mediatype"/>
            </td>
          </tr>
          <tr>
            <td>Directory</td>
            <td>pref</td>
            <td>
              <xref target="vcard-param-pref"/>
            </td>
          </tr>
          <tr>
            <td>Directory</td>
            <td>uri</td>
            <td><xref target="vcard-prop-source"/>,
            <td>Sections <xref target="vcard-prop-org-directory"/></td> target="vcard-prop-source" format="counter"/> and <xref target="vcard-prop-org-directory" format="counter"/></td>
          </tr>
          <tr>
            <td>EmailAddress</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>EmailAddress</td>
            <td>address</td>
            <td>
              <xref target="vcard-prop-email"/>
            </td>
          </tr>
          <tr>
            <td>EmailAddress</td>
            <td>contexts</td>
            <td>
              <xref target="vcard-param-type"/>
            </td>
          </tr>
          <tr>
            <td>EmailAddress</td>
            <td>label</td>
            <td>
              <xref target="vcard-prop-xablabel"/>
            </td>
          </tr>
          <tr>
            <td>EmailAddress</td>
            <td>pref</td>
            <td>
              <xref target="vcard-param-pref"/>
            </td>
          </tr>
          <tr>
            <td>LanguagePref</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>LanguagePref</td>
            <td>contexts</td>
            <td>
              <xref target="vcard-param-type"/>
            </td>
          </tr>
          <tr>
            <td>LanguagePref</td>
            <td>pref</td>
            <td>
              <xref target="vcard-param-pref"/>
            </td>
          </tr>
          <tr>
            <td>Link</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>Link</td>
            <td>contexts</td>
            <td>
              <xref target="vcard-param-type"/>
            </td>
          </tr>
          <tr>
            <td>Link</td>
            <td>kind</td>
            <td><xref target="vcard-prop-contact-uri"/>, <xref target="vcard-prop-url"/></td> target="vcard-prop-contact-uri"/></td>
          </tr>
          <tr>
            <td>Link</td>
            <td>label</td>
            <td>
              <xref target="vcard-prop-xablabel"/>
            </td>
          </tr>
          <tr>
            <td>Link</td>
            <td>mediaType</td>
            <td>
              <xref target="vcard-param-mediatype"/>
            </td>
          </tr>
          <tr>
            <td>Link</td>
            <td>pref</td>
            <td>
              <xref target="vcard-param-pref"/>
            </td>
          </tr>
          <tr>
            <td>Link</td>
            <td>uri</td>
            <td><xref target="vcard-prop-contact-uri"/>,
            <td>Sections <xref target="vcard-prop-contact-uri" format="counter"/> and <xref target="vcard-prop-url"/>&gt;</td> target="vcard-prop-url" format="counter"/></td>
          </tr>
          <tr>
            <td>Media</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>Media</td>
            <td>contexts</td>
            <td>
              <xref target="vcard-param-type"/>
            </td>
          </tr>
          <tr>
            <td>Media</td>
            <td>kind</td>
            <td><xref target="vcard-prop-photo"/>,
            <td>Sections <xref target="vcard-prop-photo" format="counter"/>, <xref target="vcard-prop-logo"/>, target="vcard-prop-logo" format="counter"/>, and <xref target="vcard-prop-sound"/></td> target="vcard-prop-sound" format="counter"/></td>
          </tr>
          <tr>
            <td>Media</td>
            <td>label</td>
            <td>
              <xref target="vcard-prop-xablabel"/>
            </td>
          </tr>
          <tr>
            <td>Media</td>
            <td>mediaType</td>
            <td>
              <xref target="vcard-param-mediatype"/>
            </td>
          </tr>
          <tr>
            <td>Media</td>
            <td>pref</td>
            <td>
              <xref target="vcard-param-pref"/>
            </td>
          </tr>
          <tr>
            <td>Media</td>
            <td>uri</td>
            <td><xref target="vcard-prop-photo"/>,
            <td>Sections <xref target="vcard-prop-photo" format="counter"/>, <xref target="vcard-prop-logo"/>, target="vcard-prop-logo" format="counter"/>, and <xref target="vcard-prop-sound"/></td> target="vcard-prop-sound" format="counter"/></td>
          </tr>
          <tr>
            <td>Name</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>Name</td>
            <td>components</td>
            <td><xref target="vcard-prop-n"/>,
            <td>Sections <xref target="vcard-prop-n" format="counter"/> and
              <xref target="vcard-param-jscomps"/></td> target="vcard-param-jscomps" format="counter"/></td>
          </tr>
          <tr>
            <td>Name</td>
            <td>defaultSeparator</td>
            <td><xref target="vcard-prop-n"/>,
            <td>Sections <xref target="vcard-prop-n" format="counter"/> and
              <xref target="vcard-param-jscomps"/></td> target="vcard-param-jscomps" format="counter"/></td>
          </tr>
          <tr>
            <td>Name</td>
            <td>full</td>
            <td>
              <xref target="vcard-prop-fn"/>
            </td>
          </tr>
          <tr>
            <td>Name</td>
            <td>phoneticScript</td>
            <td>
            <td>Sections
<xref target="vcard-param-phonetic"/>, target="vcard-param-phonetic" format="counter"/> and
<xref target="vcard-param-script"/> target="vcard-param-script" format="counter"/>
</td>
          </tr>
          <tr>
            <td>Name</td>
            <td>phoneticSystem</td>
            <td><xref target="vcard-param-phonetic"/></td>
          </tr>
          <tr>
            <td>Name</td>
            <td>isOrdered</td>
            <td><xref target="vcard-prop-n"/>,
            <td>Sections <xref target="vcard-prop-n" format="counter"/> and
              <xref target="vcard-param-jscomps"/></td> target="vcard-param-jscomps" format="counter"/></td>
          </tr>
          <tr>
            <td>Name</td>
            <td>sortAs</td>
            <td>
              <xref target="vcard-param-sortas"/>
            </td>
          </tr>
          <tr>
            <td>NameComponent</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>NameComponent</td>
            <td>kind</td>
            <td>
              <xref target="vcard-prop-n"/>
            </td>
          </tr>
          <tr>
            <td>NameComponent</td>
            <td>phonetic</td>
            <td><xref target="vcard-param-phonetic"/></td>
          </tr>
          <tr>
            <td>NameComponent</td>
            <td>value</td>
            <td>
              <xref target="vcard-prop-n"/>
            </td>
          </tr>
          <tr>
            <td>Nickname</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>Nickname</td>
            <td>contexts</td>
            <td>
              <xref target="vcard-param-type"/>
            </td>
          </tr>
          <tr>
            <td>Nickname</td>
            <td>name</td>
            <td>
              <xref target="vcard-prop-n"/>
            </td>
          </tr>
          <tr>
            <td>Nickname</td>
            <td>pref</td>
            <td>
              <xref target="vcard-param-pref"/>
            </td>
          </tr>
          <tr>
            <td>Note</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>Note</td>
            <td>author</td>
            <td><xref target="vcard-param-author"/>,
            <td>Sections <xref target="vcard-param-author" format="counter"/> and <xref target="vcard-param-author-name"/></td> target="vcard-param-author-name" format="counter"/></td>
          </tr>
          <tr>
            <td>Note</td>
            <td>created</td>
            <td>
              <xref target="vcard-param-created"/>
            </td>
          </tr>
          <tr>
            <td>Note</td>
            <td>note</td>
            <td>
              <xref target="vcard-prop-note"/>
            </td>
          </tr>
          <tr>
            <td>OnlineService</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>OnlineService</td>
            <td>contexts</td>
            <td>
              <xref target="vcard-param-type"/>
            </td>
          </tr>
          <tr>
            <td>OnlineService</td>
            <td>kind</td>
            <td><xref target="vcard-prop-impp"/>, <xref target="vcard-prop-socialprofile"/></td>
          </tr>
          <tr>
            <td>OnlineService</td>
            <td>label</td>
            <td>
              <xref target="vcard-prop-xablabel"/>
            </td>
          </tr>
          <tr>
            <td>OnlineService</td>
            <td>pref</td>
            <td>
              <xref target="vcard-param-pref"/>
            </td>
          </tr>
          <tr>
            <td>OnlineService</td>
            <td>service</td>
            <td>
              <xref target="vcard-param-service-type"/>
            </td>
          </tr>
          <tr>
            <td>OnlineService</td>
            <td>uri</td>
            <td><xref target="vcard-prop-impp"/>,
            <td>Sections <xref target="vcard-prop-socialprofile"/></td> target="vcard-prop-impp" format="counter"/> and <xref target="vcard-prop-socialprofile" format="counter"/></td>
          </tr>
          <tr>
            <td>OnlineService</td>
            <td>user</td>
            <td>
              <xref target="vcard-param-username"/>
            </td>
          </tr>
          <tr>
            <td>OrgUnit</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>OrgUnit</td>
            <td>name</td>
            <td>
              <xref target="vcard-prop-org"/>
            </td>
          </tr>
          <tr>
            <td>OrgUnit</td>
            <td>sortAs</td>
            <td>
              <xref target="vcard-param-sortas"/>
            </td>
          </tr>
          <tr>
            <td>Organization</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>Organization</td>
            <td>contexts</td>
            <td>
              <xref target="vcard-param-type"/>
            </td>
          </tr>
          <tr>
            <td>Organization</td>
            <td>name</td>
            <td>
              <xref target="vcard-prop-org"/>
            </td>
          </tr>
          <tr>
            <td>Organization</td>
            <td>sortAs</td>
            <td>
              <xref target="vcard-param-sortas"/>
            </td>
          </tr>
          <tr>
            <td>Organization</td>
            <td>units</td>
            <td>
              <xref target="vcard-prop-org"/>
            </td>
          </tr>
          <tr>
            <td>PartialDate</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>PartialDate</td>
            <td>calendarScale</td>
            <td>
              <xref target="vcard-param-calscale"/>
            </td>
          </tr>
          <tr>
            <td>PartialDate</td>
            <td>day</td>
            <td>
              <xref target="vcard-type-datetime"/>
            </td>
          </tr>
          <tr>
            <td>PartialDate</td>
            <td>month</td>
            <td>
              <xref target="vcard-type-datetime"/>
            </td>
          </tr>
          <tr>
            <td>PartialDate</td>
            <td>year</td>
            <td>
              <xref target="vcard-type-datetime"/>
            </td>
          </tr>
          <tr>
            <td>PatchObject</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>PersonalInfo</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>PersonalInfo</td>
            <td>kind</td>
            <td><xref target="vcard-prop-expertise"/>,
            <td>Sections <xref target="vcard-prop-expertise" format="counter"/>, <xref target="vcard-prop-hobby"/>, target="vcard-prop-hobby" format="counter"/>, and <xref target="vcard-prop-interest"/></td> target="vcard-prop-interest" format="counter"/></td>
          </tr>
          <tr>
            <td>PersonalInfo</td>
            <td>listAs</td>
            <td>
              <xref target="vcard-param-index"/>
            </td>
          </tr>
          <tr>
            <td>PersonalInfo</td>
            <td>level</td>
            <td>
              <xref target="vcard-param-level"/>
            </td>
          </tr>
          <tr>
            <td>PersonalInfo</td>
            <td>value</td>
            <td><xref target="vcard-prop-expertise"/>,
            <td>Sections <xref target="vcard-prop-expertise" format="counter"/>, <xref target="vcard-prop-hobby"/>, target="vcard-prop-hobby" format="counter"/>, and <xref target="vcard-prop-interest"/></td> target="vcard-prop-interest" format="counter"/></td>
          </tr>
          <tr>
            <td>Phone</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>Phone</td>
            <td>contexts</td>
            <td>
              <xref target="vcard-param-type"/>
            </td>
          </tr>
          <tr>
            <td>Phone</td>
            <td>features</td>
            <td>
              <xref target="vcard-prop-tel"/>
            </td>
          </tr>
          <tr>
            <td>Phone</td>
            <td>label</td>
            <td>
              <xref target="vcard-prop-xablabel"/>
            </td>
          </tr>
          <tr>
            <td>Phone</td>
            <td>number</td>
            <td>
              <xref target="vcard-prop-tel"/>
            </td>
          </tr>
          <tr>
            <td>Phone</td>
            <td>pref</td>
            <td>
              <xref target="vcard-param-pref"/>
            </td>
          </tr>
          <tr>
            <td>Pronouns</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>Pronouns</td>
            <td>contexts</td>
            <td>
              <xref target="vcard-param-type"/>
            </td>
          </tr>
          <tr>
            <td>Pronouns</td>
            <td>pref</td>
            <td>
              <xref target="vcard-param-pref"/>
            </td>
          </tr>
          <tr>
            <td>Pronouns</td>
            <td>pronouns</td>
            <td>
              <xref target="vcard-prop-gramgender"/>
            </td>
          </tr>
          <tr>
            <td>Relation</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>Relation</td>
            <td>relation</td>
            <td>
              <xref target="vcard-prop-related"/>
            </td>
          </tr>
          <tr>
            <td>Resource</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>SchedulingAddress</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>SchedulingAddress</td>
            <td>contexts</td>
            <td>
              <xref target="vcard-param-type"/>
            </td>
          </tr>
          <tr>
            <td>SchedulingAddress</td>
            <td>label</td>
            <td>
              <xref target="vcard-prop-xablabel"/>
            </td>
          </tr>
          <tr>
            <td>SchedulingAddress</td>
            <td>pref</td>
            <td>
              <xref target="vcard-param-pref"/>
            </td>
          </tr>
          <tr>
            <td>SchedulingAddress</td>
            <td>uri</td>
            <td>
              <xref target="vcard-prop-caladruri"/>
            </td>
          </tr>
          <tr>
            <td>SpeakToAs</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>SpeakToAs</td>
            <td>grammaticalGender</td>
            <td>
              <xref target="vcard-prop-gramgender"/>
            </td>
          </tr>
          <tr>
            <td>SpeakToAs</td>
            <td>pronouns</td>
            <td>
              <xref target="vcard-prop-gramgender"/>
            </td>
          </tr>
          <tr>
            <td>AddressComponent</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>AddressComponent</td>
            <td>kind</td>
            <td>
              <xref target="vcard-prop-adr"/>
            </td>
          </tr>
          <tr>
            <td>AddressComponent</td>
            <td>value</td>
            <td>
              <xref target="vcard-prop-adr"/>
            </td>
          </tr>
          <tr>
            <td>Timestamp</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>Timestamp</td>
            <td>utc</td>
            <td>
              <xref target="vcard-type-datetime"/>
            </td>
          </tr>
          <tr>
            <td>Title</td>
            <td>@type</td>
            <td>not applicable</td>
          </tr>
          <tr>
            <td>Title</td>
            <td>kind</td>
            <td>
              <xref target="vcard-prop-title"/>
            </td>
          </tr>
          <tr>
            <td>Title</td>
            <td>name</td>
            <td>
              <xref target="vcard-prop-title"/>
            </td>
          </tr>
          <tr>
            <td>Title</td>
            <td>organization</td>
            <td>organizationId</td>
            <td>
              <xref target="vcard-prop-title"/>
            </td>
          </tr>
        </tbody>
      </table>
    </section>
      <section anchor="Acknowledgments" numbered="false">
      <name>Acknowledgements</name>
      <t>The definition and examples of the <xref target="vcard-param-phonetic">PHONETIC</xref> and <xref target="vcard-param-script">SCRIPT</xref> parameters are based on the initial draft version of <xref target="I-D.calconnect-vobject-i18n"/>.</t>
    </section>

<!-- [rfced] Please review the "Inclusive Language" portion of the online
Style Guide <https://www.rfc-editor.org/styleguide/part2/#inclusive_language>
and let us know if any changes are needed.

For example, please consider whether "whitespace" should be updated.
-->

  </back>
</rfc>