@opensanctions/followthemoney 4.5.2 → 4.7.0

package/dist/followthemoney.es.js

@@ -1,5 +1,3 @@
-import { randomUUID } from 'crypto';
-
 /**
  * An entity proxy which provides simplified access to the
  * properties and schema associated with an entity.
@@ -247,6 +245,7 @@ typeof SuppressedError === "function" ? SuppressedError : function (error, suppr
  */
 class Property {
     constructor(schema, property) {
+        this.examples = null;
         this.schema = schema;
         this.name = property.name;
         this.qname = property.qname;
@@ -263,6 +262,7 @@ class Property {
         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);
@@ -535,10 +535,7 @@ class Model {
      * @returns a new UUID.
      */
     generateRandomId() {
-        if (typeof crypto !== 'undefined' && crypto.randomUUID) {
-            return crypto.randomUUID(); // Browser
-        }
-        return randomUUID(); // Node.js
+        return crypto.randomUUID();
     }
     /**
      * Make a new object with the given schema, and generate a random ID for
@@ -1269,14 +1266,6 @@ var schemata = {
 				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,
@@ -1324,7 +1313,7 @@ var schemata = {
 				type: "string"
 			},
 			postalCode: {
-				description: "Zip code or postcode.",
+				description: "Zip code or postcode",
 				label: "Postal code",
 				maxLength: 16,
 				name: "postalCode",
@@ -1332,7 +1321,7 @@ var schemata = {
 				type: "string"
 			},
 			region: {
-				description: "Also province or area.",
+				description: "Also province or area",
 				label: "Region",
 				maxLength: 1024,
 				name: "region",
@@ -1340,7 +1329,7 @@ var schemata = {
 				type: "string"
 			},
 			remarks: {
-				description: "Handling instructions, like 'care of'.",
+				description: "Handling instructions, like 'care of'",
 				label: "Remarks",
 				maxLength: 1024,
 				name: "remarks",
@@ -1348,7 +1337,7 @@ var schemata = {
 				type: "string"
 			},
 			state: {
-				description: "State or federal unit.",
+				description: "State or federal unit",
 				label: "State",
 				maxLength: 1024,
 				name: "state",
@@ -1641,7 +1630,7 @@ var schemata = {
 		]
 	},
 	Associate: {
-		description: "Non-family association between two people",
+		description: "Non-family association between two people.",
 		edge: {
 			caption: [
 				"relationship"
@@ -1663,7 +1652,7 @@ var schemata = {
 		plural: "Associates",
 		properties: {
 			associate: {
-				description: "An associate of the subject person.",
+				description: "An associate of the subject person",
 				label: "Associate",
 				matchable: true,
 				maxLength: 200,
@@ -1674,7 +1663,7 @@ var schemata = {
 				type: "entity"
 			},
 			person: {
-				description: "The subject of the association.",
+				description: "The subject of the association",
 				label: "Person",
 				matchable: true,
 				maxLength: 200,
@@ -2035,7 +2024,7 @@ var schemata = {
 		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"
@@ -2161,7 +2150,7 @@ var schemata = {
 				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",
@@ -2369,13 +2358,13 @@ var schemata = {
 			},
 			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,
@@ -2384,7 +2373,7 @@ var schemata = {
 				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",
@@ -2424,6 +2413,7 @@ var schemata = {
 				type: "identifier"
 			},
 			isinCode: {
+				deprecated: true,
 				description: "International Securities Identification Number",
 				label: "ISIN",
 				matchable: true,
@@ -2441,16 +2431,8 @@ var schemata = {
 				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",
@@ -2466,7 +2448,7 @@ var schemata = {
 				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",
@@ -2474,7 +2456,7 @@ var schemata = {
 				type: "string"
 			},
 			oksmCode: {
-				description: "Russian (ОКСМ) countries classifier",
+				description: "(RU, ОКСМ) Russian countries classifier",
 				label: "OKSM",
 				maxLength: 1024,
 				name: "oksmCode",
@@ -2482,7 +2464,7 @@ var schemata = {
 				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",
@@ -2490,7 +2472,7 @@ var schemata = {
 				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,
@@ -2498,14 +2480,6 @@ var schemata = {
 				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,
@@ -2558,7 +2532,7 @@ var schemata = {
 			"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"
 		],
@@ -2696,6 +2670,10 @@ var schemata = {
 				type: "entity"
 			},
 			status: {
+				examples: [
+					"In force",
+					"Annulled"
+				],
 				label: "Status",
 				maxLength: 1024,
 				name: "status",
@@ -2710,7 +2688,12 @@ var schemata = {
 				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",
@@ -3066,6 +3049,14 @@ var schemata = {
 				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,
@@ -3074,6 +3065,15 @@ var schemata = {
 				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,
@@ -3081,6 +3081,14 @@ var schemata = {
 				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,
@@ -3109,7 +3117,7 @@ var schemata = {
 				description: "Public key used to identify the wallet",
 				label: "Address",
 				matchable: true,
-				maxLength: 128,
+				maxLength: 512,
 				name: "publicKey",
 				qname: "CryptoWallet:publicKey",
 				type: "identifier"
@@ -3218,6 +3226,7 @@ var schemata = {
 		plural: "Directorships",
 		properties: {
 			director: {
+				description: "The entity exercising control over another",
 				label: "Director",
 				matchable: true,
 				maxLength: 200,
@@ -3606,7 +3615,7 @@ var schemata = {
 			"goodsDescription",
 			"ccdNumber"
 		],
-		description: "A foreign economic activity",
+		description: "A foreign economic activity.",
 		"extends": [
 			"Interval"
 		],
@@ -4088,14 +4097,6 @@ var schemata = {
 		label: "Event",
 		plural: "Events",
 		properties: {
-			country: {
-				label: "Country",
-				matchable: true,
-				maxLength: 16,
-				name: "country",
-				qname: "Event:country",
-				type: "country"
-			},
 			important: {
 				label: "Important",
 				maxLength: 1024,
@@ -4152,7 +4153,7 @@ var schemata = {
 		}
 	},
 	Family: {
-		description: "Family relationship between two people",
+		description: "Family relationship between two people.",
 		edge: {
 			caption: [
 				"relationship"
@@ -4174,7 +4175,7 @@ var schemata = {
 		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,
@@ -4185,7 +4186,11 @@ var schemata = {
 				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",
@@ -4193,7 +4198,7 @@ var schemata = {
 				type: "string"
 			},
 			relative: {
-				description: "The relative of the subject person.",
+				description: "The relative of the subject person",
 				label: "Relative",
 				matchable: true,
 				maxLength: 200,
@@ -4326,7 +4331,7 @@ var schemata = {
 		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"
 		],
@@ -4342,6 +4347,7 @@ var schemata = {
 		plural: "Identifications",
 		properties: {
 			authority: {
+				description: "Government body issuing the identification document",
 				label: "Authority",
 				maxLength: 1024,
 				name: "authority",
@@ -4375,6 +4381,10 @@ var schemata = {
 				type: "identifier"
 			},
 			type: {
+				examples: [
+					"Passport",
+					"Driving license"
+				],
 				label: "Type",
 				maxLength: 1024,
 				name: "type",
@@ -4420,7 +4430,7 @@ var schemata = {
 		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",
@@ -4508,6 +4518,7 @@ var schemata = {
 				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,
@@ -4523,6 +4534,7 @@ var schemata = {
 				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,
@@ -4539,6 +4551,7 @@ var schemata = {
 				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,
@@ -4580,6 +4593,7 @@ var schemata = {
 				type: "url"
 			},
 			recordId: {
+				description: "Identifier of a record upon which this link is based",
 				label: "Record ID",
 				maxLength: 1024,
 				name: "recordId",
@@ -4587,6 +4601,7 @@ var schemata = {
 				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",
@@ -4594,6 +4609,7 @@ var schemata = {
 				type: "date"
 			},
 			sourceUrl: {
+				description: "A deep link to a source website for the profile",
 				label: "Source link",
 				maxLength: 4096,
 				name: "sourceUrl",
@@ -4601,6 +4617,7 @@ var schemata = {
 				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,
@@ -4640,7 +4657,7 @@ var schemata = {
 			"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"
 		],
@@ -4742,6 +4759,13 @@ var schemata = {
 				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",
@@ -4889,7 +4913,7 @@ var schemata = {
 			},
 			email: {
 				description: "Email address",
-				label: "E-Mail",
+				label: "Email",
 				matchable: true,
 				maxLength: 250,
 				name: "email",
@@ -4978,7 +5002,7 @@ var schemata = {
 				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,
@@ -4988,7 +5012,7 @@ var schemata = {
 				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,
@@ -4997,6 +5021,10 @@ var schemata = {
 				type: "country"
 			},
 			legalForm: {
+				description: "Company or organization type",
+				examples: [
+					"Joint Stock Company"
+				],
 				label: "Legal form",
 				maxLength: 1024,
 				name: "legalForm",
@@ -5023,7 +5051,7 @@ var schemata = {
 				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,
@@ -5086,7 +5114,7 @@ var schemata = {
 				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,
@@ -5146,7 +5174,7 @@ var schemata = {
 			},
 			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,
@@ -5227,6 +5255,12 @@ var schemata = {
 				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",
@@ -5245,6 +5279,13 @@ var schemata = {
 				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",
@@ -5274,7 +5315,7 @@ var schemata = {
 				type: "entity"
 			},
 			swiftBic: {
-				description: "Bank identifier code",
+				description: "SWIFT Bank identifier code from ISO9362",
 				format: "bic",
 				label: "SWIFT/BIC",
 				matchable: true,
@@ -5304,6 +5345,10 @@ var schemata = {
 				type: "entity"
 			},
 			taxStatus: {
+				examples: [
+					"Non-Habitual Resident",
+					"Compliant as at March 2022"
+				],
 				label: "Tax status",
 				maxLength: 1024,
 				name: "taxStatus",
@@ -5321,7 +5366,7 @@ var schemata = {
 				type: "identifier"
 			},
 			uscCode: {
-				description: "Unified Social Credit Identifier",
+				description: "Chinese Unified Social Credit Identifier",
 				format: "uscc",
 				label: "USCC",
 				matchable: true,
@@ -5380,7 +5425,7 @@ var schemata = {
 		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"
 		],
@@ -5783,13 +5828,31 @@ var schemata = {
 		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,
@@ -5800,6 +5863,32 @@ var schemata = {
 				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,
@@ -5811,6 +5900,10 @@ var schemata = {
 				type: "entity"
 			},
 			status: {
+				examples: [
+					"current",
+					"ended"
+				],
 				label: "Status",
 				maxLength: 1024,
 				name: "status",
@@ -5846,7 +5939,7 @@ var schemata = {
 			"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"
 		],
@@ -6020,6 +6113,12 @@ var schemata = {
 				type: "entity"
 			},
 			ownershipType: {
+				examples: [
+					"beneficial",
+					"direct",
+					"indirect",
+					"ultimate"
+				],
 				label: "Type of ownership",
 				maxLength: 1024,
 				name: "ownershipType",
@@ -6249,7 +6348,7 @@ var schemata = {
 			"passportNumber",
 			"number"
 		],
-		description: "An passport held by a person.\n",
+		description: "A passport held by a person.\n",
 		"extends": [
 			"Identification"
 		],
@@ -6287,6 +6386,8 @@ var schemata = {
 				type: "gender"
 			},
 			givenName: {
+				deprecated: true,
+				description: "Deprecated, use `Identification:holder` link's `firstName` / `middleName` instead",
 				label: "Given name",
 				maxLength: 1024,
 				name: "givenName",
@@ -6294,6 +6395,8 @@ var schemata = {
 				type: "string"
 			},
 			passportNumber: {
+				deprecated: true,
+				description: "Deprecated, use `Identification:number` instead",
 				hidden: true,
 				label: "Passport number",
 				matchable: true,
@@ -6311,6 +6414,8 @@ var schemata = {
 				type: "identifier"
 			},
 			surname: {
+				deprecated: true,
+				description: "Deprecated, use `Identification:holder` link's `lastName` instead",
 				label: "Surname",
 				maxLength: 1024,
 				name: "surname",
@@ -6561,6 +6666,7 @@ var schemata = {
 				type: "country"
 			},
 			deathDate: {
+				description: "Joined the choir invisible.",
 				label: "Death date",
 				matchable: true,
 				maxLength: 32,
@@ -6695,6 +6801,9 @@ var schemata = {
 				type: "string"
 			},
 			nameSuffix: {
+				examples: [
+					"OBE"
+				],
 				label: "Name suffix",
 				maxLength: 1024,
 				name: "nameSuffix",
@@ -6758,7 +6867,7 @@ var schemata = {
 			},
 			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",
@@ -6853,7 +6962,7 @@ var schemata = {
 		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"
 		],
@@ -6911,7 +7020,8 @@ var schemata = {
 				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",
@@ -6939,7 +7049,7 @@ var schemata = {
 			"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",
@@ -7036,7 +7146,7 @@ var schemata = {
 		caption: [
 			"role"
 		],
-		description: "An activity carried out by a group of participants.\n",
+		description: "A participant in a `Project`.\n",
 		edge: {
 			caption: [
 				"role"
@@ -7338,7 +7448,7 @@ var schemata = {
 			"reason",
 			"status"
 		],
-		description: "A risk associated with an entity",
+		description: "A risk associated with an entity.",
 		"extends": [
 			"Interval"
 		],
@@ -7428,7 +7538,7 @@ var schemata = {
 		caption: [
 			"program"
 		],
-		description: "A sanction designation",
+		description: "A sanction designation.",
 		"extends": [
 			"Interval"
 		],
@@ -7483,6 +7593,7 @@ var schemata = {
 				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,
@@ -7521,6 +7632,7 @@ var schemata = {
 				type: "string"
 			},
 			reason: {
+				description: "An explanation of the designation's justification.",
 				label: "Reason",
 				maxLength: 65000,
 				name: "reason",
@@ -7528,6 +7640,12 @@ var schemata = {
 				type: "text"
 			},
 			status: {
+				examples: [
+					"Active",
+					"Inactive",
+					"Expired",
+					"Suspended"
+				],
 				label: "Status",
 				maxLength: 1024,
 				name: "status",
@@ -7535,6 +7653,7 @@ var schemata = {
 				type: "string"
 			},
 			unscId: {
+				description: "Identifier issued by the UN Security Council for sanctions designations",
 				label: "UN SC identifier",
 				matchable: true,
 				maxLength: 16,
@@ -7864,7 +7983,7 @@ var schemata = {
 		}
 	},
 	TaxRoll: {
-		description: "A tax declaration of an individual",
+		description: "A tax declaration of an individual.",
 		"extends": [
 			"Interval"
 		],
@@ -7972,6 +8091,7 @@ var schemata = {
 		plural: "Thing",
 		properties: {
 			address: {
+				description: "A textual description of an address linked to the entity",
 				label: "Address",
 				matchable: true,
 				maxLength: 250,
@@ -7980,6 +8100,7 @@ var schemata = {
 				type: "address"
 			},
 			addressEntity: {
+				description: "A reference to an `Address` entity with structured place information",
 				label: "Address",
 				matchable: true,
 				maxLength: 200,
@@ -7998,6 +8119,7 @@ var schemata = {
 				type: "url"
 			},
 			alias: {
+				description: "An alternative or secondary name",
 				label: "Alias",
 				matchable: true,
 				maxLength: 384,
@@ -8017,6 +8139,7 @@ var schemata = {
 				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,
@@ -8036,6 +8159,7 @@ var schemata = {
 				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",
@@ -8043,6 +8167,7 @@ var schemata = {
 				type: "date"
 			},
 			description: {
+				description: "A longer description; see also `notes`, `summary`",
 				label: "Description",
 				maxLength: 65000,
 				name: "description",
@@ -8069,6 +8194,7 @@ var schemata = {
 				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",
@@ -8087,6 +8213,7 @@ var schemata = {
 				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",
@@ -8094,6 +8221,7 @@ var schemata = {
 				type: "date"
 			},
 			name: {
+				description: "The primary name of the entity",
 				label: "Name",
 				matchable: true,
 				maxLength: 384,
@@ -8113,6 +8241,7 @@ var schemata = {
 				type: "entity"
 			},
 			notes: {
+				description: "Narrative description of the entity; see also `description`, `summary`",
 				label: "Notes",
 				maxLength: 65000,
 				name: "notes",
@@ -8120,6 +8249,7 @@ var schemata = {
 				type: "text"
 			},
 			previousName: {
+				description: "A former name of the entity",
 				label: "Previous name",
 				matchable: true,
 				maxLength: 384,
@@ -8128,7 +8258,7 @@ var schemata = {
 				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",
@@ -8168,6 +8298,7 @@ var schemata = {
 				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",
@@ -8197,6 +8328,7 @@ var schemata = {
 				type: "entity"
 			},
 			sourceUrl: {
+				description: "A deep link to a source website for the profile",
 				label: "Source link",
 				maxLength: 4096,
 				name: "sourceUrl",
@@ -8204,6 +8336,7 @@ var schemata = {
 				type: "url"
 			},
 			summary: {
+				description: "A short one-liner description; see also `description`, `notes`",
 				label: "Summary",
 				maxLength: 65000,
 				name: "summary",
@@ -8211,6 +8344,12 @@ var schemata = {
 				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",
@@ -8248,6 +8387,9 @@ var schemata = {
 				type: "name"
 			},
 			wikidataId: {
+				examples: [
+					"Q7747"
+				],
 				format: "wikidata",
 				label: "Wikidata ID",
 				matchable: true,
@@ -8427,7 +8569,7 @@ var schemata = {
 		properties: {
 			email: {
 				description: "Email address",
-				label: "E-Mail",
+				label: "Email",
 				matchable: true,
 				maxLength: 250,
 				name: "email",
@@ -8617,6 +8759,7 @@ var schemata = {
 			},
 			owner: {
 				deprecated: true,
+				description: "Deprecated, use `Ownership` link instead",
 				label: "Owner",
 				matchable: true,
 				maxLength: 200,
@@ -8654,6 +8797,9 @@ var schemata = {
 				type: "entity"
 			},
 			type: {
+				examples: [
+					"Bulk carrier"
+				],
 				label: "Type",
 				maxLength: 1024,
 				name: "type",
@@ -8713,6 +8859,7 @@ var schemata = {
 				type: "identifier"
 			},
 			deadweightTonnage: {
+				description: "Weight of the vessel when not carrying freight",
 				label: "Deadweight Tonnage",
 				maxLength: 250,
 				name: "deadweightTonnage",
@@ -9437,6 +9584,7 @@ var types = {
 			"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",
@@ -9456,8 +9604,11 @@ var types = {
 			"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",