@takuhon/core 1.1.0 → 1.4.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/1.1.0/takuhon.schema.json";
+var $id = "https://takuhon.example/schemas/1.4.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";
@@ -125,6 +125,13 @@ var properties = {
 			$ref: "#/$defs/Recommendation"
 		}
 	},
+	highlights: {
+		type: "array",
+		maxItems: 50,
+		items: {
+			$ref: "#/$defs/Highlight"
+		}
+	},
 	contact: {
 		$ref: "#/$defs/Contact"
 	},
@@ -425,6 +432,10 @@ var $defs = {
 			title: {
 				$ref: "#/$defs/LocalizedTitle"
 			},
+			role: {
+				$ref: "#/$defs/LocalizedTitle",
+				description: "The owner's role/relationship on this project (added in 1.4.0), e.g. \"Author & lead maintainer\", \"Contributor\", \"Product owner\". Rendered as a short line under the project title. Localized, like the section-entry roles in `Career`/`Membership`/`Volunteering`."
+			},
 			description: {
 				$ref: "#/$defs/LocalizedBody"
 			},
@@ -480,9 +491,17 @@ var $defs = {
 				$ref: "#/$defs/Visibility"
 			},
 			label: {
-				type: "string",
-				minLength: 1,
-				maxLength: 100
+				anyOf: [
+					{
+						type: "string",
+						minLength: 1,
+						maxLength: 100
+					},
+					{
+						$ref: "#/$defs/LocalizedTitle"
+					}
+				],
+				description: "Skill name. A plain string is locale-independent; a localized map (added in 1.4.0) resolves per request locale. Existing single-string labels stay valid — the map form is purely additive."
 			},
 			category: {
 				type: "string",
@@ -496,6 +515,26 @@ var $defs = {
 			}
 		}
 	},
+	SkillCategory: {
+		type: "object",
+		additionalProperties: false,
+		required: [
+			"id",
+			"label"
+		],
+		properties: {
+			id: {
+				type: "string",
+				minLength: 1,
+				maxLength: 64,
+				description: "Matches the `category` value on the skills that belong to this group."
+			},
+			label: {
+				$ref: "#/$defs/LocalizedTitle",
+				description: "Localized display heading for the group."
+			}
+		}
+	},
 	Contact: {
 		type: "object",
 		additionalProperties: false,
@@ -569,9 +608,203 @@ var $defs = {
 			},
 			contact: {
 				$ref: "#/$defs/ContactSettings"
+			},
+			appearance: {
+				$ref: "#/$defs/AppearanceSettings"
+			},
+			skillCategories: {
+				type: "array",
+				maxItems: 50,
+				items: {
+					$ref: "#/$defs/SkillCategory"
+				},
+				description: "Ordered skill-category display groups (added in 1.3.0). When present, the rendered profile groups skills by their `category` under these localized headings, in array order; absent = the flat skill list. A skill whose `category` is not listed here (or which has none) renders in a trailing group so nothing is dropped."
+			},
+			sectionOrder: {
+				type: "array",
+				uniqueItems: true,
+				maxItems: 18,
+				items: {
+					"enum": [
+						"about",
+						"careers",
+						"projects",
+						"volunteering",
+						"skills",
+						"activity",
+						"education",
+						"certifications",
+						"publications",
+						"honors",
+						"memberships",
+						"courses",
+						"patents",
+						"testScores",
+						"languages",
+						"recommendations",
+						"highlights",
+						"contact"
+					]
+				},
+				description: "Explicit section display order (added in 1.4.0). A partial list is allowed — any renderable section not named here follows, in the default order. Absent = the default order."
+			},
+			sectionLabels: {
+				$ref: "#/$defs/SectionLabelOverrides"
+			},
+			highlightsIntro: {
+				$ref: "#/$defs/LocalizedTitle",
+				description: "Optional localized intro line shown under the highlights section heading (added in 1.4.0). Absent = no intro line."
+			}
+		}
+	},
+	SectionLabelOverrides: {
+		type: "object",
+		additionalProperties: false,
+		description: "Localized overrides for section headings and chrome labels (added in 1.4.0). Each present key retitles that label; the renderer merges these over its built-in locale pack. Absent keys keep the built-in label.",
+		properties: {
+			about: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			careers: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			projects: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			volunteering: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			skills: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			activity: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			education: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			certifications: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			publications: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			honors: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			memberships: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			courses: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			patents: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			testScores: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			languages: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			recommendations: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			highlights: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			contact: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			skipLink: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			localeNav: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			featuredLinks: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			otherLinks: {
+				$ref: "#/$defs/LocalizedTitle"
+			},
+			poweredBy: {
+				$ref: "#/$defs/LocalizedTitle"
+			}
+		}
+	},
+	AppearanceSettings: {
+		type: "object",
+		additionalProperties: false,
+		description: "Opt-in design tokens for the rendered profile (added in 1.2.0). A declarative re-skin seam: owners override the standard renderer's built-in color and font defaults. This is a token map only, not arbitrary CSS — every value is length- and pattern-constrained so it cannot break out of the inline <style>. Overriding tokens re-skins the page but cannot re-layout it (spacing/radius/type-scale are intentionally not exposed). Absent = the built-in defaults are used unchanged.",
+		properties: {
+			fontFamily: {
+				type: "string",
+				minLength: 1,
+				maxLength: 256,
+				pattern: "^[A-Za-z0-9\\s,'\"._-]+$",
+				description: "CSS font-family stack for the page body, e.g. \"Inter, system-ui, sans-serif\". Quotes and commas are allowed; CSS-structural characters (; { } < >) are not."
+			},
+			colors: {
+				$ref: "#/$defs/AppearanceColors",
+				description: "Light-mode (:root) color overrides."
+			},
+			colorsDark: {
+				$ref: "#/$defs/AppearanceColors",
+				description: "Dark-mode (prefers-color-scheme: dark) color overrides. Note: until the standard renderer ships a default dark palette, only the keys set here change in dark mode."
 			}
 		}
 	},
