@takuhon/core 1.3.0 → 1.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takuhon/core",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "JSON Schema, validation, normalization, locale resolution, and JSON-LD generation for takuhon",
   "license": "Apache-2.0",
   "author": "Takuhon contributors",

package/takuhon.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://takuhon.example/schemas/1.3.0/takuhon.schema.json",
+  "$id": "https://takuhon.example/schemas/1.4.0/takuhon.schema.json",
   "title": "Takuhon Profile",
   "description": "Portable profile data format consumed by @takuhon/core. The canonical contract for profile content authored as takuhon.json.",
   "type": "object",
@@ -88,6 +88,11 @@
       "maxItems": 50,
       "items": { "$ref": "#/$defs/Recommendation" }
     },
+    "highlights": {
+      "type": "array",
+      "maxItems": 50,
+      "items": { "$ref": "#/$defs/Highlight" }
+    },
     "contact": { "$ref": "#/$defs/Contact" },
     "settings": { "$ref": "#/$defs/Settings" },
     "meta": { "$ref": "#/$defs/Meta" }
@@ -279,6 +284,10 @@
         "id": { "$ref": "#/$defs/Slug" },
         "visibility": { "$ref": "#/$defs/Visibility" },
         "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" },
         "url": { "$ref": "#/$defs/Url" },
         "tags": {
@@ -302,7 +311,13 @@
       "properties": {
         "id": { "$ref": "#/$defs/Slug" },
         "visibility": { "$ref": "#/$defs/Visibility" },
-        "label": { "type": "string", "minLength": 1, "maxLength": 100 },
+        "label": {
+          "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",
           "minLength": 1,
@@ -387,9 +402,72 @@
           "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,
@@ -439,6 +517,10 @@
         "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 (##/###)."
         }
       }
     },
@@ -544,6 +626,10 @@
           "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."
@@ -725,9 +811,29 @@
         },
         "isCurrent": { "type": "boolean" },
         "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,
@@ -933,6 +1039,56 @@
           "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 }
+      }
     }
   }
 }