@takuhon/core 0.12.0 → 0.13.0

package/dist/index.d.ts

@@ -3712,6 +3712,95 @@ declare class ConflictError extends StorageError {
  */
 declare function renderActivitySvg(snapshot: ActivitySnapshot): string;
 
+/**
+ * Résumé / CV projection of a profile.
+ *
+ * {@link deriveCv} turns one locale-resolved {@link LocalizedTakuhon} into a
+ * {@link CvDocument}: a header plus the CV-relevant sections in a fixed,
+ * résumé-conventional order. It is a pure, deterministic selection-and-projection
+ * — no clock, no randomness, no I/O — so the static export ({@link
+ * import('@takuhon/cli')}) and a React `CvView` render identical output from the
+ * 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
+ * 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
+ * emptiness checks.
+ *
+ * The input must already be privacy-filtered (`applyPublicPrivacyFilter`) by the
+ * caller, exactly as the public render path is: `deriveCv` does not strip
+ * anything itself, it only projects what it is given.
+ */
+
+/** The header block of a CV: identity and contact, drawn from `profile` + `contact`. */
+interface CvHeader {
+    displayName: string;
+    tagline?: string;
+    /** Human-readable location (the address `display` string), if present. */
+    location?: string;
+    bio?: string;
+    /** Email, only when the profile exposed it (privacy filter already applied). */
+    email?: string;
+    formUrl?: string;
+}
+/**
+ * One CV section, discriminated by `kind`, carrying the locale-resolved entries
+ * for that section. The entry types are reused verbatim from `LocalizedTakuhon`.
+ */
+type CvSection = {
+    kind: 'experience';
+    entries: LocalizedCareer[];
+} | {
+    kind: 'education';
+    entries: LocalizedEducation[];
+} | {
+    kind: 'skills';
+    entries: Skill[];
+} | {
+    kind: 'certifications';
+    entries: LocalizedCertification[];
+} | {
+    kind: 'publications';
+    entries: LocalizedPublication[];
+} | {
+    kind: 'honors';
+    entries: LocalizedHonor[];
+} | {
+    kind: 'courses';
+    entries: LocalizedCourse[];
+} | {
+    kind: 'patents';
+    entries: LocalizedPatent[];
+} | {
+    kind: 'languages';
+    entries: LocalizedLanguage[];
+} | {
+    kind: 'volunteering';
+    entries: LocalizedVolunteering[];
+} | {
+    kind: 'memberships';
+    entries: LocalizedMembership[];
+};
+/** Every `CvSection` discriminant, in the fixed résumé order `deriveCv` emits. */
+type CvSectionKind = CvSection['kind'];
+/** A résumé/CV view derived from a profile: a header plus ordered sections. */
+interface CvDocument {
+    /** The locale this CV was resolved at (mirrors `LocalizedTakuhon.resolvedLocale`). */
+    resolvedLocale: string;
+    header: CvHeader;
+    /** Non-empty sections only, in the fixed CV order. */
+    sections: CvSection[];
+}
+/**
+ * Project a locale-resolved profile into a {@link CvDocument}. Sections appear
+ * in a fixed résumé-conventional order and empty ones are omitted; entry order
+ * within each section is preserved from the input. Pure and deterministic.
+ */
+declare function deriveCv(localized: LocalizedTakuhon): CvDocument;
+
 /**
  * Image-asset helpers for uploaded media (avatars, project images): magic-byte
  * type detection, header-only dimension / frame reading, and metadata stripping
@@ -3812,4 +3901,4 @@ declare function stripImageMetadata(bytes: Uint8Array, mime: AcceptedImageMime):
  */
 declare const SCHEMA_VERSION = "0.5.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 Education, type ExportOptions, type ExportedTakuhon, type Honor, IMAGE_EXTENSIONS, type ImageInfo, ImportError, type Iso3166Alpha2, type IsoDateTime, 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, type Membership, type Meta, type MetaPrivacy, type Migration, MigrationError, type NormalizedTakuhon, NotFoundError, 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, 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, deriveRankTier, detectImageMime, exportTakuhon, formatCodingTime, generateJsonLd, generatePersonJsonLd, generateProfilePageJsonLd, importTakuhon, isActivitySnapshot, migrateTakuhon, migrations, normalize, readImageInfo, 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, type Education, type ExportOptions, type ExportedTakuhon, type Honor, IMAGE_EXTENSIONS, type ImageInfo, ImportError, type Iso3166Alpha2, type IsoDateTime, 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, type Membership, type Meta, type MetaPrivacy, type Migration, MigrationError, type NormalizedTakuhon, NotFoundError, 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, 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, exportTakuhon, formatCodingTime, generateJsonLd, generatePersonJsonLd, generateProfilePageJsonLd, importTakuhon, isActivitySnapshot, migrateTakuhon, migrations, normalize, readImageInfo, renderActivitySvg, resolveLocale, schema, stripImageMetadata, validate };

package/dist/index.js

@@ -11558,6 +11558,35 @@ function renderActivitySvg(snapshot) {
   return `<svg xmlns="http://www.w3.org/2000/svg" width="${String(WIDTH)}" height="${String(height)}" viewBox="0 0 ${String(WIDTH)} ${String(height)}" role="img" aria-label="Developer activity"><title>Developer activity</title>${parts.join("")}</svg>`;
 }
 
+// src/cv.ts
+function deriveCv(localized) {
+  const p = localized.profile;
+  const header = { displayName: p.displayName };
+  if (p.tagline !== void 0) header.tagline = p.tagline;
+  if (p.location?.display !== void 0) header.location = p.location.display;
+  if (p.bio !== void 0) header.bio = p.bio;
+  if (localized.contact.email !== void 0) header.email = localized.contact.email;
+  if (localized.contact.formUrl !== void 0) header.formUrl = localized.contact.formUrl;
+  const candidates = [
+    { kind: "experience", entries: localized.careers },
+    { kind: "education", entries: localized.education },
+    { kind: "skills", entries: localized.skills },
+    { kind: "certifications", entries: localized.certifications },
+    { kind: "publications", entries: localized.publications },
+    { kind: "honors", entries: localized.honors },
+    { kind: "courses", entries: localized.courses },
+    { kind: "patents", entries: localized.patents },
+    { kind: "languages", entries: localized.languages },
+    { kind: "volunteering", entries: localized.volunteering },
+    { kind: "memberships", entries: localized.memberships }
+  ];
+  return {
+    resolvedLocale: localized.resolvedLocale,
+    header,
+    sections: candidates.filter((section) => section.entries.length > 0)
+  };
+}
+
 // src/image.ts
 var ACCEPTED_IMAGE_MIME_TYPES = [
   "image/jpeg",
@@ -11908,6 +11937,7 @@ export {
   StorageError,
   applyPublicPrivacyFilter,
   computeLanguagePercentages,
+  deriveCv,
   deriveRankTier,
   detectImageMime,
   exportTakuhon,