+	AppearanceColors: {
+		type: "object",
+		additionalProperties: false,
+		description: "A set of overridable color tokens. Each value is a CSS color (hex, rgb()/rgba(), hsl()/hsla(), or a named color); CSS-structural characters (; { } < > \" ' \\) are disallowed so a value cannot escape the inline <style>.",
+		properties: {
+			bg: {
+				$ref: "#/$defs/CssColor",
+				description: "Page background."
+			},
+			surface: {
+				$ref: "#/$defs/CssColor",
+				description: "Raised surfaces such as skill/tag chips."
+			},
+			text: {
+				$ref: "#/$defs/CssColor",
+				description: "Primary body text."
+			},
+			textMuted: {
+				$ref: "#/$defs/CssColor",
+				description: "Secondary/muted text (taglines, meta, captions)."
+			},
+			border: {
+				$ref: "#/$defs/CssColor",
+				description: "Hairline borders and rules."
+			},
+			accent: {
+				$ref: "#/$defs/CssColor",
+				description: "Accent color for emphasis and focus affordances."
+			},
+			primary: {
+				$ref: "#/$defs/CssColor",
+				description: "Primary interactive color, e.g. links."
+			},
+			primaryContrast: {
+				$ref: "#/$defs/CssColor",
+				description: "Foreground color used on top of the primary color."
+			},
+			heading: {
+				$ref: "#/$defs/CssColor",
+				description: "Heading color for the \"About\" section's Markdown sub-headings (##/###)."
+			}
+		}
+	},
+	CssColor: {
+		type: "string",
+		minLength: 1,
+		maxLength: 64,
+		pattern: "^(?:#[0-9A-Fa-f]{3,8}|[A-Za-z]+|(?:rgb|rgba|hsl|hsla|hwb|lab|lch|oklab|oklch|color)\\([A-Za-z0-9.,%/\\s-]*\\))$",
+		description: "A CSS color value, restricted to a safe allowlist: a hex color (#rgb/#rgba/#rrggbb/#rrggbbaa), a bare keyword (named colors, currentColor, transparent), or a color function (rgb/rgba/hsl/hsla/hwb/lab/lch/oklab/oklch/color). url(), image-set(), var(), and other fetch- or reference-bearing functions are intentionally excluded so a value can never trigger an external request or escape the inline <style>."
+	},
 	ContactSettings: {
 		type: "object",
 		additionalProperties: false,
@@ -667,6 +900,10 @@ var $defs = {
 				type: "boolean",
 				description: "Default true. When false, recommendations[] is emitted empty on public surfaces."
 			},
+			highlights: {
+				type: "boolean",
+				description: "Default true. When false, highlights[] is emitted empty on public surfaces."
+			},
 			contact: {
 				type: "boolean",
 				description: "Default true. When false, the contact section (email, formUrl) is emitted empty on public surfaces."
@@ -968,12 +1205,34 @@ var $defs = {
 			url: {
 				$ref: "#/$defs/Url"
 			},
+			secondaryLink: {
+				$ref: "#/$defs/SecondaryLink",
+				description: "An optional second link for this entry (added in 1.4.0), rendered as a small pill beside the description — e.g. the organization's GitHub org page next to its main site. The brand glyph is resolved from the URL host; no vendor name is hard-coded."
+			},
 			order: {
 				type: "integer",
 				minimum: 0
 			}
 		}
 	},
+	SecondaryLink: {
+		type: "object",
+		additionalProperties: false,
+		required: [
+			"url"
+		],
+		description: "A supplementary link with an optional localized label (added in 1.4.0). When the label is absent the renderer shows the URL host. The brand glyph is resolved from the URL host.",
+		properties: {
+			url: {
+				$ref: "#/$defs/Url",
+				description: "The link target."
+			},
+			label: {
+				$ref: "#/$defs/LocalizedTitle",
+				description: "Localized display label. When absent, the renderer derives a label from the URL host."
+			}
+		}
+	},
 	Honor: {
 		type: "object",
 		additionalProperties: false,
@@ -1377,6 +1636,74 @@ var $defs = {
 				description: "Link to the recommender's profile, for external verification by the reader."
 			}
 		}
+	},
+	Highlight: {
+		type: "object",
+		additionalProperties: false,
+		required: [
+			"id",
+			"platform",
+			"url",
+			"image",
+			"alt",
+			"title"
+		],
+		description: "One curated \"selected post\" (added in 1.4.0), rendered as a card in the highlights carousel. A hand-picked link to an off-site post (Instagram, X, a blog, a talk, …) with a self-hosted thumbnail — deliberately not an automated social feed. Appears on the public page, /api/profile, /takuhon.json, and MCP; it is intentionally omitted from JSON-LD and the derived CV (no natural vocabulary/résumé slot).",
+		properties: {
+			id: {
+				$ref: "#/$defs/Slug"
+			},
+			visibility: {
+				$ref: "#/$defs/Visibility"
+			},
+			platform: {
+				type: "string",
+				minLength: 1,
+				maxLength: 64,
+				description: "Free-form source platform (e.g. 'instagram', 'x', 'github', 'blog', 'event'). A value with a matching brand glyph renders a badge icon; others fall back to a text badge. Not an enum, so new platforms need no schema change."
+			},
+			url: {
+				$ref: "#/$defs/Url",
+				description: "Permalink to the original post; the card links here."
+			},
+			image: {
+				type: "string",
+				format: "uri-reference",
+				maxLength: 2048,
+				description: "Self-hosted thumbnail, as an absolute URL or a root-relative path (like avatar). Serving the asset is the deployment's responsibility (a static build does not copy it; a Cloudflare deploy serves it via its assets binding / /assets/*). Do not point at a third-party CDN URL — those can be signed/expiring and leak visitor data."
+			},
+			alt: {
+				$ref: "#/$defs/LocalizedTitle",
+				description: "Required alt text for the thumbnail — the card must not depend on the image alone."
+			},
+			title: {
+				$ref: "#/$defs/LocalizedTitle",
+				description: "Localized card title / caption."
+			},
+			description: {
+				$ref: "#/$defs/LocalizedBody",
+				description: "Optional localized supporting text shown under the title."
+			},
+			postedAt: {
+				type: "string",
+				format: "date",
+				pattern: "^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$",
+				description: "Optional post date, ISO 'YYYY-MM-DD' (full date, unlike the YYYY-MM dates used elsewhere — a post has a specific day)."
+			},
+			tags: {
+				type: "array",
+				maxItems: 30,
+				items: {
+					type: "string",
+					minLength: 1,
+					maxLength: 50
+				}
+			},
+			order: {
+				type: "integer",
+				minimum: 0
+			}
+		}
 	}
 };
 var schemaJson = {
@@ -1522,6 +1849,13 @@ declare const schema: {
                 $ref: string;
             };
         };
