@takuhon/ui 0.11.0 → 0.13.0

package/dist/index.d.ts

@@ -1,9 +1,50 @@
-import { LocalizedTakuhon, LocalizedProfile, LocalizedLink, LocaleTag, LocalizedCareer, LocalizedEducation, LocalizedCertification, LocalizedMembership, LocalizedVolunteering, LocalizedHonor, LocalizedRecommendation, LocalizedPublication, LocalizedLanguage, LocalizedTestScore, LocalizedCourse, LocalizedPatent, LocalizedProject, Skill, Contact } from '@takuhon/core';
+import { LocalizedTakuhon, ActivitySnapshot, LocaleTag, CvDocument, LocalizedProfile, LocalizedLink, LocalizedCareer, LocalizedEducation, LocalizedCertification, LocalizedMembership, LocalizedVolunteering, LocalizedHonor, LocalizedRecommendation, LocalizedPublication, LocalizedLanguage, LocalizedTestScore, LocalizedCourse, LocalizedPatent, LocalizedProject, Skill, Contact } from '@takuhon/core';
 
 interface TakuhonProfileProps {
     data: LocalizedTakuhon;
-}
-declare function TakuhonProfile({ data }: TakuhonProfileProps): React.JSX.Element;
+    /**
+     * Synced developer-activity snapshot (a sibling document, fetched by the
+     * host — e.g. `GET /api/activity`). Rendered only while
+     * `settings.activity.enabled` is true, the same opt-in gate the API and the
+     * static export apply, so disabling the feature drops the section even if a
+     * stale snapshot is still supplied.
+     */
+    activitySnapshot?: ActivitySnapshot | null;
+}
+declare function TakuhonProfile({ data, activitySnapshot }: TakuhonProfileProps): React.JSX.Element;
+
+interface ActivitySectionProps {
+    /**
+     * The synced developer-activity snapshot (a sibling document, not part of
+     * `LocalizedTakuhon`). Hosts fetch it themselves — `GET /api/activity` on a
+     * deployment, or the `activity.json` beside the profile locally.
+     */
+    snapshot?: ActivitySnapshot | null;
+    locale?: LocaleTag;
+}
+/**
+ * Developer-activity section: the same self-owned inline-SVG card the static
+ * export renders, generated by `@takuhon/core`'s `renderActivitySvg` so the
+ * two surfaces cannot drift. Renders nothing without a snapshot (or with one
+ * that carries no metric data) — the section degrades away gracefully.
+ */
+declare function ActivitySection({ snapshot, locale, }: ActivitySectionProps): React.JSX.Element | null;
+
+interface CvViewProps {
+    /** The CV projection from `@takuhon/core`'s `deriveCv` (already privacy-filtered upstream). */
+    cv: CvDocument;
+    /** Locale for headings and dates; defaults to the CV's resolved locale. */
+    locale?: LocaleTag;
+}
+/**
+ * Print-ready résumé/CV view, the React counterpart of the CLI's `renderCvHtml`.
+ * Renders a {@link CvDocument} (from `@takuhon/core`'s `deriveCv`) as an A4
+ * single-column document; the co-located CSS module carries an `@media print`
+ * block so the browser's "Save as PDF" yields a clean résumé. This is a
+ * presentational component (it shows what `deriveCv` gives it, which the host
+ * has already privacy-filtered) and renders nothing for an empty CV.
+ */
+declare function CvView({ cv, locale }: CvViewProps): React.JSX.Element | null;
 
 interface ProfileHeaderProps {
     profile: LocalizedProfile;
@@ -124,4 +165,4 @@ interface TakuhonHeadProps {
 }
 declare function TakuhonHead({ data, siteUrl, pageUrl }: TakuhonHeadProps): React.JSX.Element;
 
-export { CareerTimeline, type CareerTimelineProps, Certifications, type CertificationsProps, ContactInfo, type ContactInfoProps, Courses, type CoursesProps, EducationTimeline, type EducationTimelineProps, Footer, HonorsList, type HonorsListProps, Languages, type LanguagesProps, LinksList, type LinksListProps, LocaleSwitcher, type LocaleSwitcherProps, Memberships, type MembershipsProps, Patents, type PatentsProps, ProfileHeader, type ProfileHeaderProps, ProjectsList, type ProjectsListProps, Publications, type PublicationsProps, Recommendations, type RecommendationsProps, SkillsList, type SkillsListProps, TakuhonHead, type TakuhonHeadProps, TakuhonProfile, type TakuhonProfileProps, TestScores, type TestScoresProps, Volunteering, type VolunteeringProps };
+export { ActivitySection, type ActivitySectionProps, CareerTimeline, type CareerTimelineProps, Certifications, type CertificationsProps, ContactInfo, type ContactInfoProps, Courses, type CoursesProps, CvView, type CvViewProps, EducationTimeline, type EducationTimelineProps, Footer, HonorsList, type HonorsListProps, Languages, type LanguagesProps, LinksList, type LinksListProps, LocaleSwitcher, type LocaleSwitcherProps, Memberships, type MembershipsProps, Patents, type PatentsProps, ProfileHeader, type ProfileHeaderProps, ProjectsList, type ProjectsListProps, Publications, type PublicationsProps, Recommendations, type RecommendationsProps, SkillsList, type SkillsListProps, TakuhonHead, type TakuhonHeadProps, TakuhonProfile, type TakuhonProfileProps, TestScores, type TestScoresProps, Volunteering, type VolunteeringProps };