@takuhon/core 0.1.1 → 0.3.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 var $schema = "https://json-schema.org/draft/2020-12/schema";
-var $id = "https://takuhon.example/schemas/0.1.0/takuhon.schema.json";
+var $id = "https://takuhon.example/schemas/0.2.0/takuhon.schema.json";
 var title = "Takuhon Profile";
 var description = "Portable profile data format consumed by @takuhon/core. The canonical contract for profile content authored as takuhon.json.";
 var type = "object";
@@ -52,6 +52,69 @@ var properties = {
 			$ref: "#/$defs/Skill"
 		}
 	},
+	certifications: {
+		type: "array",
+		maxItems: 50,
+		items: {
+			$ref: "#/$defs/Certification"
+		}
+	},
+	memberships: {
+		type: "array",
+		maxItems: 50,
+		items: {
+			$ref: "#/$defs/Membership"
+		}
+	},
+	volunteering: {
+		type: "array",
+		maxItems: 50,
+		items: {
+			$ref: "#/$defs/Volunteering"
+		}
+	},
+	honors: {
+		type: "array",
+		maxItems: 50,
+		items: {
+			$ref: "#/$defs/Honor"
+		}
+	},
+	education: {
+		type: "array",
+		maxItems: 30,
+		items: {
+			$ref: "#/$defs/Education"
+		}
+	},
+	publications: {
+		type: "array",
+		maxItems: 100,
+		items: {
+			$ref: "#/$defs/Publication"
+		}
+	},
+	languages: {
+		type: "array",
+		maxItems: 30,
+		items: {
+			$ref: "#/$defs/Language"
+		}
+	},
+	courses: {
+		type: "array",
+		maxItems: 100,
+		items: {
+			$ref: "#/$defs/Course"
+		}
+	},
+	patents: {
+		type: "array",
+		maxItems: 50,
+		items: {
+			$ref: "#/$defs/Patent"
+		}
+	},
 	contact: {
 		$ref: "#/$defs/Contact"
 	},
@@ -489,6 +552,9 @@ var $defs = {
 			},
 			contentLicense: {
 				$ref: "#/$defs/ContentLicense"
+			},
+			privacy: {
+				$ref: "#/$defs/MetaPrivacy"
 			}
 		}
 	},
@@ -529,262 +595,1067 @@ var $defs = {
 				description: "Free-form rights statement (used when spdxId='Proprietary' or for additional notices)."
 			}
 		}