+        highlights: {
+            type: string;
+            maxItems: number;
+            items: {
+                $ref: string;
+            };
+        };
         contact: {
             $ref: string;
         };
@@ -1780,6 +2114,10 @@ declare const schema: {
                 title: {
                     $ref: string;
                 };
+                role: {
+                    $ref: string;
+                    description: string;
+                };
                 description: {
                     $ref: string;
                 };
@@ -1831,9 +2169,18 @@ declare const schema: {
                     $ref: string;
                 };
                 label: {
-                    type: string;
-                    minLength: number;
-                    maxLength: number;
+                    anyOf: ({
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                        $ref?: undefined;
+                    } | {
+                        $ref: string;
+                        type?: undefined;
+                        minLength?: undefined;
+                        maxLength?: undefined;
+                    })[];
+                    description: string;
                 };
                 category: {
                     type: string;
@@ -1847,6 +2194,23 @@ declare const schema: {
                 };
             };
         };
+        SkillCategory: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                id: {
+                    type: string;
+                    minLength: number;
+                    maxLength: number;
+                    description: string;
+                };
+                label: {
+                    $ref: string;
+                    description: string;
+                };
+            };
+        };
         Contact: {
             type: string;
             additionalProperties: boolean;
@@ -1918,11 +2282,186 @@ declare const schema: {
                 contact: {
                     $ref: string;
                 };
-            };
-        };
-        ContactSettings: {
-            type: string;
-            additionalProperties: boolean;
+                appearance: {
+                    $ref: string;
+                };
+                skillCategories: {
+                    type: string;
+                    maxItems: number;
+                    items: {
+                        $ref: string;
+                    };
+                    description: string;
+                };
+                sectionOrder: {
+                    type: string;
+                    uniqueItems: boolean;
+                    maxItems: number;
+                    items: {
+                        enum: string[];
+                    };
+                    description: string;
+                };
+                sectionLabels: {
+                    $ref: string;
+                };
+                highlightsIntro: {
+                    $ref: string;
+                    description: string;
+                };
+            };
+        };
+        SectionLabelOverrides: {
+            type: string;
+            additionalProperties: boolean;
+            description: string;
+            properties: {
+                about: {
+                    $ref: string;
+                };
+                careers: {
+                    $ref: string;
+                };
+                projects: {
+                    $ref: string;
+                };
+                volunteering: {
+                    $ref: string;
+                };
+                skills: {
+                    $ref: string;
+                };
+                activity: {
+                    $ref: string;
+                };
+                education: {
+                    $ref: string;
+                };
+                certifications: {
+                    $ref: string;
+                };
+                publications: {
+                    $ref: string;
+                };
+                honors: {
+                    $ref: string;
+                };
+                memberships: {
+                    $ref: string;
+                };
+                courses: {
+                    $ref: string;
+                };
+                patents: {
+                    $ref: string;
+                };
+                testScores: {
+                    $ref: string;
+                };
+                languages: {
+                    $ref: string;
+                };
+                recommendations: {
+                    $ref: string;
+                };
+                highlights: {
+                    $ref: string;
+                };
+                contact: {
+                    $ref: string;
+                };
+                skipLink: {
+                    $ref: string;
+                };
+                localeNav: {
+                    $ref: string;
+                };
+                featuredLinks: {
+                    $ref: string;
+                };
+                otherLinks: {
+                    $ref: string;
+                };
+                poweredBy: {
+                    $ref: string;
+                };
+            };
+        };
+        AppearanceSettings: {
+            type: string;
+            additionalProperties: boolean;
+            description: string;
+            properties: {
+                fontFamily: {
+                    type: string;
+                    minLength: number;
+                    maxLength: number;
+                    pattern: string;
+                    description: string;
+                };
+                colors: {
+                    $ref: string;
+                    description: string;
+                };
+                colorsDark: {
+                    $ref: string;
+                    description: string;
+                };
+            };
+        };
+        AppearanceColors: {
+            type: string;
+            additionalProperties: boolean;
+            description: string;
+            properties: {
+                bg: {
+                    $ref: string;
+                    description: string;
+                };
+                surface: {
+                    $ref: string;
+                    description: string;
+                };
+                text: {
+                    $ref: string;
+                    description: string;
+                };
+                textMuted: {
+                    $ref: string;
+                    description: string;
+                };
+                border: {
+                    $ref: string;
+                    description: string;
+                };
+                accent: {
+                    $ref: string;
+                    description: string;
+                };
+                primary: {
+                    $ref: string;
+                    description: string;
+                };
+                primaryContrast: {
+                    $ref: string;
+                    description: string;
+                };
+                heading: {
+                    $ref: string;
+                    description: string;
+                };
+            };
+        };
+        CssColor: {
+            type: string;
+            minLength: number;
+            maxLength: number;
+            pattern: string;
+            description: string;
+        };
+        ContactSettings: {
+            type: string;
+            additionalProperties: boolean;
             description: string;
             properties: {
                 enabled: {
@@ -2015,6 +2554,10 @@ declare const schema: {
                     type: string;
                     description: string;
                 };
+                highlights: {
+                    type: string;
+                    description: string;
+                };
                 contact: {
                     type: string;
                     description: string;
@@ -2291,12 +2834,32 @@ declare const schema: {
                 url: {
                     $ref: string;
                 };
+                secondaryLink: {
+                    $ref: string;
+                    description: string;
+                };
                 order: {
                     type: string;
                     minimum: number;
                 };
             };
         };
+        SecondaryLink: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            description: string;
+            properties: {
+                url: {
+                    $ref: string;
+                    description: string;
+                };
+                label: {
+                    $ref: string;
+                    description: string;
+                };
+            };
+        };
         Honor: {
             type: string;
             additionalProperties: boolean;
@@ -2653,10 +3216,115 @@ declare const schema: {
                 };
             };
         };
+        Highlight: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            description: string;
+            properties: {
+                id: {
+                    $ref: string;
+                };
+                visibility: {
+                    $ref: string;
+                };
+                platform: {
+                    type: string;
+                    minLength: number;
+                    maxLength: number;
+                    description: string;
+                };
+                url: {
+                    $ref: string;
+                    description: string;
+                };
+                image: {
+                    type: string;
+                    format: string;
+                    maxLength: number;
+                    description: string;
+                };
+                alt: {
+                    $ref: string;
+                    description: string;
+                };
+                title: {
+                    $ref: string;
+                    description: string;
+                };
+                description: {
+                    $ref: string;
+                    description: string;
+                };
+                postedAt: {
+                    type: string;
+                    format: string;
+                    pattern: string;
+                    description: string;
+                };
+                tags: {
+                    type: string;
+                    maxItems: number;
+                    items: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                };
+                order: {
+                    type: string;
+                    minimum: number;
+                };
+            };
+        };
     };
 };
 type Schema = typeof schemaJson;
 
