@singi-labs/sifa-sdk 0.12.0 → 0.12.2

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { P as ProfileSkill, b as ProfilePresentationDelivery, L as LocationValue, c as PdsProviderInfo, d as Profile } from './adult-content-BO4nea-m.cjs';
-export { e as ADULT_CONTENT_LABELS, f as ActiveApp, a as ActivityLabel, A as AdultContentLabel, C as CoSpeaker, g as Endorsement, h as EndorsementData, E as ExternalAccount, i as ExternalAccountKeytraceClaim, F as FeedItem, j as LanguageProficiency, k as PresentationLinkView, l as ProfileCertification, m as ProfileCourse, n as ProfileEducation, o as ProfileHonor, p as ProfileIndustry, q as ProfileInvolvement, r as ProfileInvolvementLink, s as ProfileLanguage, t as ProfileLocation, u as ProfileOverrideSource, v as ProfilePosition, w as ProfilePresentation, x as ProfileProject, y as ProfilePublication, z as ProfileVolunteering, B as PublicationContributor, D as SkillRef, S as SkillSuggestion, T as TrustStat, V as VerifiedAccount, G as hasAdultContent } from './adult-content-BO4nea-m.cjs';
+import { P as ProfileSkill, b as ProfilePresentationDelivery, L as LocationValue, c as PdsProviderInfo, d as Profile, e as ProfilePosition, f as ProfileCertification, g as ProfileEducation, h as ProfileHonor, i as ProfileLanguage, j as ProfileProject, k as ProfilePublication, l as ProfileInvolvement } from './adult-content-DDGP8W1e.cjs';
+export { m as ADULT_CONTENT_LABELS, n as ActiveApp, a as ActivityLabel, A as AdultContentLabel, C as CoSpeaker, o as Endorsement, p as EndorsementData, E as ExternalAccount, q as ExternalAccountKeytraceClaim, F as FeedItem, r as LanguageProficiency, s as PresentationLinkView, t as ProfileCourse, u as ProfileIndustry, v as ProfileInvolvementLink, w as ProfileLocation, x as ProfileOverrideSource, y as ProfilePresentation, z as ProfileVolunteering, B as PublicationContributor, D as SkillRef, S as SkillSuggestion, T as TrustStat, V as VerifiedAccount, G as hasAdultContent } from './adult-content-DDGP8W1e.cjs';
 import { PresentationDuration, ProfilePresentationDeliveryRecord, ProfilePresentationRecord } from './schemas/index.cjs';
 export { ArtifactLink, ArtifactLinkSchema, EndorsementConfirmationRecord, EndorsementConfirmationRecordSchema, EndorsementRecord, EndorsementRecordSchema, GraphFollowRecord, GraphFollowRecordSchema, PROFILE_INVOLVEMENT_NSID, PresentationDurationSchema, PresentationLink, PresentationLinkSchema, ProfileCertificationRecord, ProfileCertificationRecordSchema, ProfileCourseRecord, ProfileCourseRecordSchema, ProfileEducationRecord, ProfileEducationRecordSchema, ProfileExternalAccountRecord, ProfileExternalAccountRecordSchema, ProfileHonorRecord, ProfileHonorRecordSchema, ProfileInvolvementRecord, ProfileInvolvementRecordSchema, ProfileLanguageRecord, ProfileLanguageRecordSchema, ProfilePositionRecord, ProfilePositionRecordSchema, ProfilePresentationDeliveryRecordSchema, ProfilePresentationRecordSchema, ProfileProjectRecord, ProfileProjectRecordSchema, ProfilePublicationRecord, ProfilePublicationRecordSchema, ProfileSelfRecord, ProfileSelfRecordSchema, ProfileSkillRecord, ProfileSkillRecordSchema, ProfileVolunteeringRecord, ProfileVolunteeringRecordSchema, PublicationAuthor, PublicationAuthorSchema, atUriSchema, cidSchema, datetimeSchema, didSchema, externalRecordRefSchema, languageTagSchema, makeGraphFollowRecordSchema, maxGraphemes, partialDateSchema, selfLabelsSchema, strongRefSchema, uriSchema } from './schemas/index.cjs';
 import { E as EntitySearchResult } from './feed-D2ZV8Eaj.cjs';
@@ -653,6 +653,17 @@ declare function formatRelativeTime(dateString: string): string;
  */
 declare function formatPresentationDuration(duration: PresentationDuration | undefined | null): string | undefined;
 