-	}
-};
-var schemaJson = {
-	$schema: $schema,
-	$id: $id,
-	title: title,
-	description: description,
-	type: type,
-	additionalProperties: additionalProperties,
-	required: required,
-	properties: properties,
-	$defs: $defs
-};
-
-/**
- * Re-exports the canonical JSON Schema for takuhon profiles.
- *
- * The schema source of truth lives at `packages/core/takuhon.schema.json`
- * (also distributed via the `@takuhon/core/schema.json` sub-path). This module
- * is the convenient ESM-side entry point for consumers that want to feed it
- * directly to a JSON Schema validator (e.g. Ajv) without a filesystem read.
- */
-
-declare const schema: {
-    $schema: string;
-    $id: string;
-    title: string;
-    description: string;
-    type: string;
-    additionalProperties: boolean;
-    required: string[];
-    properties: {
-        schemaVersion: {
-            type: string;
-            pattern: string;
-            description: string;
-        };
-        profile: {
-            $ref: string;
-        };
-        links: {
-            type: string;
-            maxItems: number;
-            items: {
-                $ref: string;
-            };
-        };
-        careers: {
-            type: string;
-            maxItems: number;
-            items: {
-                $ref: string;
-            };
-        };
-        projects: {
-            type: string;
-            maxItems: number;
-            items: {
-                $ref: string;
-            };
-        };
-        skills: {
-            type: string;
-            maxItems: number;
-            items: {
-                $ref: string;
-            };
-        };
-        contact: {
-            $ref: string;
-        };
-        settings: {
-            $ref: string;
-        };
-        meta: {
-            $ref: string;
-        };
-    };
-    $defs: {
-        LocaleTag: {
-            type: string;
-            minLength: number;
-            maxLength: number;
-            pattern: string;
-            description: string;
-        };
-        Iso3166Alpha2: {
-            type: string;
-            pattern: string;
-            description: string;
-        };
-        YearMonth: {
-            type: string;
-            pattern: string;
-            description: string;
-        };
-        IsoDateTime: {
-            type: string;
-            format: string;
-            description: string;
-        };
-        Url: {
-            type: string;
-            format: string;
-            maxLength: number;
-        };
-        Email: {
-            type: string;
-            format: string;
-            maxLength: number;
-        };
-        Slug: {
-            type: string;
-            minLength: number;
-            maxLength: number;
-            pattern: string;
-            description: string;
-        };
-        LocalizedTitle: {
-            type: string;
-            minProperties: number;
-            propertyNames: {
-                type: string;
-                pattern: string;
-            };
-            additionalProperties: {
-                type: string;
-                minLength: number;
-                maxLength: number;
-            };
-            description: string;
-        };
-        LocalizedBody: {
-            type: string;
-            minProperties: number;
-            propertyNames: {
-                type: string;
-                pattern: string;
-            };
-            additionalProperties: {
-                type: string;
-                minLength: number;
-                maxLength: number;
-            };
-            description: string;
-        };
-        LinkType: {
-            type: string;
-            enum: string[];
-            description: string;
-        };
-        Profile: {
-            type: string;
-            additionalProperties: boolean;
-            required: string[];
-            properties: {
-                displayName: {
-                    $ref: string;
-                };
-                tagline: {
-                    $ref: string;
-                };
-                bio: {
-                    $ref: string;
-                };
-                avatar: {
-                    $ref: string;
-                };
-                location: {
-                    $ref: string;
-                };
-            };
-        };
-        Avatar: {
-            type: string;
-            additionalProperties: boolean;
-            required: string[];
-            properties: {
-                url: {
-                    type: string;
-                    format: string;
-                    maxLength: number;
-                    description: string;
-                };
-                alt: {
-                    $ref: string;
-                };
-            };
-        };
-        Address: {
-            type: string;
-            additionalProperties: boolean;
-            properties: {
-                country: {
-                    $ref: string;
-                };
-                region: {
-                    type: string;
-                    maxLength: number;
-                };
-                locality: {
-                    $ref: string;
-                };
-                display: {
-                    $ref: string;
-                };
-            };
-        };
-        Link: {
-            type: string;
-            additionalProperties: boolean;
-            required: string[];
+	},
+	MetaPrivacy: {
+		type: "object",
+		additionalProperties: true,
+		description: "Opt-out flags that strip personally identifying fields from public API output (GET /api/profile, /api/jsonld, /takuhon.json). Admin endpoints (PUT /api/admin/*, GET /api/export) ignore these flags. Privacy-by-default: omitting the object or individual flags is equivalent to true.",
+		properties: {
+			hideCredentialIds: {
+				type: "boolean",
+				"default": true,
+				description: "When true (default), strip certifications[*].credentialId from public responses."
+			},
+			hideEducationGrades: {
+				type: "boolean",
+				"default": true,
+				description: "When true (default), strip education[*].grade from public responses."
+			}
+		}
+	},
+	Certification: {
+		type: "object",
+		additionalProperties: true,
+		required: [
+			"id",
+			"title",
+			"issuingOrganization",
+			"issueDate"
+		],
+		properties: {
+			id: {
+				$ref: "#/$defs/Slug"
+			},
+			title: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			issuingOrganization: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			issueDate: {
+				$ref: "#/$defs/YearMonth"
+			},
+			expirationDate: {
+				anyOf: [
+					{
+						$ref: "#/$defs/YearMonth"
+					},
+					{
+						type: "null"
+					}
+				],
+				description: "null = explicitly 'no expiration'. Omit if unknown/unstated."
+			},
+			credentialId: {
+				type: "string",
+				minLength: 1,
+				maxLength: 100,
+				description: "License or certificate number. Public exposure controlled by meta.privacy.hideCredentialIds."
+			},
+			url: {
+				$ref: "#/$defs/Url"
+			},
+			order: {
+				type: "integer",
+				minimum: 0
+			}
+		}
+	},
+	Membership: {
+		type: "object",
+		additionalProperties: true,
+		required: [
+			"id",
+			"organization",
+			"startDate"
+		],
+		properties: {
+			id: {
+				$ref: "#/$defs/Slug"
+			},
+			organization: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			role: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			description: {
+				$ref: "#/$defs/LocalizedBody"
+			},
+			startDate: {
+				$ref: "#/$defs/YearMonth"
+			},
+			endDate: {
+				anyOf: [
+					{
+						$ref: "#/$defs/YearMonth"
+					},
+					{
+						type: "null"
+					}
+				],
+				description: "null = ongoing. Omit if unknown."
+			},
+			isCurrent: {
+				type: "boolean"
+			},
+			url: {
+				$ref: "#/$defs/Url"
+			},
+			order: {
+				type: "integer",
+				minimum: 0
+			}
+		}
+	},
+	Volunteering: {
+		type: "object",
+		additionalProperties: true,
+		required: [
+			"id",
+			"organization",
+			"role",
+			"startDate"
+		],
+		properties: {
+			id: {
+				$ref: "#/$defs/Slug"
+			},
+			organization: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			role: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			cause: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			description: {
+				$ref: "#/$defs/LocalizedBody"
+			},
+			startDate: {
+				$ref: "#/$defs/YearMonth"
+			},
+			endDate: {
+				anyOf: [
+					{
+						$ref: "#/$defs/YearMonth"
+					},
+					{
+						type: "null"
+					}
+				]
+			},
+			isCurrent: {
+				type: "boolean"
+			},
+			url: {
+				$ref: "#/$defs/Url"
+			},
+			order: {
+				type: "integer",
+				minimum: 0
+			}
+		}
+	},
+	Honor: {
+		type: "object",
+		additionalProperties: true,
+		required: [
+			"id",
+			"title",
+			"issuer",
+			"date"
+		],
+		properties: {
+			id: {
+				$ref: "#/$defs/Slug"
+			},
+			title: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			issuer: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			description: {
+				$ref: "#/$defs/LocalizedBody"
+			},
+			date: {
+				$ref: "#/$defs/YearMonth"
+			},
+			url: {
+				$ref: "#/$defs/Url"
+			},
+			order: {
+				type: "integer",
+				minimum: 0
+			}
+		}
+	},
+	Education: {
+		type: "object",
+		additionalProperties: true,
+		required: [
+			"id",
+			"institution",
+			"startDate"
+		],
+		properties: {
+			id: {
+				$ref: "#/$defs/Slug"
+			},
+			institution: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			degree: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			fieldOfStudy: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			description: {
+				$ref: "#/$defs/LocalizedBody"
+			},
+			grade: {
+				type: "string",
+				minLength: 1,
+				maxLength: 50,
+				description: "Free-form grade / class / GPA. Public exposure controlled by meta.privacy.hideEducationGrades."
+			},
+			startDate: {
+				$ref: "#/$defs/YearMonth"
+			},
+			endDate: {
+				anyOf: [
+					{
+						$ref: "#/$defs/YearMonth"
+					},
+					{
+						type: "null"
+					}
+				],
+				description: "null = currently enrolled."
+			},
+			isCurrent: {
+				type: "boolean"
+			},
+			url: {
+				$ref: "#/$defs/Url"
+			},
+			order: {
+				type: "integer",
+				minimum: 0
+			}
+		}
+	},
+	Publication: {
+		type: "object",
+		additionalProperties: true,
+		required: [
+			"id",
+			"title",
+			"date"
+		],
+		properties: {
+			id: {
+				$ref: "#/$defs/Slug"
+			},
+			title: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			publisher: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			description: {
+				$ref: "#/$defs/LocalizedBody"
+			},
+			date: {
+				$ref: "#/$defs/YearMonth"
+			},
+			url: {
+				$ref: "#/$defs/Url"
+			},
+			doi: {
+				type: "string",
+				minLength: 1,
+				maxLength: 200,
+				description: "DOI identifier (e.g. '10.1145/3548643.3548644'). The full URL goes in 'url'."
+			},
+			coAuthors: {
+				type: "array",
+				maxItems: 50,
+				items: {
+					type: "string",
+					minLength: 1,
+					maxLength: 100
+				},
+				description: "Co-author names in original script. Excludes the profile owner."
+			},
+			order: {
+				type: "integer",
+				minimum: 0
+			}
+		}
+	},
+	Language: {
+		type: "object",
+		additionalProperties: true,
+		required: [
+			"id",
+			"language",
+			"proficiency"
+		],
+		properties: {
+			id: {
+				$ref: "#/$defs/Slug"
+			},
+			language: {
+				$ref: "#/$defs/LocaleTag"
+			},
+			displayName: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			proficiency: {
+				type: "string",
+				"enum": [
+					"native",
+					"fluent",
+					"professional",
+					"intermediate",
+					"basic"
+				],
+				description: "LinkedIn-compatible 5-level proficiency."
+			},
+			order: {
+				type: "integer",
+				minimum: 0
+			}
+		}
+	},
+	Course: {
+		type: "object",
+		additionalProperties: true,
+		required: [
+			"id",
+			"title"
+		],
+		properties: {
+			id: {
+				$ref: "#/$defs/Slug"
+			},
+			title: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			provider: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			courseNumber: {
+				type: "string",
+				minLength: 1,
+				maxLength: 50
+			},
+			description: {
+				$ref: "#/$defs/LocalizedBody"
+			},
+			completionDate: {
+				$ref: "#/$defs/YearMonth"
+			},
+			certificateUrl: {
+				$ref: "#/$defs/Url"
+			},
+			relatedEducationId: {
+				$ref: "#/$defs/Slug",
+				description: "Optional reference to an education[].id (e.g. for university coursework)."
+			},
+			order: {
+				type: "integer",
+				minimum: 0
+			}
+		}
+	},
+	Patent: {
+		type: "object",
+		additionalProperties: true,
+		required: [
+			"id",
+			"title",
+			"patentNumber",
+			"status"
+		],
+		properties: {
+			id: {
+				$ref: "#/$defs/Slug"
+			},
+			title: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			patentNumber: {
+				type: "string",
+				minLength: 1,
+				maxLength: 100
+			},
+			office: {
+				type: "string",
+				maxLength: 100,
+				description: "Patent office name (e.g. 'USPTO', 'JPO', 'EPO')."
+			},
+			status: {
+				type: "string",
+				"enum": [
+					"pending",
+					"issued",
+					"expired",
+					"abandoned"
+				]
+			},
+			description: {
+				$ref: "#/$defs/LocalizedBody"
+			},
+			filingDate: {
+				$ref: "#/$defs/YearMonth"
+			},
+			grantDate: {
+				$ref: "#/$defs/YearMonth"
+			},
+			url: {
+				$ref: "#/$defs/Url"
+			},
+			coInventors: {
+				type: "array",
+				maxItems: 20,
+				items: {
+					type: "string",
+					minLength: 1,
+					maxLength: 100
+				}
+			},
+			order: {
+				type: "integer",
+				minimum: 0
+			}
+		}
+	}
+};
+var schemaJson = {
+	$schema: $schema,
+	$id: $id,
+	title: title,
+	description: description,
+	type: type,
+	additionalProperties: additionalProperties,
+	required: required,
+	properties: properties,
+	$defs: $defs
+};
+
+/**
+ * Re-exports the canonical JSON Schema for takuhon profiles.
+ *
+ * The schema source of truth lives at `packages/core/takuhon.schema.json`
+ * (also distributed via the `@takuhon/core/schema.json` sub-path). This module
+ * is the convenient ESM-side entry point for consumers that want to feed it
+ * directly to a JSON Schema validator (e.g. Ajv) without a filesystem read.
+ */
+
+declare const schema: {
+    $schema: string;
+    $id: string;
+    title: string;
+    description: string;
+    type: string;
+    additionalProperties: boolean;
+    required: string[];
+    properties: {
+        schemaVersion: {
+            type: string;
+            pattern: string;
+            description: string;
+        };
+        profile: {
+            $ref: string;
+        };
+        links: {
+            type: string;
+            maxItems: number;
+            items: {
+                $ref: string;
+            };
+        };
+        careers: {
+            type: string;
+            maxItems: number;
+            items: {
+                $ref: string;
+            };
+        };
+        projects: {
+            type: string;
+            maxItems: number;
+            items: {
+                $ref: string;
+            };
+        };
+        skills: {
+            type: string;
+            maxItems: number;
+            items: {
+                $ref: string;
+            };
+        };
+        certifications: {
+            type: string;
+            maxItems: number;
+            items: {
+                $ref: string;
+            };
+        };
+        memberships: {
+            type: string;
+            maxItems: number;
+            items: {
+                $ref: string;
+            };
+        };
+        volunteering: {
+            type: string;
+            maxItems: number;
+            items: {
+                $ref: string;
+            };
+        };
+        honors: {
+            type: string;
+            maxItems: number;
+            items: {
+                $ref: string;
+            };
+        };
+        education: {
+            type: string;
+            maxItems: number;
+            items: {
+                $ref: string;
+            };
+        };
+        publications: {
+            type: string;
+            maxItems: number;
+            items: {
+                $ref: string;
+            };
+        };
+        languages: {
+            type: string;
+            maxItems: number;
+            items: {
+                $ref: string;
+            };
+        };
+        courses: {
+            type: string;
+            maxItems: number;
+            items: {
+                $ref: string;
+            };
+        };
+        patents: {
+            type: string;
+            maxItems: number;
+            items: {
+                $ref: string;
+            };
+        };
+        contact: {
+            $ref: string;
+        };
+        settings: {
+            $ref: string;
+        };
+        meta: {
+            $ref: string;
+        };
+    };
+    $defs: {
+        LocaleTag: {
+            type: string;
+            minLength: number;
+            maxLength: number;
+            pattern: string;
+            description: string;
+        };
+        Iso3166Alpha2: {
+            type: string;
+            pattern: string;
+            description: string;
+        };
+        YearMonth: {
+            type: string;
+            pattern: string;
+            description: string;
+        };
+        IsoDateTime: {
+            type: string;
+            format: string;
+            description: string;
+        };
+        Url: {
+            type: string;
+            format: string;
+            maxLength: number;
+        };
+        Email: {
+            type: string;
+            format: string;
+            maxLength: number;
+        };
+        Slug: {
+            type: string;
+            minLength: number;
+            maxLength: number;
+            pattern: string;
+            description: string;
+        };
+        LocalizedTitle: {
+            type: string;
+            minProperties: number;
+            propertyNames: {
+                type: string;
+                pattern: string;
+            };
+            additionalProperties: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+            };
+            description: string;
+        };
+        LocalizedBody: {
+            type: string;
+            minProperties: number;
+            propertyNames: {
+                type: string;
+                pattern: string;
+            };
+            additionalProperties: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+            };
+            description: string;
+        };
+        LinkType: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
+        Profile: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                displayName: {
+                    $ref: string;
+                };
+                tagline: {
+                    $ref: string;
+                };
+                bio: {
+                    $ref: string;
+                };
+                avatar: {
+                    $ref: string;
+                };
+                location: {
+                    $ref: string;
+                };
+            };
+        };
+        Avatar: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                url: {
+                    type: string;
+                    format: string;
+                    maxLength: number;
+                    description: string;
+                };
+                alt: {
+                    $ref: string;
+                };
+            };
+        };
+        Address: {
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                country: {
+                    $ref: string;
+                };
+                region: {
+                    type: string;
+                    maxLength: number;
+                };
+                locality: {
+                    $ref: string;
+                };
+                display: {
+                    $ref: string;
+                };
+            };
+        };
+        Link: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                id: {
+                    $ref: string;
+                };
+                type: {
+                    $ref: string;
+                };
+                label: {
+                    $ref: string;
+                };
+                url: {
+                    $ref: string;
+                };
+                featured: {
+                    type: string;
+                };
+                order: {
+                    type: string;
+                    minimum: number;
+                };
+                iconUrl: {
+                    $ref: string;
+                };
+            };
+            allOf: {
+                if: {
+                    properties: {
+                        type: {
+                            const: string;
+                        };
+                    };
+                    required: string[];
+                };
+                then: {
+                    properties: {
+                        iconUrl: {
+                            $ref: string;
+                        };
+                    };
+                    required: string[];
+                };
+            }[];
+        };
+        Career: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                id: {
+                    $ref: string;
+                };
+                organization: {
+                    $ref: string;
+                };
+                role: {
+                    $ref: string;
+                };
+                description: {
+                    $ref: string;
+                };
+                startDate: {
+                    $ref: string;
+                };
+                endDate: {
+                    anyOf: ({
+                        $ref: string;
+                        type?: undefined;
+                    } | {
+                        type: string;
+                        $ref?: undefined;
+                    })[];
+                };
+                isCurrent: {
+                    type: string;
+                };
+                url: {
+                    $ref: string;
+                };
+                location: {
+                    $ref: string;
+                };
+                order: {
+                    type: string;
+                    minimum: number;
+                };
+            };
+        };
+        Project: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                id: {
+                    $ref: string;
+                };
+                title: {
+                    $ref: string;
+                };
+                description: {
+                    $ref: string;
+                };
+                url: {
+                    $ref: string;
+                };
+                tags: {
+                    type: string;
+                    maxItems: number;
+                    items: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                };
+                relatedCareerId: {
+                    $ref: string;
+                };
+                startDate: {
+                    $ref: string;
+                };
+                endDate: {
+                    anyOf: ({
+                        $ref: string;
+                        type?: undefined;
+                    } | {
+                        type: string;
+                        $ref?: undefined;
+                    })[];
+                };
+                highlighted: {
+                    type: string;
+                };
+                order: {
+                    type: string;
+                    minimum: number;
+                };
+            };
+        };
+        Skill: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                id: {
+                    $ref: string;
+                };
+                label: {
+                    type: string;
+                    minLength: number;
+                    maxLength: number;
+                };
+                category: {
+                    type: string;
+                    minLength: number;
+                    maxLength: number;
+                    description: string;
+                };
+                order: {
+                    type: string;
+                    minimum: number;
+                };
+            };
+        };
+        Contact: {
+            type: string;
+            additionalProperties: boolean;
             properties: {
-                id: {
+                email: {
                     $ref: string;
                 };
-                type: {
+                showEmail: {
+                    type: string;
+                    default: boolean;
+                };
+                formUrl: {
                     $ref: string;
                 };
-                label: {
+            };
+        };
+        Settings: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                defaultLocale: {
                     $ref: string;
                 };
-                url: {
+                fallbackLocale: {
                     $ref: string;
                 };
-                featured: {
+                availableLocales: {
                     type: string;
+                    minItems: number;
+                    maxItems: number;
+                    uniqueItems: boolean;
+                    items: {
+                        $ref: string;
+                    };
                 };
-                order: {
+                theme: {
                     type: string;
-                    minimum: number;
+                    minLength: number;
+                    maxLength: number;
+                    description: string;
                 };
-                iconUrl: {
+                showPoweredBy: {
+                    type: string;
+                    default: boolean;
+                    description: string;
+                };
+                enableJsonLd: {
+                    type: string;
+                    default: boolean;
+                    description: string;
+                };
+                enableApi: {
+                    type: string;
+                    default: boolean;
+                    description: string;
+                };
+                enableAnalytics: {
+                    type: string;
+                    default: boolean;
+                    description: string;
+                };
+            };
+        };
+        Meta: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                createdAt: {
+                    $ref: string;
+                };
+                updatedAt: {
+                    $ref: string;
+                };
+                generator: {
+                    type: string;
+                    minLength: number;
+                    maxLength: number;
+                    description: string;
+                };
+                contentLicense: {
+                    $ref: string;
+                };
+                privacy: {
                     $ref: string;
                 };
             };
-            allOf: {
-                if: {
-                    properties: {
-                        type: {
-                            const: string;
-                        };
-                    };
-                    required: string[];
+        };
+        ContentLicense: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                spdxId: {
+                    type: string;
+                    minLength: number;
+                    maxLength: number;
+                    description: string;
                 };
-                then: {
+                url: {
+                    $ref: string;
+                };
+                attribution: {
+                    type: string;
+                    additionalProperties: boolean;
                     properties: {
-                        iconUrl: {
+                        name: {
+                            type: string;
+                            minLength: number;
+                            maxLength: number;
+                        };
+                        url: {
                             $ref: string;
                         };
                     };
-                    required: string[];
                 };
-            }[];
+                rights: {
+                    type: string;
+                    minLength: number;
+                    maxLength: number;
+                    description: string;
+                };
+            };
         };
-        Career: {
+        MetaPrivacy: {
+            type: string;
+            additionalProperties: boolean;
+            description: string;
+            properties: {
+                hideCredentialIds: {
+                    type: string;
+                    default: boolean;
+                    description: string;
+                };
+                hideEducationGrades: {
+                    type: string;
+                    default: boolean;
+                    description: string;
+                };
+            };
+        };
+        Certification: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                id: {
+                    $ref: string;
+                };
+                title: {
+                    $ref: string;
+                };
+                issuingOrganization: {
+                    $ref: string;
+                };
+                issueDate: {
+                    $ref: string;
+                };
+                expirationDate: {
+                    anyOf: ({
+                        $ref: string;
+                        type?: undefined;
+                    } | {
+                        type: string;
+                        $ref?: undefined;
+                    })[];
+                    description: string;
+                };
+                credentialId: {
+                    type: string;
+                    minLength: number;
+                    maxLength: number;
+                    description: string;
+                };
+                url: {
+                    $ref: string;
+                };
+                order: {
+                    type: string;
+                    minimum: number;
+                };
+            };
+        };
+        Membership: {
             type: string;
             additionalProperties: boolean;
             required: string[];
@@ -812,6 +1683,7 @@ declare const schema: {
                         type: string;
                         $ref?: undefined;
                     })[];
+                    description: string;
                 };
                 isCurrent: {
                     type: string;
@@ -819,7 +1691,48 @@ declare const schema: {
                 url: {
                     $ref: string;
                 };
-                location: {
+                order: {
+                    type: string;
+                    minimum: number;
+                };
+            };
+        };
+        Volunteering: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                id: {
+                    $ref: string;
+                };
+                organization: {
+                    $ref: string;
+                };
+                role: {
+                    $ref: string;
+                };
+                cause: {
+                    $ref: string;
+                };
+                description: {
+                    $ref: string;
+                };
+                startDate: {
+                    $ref: string;
+                };
+                endDate: {
+                    anyOf: ({
+                        $ref: string;
+                        type?: undefined;
+                    } | {
+                        type: string;
+                        $ref?: undefined;
+                    })[];
+                };
+                isCurrent: {
+                    type: string;
+                };
+                url: {
                     $ref: string;
                 };
                 order: {
@@ -828,7 +1741,7 @@ declare const schema: {
                 };
             };
         };
-        Project: {
+        Honor: {
             type: string;
             additionalProperties: boolean;
             required: string[];
@@ -839,24 +1752,50 @@ declare const schema: {
                 title: {
                     $ref: string;
                 };
+                issuer: {
+                    $ref: string;
+                };
                 description: {
                     $ref: string;
                 };
+                date: {
+                    $ref: string;
+                };
                 url: {
                     $ref: string;
                 };
-                tags: {
+                order: {
                     type: string;
-                    maxItems: number;
-                    items: {
-                        type: string;
-                        minLength: number;
-                        maxLength: number;
-                    };
+                    minimum: number;
                 };
-                relatedCareerId: {
+            };
+        };
+        Education: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                id: {
+                    $ref: string;
+                };
+                institution: {
+                    $ref: string;
+                };
+                degree: {
+                    $ref: string;
+                };
+                fieldOfStudy: {
+                    $ref: string;
+                };
+                description: {
                     $ref: string;
                 };
+                grade: {
+                    type: string;
+                    minLength: number;
+                    maxLength: number;
+                    description: string;
+                };
                 startDate: {
                     $ref: string;
                 };
@@ -868,17 +1807,21 @@ declare const schema: {
                         type: string;
                         $ref?: undefined;
                     })[];
+                    description: string;
                 };
-                highlighted: {
+                isCurrent: {
                     type: string;
                 };
+                url: {
+                    $ref: string;
+                };
                 order: {
                     type: string;
                     minimum: number;
                 };
             };
         };
-        Skill: {
+        Publication: {
             type: string;
             additionalProperties: boolean;
             required: string[];
@@ -886,15 +1829,35 @@ declare const schema: {
                 id: {
                     $ref: string;
                 };
-                label: {
+                title: {
+                    $ref: string;
+                };
+                publisher: {
+                    $ref: string;
+                };
+                description: {
+                    $ref: string;
+                };
+                date: {
+                    $ref: string;
+                };
+                url: {
+                    $ref: string;
+                };
+                doi: {
                     type: string;
                     minLength: number;
                     maxLength: number;
+                    description: string;
                 };
-                category: {
+                coAuthors: {
                     type: string;
-                    minLength: number;
-                    maxLength: number;
+                    maxItems: number;
+                    items: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
                     description: string;
                 };
                 order: {
@@ -903,125 +1866,118 @@ declare const schema: {
                 };
             };
         };
-        Contact: {
+        Language: {
             type: string;
             additionalProperties: boolean;
+            required: string[];
             properties: {
-                email: {
+                id: {
                     $ref: string;
                 };
-                showEmail: {
-                    type: string;
-                    default: boolean;
+                language: {
+                    $ref: string;
                 };
-                formUrl: {
+                displayName: {
                     $ref: string;
                 };
+                proficiency: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                order: {
+                    type: string;
+                    minimum: number;
+                };
             };
         };
-        Settings: {
+        Course: {
             type: string;
             additionalProperties: boolean;
             required: string[];
             properties: {
-                defaultLocale: {
+                id: {
                     $ref: string;
                 };
-                fallbackLocale: {
+                title: {
                     $ref: string;
                 };
-                availableLocales: {
-                    type: string;
-                    minItems: number;
-                    maxItems: number;
-                    uniqueItems: boolean;
-                    items: {
-                        $ref: string;
-                    };
+                provider: {
+                    $ref: string;
                 };
-                theme: {
+                courseNumber: {
                     type: string;
                     minLength: number;
                     maxLength: number;
-                    description: string;
                 };
-                showPoweredBy: {
-                    type: string;
-                    default: boolean;
-                    description: string;
+                description: {
+                    $ref: string;
                 };
-                enableJsonLd: {
-                    type: string;
-                    default: boolean;
-                    description: string;
+                completionDate: {
+                    $ref: string;
                 };
-                enableApi: {
-                    type: string;
-                    default: boolean;
+                certificateUrl: {
+                    $ref: string;
+                };
+                relatedEducationId: {
+                    $ref: string;
                     description: string;
                 };
-                enableAnalytics: {
+                order: {
                     type: string;
-                    default: boolean;
-                    description: string;
+                    minimum: number;
                 };
             };
         };
-        Meta: {
+        Patent: {
             type: string;
             additionalProperties: boolean;
             required: string[];
             properties: {
-                createdAt: {
+                id: {
                     $ref: string;
                 };
-                updatedAt: {
+                title: {
                     $ref: string;
                 };
-                generator: {
+                patentNumber: {
                     type: string;
                     minLength: number;
                     maxLength: number;
-                    description: string;
-                };
-                contentLicense: {
-                    $ref: string;
                 };
-            };
-        };
-        ContentLicense: {
-            type: string;
-            additionalProperties: boolean;
-            required: string[];
-            properties: {
-                spdxId: {
+                office: {
                     type: string;
-                    minLength: number;
                     maxLength: number;
                     description: string;
                 };
+                status: {
+                    type: string;
+                    enum: string[];
+                };
+                description: {
+                    $ref: string;
+                };
+                filingDate: {
+                    $ref: string;
+                };
+                grantDate: {
+                    $ref: string;
+                };
                 url: {
                     $ref: string;
                 };
-                attribution: {
+                coInventors: {
                     type: string;
-                    additionalProperties: boolean;
-                    properties: {
-                        name: {
-                            type: string;
-                            minLength: number;
-                            maxLength: number;
-                        };
-                        url: {
-                            $ref: string;
-                        };
+                    maxItems: number;
+                    items: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
                     };
                 };
-                rights: {
+                order: {
                     type: string;
-                    minLength: number;
-                    maxLength: number;
-                    description: string;
+                    minimum: number;
                 };
             };
         };
@@ -1162,6 +2118,122 @@ interface Skill {
     category?: string;
     order?: number;
 }
+interface Certification {
+    id: Slug;
+    title: LocalizedTitle;
+    issuingOrganization: LocalizedTitle;
+    issueDate: YearMonth;
+    /** `null` denotes an explicit "no expiration" (permanent credential). Omit when unknown. */
+    expirationDate?: YearMonth | null;
+    /**
+     * License or certificate number. Public exposure is controlled by
+     * {@link MetaPrivacy.hideCredentialIds} (default true).
+     */
+    credentialId?: string;
+    url?: string;
+    order?: number;
+}
+interface Membership {
+    id: Slug;
+    organization: LocalizedTitle;
+    role?: LocalizedTitle;
+    description?: LocalizedBody;
+    startDate: YearMonth;
+    /** `null` denotes ongoing membership; omit when unknown. */
+    endDate?: YearMonth | null;
+    isCurrent?: boolean;
+    url?: string;
+    order?: number;
+}
+interface Volunteering {
+    id: Slug;
+    organization: LocalizedTitle;
+    role: LocalizedTitle;
+    cause?: LocalizedTitle;
+    description?: LocalizedBody;
+    startDate: YearMonth;
+    endDate?: YearMonth | null;
+    isCurrent?: boolean;
+    url?: string;
+    order?: number;
+}
+interface Honor {
+    id: Slug;
+    title: LocalizedTitle;
+    issuer: LocalizedTitle;
+    description?: LocalizedBody;
+    date: YearMonth;
+    url?: string;
+    order?: number;
+}
+interface Education {
+    id: Slug;
+    institution: LocalizedTitle;
+    degree?: LocalizedTitle;
+    fieldOfStudy?: LocalizedTitle;
+    description?: LocalizedBody;
+    /**
+     * Free-form grade / class / GPA. Public exposure is controlled by
+     * {@link MetaPrivacy.hideEducationGrades} (default true).
+     */
+    grade?: string;
+    startDate: YearMonth;
+    /** `null` denotes currently enrolled; omit when unknown. */
+    endDate?: YearMonth | null;
+    isCurrent?: boolean;
+    url?: string;
+    order?: number;
+}
+interface Publication {
+    id: Slug;
+    title: LocalizedTitle;
+    publisher?: LocalizedTitle;
+    description?: LocalizedBody;
+    date: YearMonth;
+    url?: string;
+    /** DOI identifier portion (e.g. '10.1145/...'); full URL goes in `url`. */
+    doi?: string;
+    /** Co-author names in original script. Excludes the profile owner. */
+    coAuthors?: string[];
+    order?: number;
+}
+type LanguageProficiency = 'native' | 'fluent' | 'professional' | 'intermediate' | 'basic';
+interface Language {
+    id: Slug;
+    /** BCP-47 tag (e.g. 'ja', 'en', 'fr-CA'). */
+    language: LocaleTag;
+    /** Human-readable label per locale (e.g. `{ en: 'Japanese', fr: 'japonais' }`). */
+    displayName?: LocalizedTitle;
+    proficiency: LanguageProficiency;
+    order?: number;
+}
+interface Course {
+    id: Slug;
+    title: LocalizedTitle;
+    provider?: LocalizedTitle;
+    courseNumber?: string;
+    description?: LocalizedBody;
+    completionDate?: YearMonth;
+    certificateUrl?: string;
+    /** Optional reference to an `education[].id` for university coursework. */
+    relatedEducationId?: Slug;
+    order?: number;
+}
+type PatentStatus = 'pending' | 'issued' | 'expired' | 'abandoned';
+interface Patent {
+    id: Slug;
+    title: LocalizedTitle;
+    patentNumber: string;
+    /** Patent office name (e.g. 'USPTO', 'JPO', 'EPO'). */
+    office?: string;
+    status: PatentStatus;
+    description?: LocalizedBody;
+    filingDate?: YearMonth;
+    grantDate?: YearMonth;
+    url?: string;
+    coInventors?: string[];
+    order?: number;
+}
 interface Contact {
     email?: string;
     showEmail?: boolean;
@@ -1193,14 +2265,35 @@ interface ContentLicense {
     attribution?: ContentLicenseAttribution;
     rights?: string;
 }
+/**
+ * Privacy opt-out flags that strip personally identifying fields from public
+ * API output (`GET /api/profile`, `/api/jsonld`, `/takuhon.json`). Admin
+ * endpoints (`PUT /api/admin/*`, `GET /api/export`) ignore these flags.
+ * Privacy-by-default: omitting the object or individual flags is equivalent
+ * to `true`.
+ */
+interface MetaPrivacy {
+    /** When true (default), strip `certifications[*].credentialId` from public responses. */
+    hideCredentialIds?: boolean;
+    /** When true (default), strip `education[*].grade` from public responses. */
+    hideEducationGrades?: boolean;
+}
 interface Meta {
     createdAt?: IsoDateTime;
     updatedAt?: IsoDateTime;
     /** Tool that produced this document (e.g. `'Takuhon'`, `'create-takuhon@0.1.0'`). */
     generator?: string;
     contentLicense: ContentLicense;
+    privacy?: MetaPrivacy;
 }
-/** A complete takuhon profile document. */
+/**
+ * A complete takuhon profile document.
+ *
+ * Schema-level, the nine new arrays from 0.2.0 (`certifications` through
+ * `patents`) are optional for 0.1.x back-compat. At the TypeScript layer they
+ * are typed as required because `validate()` and `normalize()` defensively
+ * coerce missing arrays to `[]` so downstream consumers never see `undefined`.
+ */
 interface Takuhon {
     schemaVersion: string;
     profile: Profile;
@@ -1208,6 +2301,15 @@ interface Takuhon {
     careers: Career[];
     projects: Project[];
     skills: Skill[];
+    certifications: Certification[];
+    memberships: Membership[];
+    volunteering: Volunteering[];
+    honors: Honor[];
+    education: Education[];
+    publications: Publication[];
+    languages: Language[];
+    courses: Course[];
+    patents: Patent[];
     contact: Contact;
     settings: Settings;
     meta: Meta;
@@ -1288,6 +2390,112 @@ interface LocalizedProject {
     highlighted?: boolean;
     order?: number;
 }
+/** Certification with localized fields collapsed to single strings. */
+interface LocalizedCertification {
+    id: Slug;
+    title: string;
+    issuingOrganization: string;
+    issueDate: YearMonth;
+    expirationDate?: YearMonth | null;
+    credentialId?: string;
+    url?: string;
+    order?: number;
+}
+/** Membership with localized fields collapsed to single strings. */
+interface LocalizedMembership {
+    id: Slug;
+    organization: string;
+    role?: string;
+    description?: string;
+    startDate: YearMonth;
+    endDate?: YearMonth | null;
+    isCurrent?: boolean;
+    url?: string;
+    order?: number;
+}
+/** Volunteering with localized fields collapsed to single strings. */
+interface LocalizedVolunteering {
+    id: Slug;
+    organization: string;
+    role: string;
+    cause?: string;
+    description?: string;
+    startDate: YearMonth;
+    endDate?: YearMonth | null;
+    isCurrent?: boolean;
+    url?: string;
+    order?: number;
+}
+/** Honor with localized fields collapsed to single strings. */
+interface LocalizedHonor {
+    id: Slug;
+    title: string;
+    issuer: string;
+    description?: string;
+    date: YearMonth;
+    url?: string;
+    order?: number;
+}
+/** Education with localized fields collapsed to single strings. */
+interface LocalizedEducation {
+    id: Slug;
+    institution: string;
+    degree?: string;
+    fieldOfStudy?: string;
+    description?: string;
+    grade?: string;
+    startDate: YearMonth;
+    endDate?: YearMonth | null;
+    isCurrent?: boolean;
+    url?: string;
+    order?: number;
+}
+/** Publication with localized fields collapsed to single strings. */
+interface LocalizedPublication {
+    id: Slug;
+    title: string;
+    publisher?: string;
+    description?: string;
+    date: YearMonth;
+    url?: string;
+    doi?: string;
+    coAuthors?: string[];
+    order?: number;
+}
+/** Language entry with `displayName` collapsed to a single string. */
+interface LocalizedLanguage {
+    id: Slug;
+    language: LocaleTag;
+    displayName?: string;
+    proficiency: LanguageProficiency;
+    order?: number;
+}
+/** Course with localized fields collapsed to single strings. */
+interface LocalizedCourse {
+    id: Slug;
+    title: string;
+    provider?: string;
+    courseNumber?: string;
+    description?: string;
+    completionDate?: YearMonth;
+    certificateUrl?: string;
+    relatedEducationId?: Slug;
+    order?: number;
+}
+/** Patent with localized fields collapsed to single strings. */
+interface LocalizedPatent {
+    id: Slug;
+    title: string;
+    patentNumber: string;
+    office?: string;
+    status: PatentStatus;
+    description?: string;
+    filingDate?: YearMonth;
+    grantDate?: YearMonth;
+    url?: string;
+    coInventors?: string[];
+    order?: number;
+}
 /**
  * A takuhon document with every localized map flattened to a single string,
  * plus a `resolvedLocale` field recording which tag was actually used as the
@@ -1303,6 +2511,15 @@ interface LocalizedTakuhon {
     careers: LocalizedCareer[];
     projects: LocalizedProject[];
     skills: Skill[];
+    certifications: LocalizedCertification[];
+    memberships: LocalizedMembership[];
+    volunteering: LocalizedVolunteering[];
+    honors: LocalizedHonor[];
+    education: LocalizedEducation[];
+    publications: LocalizedPublication[];
+    languages: LocalizedLanguage[];
+    courses: LocalizedCourse[];
+    patents: LocalizedPatent[];
     contact: Contact;
     settings: Settings;
     meta: Meta;
@@ -1344,7 +2561,7 @@ interface LocalizedTakuhon {
  * versions whose JSON Schema this package literally bundles, not the full
  * support window seen by end users.
  */
-declare const SUPPORTED_SCHEMA_VERSIONS: readonly ["0.1.0"];
+declare const SUPPORTED_SCHEMA_VERSIONS: readonly ["0.1.0", "0.2.0"];
 /**
  * A single validation failure.
  *
@@ -1659,8 +2876,11 @@ interface Migration<From, To> {
     migrate(data: From): To;
 }
 /**
- * Forward migrations bundled with this build of `@takuhon/core`. Empty in
- * Phase 1; the first entry will land alongside the v0.2.0 schema bump.
+ * Forward migrations bundled with this build of `@takuhon/core`.
+ *
+ * Entries are listed in the order they would chain for forward migration
+ * (`0.1.0 → 0.2.0 → 0.3.0 → ...`). {@link migrateTakuhon} consults this
+ * array to build the chain between a source `schemaVersion` and a target.
  */
 declare const migrations: readonly Migration<Takuhon, Takuhon>[];
 
@@ -1838,6 +3058,6 @@ declare class ConflictError extends StorageError {
  * A takuhon profile document's `schemaVersion` field must be migrate-compatible
  * with this version. See operational-lifecycle docs for the migration policy.
  */
-declare const SCHEMA_VERSION = "0.1.0";
+declare const SCHEMA_VERSION = "0.2.0";
 
-export { type Address, type AssetOptions, type AssetRecord, type Avatar, type Career, ConflictError, type Contact, type ContentLicense, type ContentLicenseAttribution, type ExportOptions, type ExportedTakuhon, ImportError, type Iso3166Alpha2, type IsoDateTime, type Link, type LinkBuiltin, type LinkCustom, type LinkType, type LocaleTag, type LocalizedAddress, type LocalizedAvatar, type LocalizedBody, type LocalizedCareer, type LocalizedLink, type LocalizedLinkBuiltin, type LocalizedLinkCustom, type LocalizedProfile, type LocalizedProject, type LocalizedTakuhon, type LocalizedTitle, type Meta, type Migration, MigrationError, type NormalizedTakuhon, NotFoundError, type Profile, type Project, SCHEMA_VERSION, SUPPORTED_SCHEMA_VERSIONS, type Schema, type Settings, type Skill, type Slug, StorageError, type Takuhon, type TakuhonAssetStorage, type TakuhonStorage, type ValidationError, type ValidationResult, type YearMonth, exportTakuhon, generateJsonLd, generatePersonJsonLd, generateProfilePageJsonLd, importTakuhon, migrateTakuhon, migrations, normalize, resolveLocale, schema, validate };
+export { type Address, type AssetOptions, type AssetRecord, type Avatar, type Career, type Certification, ConflictError, type Contact, type ContentLicense, type ContentLicenseAttribution, type Course, type Education, type ExportOptions, type ExportedTakuhon, type Honor, ImportError, type Iso3166Alpha2, type IsoDateTime, type Language, type LanguageProficiency, type Link, type LinkBuiltin, type LinkCustom, type LinkType, type LocaleTag, type LocalizedAddress, type LocalizedAvatar, type LocalizedBody, type LocalizedCareer, type LocalizedCertification, type LocalizedCourse, type LocalizedEducation, type LocalizedHonor, type LocalizedLanguage, type LocalizedLink, type LocalizedLinkBuiltin, type LocalizedLinkCustom, type LocalizedMembership, type LocalizedPatent, type LocalizedProfile, type LocalizedProject, type LocalizedPublication, type LocalizedTakuhon, type LocalizedTitle, type LocalizedVolunteering, type Membership, type Meta, type MetaPrivacy, type Migration, MigrationError, type NormalizedTakuhon, NotFoundError, type Patent, type PatentStatus, type Profile, type Project, type Publication, SCHEMA_VERSION, SUPPORTED_SCHEMA_VERSIONS, type Schema, type Settings, type Skill, type Slug, StorageError, type Takuhon, type TakuhonAssetStorage, type TakuhonStorage, type ValidationError, type ValidationResult, type Volunteering, type YearMonth, exportTakuhon, generateJsonLd, generatePersonJsonLd, generateProfilePageJsonLd, importTakuhon, migrateTakuhon, migrations, normalize, resolveLocale, schema, validate };