@opensanctions/followthemoney 4.6.2 → 4.7.0

package/dist/followthemoney.umd.js

@@ -245,71 +245,13 @@
         return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
     };
 
-    const byteToHex = [];
-    for (let i = 0; i < 256; ++i) {
-        byteToHex.push((i + 0x100).toString(16).slice(1));
-    }
-    function unsafeStringify(arr, offset = 0) {
-        return (byteToHex[arr[offset + 0]] +
-            byteToHex[arr[offset + 1]] +
-            byteToHex[arr[offset + 2]] +
-            byteToHex[arr[offset + 3]] +
-            '-' +
-            byteToHex[arr[offset + 4]] +
-            byteToHex[arr[offset + 5]] +
-            '-' +
-            byteToHex[arr[offset + 6]] +
-            byteToHex[arr[offset + 7]] +
-            '-' +
-            byteToHex[arr[offset + 8]] +
-            byteToHex[arr[offset + 9]] +
-            '-' +
-            byteToHex[arr[offset + 10]] +
-            byteToHex[arr[offset + 11]] +
-            byteToHex[arr[offset + 12]] +
-            byteToHex[arr[offset + 13]] +
-            byteToHex[arr[offset + 14]] +
-            byteToHex[arr[offset + 15]]).toLowerCase();
-    }
-
-    let getRandomValues;
-    const rnds8 = new Uint8Array(16);
-    function rng() {
-        if (!getRandomValues) {
-            if (typeof crypto === 'undefined' || !crypto.getRandomValues) {
-                throw new Error('crypto.getRandomValues() not supported. See https://github.com/uuidjs/uuid#getrandomvalues-not-supported');
-            }
-            getRandomValues = crypto.getRandomValues.bind(crypto);
-        }
-        return getRandomValues(rnds8);
-    }
-
-    const randomUUID = typeof crypto !== 'undefined' && crypto.randomUUID && crypto.randomUUID.bind(crypto);
-    var native = { randomUUID };
-
-    function _v4(options, buf, offset) {
-        options = options || {};
-        const rnds = options.random ?? options.rng?.() ?? rng();
-        if (rnds.length < 16) {
-            throw new Error('Random bytes length must be >= 16');
-        }
-        rnds[6] = (rnds[6] & 0x0f) | 0x40;
-        rnds[8] = (rnds[8] & 0x3f) | 0x80;
-        return unsafeStringify(rnds);
-    }
-    function v4(options, buf, offset) {
-        if (native.randomUUID && true && !options) {
-            return native.randomUUID();
-        }
-        return _v4(options);
-    }
-
     /**
      * Definition of a property, with relevant metadata for type,
      * labels and other useful criteria.
      */
     class Property {
         constructor(schema, property) {
+            this.examples = null;
             this.schema = schema;
             this.name = property.name;
             this.qname = property.qname;
@@ -326,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);
@@ -592,6 +535,14 @@
                 return new Entity(this, raw);
             }
         }