+/**
+ * The canonical set — and default order — of the profile sections the standard
+ * renderer emits. One key per orderable `<section>`.
+ *
+ * This is the single source of truth for section identity and default ordering,
+ * shared so the renderer, `settings.sectionOrder`, and the section-level privacy
+ * controls cannot drift apart. Two kinds of keys appear:
+ *
+ * - **Data sections** — the array/object sections of the document, named exactly
+ *   as in {@link PublicVisibility} (`careers`, `projects`, `highlights`, …). A
+ *   parity test guarantees every visibility-controlled data section is
+ *   represented here. `highlights` (the curated "selected posts" carousel, its
+ *   own top-level array added in 1.4.0) is one of these.
+ * - **Page-only sections** — `about` (rendered from `profile.bio`) and
+ *   `activity` (rendered from a synced snapshot, not stored document data).
+ *
+ * `links` is deliberately absent: featured links render at the top and the
+ * remaining links render as a fixed bottom section, so link placement is not
+ * part of the reorderable section flow.
+ *
+ * The array order is the renderer's default section order; a caller may render a
+ * subset in a different order, but unlisted sections keep this ordering.
+ */
+declare const SECTION_KEYS: readonly ["about", "careers", "projects", "volunteering", "skills", "activity", "education", "certifications", "publications", "honors", "memberships", "courses", "patents", "testScores", "languages", "recommendations", "highlights", "contact"];
+/** One of the canonical {@link SECTION_KEYS}. */
+type SectionKey = (typeof SECTION_KEYS)[number];
+/**
+ * Non-section "chrome" labels the renderer emits (skip link, nav aria-labels,
+ * the other-links heading, the footer credit lead-in). Together with the
+ * section headings these form the full set of localizable labels a caller can
+ * override.
+ */
+declare const CHROME_LABEL_KEYS: readonly ["skipLink", "localeNav", "featuredLinks", "otherLinks", "poweredBy"];
+/**
+ * Every overridable label key: one per {@link SECTION_KEYS} heading plus the
+ * {@link CHROME_LABEL_KEYS}. This is the single source of truth for the label
+ * set shared by the renderer's `SectionLabels`, the `settings.sectionLabels`
+ * data override, and the per-request label override — so all three stay in
+ * lock-step.
+ */
+declare const LABEL_KEYS: readonly ["about", "careers", "projects", "volunteering", "skills", "activity", "education", "certifications", "publications", "honors", "memberships", "courses", "patents", "testScores", "languages", "recommendations", "highlights", "contact", "skipLink", "localeNav", "featuredLinks", "otherLinks", "poweredBy"];
+/** One of the {@link LABEL_KEYS}. */
+type LabelKey = (typeof LABEL_KEYS)[number];
+
 /**
  * TypeScript types for takuhon profile data.
  *
@@ -2699,6 +3367,7 @@ type Schema = typeof schemaJson;
  * alongside a profile should keep it in a sibling structure rather than
  * smuggling undeclared keys into the contract — schema 1.0.0 now rejects them.
  */
