@takuhon/core 0.16.0 → 0.18.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.5.0/takuhon.schema.json";
+var $id = "https://takuhon.example/schemas/0.6.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";
@@ -545,6 +545,80 @@ var $defs = {
 			},
 			activity: {
 				$ref: "#/$defs/ActivitySettings"
+			},
+			publicVisibility: {
+				$ref: "#/$defs/PublicVisibility"
+			}
+		}
+	},
+	PublicVisibility: {
+		type: "object",
+		additionalProperties: false,
+		description: "Per-section public visibility (added in 0.6.0). Each key is a content section; setting it to false hides that whole section from every public surface (GET /, /api/profile, /api/jsonld, /takuhon.json, MCP, and the derived CV) via the shared applyPublicPrivacyFilter. An absent key — or an absent object — means the section is public, so the default is all-visible and omitting this block is fully backwards-compatible. The profile identity (profile.displayName, …) is always public and is intentionally not a key here. Field-level controls (contact.showEmail, meta.privacy.*) still apply within a visible section: visibility is the AND of the feature toggle, this section flag, and the field flag.",
+		properties: {
+			links: {
+				type: "boolean",
+				description: "Default true. When false, links[] is emitted empty on public surfaces."
+			},
+			careers: {
+				type: "boolean",
+				description: "Default true. When false, careers[] is emitted empty on public surfaces."
+			},
+			projects: {
+				type: "boolean",
+				description: "Default true. When false, projects[] is emitted empty on public surfaces."
+			},
+			skills: {
+				type: "boolean",
+				description: "Default true. When false, skills[] is emitted empty on public surfaces."
+			},
+			certifications: {
+				type: "boolean",
+				description: "Default true. When false, certifications[] is emitted empty on public surfaces."
+			},
+			memberships: {
+				type: "boolean",
+				description: "Default true. When false, memberships[] is emitted empty on public surfaces."
+			},
+			volunteering: {
+				type: "boolean",
+				description: "Default true. When false, volunteering[] is emitted empty on public surfaces."
+			},
+			honors: {
+				type: "boolean",
+				description: "Default true. When false, honors[] is emitted empty on public surfaces."
+			},
+			education: {
+				type: "boolean",
+				description: "Default true. When false, education[] is emitted empty on public surfaces."
+			},
+			publications: {
+				type: "boolean",
+				description: "Default true. When false, publications[] is emitted empty on public surfaces."
+			},
+			languages: {
+				type: "boolean",
+				description: "Default true. When false, languages[] is emitted empty on public surfaces."
+			},
+			courses: {
+				type: "boolean",
+				description: "Default true. When false, courses[] is emitted empty on public surfaces."
+			},
+			patents: {
+				type: "boolean",
+				description: "Default true. When false, patents[] is emitted empty on public surfaces."
+			},
+			testScores: {
+				type: "boolean",
+				description: "Default true. When false, testScores[] is emitted empty on public surfaces."
+			},
+			recommendations: {
+				type: "boolean",
+				description: "Default true. When false, recommendations[] 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."
 			}
 		}
 	},
