@takuhon/core 0.22.0 → 0.24.0

package/dist/index.d.ts

@@ -4208,6 +4208,43 @@ interface GravatarOptions {
  */
 declare function gravatarUrl(email: string, options?: GravatarOptions): string;
 
+/**
+ * Format an ISO date (`YYYY-MM` or `YYYY-MM-DD`) as human-facing text in the
+ * given locale — e.g. `2024-11` renders as `Nov 2024` (en) / `2024年11月` (ja),
+ * and `2025-12-22` as `Dec 22, 2025` (en) / `2025年12月22日` (ja).
+ *
+ * This is the single date-formatting transform shared by the static HTML and CV
+ * renderers in `@takuhon/api` (via their `dateRange`/`timeTag` helpers). The
+ * machine-readable ISO value is never altered: the caller keeps it verbatim in
+ * the enclosing `<time datetime>` attribute. The machine-readable surfaces
+ * (JSON-LD, `/api/profile`, `takuhon.json`, MCP) must NOT call this — they emit
+ * raw ISO so consuming machines decide their own presentation.
+ *
+ * The date is built with `setUTCFullYear` — not `Date.UTC`, which coerces years
+ * 0-99 into 1900-1999 — and formatted in UTC, so a month-precision value keeps
+ * its century and never slips to the previous month west of UTC (`new
+ * Date('2024-05')` parses as midnight UTC and would render as the prior month).
+ *
+ * Every failure path is fail-safe (this never throws):
+ * - A value that is not a well-formed `YYYY-MM`/`YYYY-MM-DD` (wrong shape, an
+ *   out-of-range month/day digit, or a calendar-impossible date such as
+ *   `2024-02-30`) is returned unchanged, never a shifted or `Invalid Date`.
+ * - An empty `locale` is replaced with `en` before the call, because
+ *   `Intl.DateTimeFormat('')` throws a `RangeError`. A structurally invalid
+ *   BCP-47 tag also throws and is caught, again falling back to `en`. A
+ *   well-formed but unregistered tag (e.g. `zz`) does not throw — `Intl`
+ *   negotiates it (typically to English) without entering the catch.
+ */
+declare function formatDate(value: string, locale: LocaleTag): string;
+
+/**
+ * Resolve the "Present" timeline label for the given locale. Tries the exact
+ * tag, then the base language subtag (so a resolved `ja-JP` still finds `ja`,
+ * mirroring core's regional-subtag fallback), then English. Callers pass a
+ * `LocalizedTakuhon.resolvedLocale`.
+ */
+declare function getPresentLabel(locale: LocaleTag): string;
+
 /**
  * MCP (Model Context Protocol) projection of a profile.
  *
@@ -4417,4 +4454,4 @@ declare function stripImageMetadata(bytes: Uint8Array, mime: AcceptedImageMime):
  */
 declare const SCHEMA_VERSION = "0.7.0";
 
-export { ACCEPTED_IMAGE_MIME_TYPES, type AcceptedImageMime, type ActivitySettings, type ActivitySnapshot, type ActivityStorage, type Address, type AssetOptions, type AssetRecord, type Avatar, type Career, type Certification, type CodingTime, ConflictError, type Contact, type ContentLicense, type ContentLicenseAttribution, type ContributionCalendar, type ContributionDay, type Course, type CvDocument, type CvHeader, type CvSection, type CvSectionKind, DARK_PALETTE, type Education, type ExportOptions, type ExportedTakuhon, type GravatarOptions, type Honor, IMAGE_EXTENSIONS, type ImageInfo, ImportError, type Iso3166Alpha2, type IsoDateTime, LIGHT_PALETTE, type Language, type LanguageBreakdown, type LanguageProficiency, type Link, type LinkBuiltin, type LinkCustom, type LinkType, type LocaleTag, type LocalizedAddress, type LocalizedAvatar, type LocalizedBody, type LocalizedCareer, type LocalizedCertification, type LocalizedCourse, type LocalizedEducation, type LocalizedHonor, type LocalizedLanguage, type LocalizedLink, type LocalizedLinkBuiltin, type LocalizedLinkCustom, type LocalizedMembership, type LocalizedPatent, type LocalizedProfile, type LocalizedProject, type LocalizedPublication, type LocalizedRecommendation, type LocalizedRecommendationAuthor, type LocalizedTakuhon, type LocalizedTestScore, type LocalizedTitle, type LocalizedVolunteering, MAX_IMAGE_BYTES, MAX_IMAGE_DIMENSION, MAX_IMAGE_FRAMES, MCP_PROFILE_SECTIONS, MCP_RESOURCES, MCP_TOOLS, type McpInputSchema, type McpProfileSection, McpRequestError, type McpResourceDefinition, type McpResourceResult, type McpToolDefinition, type McpToolResult, type Membership, type Meta, type MetaPrivacy, type Migration, MigrationError, type NormalizedTakuhon, NotFoundError, type Palette, type Patent, type PatentStatus, type Profile, type Project, type PublicVisibility, type Publication, RANK_FULL_CODING_HOURS, RANK_FULL_CONTRIBUTIONS, RANK_TIER_THRESHOLDS, type RankInput, type RankTier, type RankTierLabel, type Recommendation, type RecommendationAuthor, type RenderActivitySvgOptions, SCHEMA_VERSION, SUPPORTED_SCHEMA_VERSIONS, type Schema, type Settings, type Skill, type Slug, StorageError, type Takuhon, type TakuhonAssetStorage, type TakuhonStorage, type TestScore, type ValidationError, type ValidationResult, type Volunteering, type YearMonth, applyPublicPrivacyFilter, computeLanguagePercentages, deriveCv, deriveRankTier, detectImageMime, executeMcpTool, exportTakuhon, formatCodingTime, generateJsonLd, generatePersonJsonLd, generateProfilePageJsonLd, gravatarUrl, importTakuhon, isActivitySnapshot, migrateTakuhon, migrations, normalize, readImageInfo, readMcpResource, renderActivitySvg, resolveLocale, schema, stripImageMetadata, validate };
+export { ACCEPTED_IMAGE_MIME_TYPES, type AcceptedImageMime, type ActivitySettings, type ActivitySnapshot, type ActivityStorage, type Address, type AssetOptions, type AssetRecord, type Avatar, type Career, type Certification, type CodingTime, ConflictError, type Contact, type ContentLicense, type ContentLicenseAttribution, type ContributionCalendar, type ContributionDay, type Course, type CvDocument, type CvHeader, type CvSection, type CvSectionKind, DARK_PALETTE, type Education, type ExportOptions, type ExportedTakuhon, type GravatarOptions, type Honor, IMAGE_EXTENSIONS, type ImageInfo, ImportError, type Iso3166Alpha2, type IsoDateTime, LIGHT_PALETTE, type Language, type LanguageBreakdown, type LanguageProficiency, type Link, type LinkBuiltin, type LinkCustom, type LinkType, type LocaleTag, type LocalizedAddress, type LocalizedAvatar, type LocalizedBody, type LocalizedCareer, type LocalizedCertification, type LocalizedCourse, type LocalizedEducation, type LocalizedHonor, type LocalizedLanguage, type LocalizedLink, type LocalizedLinkBuiltin, type LocalizedLinkCustom, type LocalizedMembership, type LocalizedPatent, type LocalizedProfile, type LocalizedProject, type LocalizedPublication, type LocalizedRecommendation, type LocalizedRecommendationAuthor, type LocalizedTakuhon, type LocalizedTestScore, type LocalizedTitle, type LocalizedVolunteering, MAX_IMAGE_BYTES, MAX_IMAGE_DIMENSION, MAX_IMAGE_FRAMES, MCP_PROFILE_SECTIONS, MCP_RESOURCES, MCP_TOOLS, type McpInputSchema, type McpProfileSection, McpRequestError, type McpResourceDefinition, type McpResourceResult, type McpToolDefinition, type McpToolResult, type Membership, type Meta, type MetaPrivacy, type Migration, MigrationError, type NormalizedTakuhon, NotFoundError, type Palette, type Patent, type PatentStatus, type Profile, type Project, type PublicVisibility, type Publication, RANK_FULL_CODING_HOURS, RANK_FULL_CONTRIBUTIONS, RANK_TIER_THRESHOLDS, type RankInput, type RankTier, type RankTierLabel, type Recommendation, type RecommendationAuthor, type RenderActivitySvgOptions, SCHEMA_VERSION, SUPPORTED_SCHEMA_VERSIONS, type Schema, type Settings, type Skill, type Slug, StorageError, type Takuhon, type TakuhonAssetStorage, type TakuhonStorage, type TestScore, type ValidationError, type ValidationResult, type Volunteering, type YearMonth, applyPublicPrivacyFilter, computeLanguagePercentages, deriveCv, deriveRankTier, detectImageMime, executeMcpTool, exportTakuhon, formatCodingTime, formatDate, generateJsonLd, generatePersonJsonLd, generateProfilePageJsonLd, getPresentLabel, gravatarUrl, importTakuhon, isActivitySnapshot, migrateTakuhon, migrations, normalize, readImageInfo, readMcpResource, renderActivitySvg, resolveLocale, schema, stripImageMetadata, validate };

package/dist/index.js

@@ -12459,6 +12459,37 @@ function gravatarUrl(email, options) {
   return query ? `${GRAVATAR_AVATAR_BASE}${hash}?${query}` : `${GRAVATAR_AVATAR_BASE}${hash}`;
 }
 
+// src/date-format.ts
+var ISO_DATE = /^(\d{4})-(0[1-9]|1[0-2])(?:-(0[1-9]|[12]\d|3[01]))?$/;
+function formatDate(value, locale) {
+  const match = ISO_DATE.exec(value);
+  if (!match) return value;
+  const year = Number(match[1]);
+  const month = Number(match[2]);
+  const day = match[3] !== void 0 ? Number(match[3]) : void 0;
+  const date = /* @__PURE__ */ new Date(0);
+  date.setUTCFullYear(year, month - 1, day ?? 1);
+  if (date.getUTCFullYear() !== year || date.getUTCMonth() !== month - 1 || date.getUTCDate() !== (day ?? 1)) {
+    return value;
+  }
+  const options = day !== void 0 ? { year: "numeric", month: "short", day: "numeric", timeZone: "UTC" } : { year: "numeric", month: "short", timeZone: "UTC" };
+  try {
+    return new Intl.DateTimeFormat(locale || "en", options).format(date);
+  } catch {
+    return new Intl.DateTimeFormat("en", options).format(date);
+  }
+}
+
+// src/ui-labels.ts
+var PRESENT_LABELS = {
+  en: "Present",
+  ja: "\u73FE\u5728"
+};
+function getPresentLabel(locale) {
+  const base = locale.split("-")[0] ?? locale;
+  return PRESENT_LABELS[locale] ?? PRESENT_LABELS[base] ?? "Present";
+}
+
 // src/mcp.ts
 var MCP_PROFILE_SECTIONS = [
   "profile",
@@ -12976,9 +13007,11 @@ export {
   executeMcpTool,
   exportTakuhon,
   formatCodingTime,
+  formatDate,
   generateJsonLd,
   generatePersonJsonLd,
   generateProfilePageJsonLd,
+  getPresentLabel,
   gravatarUrl,
   importTakuhon,
   isActivitySnapshot,