+
 /** BCP-47 language tag, e.g. 'en', 'ja', 'zh-Hant', 'pt-BR'. */
 type LocaleTag = string;
 /** ISO 3166-1 alpha-2 country code, uppercase, two letters (e.g. 'JP', 'PT'). */
@@ -2790,6 +3459,12 @@ interface Career extends VisibilityControlled {
 interface Project extends VisibilityControlled {
     id: Slug;
     title: LocalizedTitle;
+    /**
+     * The owner's role/relationship on this project (added in 1.4.0), e.g.
+     * "Author & lead maintainer". Rendered as a short line under the title.
+     * Localized, like {@link Career.role}.
+     */
+    role?: LocalizedTitle;
     description?: LocalizedBody;
     url?: string;
     tags?: string[];
@@ -2801,7 +3476,12 @@ interface Project extends VisibilityControlled {
 }
 interface Skill extends VisibilityControlled {
     id: Slug;
-    label: string;
+    /**
+     * Skill name. A plain `string` is locale-independent; a {@link LocalizedTitle}
+     * map (added in 1.4.0) resolves per request locale. The map form is purely
+     * additive — existing single-string labels stay valid.
+     */
+    label: string | LocalizedTitle;
     /**
      * Recommended values (extensible): programming, design, business, communication,
      * language, music, art, sports, other.
@@ -2846,8 +3526,20 @@ interface Volunteering extends VisibilityControlled {
     endDate?: YearMonth | null;
     isCurrent?: boolean;
     url?: string;
+    /** An optional second link (added in 1.4.0), e.g. the organization's GitHub org page. */
+    secondaryLink?: SecondaryLink;
     order?: number;
 }
+/**
+ * A supplementary link with an optional localized label (added in 1.4.0). Used by
+ * {@link Volunteering.secondaryLink}. The renderer resolves the brand glyph from
+ * the URL host and, when {@link SecondaryLink.label} is absent, derives a display
+ * label from the host too.
+ */
+interface SecondaryLink {
+    url: string;
+    label?: LocalizedTitle;
+}
 interface Honor extends VisibilityControlled {
     id: Slug;
     title: LocalizedTitle;
@@ -2964,6 +3656,41 @@ interface Recommendation extends VisibilityControlled {
     relatedEducationId?: Slug;
     order?: number;
 }
+/**
+ * One curated "selected post" (added in 1.4.0), rendered as a card in the
+ * highlights carousel: a hand-picked link to an off-site post (Instagram, X, a
+ * blog, a talk, …) with a self-hosted thumbnail — deliberately not an automated
+ * social feed. It appears on the public page, `/api/profile`, `/takuhon.json`,
+ * and MCP, but is intentionally omitted from JSON-LD and the derived CV (no
+ * natural vocabulary / résumé slot for it).
+ */
+interface Highlight extends VisibilityControlled {
+    id: Slug;
+    /**
+     * Free-form source platform (e.g. `'instagram'`, `'x'`, `'github'`, `'blog'`,
+     * `'event'`). A value with a matching brand glyph renders a badge icon; others
+     * fall back to a text badge. Not an enum, so new platforms need no schema
+     * change.
+     */
+    platform: string;
+    /** Permalink to the original post; the card links here. */
+    url: string;
+    /**
+     * Self-hosted thumbnail, as an absolute URL or a root-relative path (like
+     * {@link Avatar.url}). Serving the asset is the deployment's responsibility.
+     */
+    image: string;
+    /** Required alt text for the thumbnail — the card must not rely on the image alone. */
+    alt: LocalizedTitle;
+    /** Localized card title / caption. */
+    title: LocalizedTitle;
+    /** Optional localized supporting text shown under the title. */
+    description?: LocalizedBody;
+    /** Optional post date, ISO `YYYY-MM-DD` (a full date, unlike the YYYY-MM used elsewhere). */
+    postedAt?: string;
+    tags?: string[];
+    order?: number;
+}
 interface Contact {
     email?: string;
     showEmail?: boolean;
@@ -2989,6 +3716,98 @@ interface Settings {
     publicVisibility?: PublicVisibility;
     /** Opt-in contact form (added in 1.1.0). Absent = no contact form. */
     contact?: ContactSettings;
+    /** Opt-in design tokens for the rendered profile (added in 1.2.0). Absent = built-in defaults. */
+    appearance?: AppearanceSettings;
+    /**
+     * Ordered skill-category display groups (added in 1.3.0). When present, the
+     * rendered profile groups skills by their `category` under these localized
+     * headings, in array order; absent = the flat skill list. A skill whose
+     * `category` is unlisted (or absent) renders in a trailing group.
+     */
+    skillCategories?: SkillCategory[];
+    /**
+     * Explicit section display order (added in 1.4.0). A partial list is allowed:
+     * any renderable section not named here follows, in the default order. Absent
+     * = the default order. Keys are the canonical {@link SectionKey}s.
+     */
+    sectionOrder?: SectionKey[];
+    /**
+     * Localized overrides for section headings and chrome labels (added in 1.4.0).
+     * A partial map keyed by {@link LabelKey}; the renderer merges it over the
+     * built-in locale pack and under a per-request override, so an owner can
+     * retitle any section or chrome label straight from `takuhon.json`. Absent =
+     * the built-in labels.
+     */
+    sectionLabels?: SectionLabelOverrides;
+    /**
+     * Localized intro line shown under the highlights section heading (added in
+     * 1.4.0). Absent = no intro line.
+     */
+    highlightsIntro?: LocalizedTitle;
+}
+/** Localized label overrides for {@link Settings.sectionLabels}. */
+type SectionLabelOverrides = Partial<Record<LabelKey, LocalizedTitle>>;
+/**
+ * One skill-category display group (added in 1.3.0). Maps a `Skill.category`
+ * value to a localized heading; the array position in {@link
+ * Settings.skillCategories} defines the group's display order.
+ */
+interface SkillCategory {
+    /** Matches the `category` value on the skills that belong to this group. */
+    id: string;
+    /** Localized display heading for the group. */
+    label: LocalizedTitle;
+}
+/**
+ * Opt-in design tokens for the rendered profile (added in 1.2.0).
+ *
+ * A declarative re-skin seam: owners override the standard renderer's built-in
+ * color and font defaults. This is a token map only — never arbitrary CSS — so
+ * every value is length- and pattern-constrained (see the schema) and cannot
+ * break out of the inline `<style>`. Overriding tokens re-skins the page but
+ * cannot re-layout it; spacing, radius, and the type scale are intentionally
+ * not exposed. An absent block leaves the built-in defaults unchanged.
+ */
+interface AppearanceSettings {
+    /** CSS font-family stack for the page body, e.g. `"Inter, system-ui, sans-serif"`. */
+    fontFamily?: string;
+    /** Light-mode (`:root`) color overrides. */
+    colors?: AppearanceColors;
+    /**
+     * Dark-mode (`prefers-color-scheme: dark`) color overrides. Until the
+     * standard renderer ships a default dark palette, only the keys set here
+     * change in dark mode.
+     */
+    colorsDark?: AppearanceColors;
+}
+/**
+ * Overridable color tokens (added in 1.2.0). Each value is a CSS color (hex,
+ * `rgb()`/`rgba()`, `hsl()`/`hsla()`, or a named color); CSS-structural
+ * characters are disallowed so a value cannot escape the inline `<style>`.
+ */
+interface AppearanceColors {
+    /** Page background. */
+    bg?: string;
+    /** Raised surfaces such as skill/tag chips. */
+    surface?: string;
+    /** Primary body text. */
+    text?: string;
+    /** Secondary/muted text (taglines, meta, captions). */
+    textMuted?: string;
+    /** Hairline borders and rules. */
+    border?: string;
+    /** Accent color for emphasis and focus affordances. */
+    accent?: string;
+    /** Primary interactive color, e.g. links. */
+    primary?: string;
+    /** Foreground color used on top of the primary color. */
+    primaryContrast?: string;
+    /**
+     * Heading color for the "About" section's Markdown sub-headings (`##`/`###`).
+     * Defaults to a deep indigo (light) / soft indigo (dark) so sub-headings stand
+     * out from body text; override to re-tint them.
+     */
+    heading?: string;
 }
 /**
  * Owner-curated configuration for the opt-in contact form (added in 1.1.0).
@@ -3040,6 +3859,7 @@ interface PublicVisibility {
     patents?: boolean;
     testScores?: boolean;
     recommendations?: boolean;
+    highlights?: boolean;
     contact?: boolean;
 }
 /**
@@ -3125,6 +3945,7 @@ interface Takuhon {
     patents: Patent[];
     testScores: TestScore[];
     recommendations: Recommendation[];
+    highlights: Highlight[];
     contact: Contact;
     settings: Settings;
     meta: Meta;
@@ -3196,6 +4017,8 @@ interface LocalizedCareer extends VisibilityControlled {
 interface LocalizedProject extends VisibilityControlled {
     id: Slug;
     title: string;
+    /** Resolved {@link Project.role} for the active locale (added in 1.4.0). */
+    role?: string;
     description?: string;
     url?: string;
     tags?: string[];
@@ -3228,6 +4051,11 @@ interface LocalizedMembership extends VisibilityControlled {
     url?: string;
     order?: number;
 }
+/** {@link SecondaryLink} with its localized label collapsed to a single string. */
+interface LocalizedSecondaryLink {
+    url: string;
+    label?: string;
+}
 /** Volunteering with localized fields collapsed to single strings. */
 interface LocalizedVolunteering extends VisibilityControlled {
     id: Slug;
@@ -3239,6 +4067,7 @@ interface LocalizedVolunteering extends VisibilityControlled {
     endDate?: YearMonth | null;
     isCurrent?: boolean;
     url?: string;
+    secondaryLink?: LocalizedSecondaryLink;
     order?: number;
 }
 /** Honor with localized fields collapsed to single strings. */
@@ -3339,13 +4168,60 @@ interface LocalizedRecommendation extends VisibilityControlled {
     relatedEducationId?: Slug;
     order?: number;
 }
+/** Highlight with `alt`, `title`, `description` collapsed to single strings. */
+interface LocalizedHighlight extends VisibilityControlled {
+    id: Slug;
+    platform: string;
+    url: string;
+    image: string;
+    alt: string;
+    title: string;
+    description?: string;
+    postedAt?: string;
+    tags?: string[];
+    order?: number;
+}
+/**
+ * {@link Skill} after locale resolution: its `label` — a plain string or a
+ * localized map — collapsed to the single resolved string. Every other field
+ * passes through unchanged.
+ */
+interface LocalizedSkill extends VisibilityControlled {
+    id: Slug;
+    label: string;
+    category?: string;
+    order?: number;
+}
+/**
+ * One skill-category group after locale resolution: the localized `label` map
+ * collapsed to the single resolved string. See {@link SkillCategory}.
+ */
+interface LocalizedSkillCategory {
+    id: string;
+    label: string;
+}
+/**
+ * {@link Settings} after locale resolution. Identical to the raw settings
+ * except `skillCategories` labels are collapsed to single resolved strings
+ * ({@link LocalizedSkillCategory}); every other settings field is passed
+ * through unchanged.
+ */
+type LocalizedSettings = Omit<Settings, 'skillCategories' | 'sectionLabels' | 'highlightsIntro'> & {
+    skillCategories?: LocalizedSkillCategory[];
+    /** {@link Settings.sectionLabels} with each value collapsed to the resolved string. */
+    sectionLabels?: Partial<Record<LabelKey, string>>;
+    /** {@link Settings.highlightsIntro} collapsed to the resolved string. */
+    highlightsIntro?: string;
+};
 /**
  * A takuhon document with every localized map flattened to a single string,
  * plus a `resolvedLocale` field recording which tag was actually used as the
  * head of the fallback chain. `resolveLocale()` returns this shape.
  *
- * `Skill`, `Contact`, `Settings`, and `Meta` carry no localized fields and
- * pass through unchanged.
+ * `Contact` and `Meta` carry no localized fields and pass through unchanged;
+ * `Settings` passes through too, except its `skillCategories` labels are
+ * resolved to the single locale string (see {@link LocalizedSettings}). `Skill`
+ * becomes {@link LocalizedSkill} once its `label` can be a localized map (1.4.0).
  */
 interface LocalizedTakuhon {
     schemaVersion: string;
@@ -3353,7 +4229,7 @@ interface LocalizedTakuhon {
     links: LocalizedLink[];
     careers: LocalizedCareer[];
     projects: LocalizedProject[];
-    skills: Skill[];
+    skills: LocalizedSkill[];
     certifications: LocalizedCertification[];
     memberships: LocalizedMembership[];
     volunteering: LocalizedVolunteering[];
@@ -3365,8 +4241,9 @@ interface LocalizedTakuhon {
     patents: LocalizedPatent[];
     testScores: LocalizedTestScore[];
     recommendations: LocalizedRecommendation[];
+    highlights: LocalizedHighlight[];
     contact: Contact;
-    settings: Settings;
+    settings: LocalizedSettings;
     meta: Meta;
     /**
      * The locale tag that was matched first by the fallback chain and used as
@@ -3412,7 +4289,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", "0.2.0", "0.3.0", "0.4.0", "0.5.0", "0.6.0", "0.7.0", "1.0.0", "1.1.0"];
+declare const SUPPORTED_SCHEMA_VERSIONS: readonly ["0.1.0", "0.2.0", "0.3.0", "0.4.0", "0.5.0", "0.6.0", "0.7.0", "1.0.0", "1.1.0", "1.2.0", "1.3.0", "1.4.0"];
 /**
  * A single validation failure.
  *
@@ -3553,6 +4430,10 @@ declare function resolveLocale(data: Takuhon, locale?: string, fallbackLocale?:
  *   no placeholder is fabricated.
  * - `profile.tagline` is intentionally not surfaced. `description` carries
  *   `profile.bio` only, matching the spec exemplar. Phase 2 may revisit.
+ * - The curated `highlights` (selected posts) are intentionally NOT surfaced:
+ *   Schema.org has no natural vocabulary for an owner-curated set of off-site
+ *   posts, so they stay a page/API/MCP feature and are absent from JSON-LD (a
+ *   deliberate omission, consistent with the derived CV).
  * - `contact.email` is surfaced only when `contact.showEmail === true`
  *   (privacy by default).
  * - URLs pass through verbatim. Relative paths in the input remain relative
@@ -4185,8 +5066,9 @@ declare function renderActivitySvg(snapshot: ActivitySnapshot, options?: RenderA
  * same input.
  *
  * A CV is a curated *subset* of the profile: the web-page-specific sections
- * (links, recommendations, the activity dashboard, test scores) are omitted,
- * and the rest appear in the order a résumé conventionally uses. Entry order
+ * (links, recommendations, the activity dashboard, test scores, and the
+ * curated `highlights` carousel) are omitted, and the rest appear in the order
+ * a résumé conventionally uses. Entry order
  * within a section is preserved from the input (already normalized by `order`
  * upstream), so the owner's `order` field controls it — `deriveCv` never
  * re-sorts. Empty sections are dropped so the renderer can iterate without
@@ -4220,7 +5102,7 @@ type CvSection = {
     entries: LocalizedEducation[];
 } | {
     kind: 'skills';
-    entries: Skill[];
+    entries: LocalizedSkill[];
 } | {
     kind: 'certifications';
     entries: LocalizedCertification[];
@@ -4367,7 +5249,7 @@ declare function getPresentLabel(locale: LocaleTag): string;
  * `meta`, `schemaVersion`, and `resolvedLocale` are intentionally excluded —
  * they are configuration / bookkeeping, not profile content an agent reads.
  */
-declare const MCP_PROFILE_SECTIONS: readonly ["profile", "links", "careers", "projects", "skills", "certifications", "memberships", "volunteering", "honors", "education", "publications", "languages", "courses", "patents", "testScores", "recommendations", "contact"];
+declare const MCP_PROFILE_SECTIONS: readonly ["profile", "links", "careers", "projects", "skills", "certifications", "memberships", "volunteering", "honors", "education", "publications", "languages", "courses", "patents", "testScores", "recommendations", "highlights", "contact"];
 /** One of the {@link MCP_PROFILE_SECTIONS} a `get_section` call accepts. */
 type McpProfileSection = (typeof MCP_PROFILE_SECTIONS)[number];
 /** A JSON Schema (draft 2020-12) object describing a tool's input arguments. */
@@ -4542,6 +5424,6 @@ declare function stripImageMetadata(bytes: Uint8Array, mime: AcceptedImageMime):
  * 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 = "1.1.0";
+declare const SCHEMA_VERSION = "1.4.0";
 
-export { ACCEPTED_IMAGE_MIME_TYPES, type AcceptedImageMime, type ActivitySettings, type ActivitySnapshot, type ActivityStorage, type Address, type AssetOptions, type AssetRecord, type Avatar, type Career, type Certification, type CodingTime, ConflictError, type Contact, type ContentLicense, type ContentLicenseAttribution, type ContributionCalendar, type ContributionDay, type Course, type CvDocument, type CvHeader, type CvSection, type CvSectionKind, DARK_PALETTE, type Education, type ExportOptions, type ExportedTakuhon, type GravatarOptions, type Honor, IMAGE_EXTENSIONS, type ImageInfo, ImportError, type Iso3166Alpha2, type IsoDateTime, LIGHT_PALETTE, type Language, type LanguageBreakdown, 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 LocalizedRecommendation, type LocalizedRecommendationAuthor, type LocalizedTakuhon, type LocalizedTestScore, type LocalizedTitle, type LocalizedVolunteering, MAX_IMAGE_BYTES, MAX_IMAGE_DIMENSION, MAX_IMAGE_FRAMES, MCP_PROFILE_SECTIONS, MCP_RESOURCES, MCP_TOOLS, type McpInputSchema, type McpProfileSection, McpRequestError, type McpResourceDefinition, type McpResourceResult, type McpToolDefinition, type McpToolResult, type Membership, type Meta, type MetaPrivacy, type Migration, MigrationError, type NormalizedTakuhon, NotFoundError, type Palette, type Patent, type PatentStatus, type Profile, type Project, type PublicVisibility, type Publication, RANK_FULL_CODING_HOURS, RANK_FULL_CONTRIBUTIONS, RANK_TIER_THRESHOLDS, type RankInput, type RankTier, type RankTierLabel, type Recommendation, type RecommendationAuthor, type RenderActivitySvgOptions, SCHEMA_VERSION, SUPPORTED_SCHEMA_VERSIONS, type Schema, type Settings, type Skill, type Slug, StorageError, type Takuhon, type TakuhonAssetStorage, type TakuhonStorage, type TestScore, type ValidationError, type ValidationResult, type Volunteering, type YearMonth, applyPublicPrivacyFilter, computeLanguagePercentages, deriveCv, deriveRankTier, detectImageMime, executeMcpTool, exportTakuhon, formatCodingTime, formatDate, generateJsonLd, generatePersonJsonLd, generateProfilePageJsonLd, getPresentLabel, gravatarUrl, importTakuhon, isActivitySnapshot, migrateTakuhon, migrations, normalize, readImageInfo, readMcpResource, renderActivitySvg, resolveLocale, schema, stripImageMetadata, validate };
+export { ACCEPTED_IMAGE_MIME_TYPES, type AcceptedImageMime, type ActivitySettings, type ActivitySnapshot, type ActivityStorage, type Address, type AppearanceColors, type AppearanceSettings, type AssetOptions, type AssetRecord, type Avatar, CHROME_LABEL_KEYS, type Career, type Certification, type CodingTime, ConflictError, type Contact, type ContentLicense, type ContentLicenseAttribution, type ContributionCalendar, type ContributionDay, type Course, type CvDocument, type CvHeader, type CvSection, type CvSectionKind, DARK_PALETTE, type Education, type ExportOptions, type ExportedTakuhon, type GravatarOptions, type Highlight, type Honor, IMAGE_EXTENSIONS, type ImageInfo, ImportError, type Iso3166Alpha2, type IsoDateTime, LABEL_KEYS, LIGHT_PALETTE, type LabelKey, type Language, type LanguageBreakdown, 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 LocalizedHighlight, type LocalizedHonor, type LocalizedLanguage, type LocalizedLink, type LocalizedLinkBuiltin, type LocalizedLinkCustom, type LocalizedMembership, type LocalizedPatent, type LocalizedProfile, type LocalizedProject, type LocalizedPublication, type LocalizedRecommendation, type LocalizedRecommendationAuthor, type LocalizedSecondaryLink, type LocalizedSkill, type LocalizedTakuhon, type LocalizedTestScore, type LocalizedTitle, type LocalizedVolunteering, MAX_IMAGE_BYTES, MAX_IMAGE_DIMENSION, MAX_IMAGE_FRAMES, MCP_PROFILE_SECTIONS, MCP_RESOURCES, MCP_TOOLS, type McpInputSchema, type McpProfileSection, McpRequestError, type McpResourceDefinition, type McpResourceResult, type McpToolDefinition, type McpToolResult, type Membership, type Meta, type MetaPrivacy, type Migration, MigrationError, type NormalizedTakuhon, NotFoundError, type Palette, type Patent, type PatentStatus, type Profile, type Project, type PublicVisibility, type Publication, RANK_FULL_CODING_HOURS, RANK_FULL_CONTRIBUTIONS, RANK_TIER_THRESHOLDS, type RankInput, type RankTier, type RankTierLabel, type Recommendation, type RecommendationAuthor, type RenderActivitySvgOptions, SCHEMA_VERSION, SECTION_KEYS, SUPPORTED_SCHEMA_VERSIONS, type Schema, type SecondaryLink, type SectionKey, type Settings, type Skill, type Slug, StorageError, type Takuhon, type TakuhonAssetStorage, type TakuhonStorage, type TestScore, type ValidationError, type ValidationResult, type Volunteering, type YearMonth, applyPublicPrivacyFilter, computeLanguagePercentages, deriveCv, deriveRankTier, detectImageMime, executeMcpTool, exportTakuhon, formatCodingTime, formatDate, generateJsonLd, generatePersonJsonLd, generateProfilePageJsonLd, getPresentLabel, gravatarUrl, importTakuhon, isActivitySnapshot, migrateTakuhon, migrations, normalize, readImageInfo, readMcpResource, renderActivitySvg, resolveLocale, schema, stripImageMetadata, validate };