@@ -1735,6 +1809,80 @@ declare const schema: {
                 activity: {
                     $ref: string;
                 };
+                publicVisibility: {
+                    $ref: string;
+                };
+            };
+        };
+        PublicVisibility: {
+            type: string;
+            additionalProperties: boolean;
+            description: string;
+            properties: {
+                links: {
+                    type: string;
+                    description: string;
+                };
+                careers: {
+                    type: string;
+                    description: string;
+                };
+                projects: {
+                    type: string;
+                    description: string;
+                };
+                skills: {
+                    type: string;
+                    description: string;
+                };
+                certifications: {
+                    type: string;
+                    description: string;
+                };
+                memberships: {
+                    type: string;
+                    description: string;
+                };
+                volunteering: {
+                    type: string;
+                    description: string;
+                };
+                honors: {
+                    type: string;
+                    description: string;
+                };
+                education: {
+                    type: string;
+                    description: string;
+                };
+                publications: {
+                    type: string;
+                    description: string;
+                };
+                languages: {
+                    type: string;
+                    description: string;
+                };
+                courses: {
+                    type: string;
+                    description: string;
+                };
+                patents: {
+                    type: string;
+                    description: string;
+                };
+                testScores: {
+                    type: string;
+                    description: string;
+                };
+                recommendations: {
+                    type: string;
+                    description: string;
+                };
+                contact: {
+                    type: string;
+                    description: string;
+                };
             };
         };
         ActivitySettings: {
@@ -2649,6 +2797,42 @@ interface Settings {
     enableAnalytics?: boolean;
     /** Opt-in developer-activity dashboard configuration (added in 0.5.0). */
     activity?: ActivitySettings;
+    /** Per-section public visibility (added in 0.6.0). Absent = all sections visible. */
+    publicVisibility?: PublicVisibility;
+}
+/**
+ * Per-section public/private visibility (added in 0.6.0).
+ *
+ * Each key names a content section. Setting it to `false` hides that whole
+ * section from every public surface (`GET /`, `/api/profile`, `/api/jsonld`,
+ * `/takuhon.json`, MCP, and the derived CV) through the shared
+ * {@link applyPublicPrivacyFilter}. An absent key — or an absent object —
+ * means the section is public, so the default is all-visible and omitting this
+ * block is fully backwards-compatible.
+ *
+ * The profile identity (`profile.displayName`, …) is always public and is
+ * intentionally not representable here. Field-level controls
+ * (`contact.showEmail`, `meta.privacy.*`) still apply within a visible section:
+ * a field is public only when the feature toggle, this section flag, and the
+ * field flag all allow it (AND composition).
+ */
+interface PublicVisibility {
+    links?: boolean;
+    careers?: boolean;
+    projects?: boolean;
+    skills?: boolean;
+    certifications?: boolean;
+    memberships?: boolean;
+    volunteering?: boolean;
+    honors?: boolean;
+    education?: boolean;
+    publications?: boolean;
+    languages?: boolean;
+    courses?: boolean;
+    patents?: boolean;
+    testScores?: boolean;
+    recommendations?: boolean;
+    contact?: boolean;
 }
 /**
  * Owner-curated configuration for the developer-activity dashboard (GitHub /
@@ -3020,7 +3204,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"];
+declare const SUPPORTED_SCHEMA_VERSIONS: readonly ["0.1.0", "0.2.0", "0.3.0", "0.4.0", "0.5.0", "0.6.0"];
 /**
  * A single validation failure.
  *
@@ -3270,20 +3454,32 @@ declare function importTakuhon(data: ExportedTakuhon): Takuhon;
 /**
  * Public-endpoint privacy filter for takuhon profile documents.
  *
- * Strips fields that the spec's privacy posture marks as opt-in for public
+ * Strips content that the spec's privacy posture marks as opt-in for public
  * exposure, before the document reaches a public reader (a public API
- * response, a statically built page, …). The filter is deliberately
- * conservative: when `meta.privacy` is absent the most restrictive
- * interpretation applies (everything sensitive is hidden), and the operator
- * must explicitly opt into disclosure by setting the relevant flag to
- * `false`.
+ * response, a server-rendered page, a statically built page, …). Two layers
+ * compose here, both conservative by default:
+ *
+ * 1. **Section layer** (`settings.publicVisibility`, schema 0.6.0). Each
+ *    content section the owner sets to `false` is emptied: array sections
+ *    become `[]` and the `contact` section becomes `{}`. An absent key — or an
+ *    absent `publicVisibility` block — means the section is public, so the
+ *    default is all-visible and older documents are unaffected.
+ * 2. **Field layer** (`meta.privacy.*`, `contact.showEmail`). Within a visible
+ *    section, individual identifying fields are stripped unless the operator
+ *    opts into disclosure.
+ *
+ * Visibility is the AND of the two layers (the surface-level `enable*` feature
+ * toggles are a third, orthogonal layer enforced by the route / renderer, not
+ * here): a field survives only when its section is visible *and* its field
+ * flag allows it. Hiding a whole section short-circuits its field checks.
  *
  * This lives in `@takuhon/core` because it is a pure transform over the core
  * document types with no transport coupling, so every public surface — the
- * API layer, the CLI's `build`, future renderers — applies the exact same
+ * API layer (`GET /`, `/api/profile`, `/api/jsonld`, `/takuhon.json`), the
+ * CLI's `build`, the MCP executor, the derived CV — applies the exact same
  * projection. `@takuhon/api` re-exports it for backwards compatibility.
  *
- * Fields filtered:
+ * Field-layer fields filtered:
  *
  * - `certifications[*].credentialId` — hidden when
  *   `meta.privacy.hideCredentialIds !== false` (default true).
@@ -3295,12 +3491,16 @@ declare function importTakuhon(data: ExportedTakuhon): Takuhon;
  * records (issued patents are published by the granting office) and Spec
  * §6.21 explicitly excludes them from the privacy block.
  *
+ * The `profile` identity (`profile.displayName`, …) is always public and is
+ * not a `publicVisibility` key, so it is never emptied here.
+ *
  * Behavior:
  *
  * - Pure function. The input is never mutated; a shallow-copied result is
  *   returned with only the touched arrays / objects replaced.
- * - When no filter applies (every flag opts into disclosure), the original
- *   reference is returned as-is so callers can compare by identity.
+ * - When no filter applies (every section visible and every field opts into
+ *   disclosure), the original reference is returned as-is so callers can
+ *   compare by identity.
  * - Admin endpoints (`/api/admin/*`, including `/api/admin/export`) MUST NOT
  *   call this helper — they always serve the full document to authenticated
  *   callers.
@@ -3308,8 +3508,7 @@ declare function importTakuhon(data: ExportedTakuhon): Takuhon;
 
 /**
  * Union of the two profile shapes that traverse the public path. The fields
- * the filter touches (`certifications[*].credentialId`, `education[*].grade`,
- * `contact.email`) are structurally identical between {@link Takuhon} and
+ * the filter touches are structurally identical between {@link Takuhon} and
  * {@link LocalizedTakuhon}, so the same logic applies to either shape.
  */
 type FilterableProfile = Takuhon | LocalizedTakuhon;
@@ -4092,6 +4291,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 = "0.5.0";
+declare const SCHEMA_VERSION = "0.6.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 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, generateJsonLd, generatePersonJsonLd, generateProfilePageJsonLd, 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 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, generateJsonLd, generatePersonJsonLd, generateProfilePageJsonLd, gravatarUrl, importTakuhon, isActivitySnapshot, migrateTakuhon, migrations, normalize, readImageInfo, readMcpResource, renderActivitySvg, resolveLocale, schema, stripImageMetadata, validate };