+/**
+ * Server-safe timeline date formatters shared by every profile surface.
+ */
+/** Format "2007-01" as "Jan 2007", pass through year-only strings. */
+declare function formatTimelineDate(dateStr: string): string;
+/**
+ * Format a date range for display. Handles missing dates, equal start/end,
+ * and ongoing entries (showPresent defaults to true).
+ */
+declare function formatDateRange(start?: string, end?: string, showPresent?: boolean): string;
+
 /** A compact roll-up of a presentation's deliveries for the collapsed view. */
 interface PresentationDeliverySummary {
     /** Times the talk was actually delivered (cancelled occasions excluded). */
@@ -1258,6 +1269,205 @@ declare function classifyEntityRef(entityRef: string | null | undefined): Entity
 /** Whether a position carries a durable link of any anchor quality. */
 declare function isLinked(entityRef: string | null | undefined): boolean;
 
+/**
+ * Shared, single-source-of-truth model for which profile sections render, in
+ * what order, their nav grouping, and which items a given viewer may see.
+ *
+ * Every Sifa profile surface builds on this: the HTML profile page, the
+ * Markdown / DOCX / print exports, and the standalone personal-site renderer.
+ * Adding a section to {@link ALL_SECTIONS} makes it appear everywhere (the
+ * exports drive presence + order from here, and {@link SECTION_LABELS} is an
+ * exhaustive `Record<SectionId, string>`, so a new id is a compile error until
+ * it has a label).
+ *
+ * The per-section sorts live in `./section-sorts.js`, built on the same SDK
+ * date extractors the HTML section components use, so the surfaces cannot
+ * diverge on ordering.
+ */
+
+/**
+ * Side-nav groups, in display order. Each labels a contiguous run of sections
+ * in {@link ALL_SECTIONS}. `labelKey` resolves against the consumer's `sections`
+ * i18n namespace.
+ */
+declare const SECTION_GROUPS: readonly [{
+    readonly id: "overview";
+    readonly labelKey: "groupOverview";
+}, {
+    readonly id: "experience";
+    readonly labelKey: "groupExperience";
+}, {
+    readonly id: "qualifications";
+    readonly labelKey: "groupQualifications";
+}, {
+    readonly id: "more";
+    readonly labelKey: "groupMore";
+}];
+type SectionGroupId = (typeof SECTION_GROUPS)[number]['id'];
+/**
+ * Profile body sections in render + nav order (evidence-first): identity and
+ * activity lead, then living work (career, skills, projects, talks,
+ * publications), then the formal record (credentials, education, courses), then
+ * the rest. `ns` selects the consumer's i18n namespace for `labelKey`; `group`
+ * ties the section to a {@link SECTION_GROUPS} header.
+ */
+declare const ALL_SECTIONS: readonly [{
+    readonly id: "about";
+    readonly labelKey: "about";
+    readonly ns: "profile";
+    readonly group: "overview";
+}, {
+    readonly id: "career";
+    readonly labelKey: "career";
+    readonly ns: "sections";
+    readonly group: "experience";
+}, {
+    readonly id: "skills";
+    readonly labelKey: "skills";
+    readonly ns: "sections";
+    readonly group: "experience";
+}, {
+    readonly id: "projects";
+    readonly labelKey: "projects";
+    readonly ns: "sections";
+    readonly group: "experience";
+}, {
+    readonly id: "presentations";
+    readonly labelKey: "talksAndSessions";
+    readonly ns: "sections";
+    readonly group: "experience";
+}, {
+    readonly id: "publications";
+    readonly labelKey: "publications";
+    readonly ns: "sections";
+    readonly group: "experience";
+}, {
+    readonly id: "credentials";
+    readonly labelKey: "credentials";
+    readonly ns: "sections";
+    readonly group: "qualifications";
+}, {
+    readonly id: "education";
+    readonly labelKey: "education";
+    readonly ns: "sections";
+    readonly group: "qualifications";
+}, {
+    readonly id: "courses";
+    readonly labelKey: "courses";
+    readonly ns: "sections";
+    readonly group: "qualifications";
+}, {
+    readonly id: "awards";
+    readonly labelKey: "awards";
+    readonly ns: "sections";
+    readonly group: "more";
+}, {
+    readonly id: "involvement";
+    readonly labelKey: "involvement";
+    readonly ns: "sections";
+    readonly group: "more";
+}, {
+    readonly id: "languages";
+    readonly labelKey: "languages";
+    readonly ns: "sections";
+    readonly group: "more";
+}, {
+    readonly id: "other-profiles";
+    readonly labelKey: "otherProfiles";
+    readonly ns: "sections";
+    readonly group: "more";
+}];
+/** Every profile section id, in canonical render order. */
+type SectionId = (typeof ALL_SECTIONS)[number]['id'];
+/** Whether a section has content for a given profile (used to hide empty nav entries for visitors). */
+declare function isSectionPopulated(profile: Profile, id: string): boolean;
+/**
+ * The section ids a given viewer should see, in {@link ALL_SECTIONS} order.
+ * Owners see every section; visitors only see populated ones.
+ */
+declare function getVisibleSectionIds(profile: Profile, isOwnProfile: boolean): SectionId[];
+/** Drop items the owner has hidden from visitors. */
+declare function filterHidden<T extends {
+    hidden?: boolean;
+}>(items: T[] | undefined): T[];
+/**
+ * Items visible to a given viewer: owners see their own hidden items, visitors
+ * do not. Shared by every export format (markdown, docx, print) and the public
+ * `.md` route so the hidden rule lives in one place.
+ */
+declare function visibleItems<T extends {
+    hidden?: boolean;
+}>(items: T[] | undefined, isOwnProfile: boolean): T[];
+/**
+ * English heading text for each section, keyed by {@link SectionId} (e.g.
+ * `other-profiles` renders as "Links"). Exhaustive `Record<SectionId, string>`:
+ * adding a section to {@link ALL_SECTIONS} without a label here is a compile
+ * error, so a section can never silently render without (or with a stale)
+ * heading. Consumers with i18n resolve their own localized labels via
+ * `labelKey`; this is the canonical English fallback used by the exports.
+ */
+declare const SECTION_LABELS: Record<SectionId, string>;
+
+/**
+ * Per-section item sorts, shared by every profile surface so ordering can't
+ * diverge between the HTML page and the Markdown / DOCX / print exports and the
+ * standalone personal-site renderer. Thin wrappers over the SDK date extractors
+ * plus the range/language sorts in this directory.
+ */
+
+/**
+ * Move a `primary && !endedAt` position to the top, matching the HTML career
+ * section, so the current primary role always leads.
+ */
+declare function hoistPrimary(positions: ProfilePosition[]): ProfilePosition[];
+declare const sortPositions: (items: ProfilePosition[]) => ProfilePosition[];
+declare const sortEducation: (items: ProfileEducation[]) => ProfileEducation[];
+declare const sortProjects: (items: ProfileProject[]) => ProfileProject[];
+declare const sortPublications: (items: ProfilePublication[]) => ProfilePublication[];
+declare const sortCertifications: (items: ProfileCertification[]) => ProfileCertification[];
+declare const sortHonors: (items: ProfileHonor[]) => ProfileHonor[];
+declare const sortLanguages: (items: ProfileLanguage[]) => ProfileLanguage[];
+
+/**
+ * Sort items by date range, floating ongoing entries (startDate present, endDate
+ * absent) to the top. Items with no dates sink to the bottom.
+ *
+ * Used by sections whose lexicons have no explicit `current` flag -- ongoing is
+ * implicit from a missing endDate. Without this wrapper, the shared
+ * `dateRangeExtractor` reads `item.current` (always undefined for these items)
+ * and sinks ongoing entries below completed ones.
+ *
+ * Sections using lexicon-aligned `startedAt`/`endedAt` fields (positions,
+ * education) should use `lexiconDateExtractor` instead -- that extractor already
+ * derives `current` correctly.
+ */
+declare function sortByActiveDateRange<T extends {
+    startDate?: string;
+    endDate?: string;
+}>(items: T[]): T[];
+
+/** Sort languages by proficiency (native first), then alphabetically within a rank. */
+declare function sortLanguagesByProficiency<T extends {
+    language?: string;
+    proficiency?: string;
+}>(items: T[]): T[];
+
+/**
+ * Fixed display order of involvement headings. A group renders only when it has
+ * records. Charity + mapped legacy volunteering fall under "Volunteering".
+ */
+declare const INVOLVEMENT_HEADING_ORDER: readonly ["Open Source", "Community", "Volunteering", "Civic", "Other"];
+interface InvolvementGroup {
+    heading: string;
+    items: ProfileInvolvement[];
+}
+/**
+ * Group involvement records by their kind's display heading, in the fixed order
+ * above, most-recent first within a group. Empty groups are omitted. An unknown
+ * kind falls under "Other" (via the shared heading map).
+ */
+declare function groupInvolvementByHeading(items: ProfileInvolvement[]): InvolvementGroup[];
+
 /**
  * Sifa SDK -- public client library for the Sifa AppView on AT Protocol.
  *
@@ -1267,4 +1477,4 @@ declare function isLinked(entityRef: string | null | undefined): boolean;
  */
 declare const SIFA_SDK_VERSION: string;
 
-export { ACTIVITY_TIERS, ACTIVITY_VISIBILITY_RULES, APP_CATEGORIES, APP_CATEGORY_IDS, APP_CATEGORY_MAP, APP_URL_PATTERNS, ARTIFACT_LINK_KIND_LABELS, ARTIFACT_LINK_KIND_OPTIONS, type AccountVerification, type ActivityItemForUrl, type ActivityTaxonomy, type ActivityTier, type AppCategoryId, type AppUrlPatterns, type ArtifactLinkKindOption, CALENDAR_EVENT_MODE_LABELS, CALENDAR_EVENT_STATUS_LABELS, CATEGORY_LABELS, CATEGORY_ORDER, COLLECTION_TO_APP, COMPANY_OPTIONAL_EMPLOYMENT_TYPES, COMPLETENESS_MAX_SCORE, CONTINENTS, COUNTRIES, type CardHealth, type CardHealthStrategy, type ContinentCode, type CsvRow, DIMENSIONS_MAX_SCORE, type DimensionKey, type DimensionMap, type DisambiguationFields, EMPLOYMENT_TYPE_GROUPS, EMPLOYMENT_TYPE_LABELS, ENTITY_REF_ANCHORS, type EmploymentTypeGroup, type EmploymentTypeOption, type EntityRefAnchor, EntitySearchResult, INDUSTRY_OPTIONS, INVOLVEMENT_KIND_HEADINGS, INVOLVEMENT_KIND_LABELS, INVOLVEMENT_KIND_OPTIONS, type IndustryOption, type InvolvementKindOption, type KnownAppId, type LexiconEntry, LocationValue, MIN_SKILLS, type MergedProfileSkill, OPEN_TO_OPTIONS, OPEN_TO_TOKENS, OPEN_TO_TOKEN_TO_VALUE, OPEN_TO_VALUE_TO_TOKEN, type OpenToGroup, type OpenToOption, PLATFORM_LABELS, PLATFORM_OPTIONS, PRESENTATION_LINK_TYPE_LABELS, PRESENTATION_LINK_TYPE_OPTIONS, PRESENTATION_ROLE_LABELS, PRESENTATION_ROLE_OPTIONS, PUBLISHERS, type ParsedDelivery, type ParsedPresentation, type PdsProvider, PdsProviderInfo, type PlatformId, type PresentationDeliverySummary, PresentationDuration, type PresentationLinkTypeOption, type PresentationRoleOption, type PrimaryPositionCandidate, Profile, type ProfileCompletion, type ProfileDimensionInputs, ProfilePresentationDelivery, ProfilePresentationDeliveryRecord, ProfilePresentationRecord, ProfileSkill, type Publisher, type RgbColor, SIFA_SDK_VERSION, SKILL_CATEGORIES, STANDARD_PUBLISHER_ID, type SkillCategory, type TierMeta, VERIFICATION_PROVIDERS, type VerificationProvider, type VerificationProviderId, type VerificationSource, WORKPLACE_TYPE_LABELS, WORKPLACE_TYPE_OPTIONS, type WorkplaceTypeOption, categoryForApp, certDateExtractor, classifyEntityRef, completenessPercent, completenessScore, contrastRatio, countFilledDimensions, countryCodeToFlag, dateRangeExtractor, dedupeSkills, detectPdsProvider, dimensionsFromInputs, durationFromMinutes, entityDisambiguationLabel, entityResultKey, findIndustry, formatCompanyName, formatDistanceToNow, formatLocation, formatPresentationDuration, formatRelativeTime, getActivityTaxonomyVersion, getActivityTier, getAppCategoryIcon, getAppIdForCollection, getArtifactLinkKindLabel, getCalendarEventModeLabel, getCalendarEventStatusLabel, getContinent, getDisplayLabel, getEmploymentTypeLabel, getFaviconUrl, getFilledDimensionsMap, getHandleStem, getIndustryLabelKey, getInvolvementKindHeading, getInvolvementKindLabel, getLexiconEntry, getOpenToLabelKey, getPdsDisplayName, getPlatformLabel, getPresentationLinkTypeLabel, getPresentationRoleLabel, getPublisherByHost, getPublisherById, getPublisherFromSiteUrl, getTierMeta, getVerificationProvider, getWorkplaceTypeLabel, groupSkillsByCategory, isAppCategory, isCompanyRequired, isKnownAppId, isKnownPlatform, isKnownVerificationProvider, isLinked, isPseudoEmployer, isValidRgbColor, isVisibleActivityItem, lexiconDateExtractor, limitCombiningMarks, looksLikeDomain, meetsContrastAA, normalizeCompanyKey, normalizeLegalForm, normalizeOpenTo, normalizePlatformId, normalizePresentationMode, normalizePresentationRole, normalizeWorkplaceTypes, openToTokenToValue, openToValueToToken, parseIntendedAudiences, parseLocationString, parsePresentationDuration, pdsProviderFromApi, pickPrimaryPosition, presentationCsvRowToRecord, presentationDeliveryCsvRowToRecord, primaryVerification, profileToDimensionInputs, relativeLuminance, resolveCardHealth, resolveCardUrl, resolveVerifierProvider, rgbToString, sanitizeDisplayText, sanitizeHandleInput, searchResultDisambiguation, singleDateExtractor, sortByDateDesc, stripHtmlToText, summarizePresentationDeliveries, truncateGraphemes };
+export { ACTIVITY_TIERS, ACTIVITY_VISIBILITY_RULES, ALL_SECTIONS, APP_CATEGORIES, APP_CATEGORY_IDS, APP_CATEGORY_MAP, APP_URL_PATTERNS, ARTIFACT_LINK_KIND_LABELS, ARTIFACT_LINK_KIND_OPTIONS, type AccountVerification, type ActivityItemForUrl, type ActivityTaxonomy, type ActivityTier, type AppCategoryId, type AppUrlPatterns, type ArtifactLinkKindOption, CALENDAR_EVENT_MODE_LABELS, CALENDAR_EVENT_STATUS_LABELS, CATEGORY_LABELS, CATEGORY_ORDER, COLLECTION_TO_APP, COMPANY_OPTIONAL_EMPLOYMENT_TYPES, COMPLETENESS_MAX_SCORE, CONTINENTS, COUNTRIES, type CardHealth, type CardHealthStrategy, type ContinentCode, type CsvRow, DIMENSIONS_MAX_SCORE, type DimensionKey, type DimensionMap, type DisambiguationFields, EMPLOYMENT_TYPE_GROUPS, EMPLOYMENT_TYPE_LABELS, ENTITY_REF_ANCHORS, type EmploymentTypeGroup, type EmploymentTypeOption, type EntityRefAnchor, EntitySearchResult, INDUSTRY_OPTIONS, INVOLVEMENT_HEADING_ORDER, INVOLVEMENT_KIND_HEADINGS, INVOLVEMENT_KIND_LABELS, INVOLVEMENT_KIND_OPTIONS, type IndustryOption, type InvolvementGroup, type InvolvementKindOption, type KnownAppId, type LexiconEntry, LocationValue, MIN_SKILLS, type MergedProfileSkill, OPEN_TO_OPTIONS, OPEN_TO_TOKENS, OPEN_TO_TOKEN_TO_VALUE, OPEN_TO_VALUE_TO_TOKEN, type OpenToGroup, type OpenToOption, PLATFORM_LABELS, PLATFORM_OPTIONS, PRESENTATION_LINK_TYPE_LABELS, PRESENTATION_LINK_TYPE_OPTIONS, PRESENTATION_ROLE_LABELS, PRESENTATION_ROLE_OPTIONS, PUBLISHERS, type ParsedDelivery, type ParsedPresentation, type PdsProvider, PdsProviderInfo, type PlatformId, type PresentationDeliverySummary, PresentationDuration, type PresentationLinkTypeOption, type PresentationRoleOption, type PrimaryPositionCandidate, Profile, ProfileCertification, type ProfileCompletion, type ProfileDimensionInputs, ProfileEducation, ProfileHonor, ProfileInvolvement, ProfileLanguage, ProfilePosition, ProfilePresentationDelivery, ProfilePresentationDeliveryRecord, ProfilePresentationRecord, ProfileProject, ProfilePublication, ProfileSkill, type Publisher, type RgbColor, SECTION_GROUPS, SECTION_LABELS, SIFA_SDK_VERSION, SKILL_CATEGORIES, STANDARD_PUBLISHER_ID, type SectionGroupId, type SectionId, type SkillCategory, type TierMeta, VERIFICATION_PROVIDERS, type VerificationProvider, type VerificationProviderId, type VerificationSource, WORKPLACE_TYPE_LABELS, WORKPLACE_TYPE_OPTIONS, type WorkplaceTypeOption, categoryForApp, certDateExtractor, classifyEntityRef, completenessPercent, completenessScore, contrastRatio, countFilledDimensions, countryCodeToFlag, dateRangeExtractor, dedupeSkills, detectPdsProvider, dimensionsFromInputs, durationFromMinutes, entityDisambiguationLabel, entityResultKey, filterHidden, findIndustry, formatCompanyName, formatDateRange, formatDistanceToNow, formatLocation, formatPresentationDuration, formatRelativeTime, formatTimelineDate, getActivityTaxonomyVersion, getActivityTier, getAppCategoryIcon, getAppIdForCollection, getArtifactLinkKindLabel, getCalendarEventModeLabel, getCalendarEventStatusLabel, getContinent, getDisplayLabel, getEmploymentTypeLabel, getFaviconUrl, getFilledDimensionsMap, getHandleStem, getIndustryLabelKey, getInvolvementKindHeading, getInvolvementKindLabel, getLexiconEntry, getOpenToLabelKey, getPdsDisplayName, getPlatformLabel, getPresentationLinkTypeLabel, getPresentationRoleLabel, getPublisherByHost, getPublisherById, getPublisherFromSiteUrl, getTierMeta, getVerificationProvider, getVisibleSectionIds, getWorkplaceTypeLabel, groupInvolvementByHeading, groupSkillsByCategory, hoistPrimary, isAppCategory, isCompanyRequired, isKnownAppId, isKnownPlatform, isKnownVerificationProvider, isLinked, isPseudoEmployer, isSectionPopulated, isValidRgbColor, isVisibleActivityItem, lexiconDateExtractor, limitCombiningMarks, looksLikeDomain, meetsContrastAA, normalizeCompanyKey, normalizeLegalForm, normalizeOpenTo, normalizePlatformId, normalizePresentationMode, normalizePresentationRole, normalizeWorkplaceTypes, openToTokenToValue, openToValueToToken, parseIntendedAudiences, parseLocationString, parsePresentationDuration, pdsProviderFromApi, pickPrimaryPosition, presentationCsvRowToRecord, presentationDeliveryCsvRowToRecord, primaryVerification, profileToDimensionInputs, relativeLuminance, resolveCardHealth, resolveCardUrl, resolveVerifierProvider, rgbToString, sanitizeDisplayText, sanitizeHandleInput, searchResultDisambiguation, singleDateExtractor, sortByActiveDateRange, sortByDateDesc, sortCertifications, sortEducation, sortHonors, sortLanguages, sortLanguagesByProficiency, sortPositions, sortProjects, sortPublications, stripHtmlToText, summarizePresentationDeliveries, truncateGraphemes, visibleItems };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { P as ProfileSkill, b as ProfilePresentationDelivery, L as LocationValue, c as PdsProviderInfo, d as Profile } from './adult-content-BO4nea-m.js';
-export { e as ADULT_CONTENT_LABELS, f as ActiveApp, a as ActivityLabel, A as AdultContentLabel, C as CoSpeaker, g as Endorsement, h as EndorsementData, E as ExternalAccount, i as ExternalAccountKeytraceClaim, F as FeedItem, j as LanguageProficiency, k as PresentationLinkView, l as ProfileCertification, m as ProfileCourse, n as ProfileEducation, o as ProfileHonor, p as ProfileIndustry, q as ProfileInvolvement, r as ProfileInvolvementLink, s as ProfileLanguage, t as ProfileLocation, u as ProfileOverrideSource, v as ProfilePosition, w as ProfilePresentation, x as ProfileProject, y as ProfilePublication, z as ProfileVolunteering, B as PublicationContributor, D as SkillRef, S as SkillSuggestion, T as TrustStat, V as VerifiedAccount, G as hasAdultContent } from './adult-content-BO4nea-m.js';
+import { P as ProfileSkill, b as ProfilePresentationDelivery, L as LocationValue, c as PdsProviderInfo, d as Profile, e as ProfilePosition, f as ProfileCertification, g as ProfileEducation, h as ProfileHonor, i as ProfileLanguage, j as ProfileProject, k as ProfilePublication, l as ProfileInvolvement } from './adult-content-DDGP8W1e.js';
+export { m as ADULT_CONTENT_LABELS, n as ActiveApp, a as ActivityLabel, A as AdultContentLabel, C as CoSpeaker, o as Endorsement, p as EndorsementData, E as ExternalAccount, q as ExternalAccountKeytraceClaim, F as FeedItem, r as LanguageProficiency, s as PresentationLinkView, t as ProfileCourse, u as ProfileIndustry, v as ProfileInvolvementLink, w as ProfileLocation, x as ProfileOverrideSource, y as ProfilePresentation, z as ProfileVolunteering, B as PublicationContributor, D as SkillRef, S as SkillSuggestion, T as TrustStat, V as VerifiedAccount, G as hasAdultContent } from './adult-content-DDGP8W1e.js';
 import { PresentationDuration, ProfilePresentationDeliveryRecord, ProfilePresentationRecord } from './schemas/index.js';
 export { ArtifactLink, ArtifactLinkSchema, EndorsementConfirmationRecord, EndorsementConfirmationRecordSchema, EndorsementRecord, EndorsementRecordSchema, GraphFollowRecord, GraphFollowRecordSchema, PROFILE_INVOLVEMENT_NSID, PresentationDurationSchema, PresentationLink, PresentationLinkSchema, ProfileCertificationRecord, ProfileCertificationRecordSchema, ProfileCourseRecord, ProfileCourseRecordSchema, ProfileEducationRecord, ProfileEducationRecordSchema, ProfileExternalAccountRecord, ProfileExternalAccountRecordSchema, ProfileHonorRecord, ProfileHonorRecordSchema, ProfileInvolvementRecord, ProfileInvolvementRecordSchema, ProfileLanguageRecord, ProfileLanguageRecordSchema, ProfilePositionRecord, ProfilePositionRecordSchema, ProfilePresentationDeliveryRecordSchema, ProfilePresentationRecordSchema, ProfileProjectRecord, ProfileProjectRecordSchema, ProfilePublicationRecord, ProfilePublicationRecordSchema, ProfileSelfRecord, ProfileSelfRecordSchema, ProfileSkillRecord, ProfileSkillRecordSchema, ProfileVolunteeringRecord, ProfileVolunteeringRecordSchema, PublicationAuthor, PublicationAuthorSchema, atUriSchema, cidSchema, datetimeSchema, didSchema, externalRecordRefSchema, languageTagSchema, makeGraphFollowRecordSchema, maxGraphemes, partialDateSchema, selfLabelsSchema, strongRefSchema, uriSchema } from './schemas/index.js';
 import { E as EntitySearchResult } from './feed-D2ZV8Eaj.js';
@@ -653,6 +653,17 @@ declare function formatRelativeTime(dateString: string): string;
  */
 declare function formatPresentationDuration(duration: PresentationDuration | undefined | null): string | undefined;
 
+/**
+ * Server-safe timeline date formatters shared by every profile surface.
+ */
+/** Format "2007-01" as "Jan 2007", pass through year-only strings. */
+declare function formatTimelineDate(dateStr: string): string;
+/**
+ * Format a date range for display. Handles missing dates, equal start/end,
+ * and ongoing entries (showPresent defaults to true).
+ */
+declare function formatDateRange(start?: string, end?: string, showPresent?: boolean): string;
+
 /** A compact roll-up of a presentation's deliveries for the collapsed view. */
 interface PresentationDeliverySummary {
     /** Times the talk was actually delivered (cancelled occasions excluded). */
@@ -1258,6 +1269,205 @@ declare function classifyEntityRef(entityRef: string | null | undefined): Entity
 /** Whether a position carries a durable link of any anchor quality. */
 declare function isLinked(entityRef: string | null | undefined): boolean;
 
+/**
+ * Shared, single-source-of-truth model for which profile sections render, in
+ * what order, their nav grouping, and which items a given viewer may see.
+ *
+ * Every Sifa profile surface builds on this: the HTML profile page, the
+ * Markdown / DOCX / print exports, and the standalone personal-site renderer.
+ * Adding a section to {@link ALL_SECTIONS} makes it appear everywhere (the
+ * exports drive presence + order from here, and {@link SECTION_LABELS} is an
+ * exhaustive `Record<SectionId, string>`, so a new id is a compile error until
+ * it has a label).
+ *
+ * The per-section sorts live in `./section-sorts.js`, built on the same SDK
+ * date extractors the HTML section components use, so the surfaces cannot
+ * diverge on ordering.
+ */
+
+/**
+ * Side-nav groups, in display order. Each labels a contiguous run of sections
+ * in {@link ALL_SECTIONS}. `labelKey` resolves against the consumer's `sections`
+ * i18n namespace.
+ */
+declare const SECTION_GROUPS: readonly [{
+    readonly id: "overview";
+    readonly labelKey: "groupOverview";
+}, {
+    readonly id: "experience";
+    readonly labelKey: "groupExperience";
+}, {
+    readonly id: "qualifications";
+    readonly labelKey: "groupQualifications";
+}, {
+    readonly id: "more";
+    readonly labelKey: "groupMore";
+}];
+type SectionGroupId = (typeof SECTION_GROUPS)[number]['id'];
+/**
+ * Profile body sections in render + nav order (evidence-first): identity and
+ * activity lead, then living work (career, skills, projects, talks,
+ * publications), then the formal record (credentials, education, courses), then
+ * the rest. `ns` selects the consumer's i18n namespace for `labelKey`; `group`
+ * ties the section to a {@link SECTION_GROUPS} header.
+ */
+declare const ALL_SECTIONS: readonly [{
+    readonly id: "about";
+    readonly labelKey: "about";
+    readonly ns: "profile";
+    readonly group: "overview";
+}, {
+    readonly id: "career";
+    readonly labelKey: "career";
+    readonly ns: "sections";
+    readonly group: "experience";
+}, {
+    readonly id: "skills";
+    readonly labelKey: "skills";
+    readonly ns: "sections";
+    readonly group: "experience";
+}, {
+    readonly id: "projects";
+    readonly labelKey: "projects";
+    readonly ns: "sections";
+    readonly group: "experience";
+}, {
+    readonly id: "presentations";
+    readonly labelKey: "talksAndSessions";
+    readonly ns: "sections";
+    readonly group: "experience";
+}, {
+    readonly id: "publications";
+    readonly labelKey: "publications";
+    readonly ns: "sections";
+    readonly group: "experience";
+}, {
+    readonly id: "credentials";
+    readonly labelKey: "credentials";
+    readonly ns: "sections";
+    readonly group: "qualifications";
+}, {
+    readonly id: "education";
+    readonly labelKey: "education";
+    readonly ns: "sections";
+    readonly group: "qualifications";
+}, {
+    readonly id: "courses";
+    readonly labelKey: "courses";
+    readonly ns: "sections";
+    readonly group: "qualifications";
+}, {
+    readonly id: "awards";
+    readonly labelKey: "awards";
+    readonly ns: "sections";
+    readonly group: "more";
+}, {
+    readonly id: "involvement";
+    readonly labelKey: "involvement";
+    readonly ns: "sections";
+    readonly group: "more";
+}, {
+    readonly id: "languages";
+    readonly labelKey: "languages";
+    readonly ns: "sections";
+    readonly group: "more";
+}, {
+    readonly id: "other-profiles";
+    readonly labelKey: "otherProfiles";
+    readonly ns: "sections";
+    readonly group: "more";
+}];
+/** Every profile section id, in canonical render order. */
+type SectionId = (typeof ALL_SECTIONS)[number]['id'];
+/** Whether a section has content for a given profile (used to hide empty nav entries for visitors). */
+declare function isSectionPopulated(profile: Profile, id: string): boolean;
+/**
+ * The section ids a given viewer should see, in {@link ALL_SECTIONS} order.
+ * Owners see every section; visitors only see populated ones.
+ */
+declare function getVisibleSectionIds(profile: Profile, isOwnProfile: boolean): SectionId[];
+/** Drop items the owner has hidden from visitors. */
+declare function filterHidden<T extends {
+    hidden?: boolean;
+}>(items: T[] | undefined): T[];
+/**
+ * Items visible to a given viewer: owners see their own hidden items, visitors
+ * do not. Shared by every export format (markdown, docx, print) and the public
+ * `.md` route so the hidden rule lives in one place.
+ */
+declare function visibleItems<T extends {
+    hidden?: boolean;
+}>(items: T[] | undefined, isOwnProfile: boolean): T[];
+/**
+ * English heading text for each section, keyed by {@link SectionId} (e.g.
+ * `other-profiles` renders as "Links"). Exhaustive `Record<SectionId, string>`:
+ * adding a section to {@link ALL_SECTIONS} without a label here is a compile
+ * error, so a section can never silently render without (or with a stale)
+ * heading. Consumers with i18n resolve their own localized labels via
+ * `labelKey`; this is the canonical English fallback used by the exports.
+ */
+declare const SECTION_LABELS: Record<SectionId, string>;
+
+/**
+ * Per-section item sorts, shared by every profile surface so ordering can't
+ * diverge between the HTML page and the Markdown / DOCX / print exports and the
+ * standalone personal-site renderer. Thin wrappers over the SDK date extractors
+ * plus the range/language sorts in this directory.
+ */
+
+/**
+ * Move a `primary && !endedAt` position to the top, matching the HTML career
+ * section, so the current primary role always leads.
+ */
+declare function hoistPrimary(positions: ProfilePosition[]): ProfilePosition[];
+declare const sortPositions: (items: ProfilePosition[]) => ProfilePosition[];
+declare const sortEducation: (items: ProfileEducation[]) => ProfileEducation[];
+declare const sortProjects: (items: ProfileProject[]) => ProfileProject[];
+declare const sortPublications: (items: ProfilePublication[]) => ProfilePublication[];
+declare const sortCertifications: (items: ProfileCertification[]) => ProfileCertification[];
+declare const sortHonors: (items: ProfileHonor[]) => ProfileHonor[];
+declare const sortLanguages: (items: ProfileLanguage[]) => ProfileLanguage[];
+
+/**
+ * Sort items by date range, floating ongoing entries (startDate present, endDate
+ * absent) to the top. Items with no dates sink to the bottom.
+ *
+ * Used by sections whose lexicons have no explicit `current` flag -- ongoing is
+ * implicit from a missing endDate. Without this wrapper, the shared
+ * `dateRangeExtractor` reads `item.current` (always undefined for these items)
+ * and sinks ongoing entries below completed ones.
+ *
+ * Sections using lexicon-aligned `startedAt`/`endedAt` fields (positions,
+ * education) should use `lexiconDateExtractor` instead -- that extractor already
+ * derives `current` correctly.
+ */
+declare function sortByActiveDateRange<T extends {
+    startDate?: string;
+    endDate?: string;
+}>(items: T[]): T[];
+
+/** Sort languages by proficiency (native first), then alphabetically within a rank. */
+declare function sortLanguagesByProficiency<T extends {
+    language?: string;
+    proficiency?: string;
+}>(items: T[]): T[];
+
+/**
+ * Fixed display order of involvement headings. A group renders only when it has
+ * records. Charity + mapped legacy volunteering fall under "Volunteering".
+ */
+declare const INVOLVEMENT_HEADING_ORDER: readonly ["Open Source", "Community", "Volunteering", "Civic", "Other"];
+interface InvolvementGroup {
+    heading: string;
+    items: ProfileInvolvement[];
+}
+/**
+ * Group involvement records by their kind's display heading, in the fixed order
+ * above, most-recent first within a group. Empty groups are omitted. An unknown
+ * kind falls under "Other" (via the shared heading map).
+ */
+declare function groupInvolvementByHeading(items: ProfileInvolvement[]): InvolvementGroup[];
+
 /**
  * Sifa SDK -- public client library for the Sifa AppView on AT Protocol.
  *
@@ -1267,4 +1477,4 @@ declare function isLinked(entityRef: string | null | undefined): boolean;
  */
 declare const SIFA_SDK_VERSION: string;
 
-export { ACTIVITY_TIERS, ACTIVITY_VISIBILITY_RULES, APP_CATEGORIES, APP_CATEGORY_IDS, APP_CATEGORY_MAP, APP_URL_PATTERNS, ARTIFACT_LINK_KIND_LABELS, ARTIFACT_LINK_KIND_OPTIONS, type AccountVerification, type ActivityItemForUrl, type ActivityTaxonomy, type ActivityTier, type AppCategoryId, type AppUrlPatterns, type ArtifactLinkKindOption, CALENDAR_EVENT_MODE_LABELS, CALENDAR_EVENT_STATUS_LABELS, CATEGORY_LABELS, CATEGORY_ORDER, COLLECTION_TO_APP, COMPANY_OPTIONAL_EMPLOYMENT_TYPES, COMPLETENESS_MAX_SCORE, CONTINENTS, COUNTRIES, type CardHealth, type CardHealthStrategy, type ContinentCode, type CsvRow, DIMENSIONS_MAX_SCORE, type DimensionKey, type DimensionMap, type DisambiguationFields, EMPLOYMENT_TYPE_GROUPS, EMPLOYMENT_TYPE_LABELS, ENTITY_REF_ANCHORS, type EmploymentTypeGroup, type EmploymentTypeOption, type EntityRefAnchor, EntitySearchResult, INDUSTRY_OPTIONS, INVOLVEMENT_KIND_HEADINGS, INVOLVEMENT_KIND_LABELS, INVOLVEMENT_KIND_OPTIONS, type IndustryOption, type InvolvementKindOption, type KnownAppId, type LexiconEntry, LocationValue, MIN_SKILLS, type MergedProfileSkill, OPEN_TO_OPTIONS, OPEN_TO_TOKENS, OPEN_TO_TOKEN_TO_VALUE, OPEN_TO_VALUE_TO_TOKEN, type OpenToGroup, type OpenToOption, PLATFORM_LABELS, PLATFORM_OPTIONS, PRESENTATION_LINK_TYPE_LABELS, PRESENTATION_LINK_TYPE_OPTIONS, PRESENTATION_ROLE_LABELS, PRESENTATION_ROLE_OPTIONS, PUBLISHERS, type ParsedDelivery, type ParsedPresentation, type PdsProvider, PdsProviderInfo, type PlatformId, type PresentationDeliverySummary, PresentationDuration, type PresentationLinkTypeOption, type PresentationRoleOption, type PrimaryPositionCandidate, Profile, type ProfileCompletion, type ProfileDimensionInputs, ProfilePresentationDelivery, ProfilePresentationDeliveryRecord, ProfilePresentationRecord, ProfileSkill, type Publisher, type RgbColor, SIFA_SDK_VERSION, SKILL_CATEGORIES, STANDARD_PUBLISHER_ID, type SkillCategory, type TierMeta, VERIFICATION_PROVIDERS, type VerificationProvider, type VerificationProviderId, type VerificationSource, WORKPLACE_TYPE_LABELS, WORKPLACE_TYPE_OPTIONS, type WorkplaceTypeOption, categoryForApp, certDateExtractor, classifyEntityRef, completenessPercent, completenessScore, contrastRatio, countFilledDimensions, countryCodeToFlag, dateRangeExtractor, dedupeSkills, detectPdsProvider, dimensionsFromInputs, durationFromMinutes, entityDisambiguationLabel, entityResultKey, findIndustry, formatCompanyName, formatDistanceToNow, formatLocation, formatPresentationDuration, formatRelativeTime, getActivityTaxonomyVersion, getActivityTier, getAppCategoryIcon, getAppIdForCollection, getArtifactLinkKindLabel, getCalendarEventModeLabel, getCalendarEventStatusLabel, getContinent, getDisplayLabel, getEmploymentTypeLabel, getFaviconUrl, getFilledDimensionsMap, getHandleStem, getIndustryLabelKey, getInvolvementKindHeading, getInvolvementKindLabel, getLexiconEntry, getOpenToLabelKey, getPdsDisplayName, getPlatformLabel, getPresentationLinkTypeLabel, getPresentationRoleLabel, getPublisherByHost, getPublisherById, getPublisherFromSiteUrl, getTierMeta, getVerificationProvider, getWorkplaceTypeLabel, groupSkillsByCategory, isAppCategory, isCompanyRequired, isKnownAppId, isKnownPlatform, isKnownVerificationProvider, isLinked, isPseudoEmployer, isValidRgbColor, isVisibleActivityItem, lexiconDateExtractor, limitCombiningMarks, looksLikeDomain, meetsContrastAA, normalizeCompanyKey, normalizeLegalForm, normalizeOpenTo, normalizePlatformId, normalizePresentationMode, normalizePresentationRole, normalizeWorkplaceTypes, openToTokenToValue, openToValueToToken, parseIntendedAudiences, parseLocationString, parsePresentationDuration, pdsProviderFromApi, pickPrimaryPosition, presentationCsvRowToRecord, presentationDeliveryCsvRowToRecord, primaryVerification, profileToDimensionInputs, relativeLuminance, resolveCardHealth, resolveCardUrl, resolveVerifierProvider, rgbToString, sanitizeDisplayText, sanitizeHandleInput, searchResultDisambiguation, singleDateExtractor, sortByDateDesc, stripHtmlToText, summarizePresentationDeliveries, truncateGraphemes };
+export { ACTIVITY_TIERS, ACTIVITY_VISIBILITY_RULES, ALL_SECTIONS, APP_CATEGORIES, APP_CATEGORY_IDS, APP_CATEGORY_MAP, APP_URL_PATTERNS, ARTIFACT_LINK_KIND_LABELS, ARTIFACT_LINK_KIND_OPTIONS, type AccountVerification, type ActivityItemForUrl, type ActivityTaxonomy, type ActivityTier, type AppCategoryId, type AppUrlPatterns, type ArtifactLinkKindOption, CALENDAR_EVENT_MODE_LABELS, CALENDAR_EVENT_STATUS_LABELS, CATEGORY_LABELS, CATEGORY_ORDER, COLLECTION_TO_APP, COMPANY_OPTIONAL_EMPLOYMENT_TYPES, COMPLETENESS_MAX_SCORE, CONTINENTS, COUNTRIES, type CardHealth, type CardHealthStrategy, type ContinentCode, type CsvRow, DIMENSIONS_MAX_SCORE, type DimensionKey, type DimensionMap, type DisambiguationFields, EMPLOYMENT_TYPE_GROUPS, EMPLOYMENT_TYPE_LABELS, ENTITY_REF_ANCHORS, type EmploymentTypeGroup, type EmploymentTypeOption, type EntityRefAnchor, EntitySearchResult, INDUSTRY_OPTIONS, INVOLVEMENT_HEADING_ORDER, INVOLVEMENT_KIND_HEADINGS, INVOLVEMENT_KIND_LABELS, INVOLVEMENT_KIND_OPTIONS, type IndustryOption, type InvolvementGroup, type InvolvementKindOption, type KnownAppId, type LexiconEntry, LocationValue, MIN_SKILLS, type MergedProfileSkill, OPEN_TO_OPTIONS, OPEN_TO_TOKENS, OPEN_TO_TOKEN_TO_VALUE, OPEN_TO_VALUE_TO_TOKEN, type OpenToGroup, type OpenToOption, PLATFORM_LABELS, PLATFORM_OPTIONS, PRESENTATION_LINK_TYPE_LABELS, PRESENTATION_LINK_TYPE_OPTIONS, PRESENTATION_ROLE_LABELS, PRESENTATION_ROLE_OPTIONS, PUBLISHERS, type ParsedDelivery, type ParsedPresentation, type PdsProvider, PdsProviderInfo, type PlatformId, type PresentationDeliverySummary, PresentationDuration, type PresentationLinkTypeOption, type PresentationRoleOption, type PrimaryPositionCandidate, Profile, ProfileCertification, type ProfileCompletion, type ProfileDimensionInputs, ProfileEducation, ProfileHonor, ProfileInvolvement, ProfileLanguage, ProfilePosition, ProfilePresentationDelivery, ProfilePresentationDeliveryRecord, ProfilePresentationRecord, ProfileProject, ProfilePublication, ProfileSkill, type Publisher, type RgbColor, SECTION_GROUPS, SECTION_LABELS, SIFA_SDK_VERSION, SKILL_CATEGORIES, STANDARD_PUBLISHER_ID, type SectionGroupId, type SectionId, type SkillCategory, type TierMeta, VERIFICATION_PROVIDERS, type VerificationProvider, type VerificationProviderId, type VerificationSource, WORKPLACE_TYPE_LABELS, WORKPLACE_TYPE_OPTIONS, type WorkplaceTypeOption, categoryForApp, certDateExtractor, classifyEntityRef, completenessPercent, completenessScore, contrastRatio, countFilledDimensions, countryCodeToFlag, dateRangeExtractor, dedupeSkills, detectPdsProvider, dimensionsFromInputs, durationFromMinutes, entityDisambiguationLabel, entityResultKey, filterHidden, findIndustry, formatCompanyName, formatDateRange, formatDistanceToNow, formatLocation, formatPresentationDuration, formatRelativeTime, formatTimelineDate, getActivityTaxonomyVersion, getActivityTier, getAppCategoryIcon, getAppIdForCollection, getArtifactLinkKindLabel, getCalendarEventModeLabel, getCalendarEventStatusLabel, getContinent, getDisplayLabel, getEmploymentTypeLabel, getFaviconUrl, getFilledDimensionsMap, getHandleStem, getIndustryLabelKey, getInvolvementKindHeading, getInvolvementKindLabel, getLexiconEntry, getOpenToLabelKey, getPdsDisplayName, getPlatformLabel, getPresentationLinkTypeLabel, getPresentationRoleLabel, getPublisherByHost, getPublisherById, getPublisherFromSiteUrl, getTierMeta, getVerificationProvider, getVisibleSectionIds, getWorkplaceTypeLabel, groupInvolvementByHeading, groupSkillsByCategory, hoistPrimary, isAppCategory, isCompanyRequired, isKnownAppId, isKnownPlatform, isKnownVerificationProvider, isLinked, isPseudoEmployer, isSectionPopulated, isValidRgbColor, isVisibleActivityItem, lexiconDateExtractor, limitCombiningMarks, looksLikeDomain, meetsContrastAA, normalizeCompanyKey, normalizeLegalForm, normalizeOpenTo, normalizePlatformId, normalizePresentationMode, normalizePresentationRole, normalizeWorkplaceTypes, openToTokenToValue, openToValueToToken, parseIntendedAudiences, parseLocationString, parsePresentationDuration, pdsProviderFromApi, pickPrimaryPosition, presentationCsvRowToRecord, presentationDeliveryCsvRowToRecord, primaryVerification, profileToDimensionInputs, relativeLuminance, resolveCardHealth, resolveCardUrl, resolveVerifierProvider, rgbToString, sanitizeDisplayText, sanitizeHandleInput, searchResultDisambiguation, singleDateExtractor, sortByActiveDateRange, sortByDateDesc, sortCertifications, sortEducation, sortHonors, sortLanguages, sortLanguagesByProficiency, sortPositions, sortProjects, sortPublications, stripHtmlToText, summarizePresentationDeliveries, truncateGraphemes, visibleItems };