+        /**
+         * Generate a new random UUID.
+         *
+         * @returns a new UUID.
+         */
+        generateRandomId() {
+            return crypto.randomUUID();
+        }
         /**
          * Make a new object with the given schema, and generate a random ID for
          * it.
@@ -600,7 +551,7 @@
          */
         createEntity(schema, namespace) {
             return __awaiter(this, void 0, void 0, function* () {
-                const rawId = v4();
+                const rawId = this.generateRandomId();
                 const id = namespace ? yield namespace.sign(rawId) : rawId;
                 return this.getEntity({
                     id,
@@ -1321,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,
@@ -1376,7 +1319,7 @@
     				type: "string"
     			},
     			postalCode: {
-    				description: "Zip code or postcode.",
+    				description: "Zip code or postcode",
     				label: "Postal code",
     				maxLength: 16,
     				name: "postalCode",
@@ -1384,7 +1327,7 @@
     				type: "string"
     			},
     			region: {
-    				description: "Also province or area.",
+    				description: "Also province or area",
     				label: "Region",
     				maxLength: 1024,
     				name: "region",
@@ -1392,7 +1335,7 @@
     				type: "string"
     			},
     			remarks: {
-    				description: "Handling instructions, like 'care of'.",
+    				description: "Handling instructions, like 'care of'",
     				label: "Remarks",
     				maxLength: 1024,
     				name: "remarks",
@@ -1400,7 +1343,7 @@
     				type: "string"
     			},
     			state: {
-    				description: "State or federal unit.",
+    				description: "State or federal unit",
     				label: "State",
     				maxLength: 1024,
     				name: "state",
@@ -1693,7 +1636,7 @@
     		]
     	},
     	Associate: {
-    		description: "Non-family association between two people",
+    		description: "Non-family association between two people.",
     		edge: {
     			caption: [
     				"relationship"
@@ -1715,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,
@@ -1726,7 +1669,7 @@
     				type: "entity"
     			},
     			person: {
-    				description: "The subject of the association.",
+    				description: "The subject of the association",
     				label: "Person",
     				matchable: true,
     				maxLength: 200,
@@ -2087,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"
@@ -2213,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",
@@ -2380,7 +2323,12 @@
     	},
     	Company: {
     		caption: [
-    			"name"
+    			"name",
+    			"alias",
+    			"abbreviation",
+    			"weakAlias",
+    			"previousName",
+    			"registrationNumber"
     		],
     		description: "A corporation, usually for profit. Does not distinguish between private and public companies, and can also be used to model more specific constructs like trusts and funds. Companies are assets, so they can be owned by other legal entities.\n",
     		"extends": [
@@ -2416,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,
@@ -2431,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",
@@ -2471,6 +2419,7 @@
     				type: "identifier"
     			},
     			isinCode: {
+    				deprecated: true,
     				description: "International Securities Identification Number",
     				label: "ISIN",
     				matchable: true,
@@ -2488,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",
@@ -2513,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",
@@ -2521,7 +2462,7 @@
     				type: "string"
     			},
     			oksmCode: {
-    				description: "Russian (ОКСМ) countries classifier",
+    				description: "(RU, ОКСМ) Russian countries classifier",
     				label: "OKSM",
     				maxLength: 1024,
     				name: "oksmCode",
@@ -2529,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",
@@ -2537,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,
@@ -2545,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,
@@ -2605,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"
     		],
@@ -2743,6 +2676,10 @@
     				type: "entity"
     			},
     			status: {
+    				examples: [
+    					"In force",
+    					"Annulled"
+    				],
     				label: "Status",
     				maxLength: 1024,
     				name: "status",
@@ -2757,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",
@@ -3089,6 +3031,15 @@
     		matchable: true,
     		plural: "Cryptocurrency wallets",
     		properties: {
+    			accountId: {
+    				description: "Platform-specific user/account identifier",
+    				label: "Account ID",
+    				matchable: true,
+    				maxLength: 64,
+    				name: "accountId",
+    				qname: "CryptoWallet:accountId",
+    				type: "identifier"
+    			},
     			balance: {
     				label: "Balance",
     				maxLength: 250,
@@ -3104,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,
@@ -3112,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,
@@ -3119,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,
@@ -3147,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"
@@ -3256,6 +3232,7 @@
     		plural: "Directorships",
     		properties: {
     			director: {
+    				description: "The entity exercising control over another",
     				label: "Director",
     				matchable: true,
     				maxLength: 200,
@@ -3644,7 +3621,7 @@
     			"goodsDescription",
     			"ccdNumber"
     		],
-    		description: "A foreign economic activity",
+    		description: "A foreign economic activity.",
     		"extends": [
     			"Interval"
     		],
@@ -4126,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,
@@ -4190,7 +4159,7 @@
     		}
     	},
     	Family: {
-    		description: "Family relationship between two people",
+    		description: "Family relationship between two people.",
     		edge: {
     			caption: [
     				"relationship"
@@ -4212,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,
@@ -4223,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",
@@ -4231,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,
@@ -4364,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"
     		],
@@ -4380,6 +4353,7 @@
     		plural: "Identifications",
     		properties: {
     			authority: {
+    				description: "Government body issuing the identification document",
     				label: "Authority",
     				maxLength: 1024,
     				name: "authority",
@@ -4413,6 +4387,10 @@
     				type: "identifier"
     			},
     			type: {
+    				examples: [
+    					"Passport",
+    					"Driving license"
+    				],
     				label: "Type",
     				maxLength: 1024,
     				name: "type",
@@ -4457,6 +4435,14 @@
     		label: "Image",
     		plural: "Images",
     		properties: {
+    			credit: {
+    				description: "The credit or attribution for the image",
+    				label: "Credit",
+    				maxLength: 1024,
+    				name: "credit",
+    				qname: "Image:credit",
+    				type: "string"
+    			},
     			pictured: {
     				label: "Pictured",
     				matchable: true,
@@ -4538,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,
@@ -4553,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,
@@ -4569,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,
@@ -4610,6 +4599,7 @@
     				type: "url"
     			},
     			recordId: {
+    				description: "Identifier of a record upon which this link is based",
     				label: "Record ID",
     				maxLength: 1024,
     				name: "recordId",
@@ -4617,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",
@@ -4624,6 +4615,7 @@
     				type: "date"
     			},
     			sourceUrl: {
+    				description: "A deep link to a source website for the profile",
     				label: "Source link",
     				maxLength: 4096,
     				name: "sourceUrl",
@@ -4631,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,
@@ -4662,11 +4655,15 @@
     	LegalEntity: {
     		caption: [
     			"name",
+    			"alias",
+    			"abbreviation",
+    			"weakAlias",
+    			"previousName",
     			"email",
     			"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"
     		],
@@ -4680,6 +4677,14 @@
     		matchable: true,
     		plural: "Legal entities",
     		properties: {
+    			abbreviation: {
+    				description: "Abbreviated name or acronym",
+    				label: "Abbreviation",
+    				maxLength: 384,
+    				name: "abbreviation",
+    				qname: "LegalEntity:abbreviation",
+    				type: "name"
+    			},
     			agencyClient: {
     				label: "Clients",
     				matchable: true,
@@ -4760,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",
@@ -4907,7 +4919,7 @@
     			},
     			email: {
     				description: "Email address",
-    				label: "E-Mail",
+    				label: "Email",
     				matchable: true,
     				maxLength: 250,
     				name: "email",
@@ -4996,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,
@@ -5006,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,
@@ -5015,6 +5027,10 @@
     				type: "country"
     			},
     			legalForm: {
+    				description: "Company or organization type",
+    				examples: [
+    					"Joint Stock Company"
+    				],
     				label: "Legal form",
     				maxLength: 1024,
     				name: "legalForm",
@@ -5041,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,
@@ -5104,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,
@@ -5164,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,
@@ -5245,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",
@@ -5263,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",
@@ -5292,7 +5321,7 @@
     				type: "entity"
     			},
     			swiftBic: {
-    				description: "Bank identifier code",
+    				description: "SWIFT Bank identifier code from ISO9362",
     				format: "bic",
     				label: "SWIFT/BIC",
     				matchable: true,
@@ -5322,6 +5351,10 @@
     				type: "entity"
     			},
     			taxStatus: {
+    				examples: [
+    					"Non-Habitual Resident",
+    					"Compliant as at March 2022"
+    				],
     				label: "Tax status",
     				maxLength: 1024,
     				name: "taxStatus",
@@ -5339,7 +5372,7 @@
     				type: "identifier"
     			},
     			uscCode: {
-    				description: "Unified Social Credit Identifier",
+    				description: "Chinese Unified Social Credit Identifier",
     				format: "uscc",
     				label: "USCC",
     				matchable: true,
@@ -5398,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"
     		],
@@ -5801,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,
@@ -5818,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,
@@ -5829,6 +5906,10 @@
     				type: "entity"
     			},
     			status: {
+    				examples: [
+    					"current",
+    					"ended"
+    				],
     				label: "Status",
     				maxLength: 1024,
     				name: "status",
@@ -5857,9 +5938,14 @@
     	},
     	Organization: {
     		caption: [
-    			"name"
+    			"name",
+    			"alias",
+    			"abbreviation",
+    			"weakAlias",
+    			"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"
     		],
@@ -6033,6 +6119,12 @@
     				type: "entity"
     			},
     			ownershipType: {
+    				examples: [
+    					"beneficial",
+    					"direct",
+    					"indirect",
+    					"ultimate"
+    				],
     				label: "Type of ownership",
     				maxLength: 1024,
     				name: "ownershipType",
@@ -6262,7 +6354,7 @@
     			"passportNumber",
     			"number"
     		],
-    		description: "An passport held by a person.\n",
+    		description: "A passport held by a person.\n",
     		"extends": [
     			"Identification"
     		],
@@ -6300,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",
@@ -6307,6 +6401,8 @@
     				type: "string"
     			},
     			passportNumber: {
+    				deprecated: true,
+    				description: "Deprecated, use `Identification:number` instead",
     				hidden: true,
     				label: "Passport number",
     				matchable: true,
@@ -6324,6 +6420,8 @@
     				type: "identifier"
     			},
     			surname: {
+    				deprecated: true,
+    				description: "Deprecated, use `Identification:holder` link's `lastName` instead",
     				label: "Surname",
     				maxLength: 1024,
     				name: "surname",
@@ -6493,7 +6591,9 @@
     		caption: [
     			"name",
     			"alias",
+    			"previousName",
     			"weakAlias",
+    			"abbreviation",
     			"lastName",
     			"email",
     			"phone"
@@ -6572,6 +6672,7 @@
     				type: "country"
     			},
     			deathDate: {
+    				description: "Joined the choir invisible.",
     				label: "Death date",
     				matchable: true,
     				maxLength: 32,
@@ -6706,6 +6807,9 @@
     				type: "string"
     			},
     			nameSuffix: {
+    				examples: [
+    					"OBE"
+    				],
     				label: "Name suffix",
     				maxLength: 1024,
     				name: "nameSuffix",
@@ -6769,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",
@@ -6864,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"
     		],
@@ -6922,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",
@@ -6950,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",
@@ -7047,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"
@@ -7106,7 +7211,11 @@
     	},
     	PublicBody: {
     		caption: [
-    			"name"
+    			"name",
+    			"alias",
+    			"abbreviation",
+    			"weakAlias",
+    			"previousName"
     		],
     		description: "A public body, such as a ministry, department or state company.\n",
     		"extends": [
@@ -7345,7 +7454,7 @@
     			"reason",
     			"status"
     		],
-    		description: "A risk associated with an entity",
+    		description: "A risk associated with an entity.",
     		"extends": [
     			"Interval"
     		],
@@ -7435,7 +7544,7 @@
     		caption: [
     			"program"
     		],
-    		description: "A sanction designation",
+    		description: "A sanction designation.",
     		"extends": [
     			"Interval"
     		],
@@ -7490,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,
@@ -7528,6 +7638,7 @@
     				type: "string"
     			},
     			reason: {
+    				description: "An explanation of the designation's justification.",
     				label: "Reason",
     				maxLength: 65000,
     				name: "reason",
@@ -7535,6 +7646,12 @@
     				type: "text"
     			},
     			status: {
+    				examples: [
+    					"Active",
+    					"Inactive",
+    					"Expired",
+    					"Suspended"
+    				],
     				label: "Status",
     				maxLength: 1024,
     				name: "status",
@@ -7542,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,
@@ -7871,7 +7989,7 @@
     		}
     	},
     	TaxRoll: {
-    		description: "A tax declaration of an individual",
+    		description: "A tax declaration of an individual.",
     		"extends": [
     			"Interval"
     		],
@@ -7979,6 +8097,7 @@
     		plural: "Thing",
     		properties: {
     			address: {
+    				description: "A textual description of an address linked to the entity",
     				label: "Address",
     				matchable: true,
     				maxLength: 250,
@@ -7987,6 +8106,7 @@
     				type: "address"
     			},
     			addressEntity: {
+    				description: "A reference to an `Address` entity with structured place information",
     				label: "Address",
     				matchable: true,
     				maxLength: 200,
@@ -8005,6 +8125,7 @@
     				type: "url"
     			},
     			alias: {
+    				description: "An alternative or secondary name",
     				label: "Alias",
     				matchable: true,
     				maxLength: 384,
@@ -8024,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,
@@ -8043,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",
@@ -8050,6 +8173,7 @@
     				type: "date"
     			},
     			description: {
+    				description: "A longer description; see also `notes`, `summary`",
     				label: "Description",
     				maxLength: 65000,
     				name: "description",
@@ -8076,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",
@@ -8094,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",
@@ -8101,6 +8227,7 @@
     				type: "date"
     			},
     			name: {
+    				description: "The primary name of the entity",
     				label: "Name",
     				matchable: true,
     				maxLength: 384,
@@ -8120,6 +8247,7 @@
     				type: "entity"
     			},
     			notes: {
+    				description: "Narrative description of the entity; see also `description`, `summary`",
     				label: "Notes",
     				maxLength: 65000,
     				name: "notes",
@@ -8127,6 +8255,7 @@
     				type: "text"
     			},
     			previousName: {
+    				description: "A former name of the entity",
     				label: "Previous name",
     				matchable: true,
     				maxLength: 384,
@@ -8135,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",
@@ -8175,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",
@@ -8204,6 +8334,7 @@
     				type: "entity"
     			},
     			sourceUrl: {
+    				description: "A deep link to a source website for the profile",
     				label: "Source link",
     				maxLength: 4096,
     				name: "sourceUrl",
@@ -8211,6 +8342,7 @@
     				type: "url"
     			},
     			summary: {
+    				description: "A short one-liner description; see also `description`, `notes`",
     				label: "Summary",
     				maxLength: 65000,
     				name: "summary",
@@ -8218,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",
@@ -8255,6 +8393,9 @@
     				type: "name"
     			},
     			wikidataId: {
+    				examples: [
+    					"Q7747"
+    				],
     				format: "wikidata",
     				label: "Wikidata ID",
     				matchable: true,
@@ -8434,7 +8575,7 @@
     		properties: {
     			email: {
     				description: "Email address",
-    				label: "E-Mail",
+    				label: "Email",
     				matchable: true,
     				maxLength: 250,
     				name: "email",
@@ -8624,6 +8765,7 @@
     			},
     			owner: {
     				deprecated: true,
+    				description: "Deprecated, use `Ownership` link instead",
     				label: "Owner",
     				matchable: true,
     				maxLength: 200,
@@ -8661,6 +8803,9 @@
     				type: "entity"
     			},
     			type: {
+    				examples: [
+    					"Bulk carrier"
+    				],
     				label: "Type",
     				maxLength: 1024,
     				name: "type",
@@ -8720,6 +8865,7 @@
     				type: "identifier"
     			},
     			deadweightTonnage: {
+    				description: "Weight of the vessel when not carrying freight",
     				label: "Deadweight Tonnage",
     				maxLength: 250,
     				name: "deadweightTonnage",
@@ -9444,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",
@@ -9463,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",