@opensanctions/followthemoney 4.5.2 → 4.7.0

package/dist/followthemoney.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('crypto')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'crypto'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.followthemoney = {}, global.crypto$1));
-})(this, (function (exports, crypto$1) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
+    typeof define === 'function' && define.amd ? define(['exports'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.followthemoney = {}));
+})(this, (function (exports) { 'use strict';
 
     /**
      * An entity proxy which provides simplified access to the
@@ -251,6 +251,7 @@
      */
     class Property {
         constructor(schema, property) {
+            this.examples = null;
             this.schema = schema;
             this.name = property.name;
             this.qname = property.qname;
@@ -267,6 +268,7 @@
             this.type = schema.model.getType(property.type);
             this.hasRange = this.range !== null;
             this.hasReverse = this.range !== null && this.reverse !== null;
+            this.examples = property.examples || null;
         }
         getRange() {
             return this.schema.model.getSchema(this.range);
@@ -539,10 +541,7 @@
          * @returns a new UUID.
          */
         generateRandomId() {
-            if (typeof crypto !== 'undefined' && crypto.randomUUID) {
-                return crypto.randomUUID(); // Browser
-            }
-            return crypto$1.randomUUID(); // Node.js
+            return crypto.randomUUID();
         }
         /**
          * Make a new object with the given schema, and generate a random ID for
@@ -1273,14 +1272,6 @@
     				qname: "Address:city",
     				type: "string"
     			},
-    			country: {
-    				label: "Country",
-    				matchable: true,
-    				maxLength: 16,
-    				name: "country",
-    				qname: "Address:country",
-    				type: "country"
-    			},
     			full: {
     				label: "Full address",
     				matchable: true,
@@ -1328,7 +1319,7 @@
     				type: "string"
     			},
     			postalCode: {
-    				description: "Zip code or postcode.",
+    				description: "Zip code or postcode",
     				label: "Postal code",
     				maxLength: 16,
     				name: "postalCode",
@@ -1336,7 +1327,7 @@
     				type: "string"
     			},
     			region: {
-    				description: "Also province or area.",
+    				description: "Also province or area",
     				label: "Region",
     				maxLength: 1024,
     				name: "region",
@@ -1344,7 +1335,7 @@
     				type: "string"
     			},
     			remarks: {
-    				description: "Handling instructions, like 'care of'.",
+    				description: "Handling instructions, like 'care of'",
     				label: "Remarks",
     				maxLength: 1024,
     				name: "remarks",
@@ -1352,7 +1343,7 @@
     				type: "string"
     			},
     			state: {
-    				description: "State or federal unit.",
+    				description: "State or federal unit",
     				label: "State",
     				maxLength: 1024,
     				name: "state",
@@ -1645,7 +1636,7 @@
     		]
     	},
     	Associate: {
-    		description: "Non-family association between two people",
+    		description: "Non-family association between two people.",
     		edge: {
     			caption: [
     				"relationship"
@@ -1667,7 +1658,7 @@
     		plural: "Associates",
     		properties: {
     			associate: {
-    				description: "An associate of the subject person.",
+    				description: "An associate of the subject person",
     				label: "Associate",
     				matchable: true,
     				maxLength: 200,
@@ -1678,7 +1669,7 @@
     				type: "entity"
     			},
     			person: {
-    				description: "The subject of the association.",
+    				description: "The subject of the association",
     				label: "Person",
     				matchable: true,
     				maxLength: 200,
@@ -2039,7 +2030,7 @@
     		caption: [
     			"title"
     		],
-    		description: "A public appeal issued by an authority, possibly on behalf of another, for buying a specific work, supply or service\n",
+    		description: "A public appeal issued by an authority, possibly on behalf of another, for buying a specific work, supply or service.\n",
     		"extends": [
     			"Interval",
     			"Thing"
@@ -2165,7 +2156,7 @@
     				type: "string"
     			},
     			fallsUnderGPPScope: {
-    				description: "European Green Public Procurement (GPP) or green purchasing.",
+    				description: "European Green Public Procurement (GPP) or green purchasing",
     				label: "Does this call fall under the scope of GPP?",
     				maxLength: 1024,
     				name: "fallsUnderGPPScope",
@@ -2373,13 +2364,13 @@
     			},
     			capital: {
     				label: "Capital",
-    				maxLength: 1024,
+    				maxLength: 250,
     				name: "capital",
     				qname: "Company:capital",
-    				type: "string"
+    				type: "number"
     			},
     			cikCode: {
-    				description: "US SEC Central Index Key",
+    				description: "US SEC Central Index Key for listed companies",
     				label: "SEC Central Index Key",
     				matchable: true,
     				maxLength: 64,
@@ -2388,7 +2379,7 @@
     				type: "identifier"
     			},
     			coatoCode: {
-    				description: "Soviet classifier for territories, regions, districts, villages. Aka. SOATO and same as OKATO",
+    				description: "Soviet classifier for territories, regions, districts, villages. Aka. SOATO and same as OKATO.",
     				label: "COATO / SOATO / OKATO",
     				maxLength: 64,
     				name: "coatoCode",
@@ -2428,6 +2419,7 @@
     				type: "identifier"
     			},
     			isinCode: {
+    				deprecated: true,
     				description: "International Securities Identification Number",
     				label: "ISIN",
     				matchable: true,
@@ -2445,16 +2437,8 @@
     				qname: "Company:jibCode",
     				type: "identifier"
     			},
-    			jurisdiction: {
-    				label: "Jurisdiction",
-    				matchable: true,
-    				maxLength: 16,
-    				name: "jurisdiction",
-    				qname: "Company:jurisdiction",
-    				type: "country"
-    			},
     			kppCode: {
-    				description: "Russian code issued by the tax authority, identifies the reason for registration at the Federal Tax Service (Russian: КПП). A company may have multiple KPP codes (e.g. for different branches), and the codes are not unique across companies.",
+    				description: "(RU, КПП) Russian code issued by the tax authority, identifies the reason for registration at the Federal Tax Service. A company may have multiple KPP codes (e.g. for different branches), and the codes are not unique across companies.",
     				label: "KPP",
     				maxLength: 64,
     				name: "kppCode",
@@ -2470,7 +2454,7 @@
     				type: "identifier"
     			},
     			okopfCode: {
-    				description: "Russian classifier that that categorizes different types of legal entities in Russia based on their organizational and legal structure (Russian: ОКОПФ)",
+    				description: "(RU, ОКОПФ) Russian classifier that categorizes different types of legal entities in Russia based on their organizational and legal structure",
     				label: "OKOPF",
     				maxLength: 1024,
     				name: "okopfCode",
@@ -2478,7 +2462,7 @@
     				type: "string"
     			},
     			oksmCode: {
-    				description: "Russian (ОКСМ) countries classifier",
+    				description: "(RU, ОКСМ) Russian countries classifier",
     				label: "OKSM",
     				maxLength: 1024,
     				name: "oksmCode",
@@ -2486,7 +2470,7 @@
     				type: "string"
     			},
     			okvedCode: {
-    				description: "Russian classifier that that categorizes businesses by their (primary and secondary) economic activities (Russian: ОКВЭД)",
+    				description: "(RU, ОКВЭД) Russian classifier that categorizes businesses by their (primary and secondary) economic activities",
     				label: "OKVED(2) Classifier",
     				maxLength: 1024,
     				name: "okvedCode",
@@ -2494,7 +2478,7 @@
     				type: "string"
     			},
     			pfrNumber: {
-    				description: "(RU, ПФР) Pension Fund Registration number. AAA-BBB-CCCCCC, where AAA is organisation region, BBB is district, CCCCCC number at a specific branch",
+    				description: "(RU, ПФР) Pension Fund Registration number. AAA-BBB-CCCCCC, where AAA is organisation region, BBB is district, and CCCCCC is the number at a specific branch.",
     				label: "PFR Number",
     				matchable: true,
     				maxLength: 64,
@@ -2502,14 +2486,6 @@
     				qname: "Company:pfrNumber",
     				type: "identifier"
     			},
-    			registrationNumber: {
-    				label: "Registration number",
-    				matchable: true,
-    				maxLength: 64,
-    				name: "registrationNumber",
-    				qname: "Company:registrationNumber",
-    				type: "identifier"
-    			},
     			ricCode: {
     				label: "Reuters Instrument Code",
     				matchable: true,
@@ -2562,7 +2538,7 @@
     			"name",
     			"procedureNumber"
     		],
-    		description: "An contract or contract lot issued by an authority. Multiple lots may be awarded to different suppliers (see ContractAward).\n",
+    		description: "A contract or contract lot issued by an authority. Multiple lots may be awarded to different suppliers (see `ContractAward`).\n",
     		"extends": [
     			"Asset"
     		],
@@ -2700,6 +2676,10 @@
     				type: "entity"
     			},
     			status: {
+    				examples: [
+    					"In force",
+    					"Annulled"
+    				],
     				label: "Status",
     				maxLength: 1024,
     				name: "status",
@@ -2714,7 +2694,12 @@
     				type: "string"
     			},
     			type: {
-    				description: "Type of contract. Potentially W (Works), U (Supplies), S (Services).\n",
+    				description: "Type of contract",
+    				examples: [
+    					"W (Works)",
+    					"U (Supplies)",
+    					"S (Services)"
+    				],
     				label: "Type",
     				maxLength: 1024,
     				name: "type",
@@ -3070,6 +3055,14 @@
     				qname: "CryptoWallet:balanceDate",
     				type: "date"
     			},
+    			blockchain: {
+    				description: "The blockchain or distributed ledger system on which the wallet operates",
+    				label: "Blockchain",
+    				maxLength: 1024,
+    				name: "blockchain",
+    				qname: "CryptoWallet:blockchain",
+    				type: "string"
+    			},
     			creationDate: {
     				label: "Creation date",
     				matchable: true,
@@ -3078,6 +3071,15 @@
     				qname: "CryptoWallet:creationDate",
     				type: "date"
     			},
+    			cryptoAddress: {
+    				description: "The crypto address of the wallet",
+    				label: "Crypto address",
+    				matchable: true,
+    				maxLength: 512,
+    				name: "cryptoAddress",
+    				qname: "CryptoWallet:cryptoAddress",
+    				type: "identifier"
+    			},
     			currencySymbol: {
     				label: "Currency short code",
     				maxLength: 1024,
@@ -3085,6 +3087,14 @@
     				qname: "CryptoWallet:currencySymbol",
     				type: "string"
     			},
+    			custodyType: {
+    				description: "Type of custody arrangement for the wallet (e.g., self-custody, custodial service)",
+    				label: "Custody type",
+    				maxLength: 1024,
+    				name: "custodyType",
+    				qname: "CryptoWallet:custodyType",
+    				type: "string"
+    			},
     			holder: {
     				label: "Wallet holder",
     				matchable: true,
@@ -3113,7 +3123,7 @@
     				description: "Public key used to identify the wallet",
     				label: "Address",
     				matchable: true,
-    				maxLength: 128,
+    				maxLength: 512,
     				name: "publicKey",
     				qname: "CryptoWallet:publicKey",
     				type: "identifier"
@@ -3222,6 +3232,7 @@
     		plural: "Directorships",
     		properties: {
     			director: {
+    				description: "The entity exercising control over another",
     				label: "Director",
     				matchable: true,
     				maxLength: 200,
@@ -3610,7 +3621,7 @@
     			"goodsDescription",
     			"ccdNumber"
     		],
-    		description: "A foreign economic activity",
+    		description: "A foreign economic activity.",
     		"extends": [
     			"Interval"
     		],
@@ -4092,14 +4103,6 @@
     		label: "Event",
     		plural: "Events",
     		properties: {
-    			country: {
-    				label: "Country",
-    				matchable: true,
-    				maxLength: 16,
-    				name: "country",
-    				qname: "Event:country",
-    				type: "country"
-    			},
     			important: {
     				label: "Important",
     				maxLength: 1024,
@@ -4156,7 +4159,7 @@
     		}
     	},
     	Family: {
-    		description: "Family relationship between two people",
+    		description: "Family relationship between two people.",
     		edge: {
     			caption: [
     				"relationship"
@@ -4178,7 +4181,7 @@
     		plural: "Family members",
     		properties: {
     			person: {
-    				description: "The subject of the familial relation.",
+    				description: "The subject of the familial relation",
     				label: "Person",
     				matchable: true,
     				maxLength: 200,
@@ -4189,7 +4192,11 @@
     				type: "entity"
     			},
     			relationship: {
-    				description: "Nature of the relationship, from the person's perspective eg. 'mother', where 'relative' is mother of 'person'.",
+    				description: "Nature of the relationship from the `person`'s perspective, e.g. 'mother', where `relative` is the mother of `person`",
+    				examples: [
+    					"mother",
+    					"sibling"
+    				],
     				label: "Relationship",
     				maxLength: 1024,
     				name: "relationship",
@@ -4197,7 +4204,7 @@
     				type: "string"
     			},
     			relative: {
-    				description: "The relative of the subject person.",
+    				description: "The relative of the subject person",
     				label: "Relative",
     				matchable: true,
     				maxLength: 200,
@@ -4330,7 +4337,7 @@
     		caption: [
     			"number"
     		],
-    		description: "An form of identification associated with its holder and some issuing country. This can be used for national ID cards, voter enrollments and similar instruments.\n",
+    		description: "A form of identification associated with its holder and some issuing country. This can be used for national ID cards, voter enrollments, and similar instruments.\n",
     		"extends": [
     			"Interval"
     		],
@@ -4346,6 +4353,7 @@
     		plural: "Identifications",
     		properties: {
     			authority: {
+    				description: "Government body issuing the identification document",
     				label: "Authority",
     				maxLength: 1024,
     				name: "authority",
@@ -4379,6 +4387,10 @@
     				type: "identifier"
     			},
     			type: {
+    				examples: [
+    					"Passport",
+    					"Driving license"
+    				],
     				label: "Type",
     				maxLength: 1024,
     				name: "type",
@@ -4424,7 +4436,7 @@
     		plural: "Images",
     		properties: {
     			credit: {
-    				description: "The credit or attribution for the image.",
+    				description: "The credit or attribution for the image",
     				label: "Credit",
     				maxLength: 1024,
     				name: "credit",
@@ -4512,6 +4524,7 @@
     				type: "url"
     			},
     			date: {
+    				description: "Date associated with an Interval that isn't explicitly its `startDate` or `endDate` (prefer those when available)",
     				label: "Date",
     				matchable: true,
     				maxLength: 32,
@@ -4527,6 +4540,7 @@
     				type: "text"
     			},
     			endDate: {
+    				description: "The date of expiry of a document, or on which a relationship, sanctioned status, occupation, etc. ended",
     				label: "End date",
     				matchable: true,
     				maxLength: 32,
@@ -4543,6 +4557,7 @@
     				type: "text"
     			},
     			modifiedAt: {
+    				description: "The date on which the entity (like the ID document) was modified, not to be confused with an internal 'last updated'-style metadata field",
     				label: "Modified on",
     				matchable: true,
     				maxLength: 32,
@@ -4584,6 +4599,7 @@
     				type: "url"
     			},
     			recordId: {
+    				description: "Identifier of a record upon which this link is based",
     				label: "Record ID",
     				maxLength: 1024,
     				name: "recordId",
@@ -4591,6 +4607,7 @@
     				type: "string"
     			},
     			retrievedAt: {
+    				description: "Retrieval date generated by a data gathering system, not to be confused with an internal 'first found'-style metadata field",
     				label: "Retrieved on",
     				maxLength: 32,
     				name: "retrievedAt",
@@ -4598,6 +4615,7 @@
     				type: "date"
     			},
     			sourceUrl: {
+    				description: "A deep link to a source website for the profile",
     				label: "Source link",
     				maxLength: 4096,
     				name: "sourceUrl",
@@ -4605,6 +4623,7 @@
     				type: "url"
     			},
     			startDate: {
+    				description: "The date of issue of a document, or on which a relationship, sanctioned status, occupation, etc. started",
     				label: "Start date",
     				matchable: true,
     				maxLength: 32,
@@ -4644,7 +4663,7 @@
     			"phone",
     			"registrationNumber"
     		],
-    		description: "Any party to legal proceedings, such as asset ownership, corporate governance or social interactions. Often used when raw data does not specify if something is a person or company.\n",
+    		description: "Any party to legal proceedings, such as asset ownership, corporate governance or social interactions. Often used when raw data does not specify if something is a person, organization or company.\n",
     		"extends": [
     			"Thing"
     		],
@@ -4746,6 +4765,13 @@
     				type: "entity"
     			},
     			classification: {
+    				description: "Classification as provided by the data source or inferred based on other provided data; prefer `sector` if relevant",
+    				examples: [
+    					"Local government (current)",
+    					"Banking operations license",
+    					"4. Priority Sector Apparel",
+    					"Entities Directly Serving the Defense and Security Sectors"
+    				],
     				label: "Classification",
     				maxLength: 1024,
     				name: "classification",
@@ -4893,7 +4919,7 @@
     			},
     			email: {
     				description: "Email address",
-    				label: "E-Mail",
+    				label: "Email",
     				matchable: true,
     				maxLength: 250,
     				name: "email",
@@ -4982,7 +5008,7 @@
     				type: "date"
     			},
     			innCode: {
-    				description: "Russian tax identification number (Russian: ИНН). Issued to businesses and individuals in Russia",
+    				description: "(RU, ИНН) Russian tax identification number. Issued to businesses and individuals in Russia.",
     				format: "inn",
     				label: "INN",
     				matchable: true,
@@ -4992,7 +5018,7 @@
     				type: "identifier"
     			},
     			jurisdiction: {
-    				description: "Country or region in which this entity operates",
+    				description: "Country or region in which this entity operates; prefer over broader `country` when relevant",
     				label: "Jurisdiction",
     				matchable: true,
     				maxLength: 16,
@@ -5001,6 +5027,10 @@
     				type: "country"
     			},
     			legalForm: {
+    				description: "Company or organization type",
+    				examples: [
+    					"Joint Stock Company"
+    				],
     				label: "Legal form",
     				maxLength: 1024,
     				name: "legalForm",
@@ -5027,7 +5057,7 @@
     				type: "identifier"
     			},
     			mainCountry: {
-    				description: "Primary country of this entity",
+    				description: "Primary country of this entity; prefer over broader `country` when relevant",
     				label: "Country of origin",
     				matchable: true,
     				maxLength: 16,
@@ -5090,7 +5120,7 @@
     				type: "identifier"
     			},
     			ogrnCode: {
-    				description: "Identification number used in Russia's Unified State Register of Legal Entities (EGRUL) (Russian: ОГРН)",
+    				description: "(RU, ОГРН) Registration number used in Russia's Unified State Register of Legal Entities (EGRUL)",
     				format: "ogrn",
     				label: "OGRN",
     				matchable: true,
@@ -5150,7 +5180,7 @@
     			},
     			parent: {
     				deprecated: true,
-    				description: "If this entity is a subsidiary, another entity (company or organisation) is its parent",
+    				description: "Deprecated, use `Ownership` link instead",
     				label: "Parent company",
     				matchable: true,
     				maxLength: 200,
@@ -5231,6 +5261,12 @@
     				type: "identifier"
     			},
     			sector: {
+    				description: "Industrial or trade sector as provided by the data source",
+    				examples: [
+    					"Registered Nurse",
+    					"Retail and wholesale",
+    					"Sea and coastal freight water transport"
+    				],
     				label: "Sector",
     				maxLength: 1024,
     				name: "sector",
@@ -5249,6 +5285,13 @@
     				type: "entity"
     			},
     			status: {
+    				description: "A short string describing how 'active' (broadly defined) an entity is",
+    				examples: [
+    					"Current / Former / Sitting / Retired",
+    					"Active / Inactive",
+    					"Dissolved (last known activity October 2024)",
+    					"Liquidated on 12 November 2022"
+    				],
     				label: "Status",
     				maxLength: 1024,
     				name: "status",
@@ -5278,7 +5321,7 @@
     				type: "entity"
     			},
     			swiftBic: {
-    				description: "Bank identifier code",
+    				description: "SWIFT Bank identifier code from ISO9362",
     				format: "bic",
     				label: "SWIFT/BIC",
     				matchable: true,
@@ -5308,6 +5351,10 @@
     				type: "entity"
     			},
     			taxStatus: {
+    				examples: [
+    					"Non-Habitual Resident",
+    					"Compliant as at March 2022"
+    				],
     				label: "Tax status",
     				maxLength: 1024,
     				name: "taxStatus",
@@ -5325,7 +5372,7 @@
     				type: "identifier"
     			},
     			uscCode: {
-    				description: "Unified Social Credit Identifier",
+    				description: "Chinese Unified Social Credit Identifier",
     				format: "uscc",
     				label: "USCC",
     				matchable: true,
@@ -5384,7 +5431,7 @@
     		caption: [
     			"name"
     		],
-    		description: "A grant of land, rights or property. A type of Contract",
+    		description: "A grant of land, rights or property. A type of `Contract`.",
     		"extends": [
     			"Contract"
     		],
@@ -5787,13 +5834,31 @@
     		label: "Occupancy",
     		plural: "Occupancies",
     		properties: {
+    			constituency: {
+    				description: "The geographic area/distict represented by the holder",
+    				label: "Constituency",
+    				maxLength: 1024,
+    				name: "constituency",
+    				qname: "Occupancy:constituency",
+    				type: "string"
+    			},
     			declarationDate: {
+    				description: "If established by an asset declaration",
     				label: "Declaration date",
     				maxLength: 32,
     				name: "declarationDate",
     				qname: "Occupancy:declarationDate",
     				type: "date"
     			},
+    			electionDate: {
+    				description: "Election date for the position, if applicable",
+    				label: "Election date",
+    				matchable: true,
+    				maxLength: 32,
+    				name: "electionDate",
+    				qname: "Occupancy:electionDate",
+    				type: "date"
+    			},
     			holder: {
     				label: "Holder",
     				matchable: true,
@@ -5804,6 +5869,32 @@
     				reverse: "positionOccupancies",
     				type: "entity"
     			},
+    			periodEnd: {
+    				description: "End date of the period for which the position is occupied",
+    				label: "Period end",
+    				matchable: true,
+    				maxLength: 32,
+    				name: "periodEnd",
+    				qname: "Occupancy:periodEnd",
+    				type: "date"
+    			},
+    			periodStart: {
+    				description: "Start date of the period for which the position is occupied",
+    				label: "Period start",
+    				matchable: true,
+    				maxLength: 32,
+    				name: "periodStart",
+    				qname: "Occupancy:periodStart",
+    				type: "date"
+    			},
+    			politicalGroup: {
+    				description: "Caucus, faction or parliamentary group of the holder",
+    				label: "Political group",
+    				maxLength: 1024,
+    				name: "politicalGroup",
+    				qname: "Occupancy:politicalGroup",
+    				type: "string"
+    			},
     			post: {
     				label: "Position occupied",
     				matchable: true,
@@ -5815,6 +5906,10 @@
     				type: "entity"
     			},
     			status: {
+    				examples: [
+    					"current",
+    					"ended"
+    				],
     				label: "Status",
     				maxLength: 1024,
     				name: "status",
@@ -5850,7 +5945,7 @@
     			"previousName",
     			"registrationNumber"
     		],
-    		description: "Any type of incorporated entity that cannot be owned by another (see Company). This might include charities, foundations or state-owned enterprises, depending on their jurisdiction.\n",
+    		description: "Any type of incorporated entity that cannot be owned by another (see `Company`). This might include charities, foundations or state-owned enterprises, depending on their jurisdiction.\n",
     		"extends": [
     			"LegalEntity"
     		],
@@ -6024,6 +6119,12 @@
     				type: "entity"
     			},
     			ownershipType: {
+    				examples: [
+    					"beneficial",
+    					"direct",
+    					"indirect",
+    					"ultimate"
+    				],
     				label: "Type of ownership",
     				maxLength: 1024,
     				name: "ownershipType",
@@ -6253,7 +6354,7 @@
     			"passportNumber",
     			"number"
     		],
-    		description: "An passport held by a person.\n",
+    		description: "A passport held by a person.\n",
     		"extends": [
     			"Identification"
     		],
@@ -6291,6 +6392,8 @@
     				type: "gender"
     			},
     			givenName: {
+    				deprecated: true,
+    				description: "Deprecated, use `Identification:holder` link's `firstName` / `middleName` instead",
     				label: "Given name",
     				maxLength: 1024,
     				name: "givenName",
@@ -6298,6 +6401,8 @@
     				type: "string"
     			},
     			passportNumber: {
+    				deprecated: true,
+    				description: "Deprecated, use `Identification:number` instead",
     				hidden: true,
     				label: "Passport number",
     				matchable: true,
@@ -6315,6 +6420,8 @@
     				type: "identifier"
     			},
     			surname: {
+    				deprecated: true,
+    				description: "Deprecated, use `Identification:holder` link's `lastName` instead",
     				label: "Surname",
     				maxLength: 1024,
     				name: "surname",
@@ -6565,6 +6672,7 @@
     				type: "country"
     			},
     			deathDate: {
+    				description: "Joined the choir invisible.",
     				label: "Death date",
     				matchable: true,
     				maxLength: 32,
@@ -6699,6 +6807,9 @@
     				type: "string"
     			},
     			nameSuffix: {
+    				examples: [
+    					"OBE"
+    				],
     				label: "Name suffix",
     				maxLength: 1024,
     				name: "nameSuffix",
@@ -6762,7 +6873,7 @@
     			},
     			secondName: {
     				deprecated: true,
-    				description: "Deprecated, use one of the other more specific name properties instead.",
+    				description: "Deprecated, use one of the other more specific name properties instead",
     				label: "Second name",
     				maxLength: 1024,
     				name: "secondName",
@@ -6857,7 +6968,7 @@
     		caption: [
     			"name"
     		],
-    		description: "A post, role or position within an organization or body. This describes a position one or more people may occupy and not the occupation of the post by a specific individual at a specific point in time.\n'subnationalArea' should be used to further restrict the scope of the position. It should not simply represent some regional aspect of the role - e.g. the constituency of a national member of parliament - when their legislative jurisdiction is nationwide.\n",
+    		description: "A post, role or position within an organization or body. This describes a position one or more people may occupy and not the occupation of the post by a specific individual at a specific point in time (see `Occupancy`).\n",
     		"extends": [
     			"Thing"
     		],
@@ -6915,7 +7026,8 @@
     				type: "entity"
     			},
     			subnationalArea: {
-    				label: "Subnational jurisdiction name or code",
+    				description: "The name or code of a subnational jurisdiction, only when the position is geographically limited. Prefer `Occupancy:constituency` where relevant.",
+    				label: "Subnational area",
     				maxLength: 1024,
     				name: "subnationalArea",
     				qname: "Position:subnationalArea",
@@ -6943,7 +7055,7 @@
     			"name",
     			"projectId"
     		],
-    		description: "An activity carried out by a group of participants.\n",
+    		description: "An activity carried out by a group of `participants`.\n",
     		"extends": [
     			"Interval",
     			"Thing",
@@ -7040,7 +7152,7 @@
     		caption: [
     			"role"
     		],
-    		description: "An activity carried out by a group of participants.\n",
+    		description: "A participant in a `Project`.\n",
     		edge: {
     			caption: [
     				"role"
@@ -7342,7 +7454,7 @@
     			"reason",
     			"status"
     		],
-    		description: "A risk associated with an entity",
+    		description: "A risk associated with an entity.",
     		"extends": [
     			"Interval"
     		],
@@ -7432,7 +7544,7 @@
     		caption: [
     			"program"
     		],
-    		description: "A sanction designation",
+    		description: "A sanction designation.",
     		"extends": [
     			"Interval"
     		],
@@ -7487,6 +7599,7 @@
     				type: "entity"
     			},
     			listingDate: {
+    				description: "The date on which the designation is listed; distinct from the `startDate`, which is the date on which the designation goes into effect",
     				label: "Listing date",
     				matchable: true,
     				maxLength: 32,
@@ -7525,6 +7638,7 @@
     				type: "string"
     			},
     			reason: {
+    				description: "An explanation of the designation's justification.",
     				label: "Reason",
     				maxLength: 65000,
     				name: "reason",
@@ -7532,6 +7646,12 @@
     				type: "text"
     			},
     			status: {
+    				examples: [
+    					"Active",
+    					"Inactive",
+    					"Expired",
+    					"Suspended"
+    				],
     				label: "Status",
     				maxLength: 1024,
     				name: "status",
@@ -7539,6 +7659,7 @@
     				type: "string"
     			},
     			unscId: {
+    				description: "Identifier issued by the UN Security Council for sanctions designations",
     				label: "UN SC identifier",
     				matchable: true,
     				maxLength: 16,
@@ -7868,7 +7989,7 @@
     		}
     	},
     	TaxRoll: {
-    		description: "A tax declaration of an individual",
+    		description: "A tax declaration of an individual.",
     		"extends": [
     			"Interval"
     		],
@@ -7976,6 +8097,7 @@
     		plural: "Thing",
     		properties: {
     			address: {
+    				description: "A textual description of an address linked to the entity",
     				label: "Address",
     				matchable: true,
     				maxLength: 250,
@@ -7984,6 +8106,7 @@
     				type: "address"
     			},
     			addressEntity: {
+    				description: "A reference to an `Address` entity with structured place information",
     				label: "Address",
     				matchable: true,
     				maxLength: 200,
@@ -8002,6 +8125,7 @@
     				type: "url"
     			},
     			alias: {
+    				description: "An alternative or secondary name",
     				label: "Alias",
     				matchable: true,
     				maxLength: 384,
@@ -8021,6 +8145,7 @@
     				type: "entity"
     			},
     			country: {
+    				description: "An association between the entity and a country that is not covered by a more specific property (e.g. `jurisdiction`, `birthCountry`, `mainCountry`)",
     				label: "Country",
     				matchable: true,
     				maxLength: 16,
@@ -8040,6 +8165,7 @@
     				type: "entity"
     			},
     			createdAt: {
+    				description: "The date on which the entity was created, not to be confused with an internal 'first saved'-style metadata field",
     				label: "Created at",
     				maxLength: 32,
     				name: "createdAt",
@@ -8047,6 +8173,7 @@
     				type: "date"
     			},
     			description: {
+    				description: "A longer description; see also `notes`, `summary`",
     				label: "Description",
     				maxLength: 65000,
     				name: "description",
@@ -8073,6 +8200,7 @@
     				type: "text"
     			},
     			keywords: {
+    				description: "Plain text keywords provided for the entity; prefer more specific `type`, `status`, etc. as appropriate",
     				label: "Keywords",
     				maxLength: 1024,
     				name: "keywords",
@@ -8091,6 +8219,7 @@
     				type: "entity"
     			},
     			modifiedAt: {
+    				description: "The date on which the entity was modified, not to be confused with an internal 'last updated'-style metadata field",
     				label: "Modified on",
     				maxLength: 32,
     				name: "modifiedAt",
@@ -8098,6 +8227,7 @@
     				type: "date"
     			},
     			name: {
+    				description: "The primary name of the entity",
     				label: "Name",
     				matchable: true,
     				maxLength: 384,
@@ -8117,6 +8247,7 @@
     				type: "entity"
     			},
     			notes: {
+    				description: "Narrative description of the entity; see also `description`, `summary`",
     				label: "Notes",
     				maxLength: 65000,
     				name: "notes",
@@ -8124,6 +8255,7 @@
     				type: "text"
     			},
     			previousName: {
+    				description: "A former name of the entity",
     				label: "Previous name",
     				matchable: true,
     				maxLength: 384,
@@ -8132,7 +8264,7 @@
     				type: "name"
     			},
     			program: {
-    				description: "Regulatory program or sanctions list on which an entity is listed.",
+    				description: "Regulatory program or sanctions list on which an entity is listed",
     				label: "Program",
     				maxLength: 1024,
     				name: "program",
@@ -8172,6 +8304,7 @@
     				type: "url"
     			},
     			retrievedAt: {
+    				description: "Retrieval date generated by a data gathering system, not to be confused with an internal 'first found'-style metadata field",
     				label: "Retrieved on",
     				maxLength: 32,
     				name: "retrievedAt",
@@ -8201,6 +8334,7 @@
     				type: "entity"
     			},
     			sourceUrl: {
+    				description: "A deep link to a source website for the profile",
     				label: "Source link",
     				maxLength: 4096,
     				name: "sourceUrl",
@@ -8208,6 +8342,7 @@
     				type: "url"
     			},
     			summary: {
+    				description: "A short one-liner description; see also `description`, `notes`",
     				label: "Summary",
     				maxLength: 65000,
     				name: "summary",
@@ -8215,6 +8350,12 @@
     				type: "text"
     			},
     			topics: {
+    				description: "Controlled tags used to qualify the entity and associate it with a risk category",
+    				examples: [
+    					"sanction",
+    					"debarment",
+    					"role.pep"
+    				],
     				label: "Topics",
     				maxLength: 64,
     				name: "topics",
@@ -8252,6 +8393,9 @@
     				type: "name"
     			},
     			wikidataId: {
+    				examples: [
+    					"Q7747"
+    				],
     				format: "wikidata",
     				label: "Wikidata ID",
     				matchable: true,
@@ -8431,7 +8575,7 @@
     		properties: {
     			email: {
     				description: "Email address",
-    				label: "E-Mail",
+    				label: "Email",
     				matchable: true,
     				maxLength: 250,
     				name: "email",
@@ -8621,6 +8765,7 @@
     			},
     			owner: {
     				deprecated: true,
+    				description: "Deprecated, use `Ownership` link instead",
     				label: "Owner",
     				matchable: true,
     				maxLength: 200,
@@ -8658,6 +8803,9 @@
     				type: "entity"
     			},
     			type: {
+    				examples: [
+    					"Bulk carrier"
+    				],
     				label: "Type",
     				maxLength: 1024,
     				name: "type",
@@ -8717,6 +8865,7 @@
     				type: "identifier"
     			},
     			deadweightTonnage: {
+    				description: "Weight of the vessel when not carrying freight",
     				label: "Deadweight Tonnage",
     				maxLength: 250,
     				name: "deadweightTonnage",
@@ -9441,6 +9590,7 @@
     			"gov.security": "Security services",
     			"gov.soe": "State-owned enterprise",
     			"gov.state": "State government",
+    			"invest.risk": "Investment risk",
     			"mare.detained": "Maritime detention",
     			"mare.shadow": "Shadow fleet",
     			"mare.sts": "Ship-to-ship transfer",
@@ -9460,8 +9610,11 @@
     			"role.lawyer": "Lawyer",
     			"role.lobby": "Lobbyist",
     			"role.oligarch": "Oligarch",
-    			"role.pep": "Politician",
-    			"role.pol": "Non-PEP",
+    			"role.pep": "PEP",
+    			"role.pep.frmr": "Former PEP",
+    			"role.pep.intl": "International PEP",
+    			"role.pep.natl": "National PEP",
+    			"role.pol": "Politician",
     			"role.rca": "Close Associate",
     			"role.spy": "Spy",
     			sanction: "Sanctioned entity",