@singi-labs/sifa-sdk 0.18.3 → 0.18.5

package/dist/resume/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/format/pds-utils.ts","../../src/profile/section-model.ts","../../src/jsonld/url.ts","../../src/resume/json-resume.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { PdsProviderInfo } from '../types/index.js';\n\nexport interface PdsProvider {\n  name: string;\n  profileUrl: string;\n  host?: string;\n}\n\nconst BSKY_PROFILE_BASE = 'https://bsky.app/profile/';\n\nconst PDS_PROVIDERS: { suffix: string; name: string }[] = [\n  { suffix: '.bsky.social', name: 'bluesky' },\n  { suffix: '.blacksky.app', name: 'blacksky' },\n  { suffix: '.eurosky.social', name: 'eurosky' },\n  { suffix: '.northsky.social', name: 'northsky' },\n];\n\nconst KNOWN_PROVIDER_NAMES = new Set(PDS_PROVIDERS.map((p) => p.name));\n\nconst ICON_ONLY_PROVIDERS = new Set(['selfhosted-social', 'selfhosted']);\n\nexport function pdsProviderFromApi(\n  apiProvider: PdsProviderInfo | null | undefined,\n  handle: string,\n): PdsProvider | null {\n  if (!apiProvider) return null;\n  if (ICON_ONLY_PROVIDERS.has(apiProvider.name)) {\n    return { name: apiProvider.name, profileUrl: '', host: apiProvider.host };\n  }\n  if (!KNOWN_PROVIDER_NAMES.has(apiProvider.name)) return null;\n  return {\n    name: apiProvider.name,\n    profileUrl: `${BSKY_PROFILE_BASE}${handle}`,\n    host: apiProvider.host,\n  };\n}\n\nexport function getHandleStem(handle: string): string {\n  const lower = handle.toLowerCase();\n  for (const provider of PDS_PROVIDERS) {\n    if (lower.endsWith(provider.suffix) && lower.length > provider.suffix.length) {\n      return handle.slice(0, -provider.suffix.length);\n    }\n  }\n  return handle;\n}\n\nexport function getDisplayLabel(displayName: string | undefined, handle: string): string {\n  if (displayName) return displayName;\n  return getHandleStem(handle);\n}\n\n/**\n * Combine optional structured name fields (`id.sifa.profile.self.givenName`,\n * `familyName`) into a single string in Schema.org `Person` order — given\n * before family. Returns `undefined` when both are absent so callers can\n * fall back to `displayName`. Whitespace-only inputs are treated as absent.\n * Does not impose cultural ordering: users whose preferred presentation\n * differs (e.g. Eastern name order) should set `displayName` accordingly,\n * which this helper deliberately does not consult.\n */\nexport function formatStructuredName(\n  givenName: string | undefined,\n  familyName: string | undefined,\n): string | undefined {\n  const given = givenName?.trim();\n  const family = familyName?.trim();\n  if (given && family) return `${given} ${family}`;\n  return given || family || undefined;\n}\n\nconst PDS_DISPLAY_NAMES: Record<string, string> = {\n  bluesky: 'Bluesky',\n  blacksky: 'BlackSky',\n  eurosky: 'EuroSky',\n  northsky: 'NorthSky',\n  'selfhosted-social': 'Self-hosted',\n  selfhosted: 'Self-hosted',\n};\n\nexport function getPdsDisplayName(providerName: string): string {\n  return PDS_DISPLAY_NAMES[providerName] ?? providerName;\n}\n\nexport function detectPdsProvider(handle: string): PdsProvider | null {\n  const lower = handle.toLowerCase();\n  for (const provider of PDS_PROVIDERS) {\n    if (lower.endsWith(provider.suffix)) {\n      return {\n        name: provider.name,\n        profileUrl: `${BSKY_PROFILE_BASE}${handle}`,\n      };\n    }\n  }\n  return null;\n}\n","/**\n * Shared, single-source-of-truth model for which profile sections render, in\n * what order, their nav grouping, and which items a given viewer may see.\n *\n * Every Sifa profile surface builds on this: the HTML profile page, the\n * Markdown / DOCX / print exports, and the standalone personal-site renderer.\n * Adding a section to {@link ALL_SECTIONS} makes it appear everywhere (the\n * exports drive presence + order from here, and {@link SECTION_LABELS} is an\n * exhaustive `Record<SectionId, string>`, so a new id is a compile error until\n * it has a label).\n *\n * The per-section sorts live in `./section-sorts.js`, built on the same SDK\n * date extractors the HTML section components use, so the surfaces cannot\n * diverge on ordering.\n */\n\nimport type { Profile } from '../types/index.js';\n\n/**\n * Side-nav groups, in display order. Each labels a contiguous run of sections\n * in {@link ALL_SECTIONS}. `labelKey` resolves against the consumer's `sections`\n * i18n namespace.\n */\nexport const SECTION_GROUPS = [\n  { id: 'overview', labelKey: 'groupOverview' },\n  { id: 'experience', labelKey: 'groupExperience' },\n  { id: 'qualifications', labelKey: 'groupQualifications' },\n  { id: 'more', labelKey: 'groupMore' },\n] as const;\n\nexport type SectionGroupId = (typeof SECTION_GROUPS)[number]['id'];\n\n/**\n * Profile body sections in render + nav order (evidence-first): identity and\n * activity lead, then living work (career, skills, projects, talks,\n * publications), then the formal record (credentials, education, courses), then\n * the rest. `ns` selects the consumer's i18n namespace for `labelKey`; `group`\n * ties the section to a {@link SECTION_GROUPS} header.\n */\nexport const ALL_SECTIONS = [\n  { id: 'about', labelKey: 'about', ns: 'profile' as const, group: 'overview' as const },\n  { id: 'career', labelKey: 'career', ns: 'sections' as const, group: 'experience' as const },\n  { id: 'skills', labelKey: 'skills', ns: 'sections' as const, group: 'experience' as const },\n  { id: 'projects', labelKey: 'projects', ns: 'sections' as const, group: 'experience' as const },\n  {\n    id: 'presentations',\n    labelKey: 'talksAndSessions',\n    ns: 'sections' as const,\n    group: 'experience' as const,\n  },\n  {\n    id: 'publications',\n    labelKey: 'publications',\n    ns: 'sections' as const,\n    group: 'experience' as const,\n  },\n  {\n    id: 'credentials',\n    labelKey: 'credentials',\n    ns: 'sections' as const,\n    group: 'qualifications' as const,\n  },\n  {\n    id: 'education',\n    labelKey: 'education',\n    ns: 'sections' as const,\n    group: 'qualifications' as const,\n  },\n  { id: 'courses', labelKey: 'courses', ns: 'sections' as const, group: 'qualifications' as const },\n  { id: 'awards', labelKey: 'awards', ns: 'sections' as const, group: 'more' as const },\n  { id: 'involvement', labelKey: 'involvement', ns: 'sections' as const, group: 'more' as const },\n  // Its own section rather than a group under involvement: that record is about\n  // work contributed, this one about capital deployed.\n  { id: 'investments', labelKey: 'investments', ns: 'sections' as const, group: 'more' as const },\n  { id: 'languages', labelKey: 'languages', ns: 'sections' as const, group: 'more' as const },\n  {\n    id: 'other-profiles',\n    labelKey: 'otherProfiles',\n    ns: 'sections' as const,\n    group: 'more' as const,\n  },\n] as const;\n\n/** Every profile section id, in canonical render order. */\nexport type SectionId = (typeof ALL_SECTIONS)[number]['id'];\n\n/** Whether a section has content for a given profile (used to hide empty nav entries for visitors). */\nexport function isSectionPopulated(profile: Profile, id: string): boolean {\n  switch (id) {\n    case 'about':\n      return Boolean(profile.about && profile.headline);\n    case 'career':\n      return Boolean(profile.positions?.length);\n    case 'education':\n      return Boolean(profile.education?.length);\n    case 'courses':\n      return Boolean(profile.courses?.length);\n    case 'skills':\n      return Boolean(profile.skills?.length);\n    case 'projects':\n      return Boolean(profile.projects?.length);\n    case 'credentials':\n      return Boolean(profile.certifications?.length);\n    case 'publications':\n      return Boolean(profile.publications?.length);\n    case 'presentations':\n      return (\n        Boolean(profile.presentations?.length) || Boolean(profile.presentationDeliveries?.length)\n      );\n    case 'involvement':\n      return Boolean(profile.involvement?.length);\n    case 'investments':\n      return Boolean(profile.investments?.length);\n    case 'awards':\n      return Boolean(profile.honors?.length);\n    case 'languages':\n      return Boolean(profile.languages?.length);\n    case 'other-profiles':\n      return Boolean(profile.externalAccounts?.length);\n    default:\n      return false;\n  }\n}\n\n/**\n * The section ids a given viewer should see, in {@link ALL_SECTIONS} order.\n * Owners see every section; visitors only see populated ones.\n */\nexport function getVisibleSectionIds(profile: Profile, isOwnProfile: boolean): SectionId[] {\n  return ALL_SECTIONS.map((s) => s.id).filter(\n    (id) => isOwnProfile || isSectionPopulated(profile, id),\n  );\n}\n\n/** Drop items the owner has hidden from visitors. */\nexport function filterHidden<T extends { hidden?: boolean }>(items: T[] | undefined): T[] {\n  return (items ?? []).filter((i) => !i.hidden);\n}\n\n/**\n * Items visible to a given viewer: owners see their own hidden items, visitors\n * do not. Shared by every export format (markdown, docx, print) and the public\n * `.md` route so the hidden rule lives in one place.\n */\nexport function visibleItems<T extends { hidden?: boolean }>(\n  items: T[] | undefined,\n  isOwnProfile: boolean,\n): T[] {\n  return isOwnProfile ? (items ?? []) : filterHidden(items);\n}\n\n/**\n * English heading text for each section, keyed by {@link SectionId} (e.g.\n * `other-profiles` renders as \"Links\"). Exhaustive `Record<SectionId, string>`:\n * adding a section to {@link ALL_SECTIONS} without a label here is a compile\n * error, so a section can never silently render without (or with a stale)\n * heading. Consumers with i18n resolve their own localized labels via\n * `labelKey`; this is the canonical English fallback used by the exports.\n */\nexport const SECTION_LABELS: Record<SectionId, string> = {\n  about: 'About',\n  career: 'Career',\n  skills: 'Skills',\n  projects: 'Projects',\n  presentations: 'Talks & sessions',\n  publications: 'Publications',\n  credentials: 'Credentials',\n  education: 'Education',\n  courses: 'Courses',\n  awards: 'Awards',\n  involvement: 'Involvement',\n  investments: 'Investments',\n  languages: 'Languages',\n  'other-profiles': 'Links',\n};\n","/** Shared URL helpers for the JSON-LD emitters. */\n\nexport const DEFAULT_BASE_URL = 'https://sifa.id';\n\n/**\n * Drop trailing slashes from a caller-supplied base URL.\n *\n * Written as a scan rather than `replace(/\\/+$/, '')` on purpose: the regex\n * form is a polynomial-backtracking hazard on input the library does not\n * control (CodeQL js/polynomial-redos). This runs in linear time.\n */\nexport function normaliseBaseUrl(baseUrl: string | undefined): string {\n  const value = baseUrl ?? DEFAULT_BASE_URL;\n  let end = value.length;\n  while (end > 0 && value.charCodeAt(end - 1) === 0x2f) end -= 1;\n  return value.slice(0, end);\n}\n\nexport function profileUrl(baseUrl: string, handle: string): string {\n  return `${baseUrl}/p/${handle}`;\n}\n","/**\n * JSON Resume v1.0.0 emitter for a Sifa profile.\n *\n * https://jsonresume.org/schema/\n *\n * One pure function, no fetching, no DOM, no framework -- the same shape as the\n * JSON-LD emitter next door, and for the same reason: sifa.id, page.sifa.id and\n * any future consumer should emit one document from one implementation.\n *\n * Why this format earns its place: it is the lingua franca of CV tooling, so\n * emitting it hands a user every JSON Resume theme, and the Typst CV templates\n * on Typst Universe, without Sifa writing a renderer for any of them.\n *\n * Fields Sifa holds that JSON Resume has no slot for -- endorsements,\n * confirmations, involvement, investments, presentations, courses -- are\n * dropped rather than smuggled into a nearby field. The loss is documented for\n * the user at the point of download.\n */\n\nimport { formatStructuredName } from '../format/pds-utils.js';\nimport { filterHidden } from '../profile/section-model.js';\nimport type {\n  ExternalAccount,\n  LanguageProficiency,\n  LocationValue,\n  ProfileCertification,\n  ProfileEducation,\n  ProfileHonor,\n  ProfileLanguage,\n  ProfilePosition,\n  ProfileProject,\n  ProfilePublication,\n  ProfileSkill,\n  ProfileVolunteering,\n} from '../types/index.js';\nimport { normaliseBaseUrl, profileUrl } from '../jsonld/url.js';\n\nexport type Sanitizer = (input: string) => string;\n\nexport interface JsonResumeOptions {\n  /** Canonical origin for the profile URL. Defaults to `https://sifa.id`. */\n  readonly baseUrl?: string;\n  /** Applied to every user-authored string. Defaults to identity. */\n  readonly sanitize?: Sanitizer;\n  /**\n   * Absolute URL of the profile this resume describes. Defaults to\n   * `${baseUrl}/p/${handle}`. A personal site served from a custom domain is\n   * not at that path.\n   */\n  readonly canonicalUrl?: string;\n}\n\n/**\n * The subset of `Profile` this emitter reads. Deliberately structural rather\n * than the full `Profile`, so a caller holding a partially hydrated profile --\n * or a test -- does not have to invent forty unrelated fields.\n */\nexport interface JsonResumeProfileInput {\n  readonly handle: string;\n  readonly displayName?: string;\n  readonly givenName?: string;\n  readonly familyName?: string;\n  readonly avatar?: string;\n  readonly headline?: string;\n  readonly about?: string;\n  readonly website?: string;\n  readonly location?: LocationValue | null;\n  readonly positions?: ProfilePosition[];\n  readonly education?: ProfileEducation[];\n  readonly skills?: ProfileSkill[];\n  readonly certifications?: ProfileCertification[];\n  readonly projects?: ProfileProject[];\n  readonly publications?: ProfilePublication[];\n  readonly volunteering?: ProfileVolunteering[];\n  readonly honors?: ProfileHonor[];\n  readonly languages?: ProfileLanguage[];\n  readonly externalAccounts?: ExternalAccount[];\n}\n\nexport interface JsonResumeLocation {\n  readonly city?: string;\n  readonly region?: string;\n  readonly countryCode?: string;\n  readonly postalCode?: string;\n}\n\nexport interface JsonResumeProfileLink {\n  readonly network: string;\n  readonly username?: string;\n  readonly url: string;\n}\n\nexport interface JsonResumeBasics {\n  readonly name: string;\n  readonly label?: string;\n  readonly image?: string;\n  readonly url?: string;\n  readonly summary?: string;\n  readonly location?: JsonResumeLocation;\n  readonly profiles?: JsonResumeProfileLink[];\n}\n\nexport interface JsonResumeWork {\n  readonly name?: string;\n  readonly position: string;\n  readonly summary?: string;\n  readonly startDate?: string;\n  readonly endDate?: string;\n}\n\nexport interface JsonResumeVolunteer {\n  readonly organization: string;\n  readonly position?: string;\n  readonly summary?: string;\n  readonly startDate?: string;\n  readonly endDate?: string;\n}\n\nexport interface JsonResumeEducation {\n  readonly institution: string;\n  readonly area?: string;\n  readonly studyType?: string;\n  readonly startDate?: string;\n  readonly endDate?: string;\n}\n\nexport interface JsonResumeAward {\n  readonly title: string;\n  readonly date?: string;\n  readonly awarder?: string;\n  readonly summary?: string;\n}\n\nexport interface JsonResumeCertificate {\n  readonly name: string;\n  readonly date?: string;\n  readonly issuer?: string;\n  readonly url?: string;\n}\n\nexport interface JsonResumePublication {\n  readonly name: string;\n  readonly publisher?: string;\n  readonly releaseDate?: string;\n  readonly url?: string;\n  readonly summary?: string;\n}\n\nexport interface JsonResumeSkill {\n  readonly name: string;\n}\n\nexport interface JsonResumeLanguage {\n  readonly language: string;\n  readonly fluency?: string;\n}\n\nexport interface JsonResumeProject {\n  readonly name: string;\n  readonly description?: string;\n  readonly url?: string;\n  readonly startDate?: string;\n  readonly endDate?: string;\n}\n\nexport interface JsonResumeMeta {\n  readonly canonical: string;\n  readonly version: string;\n  readonly lastModified?: string;\n}\n\nexport interface JsonResume {\n  readonly basics?: JsonResumeBasics;\n  readonly work?: JsonResumeWork[];\n  readonly volunteer?: JsonResumeVolunteer[];\n  readonly education?: JsonResumeEducation[];\n  readonly awards?: JsonResumeAward[];\n  readonly certificates?: JsonResumeCertificate[];\n  readonly publications?: JsonResumePublication[];\n  readonly skills?: JsonResumeSkill[];\n  readonly languages?: JsonResumeLanguage[];\n  readonly projects?: JsonResumeProject[];\n  readonly meta?: JsonResumeMeta;\n}\n\n/** Schema version this emitter targets, as JSON Resume writes it in `meta`. */\nconst SCHEMA_VERSION = 'v1.0.0';\n\n/**\n * A date JSON Resume will accept: `YYYY`, `YYYY-MM` or `YYYY-MM-DD`. Sifa\n * stores RFC 3339 for some fields, and a full timestamp pasted into a CV\n * template renders as `2020-03-04T00:00:00.000Z` on the page.\n */\nconst RESUME_DATE_RE = /^(\\d{4})(-\\d{2})?(-\\d{2})?/;\n\nexport function toResumeDate(value: string | undefined): string | undefined {\n  const trimmed = value?.trim();\n  if (!trimmed) return undefined;\n  const match = RESUME_DATE_RE.exec(trimmed);\n  return match ? match[0] : undefined;\n}\n\n/**\n * JSON Resume's `fluency` is free text, so these are display labels rather\n * than a mapped vocabulary. Kept in one place so export and a future import\n * agree on the spelling.\n */\nconst FLUENCY_LABELS: Record<LanguageProficiency, string> = {\n  elementary: 'Elementary',\n  limited_working: 'Limited working',\n  professional_working: 'Professional working',\n  full_professional: 'Full professional',\n  native: 'Native or bilingual',\n};\n\nconst identity: Sanitizer = (input) => input;\n\n/** Drops keys whose value is undefined, so the document carries no empty slots. */\nfunction compact<T extends object>(value: T): T {\n  return Object.fromEntries(Object.entries(value).filter(([, v]) => v !== undefined)) as T;\n}\n\n/** Omits the key entirely when the mapped list came out empty. */\nfunction section<K extends string, T>(key: K, items: T[]): Record<K, T[]> | undefined {\n  return items.length > 0 ? ({ [key]: items } as Record<K, T[]>) : undefined;\n}\n\nfunction mapLocation(\n  location: LocationValue | null | undefined,\n  s: Sanitizer,\n): JsonResumeLocation | undefined {\n  if (!location) return undefined;\n  const mapped = compact({\n    city: text(location.locality ?? location.city, s),\n    region: text(location.region, s),\n    countryCode: text(location.countryCode, s),\n    postalCode: text(location.postalCode, s),\n  });\n  return Object.keys(mapped).length > 0 ? mapped : undefined;\n}\n\n/** Trimmed, sanitised, and undefined when there is nothing left. */\nfunction text(value: string | undefined, s: Sanitizer): string | undefined {\n  const trimmed = value?.trim();\n  return trimmed ? s(trimmed) : undefined;\n}\n\n/**\n * The name to print for a linked organization. `entityName` is the AppView's\n * resolved current name and wins when present, matching how the profile itself\n * renders these.\n */\nfunction orgName(\n  entityName: string | undefined,\n  stored: string | undefined,\n  s: Sanitizer,\n): string | undefined {\n  return text(entityName, s) ?? text(stored, s);\n}\n\n/**\n * Build a JSON Resume v1.0.0 document from a Sifa profile.\n *\n * Hidden records are dropped. Keys are omitted rather than emitted empty, so a\n * profile with no publications produces a document with no `publications` key\n * instead of one a reader has to interpret.\n */\nexport function profileToJsonResume(\n  profile: JsonResumeProfileInput,\n  options: JsonResumeOptions = {},\n): JsonResume {\n  const s = options.sanitize ?? identity;\n  const baseUrl = normaliseBaseUrl(options.baseUrl);\n  const canonical = options.canonicalUrl ?? profileUrl(baseUrl, profile.handle);\n\n  const name =\n    formatStructuredName(profile.givenName, profile.familyName) ??\n    text(profile.displayName, s) ??\n    profile.handle;\n\n  const profiles = filterHidden(profile.externalAccounts).map((account) =>\n    compact<JsonResumeProfileLink>({\n      network: s(account.platform),\n      username: text(account.label, s),\n      url: account.url,\n    }),\n  );\n\n  const basics = compact<JsonResumeBasics>({\n    name,\n    label: text(profile.headline, s),\n    image: profile.avatar,\n    url: text(profile.website, s) ?? canonical,\n    summary: text(profile.about, s),\n    location: mapLocation(profile.location, s),\n    ...section('profiles', profiles),\n  });\n\n  const work = filterHidden(profile.positions).map((position) =>\n    compact<JsonResumeWork>({\n      name: orgName(position.entityName, position.company, s),\n      position: s(position.title),\n      summary: text(position.description, s),\n      startDate: toResumeDate(position.startedAt),\n      endDate: toResumeDate(position.endedAt),\n    }),\n  );\n\n  const volunteer = filterHidden(profile.volunteering).map((entry) =>\n    compact<JsonResumeVolunteer>({\n      organization: orgName(entry.entityName, entry.organization, s) ?? '',\n      position: text(entry.role, s),\n      summary: text(entry.description, s),\n      startDate: toResumeDate(entry.startDate),\n      endDate: toResumeDate(entry.endDate),\n    }),\n  );\n\n  const education = filterHidden(profile.education).map((entry) =>\n    compact<JsonResumeEducation>({\n      institution: orgName(entry.entityName, entry.institution, s) ?? '',\n      area: text(entry.fieldOfStudy, s),\n      studyType: text(entry.degree, s),\n      startDate: toResumeDate(entry.startedAt),\n      endDate: toResumeDate(entry.endedAt),\n    }),\n  );\n\n  const awards = filterHidden(profile.honors).map((honor) =>\n    compact<JsonResumeAward>({\n      title: s(honor.title),\n      date: toResumeDate(honor.date),\n      awarder: orgName(honor.entityName, honor.issuer, s),\n      summary: text(honor.description, s),\n    }),\n  );\n\n  const certificates = filterHidden(profile.certifications).map((cert) =>\n    compact<JsonResumeCertificate>({\n      name: s(cert.name),\n      date: toResumeDate(cert.issueDate),\n      // `issuingOrg` is the deprecated read-view alias for `authority`; records\n      // indexed before the rename carry only the alias.\n      issuer: orgName(cert.entityName, cert.authority ?? cert.issuingOrg, s),\n      url: text(cert.credentialUrl, s),\n    }),\n  );\n\n  const publications = filterHidden(profile.publications).map((publication) =>\n    compact<JsonResumePublication>({\n      name: s(publication.title),\n      publisher: text(publication.publisher, s),\n      releaseDate: toResumeDate(publication.date),\n      url: text(publication.url, s),\n      summary: text(publication.description, s),\n    }),\n  );\n\n  // One entry per skill rather than JSON Resume's grouped shape: Sifa stores one\n  // record per skill, and keeping the two symmetric is what makes a round-trip\n  // through a third-party editor safe. Category and endorsement counts have no\n  // JSON Resume slot and are dropped. Skill records carry no `hidden` flag, so\n  // there is nothing to filter here.\n  const skills = (profile.skills ?? []).map((skill) => ({ name: s(skill.name) }));\n\n  const languages = filterHidden(profile.languages).map((language) =>\n    compact<JsonResumeLanguage>({\n      language: s(language.language),\n      fluency: language.proficiency ? FLUENCY_LABELS[language.proficiency] : undefined,\n    }),\n  );\n\n  const projects = filterHidden(profile.projects).map((project) =>\n    compact<JsonResumeProject>({\n      name: s(project.name),\n      description: text(project.description, s),\n      url: text(project.url, s),\n      startDate: toResumeDate(project.startDate),\n      endDate: toResumeDate(project.endDate),\n    }),\n  );\n\n  return {\n    basics,\n    ...section('work', work),\n    ...section('volunteer', volunteer),\n    ...section('education', education),\n    ...section('awards', awards),\n    ...section('certificates', certificates),\n    ...section('publications', publications),\n    ...section('skills', skills),\n    ...section('languages', languages),\n    ...section('projects', projects),\n    meta: { canonical, version: SCHEMA_VERSION },\n  };\n}\n"]}

package/dist/resume/index.d.cts

@@ -0,0 +1,163 @@
+import { L as LocationValue, d as ProfilePosition, f as ProfileEducation, P as ProfileSkill, e as ProfileCertification, i as ProfileProject, j as ProfilePublication, J as ProfileVolunteering, g as ProfileHonor, h as ProfileLanguage, p as ExternalAccount } from '../index-CTzpbW81.cjs';
+
+/**
+ * JSON Resume v1.0.0 emitter for a Sifa profile.
+ *
+ * https://jsonresume.org/schema/
+ *
+ * One pure function, no fetching, no DOM, no framework -- the same shape as the
+ * JSON-LD emitter next door, and for the same reason: sifa.id, page.sifa.id and
+ * any future consumer should emit one document from one implementation.
+ *
+ * Why this format earns its place: it is the lingua franca of CV tooling, so
+ * emitting it hands a user every JSON Resume theme, and the Typst CV templates
+ * on Typst Universe, without Sifa writing a renderer for any of them.
+ *
+ * Fields Sifa holds that JSON Resume has no slot for -- endorsements,
+ * confirmations, involvement, investments, presentations, courses -- are
+ * dropped rather than smuggled into a nearby field. The loss is documented for
+ * the user at the point of download.
+ */
+
+type Sanitizer = (input: string) => string;
+interface JsonResumeOptions {
+    /** Canonical origin for the profile URL. Defaults to `https://sifa.id`. */
+    readonly baseUrl?: string;
+    /** Applied to every user-authored string. Defaults to identity. */
+    readonly sanitize?: Sanitizer;
+    /**
+     * Absolute URL of the profile this resume describes. Defaults to
+     * `${baseUrl}/p/${handle}`. A personal site served from a custom domain is
+     * not at that path.
+     */
+    readonly canonicalUrl?: string;
+}
+/**
+ * The subset of `Profile` this emitter reads. Deliberately structural rather
+ * than the full `Profile`, so a caller holding a partially hydrated profile --
+ * or a test -- does not have to invent forty unrelated fields.
+ */
+interface JsonResumeProfileInput {
+    readonly handle: string;
+    readonly displayName?: string;
+    readonly givenName?: string;
+    readonly familyName?: string;
+    readonly avatar?: string;
+    readonly headline?: string;
+    readonly about?: string;
+    readonly website?: string;
+    readonly location?: LocationValue | null;
+    readonly positions?: ProfilePosition[];
+    readonly education?: ProfileEducation[];
+    readonly skills?: ProfileSkill[];
+    readonly certifications?: ProfileCertification[];
+    readonly projects?: ProfileProject[];
+    readonly publications?: ProfilePublication[];
+    readonly volunteering?: ProfileVolunteering[];
+    readonly honors?: ProfileHonor[];
+    readonly languages?: ProfileLanguage[];
+    readonly externalAccounts?: ExternalAccount[];
+}
+interface JsonResumeLocation {
+    readonly city?: string;
+    readonly region?: string;
+    readonly countryCode?: string;
+    readonly postalCode?: string;
+}
+interface JsonResumeProfileLink {
+    readonly network: string;
+    readonly username?: string;
+    readonly url: string;
+}
+interface JsonResumeBasics {
+    readonly name: string;
+    readonly label?: string;
+    readonly image?: string;
+    readonly url?: string;
+    readonly summary?: string;
+    readonly location?: JsonResumeLocation;
+    readonly profiles?: JsonResumeProfileLink[];
+}
+interface JsonResumeWork {
+    readonly name?: string;
+    readonly position: string;
+    readonly summary?: string;
+    readonly startDate?: string;
+    readonly endDate?: string;
+}
+interface JsonResumeVolunteer {
+    readonly organization: string;
+    readonly position?: string;
+    readonly summary?: string;
+    readonly startDate?: string;
+    readonly endDate?: string;
+}
+interface JsonResumeEducation {
+    readonly institution: string;
+    readonly area?: string;
+    readonly studyType?: string;
+    readonly startDate?: string;
+    readonly endDate?: string;
+}
+interface JsonResumeAward {
+    readonly title: string;
+    readonly date?: string;
+    readonly awarder?: string;
+    readonly summary?: string;
+}
+interface JsonResumeCertificate {
+    readonly name: string;
+    readonly date?: string;
+    readonly issuer?: string;
+    readonly url?: string;
+}
+interface JsonResumePublication {
+    readonly name: string;
+    readonly publisher?: string;
+    readonly releaseDate?: string;
+    readonly url?: string;
+    readonly summary?: string;
+}
+interface JsonResumeSkill {
+    readonly name: string;
+}
+interface JsonResumeLanguage {
+    readonly language: string;
+    readonly fluency?: string;
+}
+interface JsonResumeProject {
+    readonly name: string;
+    readonly description?: string;
+    readonly url?: string;
+    readonly startDate?: string;
+    readonly endDate?: string;
+}
+interface JsonResumeMeta {
+    readonly canonical: string;
+    readonly version: string;
+    readonly lastModified?: string;
+}
+interface JsonResume {
+    readonly basics?: JsonResumeBasics;
+    readonly work?: JsonResumeWork[];
+    readonly volunteer?: JsonResumeVolunteer[];
+    readonly education?: JsonResumeEducation[];
+    readonly awards?: JsonResumeAward[];
+    readonly certificates?: JsonResumeCertificate[];
+    readonly publications?: JsonResumePublication[];
+    readonly skills?: JsonResumeSkill[];
+    readonly languages?: JsonResumeLanguage[];
+    readonly projects?: JsonResumeProject[];
+    readonly meta?: JsonResumeMeta;
+}
+declare function toResumeDate(value: string | undefined): string | undefined;
+/**
+ * Build a JSON Resume v1.0.0 document from a Sifa profile.
+ *
+ * Hidden records are dropped. Keys are omitted rather than emitted empty, so a
+ * profile with no publications produces a document with no `publications` key
+ * instead of one a reader has to interpret.
+ */
+declare function profileToJsonResume(profile: JsonResumeProfileInput, options?: JsonResumeOptions): JsonResume;
+
+export { type JsonResume, type JsonResumeAward, type JsonResumeBasics, type JsonResumeCertificate, type JsonResumeEducation, type JsonResumeLanguage, type JsonResumeLocation, type JsonResumeMeta, type JsonResumeOptions, type JsonResumeProfileInput, type JsonResumeProfileLink, type JsonResumeProject, type JsonResumePublication, type JsonResumeSkill, type JsonResumeVolunteer, type JsonResumeWork, type Sanitizer, profileToJsonResume, toResumeDate };

package/dist/resume/index.d.ts

@@ -0,0 +1,163 @@
+import { L as LocationValue, d as ProfilePosition, f as ProfileEducation, P as ProfileSkill, e as ProfileCertification, i as ProfileProject, j as ProfilePublication, J as ProfileVolunteering, g as ProfileHonor, h as ProfileLanguage, p as ExternalAccount } from '../index-CTzpbW81.js';
+
+/**
+ * JSON Resume v1.0.0 emitter for a Sifa profile.
+ *
+ * https://jsonresume.org/schema/
+ *
+ * One pure function, no fetching, no DOM, no framework -- the same shape as the
+ * JSON-LD emitter next door, and for the same reason: sifa.id, page.sifa.id and
+ * any future consumer should emit one document from one implementation.
+ *
+ * Why this format earns its place: it is the lingua franca of CV tooling, so
+ * emitting it hands a user every JSON Resume theme, and the Typst CV templates
+ * on Typst Universe, without Sifa writing a renderer for any of them.
+ *
+ * Fields Sifa holds that JSON Resume has no slot for -- endorsements,
+ * confirmations, involvement, investments, presentations, courses -- are
+ * dropped rather than smuggled into a nearby field. The loss is documented for
+ * the user at the point of download.
+ */
+
+type Sanitizer = (input: string) => string;
+interface JsonResumeOptions {
+    /** Canonical origin for the profile URL. Defaults to `https://sifa.id`. */
+    readonly baseUrl?: string;
+    /** Applied to every user-authored string. Defaults to identity. */
+    readonly sanitize?: Sanitizer;
+    /**
+     * Absolute URL of the profile this resume describes. Defaults to
+     * `${baseUrl}/p/${handle}`. A personal site served from a custom domain is
+     * not at that path.
+     */
+    readonly canonicalUrl?: string;
+}
+/**
+ * The subset of `Profile` this emitter reads. Deliberately structural rather
+ * than the full `Profile`, so a caller holding a partially hydrated profile --
+ * or a test -- does not have to invent forty unrelated fields.
+ */
+interface JsonResumeProfileInput {
+    readonly handle: string;
+    readonly displayName?: string;
+    readonly givenName?: string;
+    readonly familyName?: string;
+    readonly avatar?: string;
+    readonly headline?: string;
+    readonly about?: string;
+    readonly website?: string;
+    readonly location?: LocationValue | null;
+    readonly positions?: ProfilePosition[];
+    readonly education?: ProfileEducation[];
+    readonly skills?: ProfileSkill[];
+    readonly certifications?: ProfileCertification[];
+    readonly projects?: ProfileProject[];
+    readonly publications?: ProfilePublication[];
+    readonly volunteering?: ProfileVolunteering[];
+    readonly honors?: ProfileHonor[];
+    readonly languages?: ProfileLanguage[];
+    readonly externalAccounts?: ExternalAccount[];
+}
+interface JsonResumeLocation {
+    readonly city?: string;
+    readonly region?: string;
+    readonly countryCode?: string;
+    readonly postalCode?: string;
+}
+interface JsonResumeProfileLink {
+    readonly network: string;
+    readonly username?: string;
+    readonly url: string;
+}
+interface JsonResumeBasics {
+    readonly name: string;
+    readonly label?: string;
+    readonly image?: string;
+    readonly url?: string;
+    readonly summary?: string;
+    readonly location?: JsonResumeLocation;
+    readonly profiles?: JsonResumeProfileLink[];
+}
+interface JsonResumeWork {
+    readonly name?: string;
+    readonly position: string;
+    readonly summary?: string;
+    readonly startDate?: string;
+    readonly endDate?: string;
+}
+interface JsonResumeVolunteer {
+    readonly organization: string;
+    readonly position?: string;
+    readonly summary?: string;
+    readonly startDate?: string;
+    readonly endDate?: string;
+}
+interface JsonResumeEducation {
+    readonly institution: string;
+    readonly area?: string;
+    readonly studyType?: string;
+    readonly startDate?: string;
+    readonly endDate?: string;
+}
+interface JsonResumeAward {
+    readonly title: string;
+    readonly date?: string;
+    readonly awarder?: string;
+    readonly summary?: string;
+}
+interface JsonResumeCertificate {
+    readonly name: string;
+    readonly date?: string;
+    readonly issuer?: string;
+    readonly url?: string;
+}
+interface JsonResumePublication {
+    readonly name: string;
+    readonly publisher?: string;
+    readonly releaseDate?: string;
+    readonly url?: string;
+    readonly summary?: string;
+}
+interface JsonResumeSkill {
+    readonly name: string;
+}
+interface JsonResumeLanguage {
+    readonly language: string;
+    readonly fluency?: string;
+}
+interface JsonResumeProject {
+    readonly name: string;
+    readonly description?: string;
+    readonly url?: string;
+    readonly startDate?: string;
+    readonly endDate?: string;
+}
+interface JsonResumeMeta {
+    readonly canonical: string;
+    readonly version: string;
+    readonly lastModified?: string;
+}
+interface JsonResume {
+    readonly basics?: JsonResumeBasics;
+    readonly work?: JsonResumeWork[];
+    readonly volunteer?: JsonResumeVolunteer[];
+    readonly education?: JsonResumeEducation[];
+    readonly awards?: JsonResumeAward[];
+    readonly certificates?: JsonResumeCertificate[];
+    readonly publications?: JsonResumePublication[];
+    readonly skills?: JsonResumeSkill[];
+    readonly languages?: JsonResumeLanguage[];
+    readonly projects?: JsonResumeProject[];
+    readonly meta?: JsonResumeMeta;
+}
+declare function toResumeDate(value: string | undefined): string | undefined;
+/**
+ * Build a JSON Resume v1.0.0 document from a Sifa profile.
+ *
+ * Hidden records are dropped. Keys are omitted rather than emitted empty, so a
+ * profile with no publications produces a document with no `publications` key
+ * instead of one a reader has to interpret.
+ */
+declare function profileToJsonResume(profile: JsonResumeProfileInput, options?: JsonResumeOptions): JsonResume;
+
+export { type JsonResume, type JsonResumeAward, type JsonResumeBasics, type JsonResumeCertificate, type JsonResumeEducation, type JsonResumeLanguage, type JsonResumeLocation, type JsonResumeMeta, type JsonResumeOptions, type JsonResumeProfileInput, type JsonResumeProfileLink, type JsonResumeProject, type JsonResumePublication, type JsonResumeSkill, type JsonResumeVolunteer, type JsonResumeWork, type Sanitizer, profileToJsonResume, toResumeDate };

package/dist/resume/index.js

@@ -0,0 +1,181 @@
+// src/format/pds-utils.ts
+var PDS_PROVIDERS = [
+  { suffix: ".bsky.social", name: "bluesky" },
+  { suffix: ".blacksky.app", name: "blacksky" },
+  { suffix: ".eurosky.social", name: "eurosky" },
+  { suffix: ".northsky.social", name: "northsky" }
+];
+new Set(PDS_PROVIDERS.map((p) => p.name));
+function formatStructuredName(givenName, familyName) {
+  const given = givenName?.trim();
+  const family = familyName?.trim();
+  if (given && family) return `${given} ${family}`;
+  return given || family || void 0;
+}
+
+// src/profile/section-model.ts
+function filterHidden(items) {
+  return (items ?? []).filter((i) => !i.hidden);
+}
+
+// src/jsonld/url.ts
+var DEFAULT_BASE_URL = "https://sifa.id";
+function normaliseBaseUrl(baseUrl) {
+  const value = baseUrl ?? DEFAULT_BASE_URL;
+  let end = value.length;
+  while (end > 0 && value.charCodeAt(end - 1) === 47) end -= 1;
+  return value.slice(0, end);
+}
+function profileUrl(baseUrl, handle) {
+  return `${baseUrl}/p/${handle}`;
+}
+
+// src/resume/json-resume.ts
+var SCHEMA_VERSION = "v1.0.0";
+var RESUME_DATE_RE = /^(\d{4})(-\d{2})?(-\d{2})?/;
+function toResumeDate(value) {
+  const trimmed = value?.trim();
+  if (!trimmed) return void 0;
+  const match = RESUME_DATE_RE.exec(trimmed);
+  return match ? match[0] : void 0;
+}
+var FLUENCY_LABELS = {
+  elementary: "Elementary",
+  limited_working: "Limited working",
+  professional_working: "Professional working",
+  full_professional: "Full professional",
+  native: "Native or bilingual"
+};
+var identity = (input) => input;
+function compact(value) {
+  return Object.fromEntries(Object.entries(value).filter(([, v]) => v !== void 0));
+}
+function section(key, items) {
+  return items.length > 0 ? { [key]: items } : void 0;
+}
+function mapLocation(location, s) {
+  if (!location) return void 0;
+  const mapped = compact({
+    city: text(location.locality ?? location.city, s),
+    region: text(location.region, s),
+    countryCode: text(location.countryCode, s),
+    postalCode: text(location.postalCode, s)
+  });
+  return Object.keys(mapped).length > 0 ? mapped : void 0;
+}
+function text(value, s) {
+  const trimmed = value?.trim();
+  return trimmed ? s(trimmed) : void 0;
+}
+function orgName(entityName, stored, s) {
+  return text(entityName, s) ?? text(stored, s);
+}
+function profileToJsonResume(profile, options = {}) {
+  const s = options.sanitize ?? identity;
+  const baseUrl = normaliseBaseUrl(options.baseUrl);
+  const canonical = options.canonicalUrl ?? profileUrl(baseUrl, profile.handle);
+  const name = formatStructuredName(profile.givenName, profile.familyName) ?? text(profile.displayName, s) ?? profile.handle;
+  const profiles = filterHidden(profile.externalAccounts).map(
+    (account) => compact({
+      network: s(account.platform),
+      username: text(account.label, s),
+      url: account.url
+    })
+  );
+  const basics = compact({
+    name,
+    label: text(profile.headline, s),
+    image: profile.avatar,
+    url: text(profile.website, s) ?? canonical,
+    summary: text(profile.about, s),
+    location: mapLocation(profile.location, s),
+    ...section("profiles", profiles)
+  });
+  const work = filterHidden(profile.positions).map(
+    (position) => compact({
+      name: orgName(position.entityName, position.company, s),
+      position: s(position.title),
+      summary: text(position.description, s),
+      startDate: toResumeDate(position.startedAt),
+      endDate: toResumeDate(position.endedAt)
+    })
+  );
+  const volunteer = filterHidden(profile.volunteering).map(
+    (entry) => compact({
+      organization: orgName(entry.entityName, entry.organization, s) ?? "",
+      position: text(entry.role, s),
+      summary: text(entry.description, s),
+      startDate: toResumeDate(entry.startDate),
+      endDate: toResumeDate(entry.endDate)
+    })
+  );
+  const education = filterHidden(profile.education).map(
+    (entry) => compact({
+      institution: orgName(entry.entityName, entry.institution, s) ?? "",
+      area: text(entry.fieldOfStudy, s),
+      studyType: text(entry.degree, s),
+      startDate: toResumeDate(entry.startedAt),
+      endDate: toResumeDate(entry.endedAt)
+    })
+  );
+  const awards = filterHidden(profile.honors).map(
+    (honor) => compact({
+      title: s(honor.title),
+      date: toResumeDate(honor.date),
+      awarder: orgName(honor.entityName, honor.issuer, s),
+      summary: text(honor.description, s)
+    })
+  );
+  const certificates = filterHidden(profile.certifications).map(
+    (cert) => compact({
+      name: s(cert.name),
+      date: toResumeDate(cert.issueDate),
+      // `issuingOrg` is the deprecated read-view alias for `authority`; records
+      // indexed before the rename carry only the alias.
+      issuer: orgName(cert.entityName, cert.authority ?? cert.issuingOrg, s),
+      url: text(cert.credentialUrl, s)
+    })
+  );
+  const publications = filterHidden(profile.publications).map(
+    (publication) => compact({
+      name: s(publication.title),
+      publisher: text(publication.publisher, s),
+      releaseDate: toResumeDate(publication.date),
+      url: text(publication.url, s),
+      summary: text(publication.description, s)
+    })
+  );
+  const skills = (profile.skills ?? []).map((skill) => ({ name: s(skill.name) }));
+  const languages = filterHidden(profile.languages).map(
+    (language) => compact({
+      language: s(language.language),
+      fluency: language.proficiency ? FLUENCY_LABELS[language.proficiency] : void 0
+    })
+  );
+  const projects = filterHidden(profile.projects).map(
+    (project) => compact({
+      name: s(project.name),
+      description: text(project.description, s),
+      url: text(project.url, s),
+      startDate: toResumeDate(project.startDate),
+      endDate: toResumeDate(project.endDate)
+    })
+  );
+  return {
+    basics,
+    ...section("work", work),
+    ...section("volunteer", volunteer),
+    ...section("education", education),
+    ...section("awards", awards),
+    ...section("certificates", certificates),
+    ...section("publications", publications),
+    ...section("skills", skills),
+    ...section("languages", languages),
+    ...section("projects", projects),
+    meta: { canonical, version: SCHEMA_VERSION }
+  };
+}
+
+export { profileToJsonResume, toResumeDate };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/resume/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/format/pds-utils.ts","../../src/profile/section-model.ts","../../src/jsonld/url.ts","../../src/resume/json-resume.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { PdsProviderInfo } from '../types/index.js';\n\nexport interface PdsProvider {\n  name: string;\n  profileUrl: string;\n  host?: string;\n}\n\nconst BSKY_PROFILE_BASE = 'https://bsky.app/profile/';\n\nconst PDS_PROVIDERS: { suffix: string; name: string }[] = [\n  { suffix: '.bsky.social', name: 'bluesky' },\n  { suffix: '.blacksky.app', name: 'blacksky' },\n  { suffix: '.eurosky.social', name: 'eurosky' },\n  { suffix: '.northsky.social', name: 'northsky' },\n];\n\nconst KNOWN_PROVIDER_NAMES = new Set(PDS_PROVIDERS.map((p) => p.name));\n\nconst ICON_ONLY_PROVIDERS = new Set(['selfhosted-social', 'selfhosted']);\n\nexport function pdsProviderFromApi(\n  apiProvider: PdsProviderInfo | null | undefined,\n  handle: string,\n): PdsProvider | null {\n  if (!apiProvider) return null;\n  if (ICON_ONLY_PROVIDERS.has(apiProvider.name)) {\n    return { name: apiProvider.name, profileUrl: '', host: apiProvider.host };\n  }\n  if (!KNOWN_PROVIDER_NAMES.has(apiProvider.name)) return null;\n  return {\n    name: apiProvider.name,\n    profileUrl: `${BSKY_PROFILE_BASE}${handle}`,\n    host: apiProvider.host,\n  };\n}\n\nexport function getHandleStem(handle: string): string {\n  const lower = handle.toLowerCase();\n  for (const provider of PDS_PROVIDERS) {\n    if (lower.endsWith(provider.suffix) && lower.length > provider.suffix.length) {\n      return handle.slice(0, -provider.suffix.length);\n    }\n  }\n  return handle;\n}\n\nexport function getDisplayLabel(displayName: string | undefined, handle: string): string {\n  if (displayName) return displayName;\n  return getHandleStem(handle);\n}\n\n/**\n * Combine optional structured name fields (`id.sifa.profile.self.givenName`,\n * `familyName`) into a single string in Schema.org `Person` order — given\n * before family. Returns `undefined` when both are absent so callers can\n * fall back to `displayName`. Whitespace-only inputs are treated as absent.\n * Does not impose cultural ordering: users whose preferred presentation\n * differs (e.g. Eastern name order) should set `displayName` accordingly,\n * which this helper deliberately does not consult.\n */\nexport function formatStructuredName(\n  givenName: string | undefined,\n  familyName: string | undefined,\n): string | undefined {\n  const given = givenName?.trim();\n  const family = familyName?.trim();\n  if (given && family) return `${given} ${family}`;\n  return given || family || undefined;\n}\n\nconst PDS_DISPLAY_NAMES: Record<string, string> = {\n  bluesky: 'Bluesky',\n  blacksky: 'BlackSky',\n  eurosky: 'EuroSky',\n  northsky: 'NorthSky',\n  'selfhosted-social': 'Self-hosted',\n  selfhosted: 'Self-hosted',\n};\n\nexport function getPdsDisplayName(providerName: string): string {\n  return PDS_DISPLAY_NAMES[providerName] ?? providerName;\n}\n\nexport function detectPdsProvider(handle: string): PdsProvider | null {\n  const lower = handle.toLowerCase();\n  for (const provider of PDS_PROVIDERS) {\n    if (lower.endsWith(provider.suffix)) {\n      return {\n        name: provider.name,\n        profileUrl: `${BSKY_PROFILE_BASE}${handle}`,\n      };\n    }\n  }\n  return null;\n}\n","/**\n * Shared, single-source-of-truth model for which profile sections render, in\n * what order, their nav grouping, and which items a given viewer may see.\n *\n * Every Sifa profile surface builds on this: the HTML profile page, the\n * Markdown / DOCX / print exports, and the standalone personal-site renderer.\n * Adding a section to {@link ALL_SECTIONS} makes it appear everywhere (the\n * exports drive presence + order from here, and {@link SECTION_LABELS} is an\n * exhaustive `Record<SectionId, string>`, so a new id is a compile error until\n * it has a label).\n *\n * The per-section sorts live in `./section-sorts.js`, built on the same SDK\n * date extractors the HTML section components use, so the surfaces cannot\n * diverge on ordering.\n */\n\nimport type { Profile } from '../types/index.js';\n\n/**\n * Side-nav groups, in display order. Each labels a contiguous run of sections\n * in {@link ALL_SECTIONS}. `labelKey` resolves against the consumer's `sections`\n * i18n namespace.\n */\nexport const SECTION_GROUPS = [\n  { id: 'overview', labelKey: 'groupOverview' },\n  { id: 'experience', labelKey: 'groupExperience' },\n  { id: 'qualifications', labelKey: 'groupQualifications' },\n  { id: 'more', labelKey: 'groupMore' },\n] as const;\n\nexport type SectionGroupId = (typeof SECTION_GROUPS)[number]['id'];\n\n/**\n * Profile body sections in render + nav order (evidence-first): identity and\n * activity lead, then living work (career, skills, projects, talks,\n * publications), then the formal record (credentials, education, courses), then\n * the rest. `ns` selects the consumer's i18n namespace for `labelKey`; `group`\n * ties the section to a {@link SECTION_GROUPS} header.\n */\nexport const ALL_SECTIONS = [\n  { id: 'about', labelKey: 'about', ns: 'profile' as const, group: 'overview' as const },\n  { id: 'career', labelKey: 'career', ns: 'sections' as const, group: 'experience' as const },\n  { id: 'skills', labelKey: 'skills', ns: 'sections' as const, group: 'experience' as const },\n  { id: 'projects', labelKey: 'projects', ns: 'sections' as const, group: 'experience' as const },\n  {\n    id: 'presentations',\n    labelKey: 'talksAndSessions',\n    ns: 'sections' as const,\n    group: 'experience' as const,\n  },\n  {\n    id: 'publications',\n    labelKey: 'publications',\n    ns: 'sections' as const,\n    group: 'experience' as const,\n  },\n  {\n    id: 'credentials',\n    labelKey: 'credentials',\n    ns: 'sections' as const,\n    group: 'qualifications' as const,\n  },\n  {\n    id: 'education',\n    labelKey: 'education',\n    ns: 'sections' as const,\n    group: 'qualifications' as const,\n  },\n  { id: 'courses', labelKey: 'courses', ns: 'sections' as const, group: 'qualifications' as const },\n  { id: 'awards', labelKey: 'awards', ns: 'sections' as const, group: 'more' as const },\n  { id: 'involvement', labelKey: 'involvement', ns: 'sections' as const, group: 'more' as const },\n  // Its own section rather than a group under involvement: that record is about\n  // work contributed, this one about capital deployed.\n  { id: 'investments', labelKey: 'investments', ns: 'sections' as const, group: 'more' as const },\n  { id: 'languages', labelKey: 'languages', ns: 'sections' as const, group: 'more' as const },\n  {\n    id: 'other-profiles',\n    labelKey: 'otherProfiles',\n    ns: 'sections' as const,\n    group: 'more' as const,\n  },\n] as const;\n\n/** Every profile section id, in canonical render order. */\nexport type SectionId = (typeof ALL_SECTIONS)[number]['id'];\n\n/** Whether a section has content for a given profile (used to hide empty nav entries for visitors). */\nexport function isSectionPopulated(profile: Profile, id: string): boolean {\n  switch (id) {\n    case 'about':\n      return Boolean(profile.about && profile.headline);\n    case 'career':\n      return Boolean(profile.positions?.length);\n    case 'education':\n      return Boolean(profile.education?.length);\n    case 'courses':\n      return Boolean(profile.courses?.length);\n    case 'skills':\n      return Boolean(profile.skills?.length);\n    case 'projects':\n      return Boolean(profile.projects?.length);\n    case 'credentials':\n      return Boolean(profile.certifications?.length);\n    case 'publications':\n      return Boolean(profile.publications?.length);\n    case 'presentations':\n      return (\n        Boolean(profile.presentations?.length) || Boolean(profile.presentationDeliveries?.length)\n      );\n    case 'involvement':\n      return Boolean(profile.involvement?.length);\n    case 'investments':\n      return Boolean(profile.investments?.length);\n    case 'awards':\n      return Boolean(profile.honors?.length);\n    case 'languages':\n      return Boolean(profile.languages?.length);\n    case 'other-profiles':\n      return Boolean(profile.externalAccounts?.length);\n    default:\n      return false;\n  }\n}\n\n/**\n * The section ids a given viewer should see, in {@link ALL_SECTIONS} order.\n * Owners see every section; visitors only see populated ones.\n */\nexport function getVisibleSectionIds(profile: Profile, isOwnProfile: boolean): SectionId[] {\n  return ALL_SECTIONS.map((s) => s.id).filter(\n    (id) => isOwnProfile || isSectionPopulated(profile, id),\n  );\n}\n\n/** Drop items the owner has hidden from visitors. */\nexport function filterHidden<T extends { hidden?: boolean }>(items: T[] | undefined): T[] {\n  return (items ?? []).filter((i) => !i.hidden);\n}\n\n/**\n * Items visible to a given viewer: owners see their own hidden items, visitors\n * do not. Shared by every export format (markdown, docx, print) and the public\n * `.md` route so the hidden rule lives in one place.\n */\nexport function visibleItems<T extends { hidden?: boolean }>(\n  items: T[] | undefined,\n  isOwnProfile: boolean,\n): T[] {\n  return isOwnProfile ? (items ?? []) : filterHidden(items);\n}\n\n/**\n * English heading text for each section, keyed by {@link SectionId} (e.g.\n * `other-profiles` renders as \"Links\"). Exhaustive `Record<SectionId, string>`:\n * adding a section to {@link ALL_SECTIONS} without a label here is a compile\n * error, so a section can never silently render without (or with a stale)\n * heading. Consumers with i18n resolve their own localized labels via\n * `labelKey`; this is the canonical English fallback used by the exports.\n */\nexport const SECTION_LABELS: Record<SectionId, string> = {\n  about: 'About',\n  career: 'Career',\n  skills: 'Skills',\n  projects: 'Projects',\n  presentations: 'Talks & sessions',\n  publications: 'Publications',\n  credentials: 'Credentials',\n  education: 'Education',\n  courses: 'Courses',\n  awards: 'Awards',\n  involvement: 'Involvement',\n  investments: 'Investments',\n  languages: 'Languages',\n  'other-profiles': 'Links',\n};\n","/** Shared URL helpers for the JSON-LD emitters. */\n\nexport const DEFAULT_BASE_URL = 'https://sifa.id';\n\n/**\n * Drop trailing slashes from a caller-supplied base URL.\n *\n * Written as a scan rather than `replace(/\\/+$/, '')` on purpose: the regex\n * form is a polynomial-backtracking hazard on input the library does not\n * control (CodeQL js/polynomial-redos). This runs in linear time.\n */\nexport function normaliseBaseUrl(baseUrl: string | undefined): string {\n  const value = baseUrl ?? DEFAULT_BASE_URL;\n  let end = value.length;\n  while (end > 0 && value.charCodeAt(end - 1) === 0x2f) end -= 1;\n  return value.slice(0, end);\n}\n\nexport function profileUrl(baseUrl: string, handle: string): string {\n  return `${baseUrl}/p/${handle}`;\n}\n","/**\n * JSON Resume v1.0.0 emitter for a Sifa profile.\n *\n * https://jsonresume.org/schema/\n *\n * One pure function, no fetching, no DOM, no framework -- the same shape as the\n * JSON-LD emitter next door, and for the same reason: sifa.id, page.sifa.id and\n * any future consumer should emit one document from one implementation.\n *\n * Why this format earns its place: it is the lingua franca of CV tooling, so\n * emitting it hands a user every JSON Resume theme, and the Typst CV templates\n * on Typst Universe, without Sifa writing a renderer for any of them.\n *\n * Fields Sifa holds that JSON Resume has no slot for -- endorsements,\n * confirmations, involvement, investments, presentations, courses -- are\n * dropped rather than smuggled into a nearby field. The loss is documented for\n * the user at the point of download.\n */\n\nimport { formatStructuredName } from '../format/pds-utils.js';\nimport { filterHidden } from '../profile/section-model.js';\nimport type {\n  ExternalAccount,\n  LanguageProficiency,\n  LocationValue,\n  ProfileCertification,\n  ProfileEducation,\n  ProfileHonor,\n  ProfileLanguage,\n  ProfilePosition,\n  ProfileProject,\n  ProfilePublication,\n  ProfileSkill,\n  ProfileVolunteering,\n} from '../types/index.js';\nimport { normaliseBaseUrl, profileUrl } from '../jsonld/url.js';\n\nexport type Sanitizer = (input: string) => string;\n\nexport interface JsonResumeOptions {\n  /** Canonical origin for the profile URL. Defaults to `https://sifa.id`. */\n  readonly baseUrl?: string;\n  /** Applied to every user-authored string. Defaults to identity. */\n  readonly sanitize?: Sanitizer;\n  /**\n   * Absolute URL of the profile this resume describes. Defaults to\n   * `${baseUrl}/p/${handle}`. A personal site served from a custom domain is\n   * not at that path.\n   */\n  readonly canonicalUrl?: string;\n}\n\n/**\n * The subset of `Profile` this emitter reads. Deliberately structural rather\n * than the full `Profile`, so a caller holding a partially hydrated profile --\n * or a test -- does not have to invent forty unrelated fields.\n */\nexport interface JsonResumeProfileInput {\n  readonly handle: string;\n  readonly displayName?: string;\n  readonly givenName?: string;\n  readonly familyName?: string;\n  readonly avatar?: string;\n  readonly headline?: string;\n  readonly about?: string;\n  readonly website?: string;\n  readonly location?: LocationValue | null;\n  readonly positions?: ProfilePosition[];\n  readonly education?: ProfileEducation[];\n  readonly skills?: ProfileSkill[];\n  readonly certifications?: ProfileCertification[];\n  readonly projects?: ProfileProject[];\n  readonly publications?: ProfilePublication[];\n  readonly volunteering?: ProfileVolunteering[];\n  readonly honors?: ProfileHonor[];\n  readonly languages?: ProfileLanguage[];\n  readonly externalAccounts?: ExternalAccount[];\n}\n\nexport interface JsonResumeLocation {\n  readonly city?: string;\n  readonly region?: string;\n  readonly countryCode?: string;\n  readonly postalCode?: string;\n}\n\nexport interface JsonResumeProfileLink {\n  readonly network: string;\n  readonly username?: string;\n  readonly url: string;\n}\n\nexport interface JsonResumeBasics {\n  readonly name: string;\n  readonly label?: string;\n  readonly image?: string;\n  readonly url?: string;\n  readonly summary?: string;\n  readonly location?: JsonResumeLocation;\n  readonly profiles?: JsonResumeProfileLink[];\n}\n\nexport interface JsonResumeWork {\n  readonly name?: string;\n  readonly position: string;\n  readonly summary?: string;\n  readonly startDate?: string;\n  readonly endDate?: string;\n}\n\nexport interface JsonResumeVolunteer {\n  readonly organization: string;\n  readonly position?: string;\n  readonly summary?: string;\n  readonly startDate?: string;\n  readonly endDate?: string;\n}\n\nexport interface JsonResumeEducation {\n  readonly institution: string;\n  readonly area?: string;\n  readonly studyType?: string;\n  readonly startDate?: string;\n  readonly endDate?: string;\n}\n\nexport interface JsonResumeAward {\n  readonly title: string;\n  readonly date?: string;\n  readonly awarder?: string;\n  readonly summary?: string;\n}\n\nexport interface JsonResumeCertificate {\n  readonly name: string;\n  readonly date?: string;\n  readonly issuer?: string;\n  readonly url?: string;\n}\n\nexport interface JsonResumePublication {\n  readonly name: string;\n  readonly publisher?: string;\n  readonly releaseDate?: string;\n  readonly url?: string;\n  readonly summary?: string;\n}\n\nexport interface JsonResumeSkill {\n  readonly name: string;\n}\n\nexport interface JsonResumeLanguage {\n  readonly language: string;\n  readonly fluency?: string;\n}\n\nexport interface JsonResumeProject {\n  readonly name: string;\n  readonly description?: string;\n  readonly url?: string;\n  readonly startDate?: string;\n  readonly endDate?: string;\n}\n\nexport interface JsonResumeMeta {\n  readonly canonical: string;\n  readonly version: string;\n  readonly lastModified?: string;\n}\n\nexport interface JsonResume {\n  readonly basics?: JsonResumeBasics;\n  readonly work?: JsonResumeWork[];\n  readonly volunteer?: JsonResumeVolunteer[];\n  readonly education?: JsonResumeEducation[];\n  readonly awards?: JsonResumeAward[];\n  readonly certificates?: JsonResumeCertificate[];\n  readonly publications?: JsonResumePublication[];\n  readonly skills?: JsonResumeSkill[];\n  readonly languages?: JsonResumeLanguage[];\n  readonly projects?: JsonResumeProject[];\n  readonly meta?: JsonResumeMeta;\n}\n\n/** Schema version this emitter targets, as JSON Resume writes it in `meta`. */\nconst SCHEMA_VERSION = 'v1.0.0';\n\n/**\n * A date JSON Resume will accept: `YYYY`, `YYYY-MM` or `YYYY-MM-DD`. Sifa\n * stores RFC 3339 for some fields, and a full timestamp pasted into a CV\n * template renders as `2020-03-04T00:00:00.000Z` on the page.\n */\nconst RESUME_DATE_RE = /^(\\d{4})(-\\d{2})?(-\\d{2})?/;\n\nexport function toResumeDate(value: string | undefined): string | undefined {\n  const trimmed = value?.trim();\n  if (!trimmed) return undefined;\n  const match = RESUME_DATE_RE.exec(trimmed);\n  return match ? match[0] : undefined;\n}\n\n/**\n * JSON Resume's `fluency` is free text, so these are display labels rather\n * than a mapped vocabulary. Kept in one place so export and a future import\n * agree on the spelling.\n */\nconst FLUENCY_LABELS: Record<LanguageProficiency, string> = {\n  elementary: 'Elementary',\n  limited_working: 'Limited working',\n  professional_working: 'Professional working',\n  full_professional: 'Full professional',\n  native: 'Native or bilingual',\n};\n\nconst identity: Sanitizer = (input) => input;\n\n/** Drops keys whose value is undefined, so the document carries no empty slots. */\nfunction compact<T extends object>(value: T): T {\n  return Object.fromEntries(Object.entries(value).filter(([, v]) => v !== undefined)) as T;\n}\n\n/** Omits the key entirely when the mapped list came out empty. */\nfunction section<K extends string, T>(key: K, items: T[]): Record<K, T[]> | undefined {\n  return items.length > 0 ? ({ [key]: items } as Record<K, T[]>) : undefined;\n}\n\nfunction mapLocation(\n  location: LocationValue | null | undefined,\n  s: Sanitizer,\n): JsonResumeLocation | undefined {\n  if (!location) return undefined;\n  const mapped = compact({\n    city: text(location.locality ?? location.city, s),\n    region: text(location.region, s),\n    countryCode: text(location.countryCode, s),\n    postalCode: text(location.postalCode, s),\n  });\n  return Object.keys(mapped).length > 0 ? mapped : undefined;\n}\n\n/** Trimmed, sanitised, and undefined when there is nothing left. */\nfunction text(value: string | undefined, s: Sanitizer): string | undefined {\n  const trimmed = value?.trim();\n  return trimmed ? s(trimmed) : undefined;\n}\n\n/**\n * The name to print for a linked organization. `entityName` is the AppView's\n * resolved current name and wins when present, matching how the profile itself\n * renders these.\n */\nfunction orgName(\n  entityName: string | undefined,\n  stored: string | undefined,\n  s: Sanitizer,\n): string | undefined {\n  return text(entityName, s) ?? text(stored, s);\n}\n\n/**\n * Build a JSON Resume v1.0.0 document from a Sifa profile.\n *\n * Hidden records are dropped. Keys are omitted rather than emitted empty, so a\n * profile with no publications produces a document with no `publications` key\n * instead of one a reader has to interpret.\n */\nexport function profileToJsonResume(\n  profile: JsonResumeProfileInput,\n  options: JsonResumeOptions = {},\n): JsonResume {\n  const s = options.sanitize ?? identity;\n  const baseUrl = normaliseBaseUrl(options.baseUrl);\n  const canonical = options.canonicalUrl ?? profileUrl(baseUrl, profile.handle);\n\n  const name =\n    formatStructuredName(profile.givenName, profile.familyName) ??\n    text(profile.displayName, s) ??\n    profile.handle;\n\n  const profiles = filterHidden(profile.externalAccounts).map((account) =>\n    compact<JsonResumeProfileLink>({\n      network: s(account.platform),\n      username: text(account.label, s),\n      url: account.url,\n    }),\n  );\n\n  const basics = compact<JsonResumeBasics>({\n    name,\n    label: text(profile.headline, s),\n    image: profile.avatar,\n    url: text(profile.website, s) ?? canonical,\n    summary: text(profile.about, s),\n    location: mapLocation(profile.location, s),\n    ...section('profiles', profiles),\n  });\n\n  const work = filterHidden(profile.positions).map((position) =>\n    compact<JsonResumeWork>({\n      name: orgName(position.entityName, position.company, s),\n      position: s(position.title),\n      summary: text(position.description, s),\n      startDate: toResumeDate(position.startedAt),\n      endDate: toResumeDate(position.endedAt),\n    }),\n  );\n\n  const volunteer = filterHidden(profile.volunteering).map((entry) =>\n    compact<JsonResumeVolunteer>({\n      organization: orgName(entry.entityName, entry.organization, s) ?? '',\n      position: text(entry.role, s),\n      summary: text(entry.description, s),\n      startDate: toResumeDate(entry.startDate),\n      endDate: toResumeDate(entry.endDate),\n    }),\n  );\n\n  const education = filterHidden(profile.education).map((entry) =>\n    compact<JsonResumeEducation>({\n      institution: orgName(entry.entityName, entry.institution, s) ?? '',\n      area: text(entry.fieldOfStudy, s),\n      studyType: text(entry.degree, s),\n      startDate: toResumeDate(entry.startedAt),\n      endDate: toResumeDate(entry.endedAt),\n    }),\n  );\n\n  const awards = filterHidden(profile.honors).map((honor) =>\n    compact<JsonResumeAward>({\n      title: s(honor.title),\n      date: toResumeDate(honor.date),\n      awarder: orgName(honor.entityName, honor.issuer, s),\n      summary: text(honor.description, s),\n    }),\n  );\n\n  const certificates = filterHidden(profile.certifications).map((cert) =>\n    compact<JsonResumeCertificate>({\n      name: s(cert.name),\n      date: toResumeDate(cert.issueDate),\n      // `issuingOrg` is the deprecated read-view alias for `authority`; records\n      // indexed before the rename carry only the alias.\n      issuer: orgName(cert.entityName, cert.authority ?? cert.issuingOrg, s),\n      url: text(cert.credentialUrl, s),\n    }),\n  );\n\n  const publications = filterHidden(profile.publications).map((publication) =>\n    compact<JsonResumePublication>({\n      name: s(publication.title),\n      publisher: text(publication.publisher, s),\n      releaseDate: toResumeDate(publication.date),\n      url: text(publication.url, s),\n      summary: text(publication.description, s),\n    }),\n  );\n\n  // One entry per skill rather than JSON Resume's grouped shape: Sifa stores one\n  // record per skill, and keeping the two symmetric is what makes a round-trip\n  // through a third-party editor safe. Category and endorsement counts have no\n  // JSON Resume slot and are dropped. Skill records carry no `hidden` flag, so\n  // there is nothing to filter here.\n  const skills = (profile.skills ?? []).map((skill) => ({ name: s(skill.name) }));\n\n  const languages = filterHidden(profile.languages).map((language) =>\n    compact<JsonResumeLanguage>({\n      language: s(language.language),\n      fluency: language.proficiency ? FLUENCY_LABELS[language.proficiency] : undefined,\n    }),\n  );\n\n  const projects = filterHidden(profile.projects).map((project) =>\n    compact<JsonResumeProject>({\n      name: s(project.name),\n      description: text(project.description, s),\n      url: text(project.url, s),\n      startDate: toResumeDate(project.startDate),\n      endDate: toResumeDate(project.endDate),\n    }),\n  );\n\n  return {\n    basics,\n    ...section('work', work),\n    ...section('volunteer', volunteer),\n    ...section('education', education),\n    ...section('awards', awards),\n    ...section('certificates', certificates),\n    ...section('publications', publications),\n    ...section('skills', skills),\n    ...section('languages', languages),\n    ...section('projects', projects),\n    meta: { canonical, version: SCHEMA_VERSION },\n  };\n}\n"]}