@takuhon/core 0.14.0 → 0.15.0

package/dist/index.d.ts

@@ -3697,20 +3697,69 @@ declare class ConflictError extends StorageError {
  * snapshot always renders the same markup, so both rendering surfaces (the
  * static HTML export and the React profile) and their tests stay in lockstep.
  *
+ * The card paints an **opaque background rectangle** first, so it stays legible
+ * wherever it is embedded — including a GitHub README served through the Camo
+ * image proxy, where no surrounding page styles apply and a transparent card
+ * would render invisibly on a dark theme. The colour set is supplied by a
+ * {@link Palette}: {@link renderActivitySvg} defaults to {@link LIGHT_PALETTE},
+ * and a transport (a Worker route, the CLI build) can pass {@link DARK_PALETTE}
+ * to serve a dark variant. Both palettes are plain data, so the render stays
+ * deterministic.
+ *
  * Every snapshot-derived string (language names, dates) is XML-escaped before
  * it reaches the markup: language names come from an external API and are
  * treated as untrusted. An empty snapshot (no metric fields) renders to `''`
  * so callers can omit the section with a truthiness check.
  */
 
+/**
+ * Colour set for an activity card. Kept as plain data (no CSS variables, no
+ * `currentColor`) so the rendered SVG is fully self-contained and legible when
+ * served as an image through Camo, where no page styles apply.
+ */
+interface Palette {
+    /** Fill of the opaque background rectangle behind the whole card. */
+    background: string;
+    /** Primary text (language legend, coding-time figure). */
+    text: string;
+    /** Secondary text (captions, rank score, "Last synced"). */
+    muted: string;
+    /** Accent fill (the rank badge disc). */
+    accent: string;
+    /**
+     * Order-based palette for the language bar and its legend chips; entries are
+     * assigned to the top languages in order, and anything past the end (or the
+     * folded "Other" segment) uses {@link Palette.otherColor}.
+     */
+    languageColors: readonly string[];
+    /** Colour of the folded "Other" language segment. */
+    otherColor: string;
+    /** Five-step contribution heat ramp, lowest (zero) first. */
+    heatColors: readonly string[];
+}
+/** Default palette: dark text on an opaque white card. */
+declare const LIGHT_PALETTE: Palette;
+/**
+ * Dark variant: light text on an opaque dark card (tuned to read on a GitHub
+ * dark-theme README). The heat ramp stays in the card's blue family rather than
+ * borrowing GitHub's green, so light and dark cards look like the same design.
+ */
+declare const DARK_PALETTE: Palette;
+/** Options accepted by {@link renderActivitySvg}. */
+interface RenderActivitySvgOptions {
+    /** Colour set to render with. Defaults to {@link LIGHT_PALETTE}. */
+    palette?: Palette;
+}
 /**
  * Render the activity snapshot as a self-contained `<svg>` string, or `''`
  * when the snapshot carries no metric data (so callers can omit the section).
  * Sections render independently — whatever the snapshot holds is shown, the
  * rest is left out — and `lastSyncedAt`'s date is always stamped in the footer
- * so staleness stays visible.
+ * so staleness stays visible. Colours come from `options.palette`
+ * ({@link LIGHT_PALETTE} by default); the card always paints an opaque
+ * background so it stays legible when embedded as an image.
  */
-declare function renderActivitySvg(snapshot: ActivitySnapshot): string;
+declare function renderActivitySvg(snapshot: ActivitySnapshot, options?: RenderActivitySvgOptions): string;
 
 /**
  * Résumé / CV projection of a profile.
@@ -4010,4 +4059,4 @@ declare function stripImageMetadata(bytes: Uint8Array, mime: AcceptedImageMime):
  */
 declare const SCHEMA_VERSION = "0.5.0";
 
-export { ACCEPTED_IMAGE_MIME_TYPES, type AcceptedImageMime, type ActivitySettings, type ActivitySnapshot, type ActivityStorage, type Address, type AssetOptions, type AssetRecord, type Avatar, type Career, type Certification, type CodingTime, ConflictError, type Contact, type ContentLicense, type ContentLicenseAttribution, type ContributionCalendar, type ContributionDay, type Course, type CvDocument, type CvHeader, type CvSection, type CvSectionKind, type Education, type ExportOptions, type ExportedTakuhon, type Honor, IMAGE_EXTENSIONS, type ImageInfo, ImportError, type Iso3166Alpha2, type IsoDateTime, type Language, type LanguageBreakdown, type LanguageProficiency, type Link, type LinkBuiltin, type LinkCustom, type LinkType, type LocaleTag, type LocalizedAddress, type LocalizedAvatar, type LocalizedBody, type LocalizedCareer, type LocalizedCertification, type LocalizedCourse, type LocalizedEducation, type LocalizedHonor, type LocalizedLanguage, type LocalizedLink, type LocalizedLinkBuiltin, type LocalizedLinkCustom, type LocalizedMembership, type LocalizedPatent, type LocalizedProfile, type LocalizedProject, type LocalizedPublication, type LocalizedRecommendation, type LocalizedRecommendationAuthor, type LocalizedTakuhon, type LocalizedTestScore, type LocalizedTitle, type LocalizedVolunteering, MAX_IMAGE_BYTES, MAX_IMAGE_DIMENSION, MAX_IMAGE_FRAMES, 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 Patent, type PatentStatus, type Profile, type Project, type Publication, RANK_FULL_CODING_HOURS, RANK_FULL_CONTRIBUTIONS, RANK_TIER_THRESHOLDS, type RankInput, type RankTier, type RankTierLabel, type Recommendation, type RecommendationAuthor, SCHEMA_VERSION, SUPPORTED_SCHEMA_VERSIONS, type Schema, type Settings, type Skill, type Slug, StorageError, type Takuhon, type TakuhonAssetStorage, type TakuhonStorage, type TestScore, type ValidationError, type ValidationResult, type Volunteering, type YearMonth, applyPublicPrivacyFilter, computeLanguagePercentages, deriveCv, deriveRankTier, detectImageMime, executeMcpTool, exportTakuhon, formatCodingTime, generateJsonLd, generatePersonJsonLd, generateProfilePageJsonLd, 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 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 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, importTakuhon, isActivitySnapshot, migrateTakuhon, migrations, normalize, readImageInfo, readMcpResource, renderActivitySvg, resolveLocale, schema, stripImageMetadata, validate };

package/dist/index.js

@@ -11413,18 +11413,30 @@ function deriveRankTier(input) {
 var WIDTH = 520;
 var PAD = 16;
 var INNER = WIDTH - PAD * 2;
-var TEXT_COLOR = "#1a1a1a";
-var MUTED_COLOR = "#666666";
-var ACCENT_COLOR = "#0b5fff";
 var FONT_FAMILY = "system-ui,-apple-system,Segoe UI,Roboto,sans-serif";
-var LANGUAGE_COLORS = ["#0b5fff", "#7c3aed", "#059669", "#d97706", "#dc2626", "#0891b2"];
-var OTHER_COLOR = "#9ca3af";
 var MAX_LANGUAGES = 6;
-var HEAT_COLORS = ["#ebedf0", "#cce0ff", "#99c2ff", "#4d8aff", "#0b5fff"];
 var CELL = 7;
 var CELL_PITCH = 9;
 var CALENDAR_ROWS = 7;
 var MAX_CALENDAR_DAYS = 53 * CALENDAR_ROWS;
+var LIGHT_PALETTE = {
+  background: "#ffffff",
+  text: "#1a1a1a",
+  muted: "#666666",
+  accent: "#0b5fff",
+  languageColors: ["#0b5fff", "#7c3aed", "#059669", "#d97706", "#dc2626", "#0891b2"],
+  otherColor: "#9ca3af",
+  heatColors: ["#ebedf0", "#cce0ff", "#99c2ff", "#4d8aff", "#0b5fff"]
+};
+var DARK_PALETTE = {
+  background: "#0d1117",
+  text: "#e6edf3",
+  muted: "#9198a1",
+  accent: "#4493f8",
+  languageColors: ["#4493f8", "#a371f7", "#3fb950", "#d29922", "#f85149", "#39c5cf"],
+  otherColor: "#6e7681",
+  heatColors: ["#161b22", "#0a2c5e", "#11468f", "#1f6fdb", "#4493f8"]
+};
 function escapeXml(value) {
   return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
 }
@@ -11441,23 +11453,23 @@ function text(x, y, content, opts) {
   const anchor = opts.anchor !== void 0 ? ` text-anchor="${opts.anchor}"` : "";
   return `<text x="${String(x)}" y="${String(y)}" font-family="${FONT_FAMILY}" font-size="${String(opts.size)}" fill="${opts.fill}"${weight}${anchor}>${escapeXml(content)}</text>`;
 }
-function caption(x, y, label) {
-  return text(x, y, label, { size: 12, fill: MUTED_COLOR, weight: 600 });
+function caption(x, y, label, fill) {
+  return text(x, y, label, { size: 12, fill, weight: 600 });
 }
 function rect(x, y, w, h, fill, rx = 0) {
   const corner = rx > 0 ? ` rx="${String(rx)}"` : "";
   return `<rect x="${String(round2(x))}" y="${String(y)}" width="${String(round2(w))}" height="${String(h)}" fill="${fill}"${corner}/>`;
 }
-function languageSegments(languages) {
+function languageSegments(languages, palette) {
   const segments = languages.slice(0, MAX_LANGUAGES).map((l, i) => ({
     name: l.name,
     percent: l.percent,
-    color: LANGUAGE_COLORS[i] ?? OTHER_COLOR
+    color: palette.languageColors[i] ?? palette.otherColor
   }));
   const rest = languages.slice(MAX_LANGUAGES);
   if (rest.length > 0) {
     const percent = round2(rest.reduce((sum, l) => sum + l.percent, 0));
-    segments.push({ name: "Other", percent, color: OTHER_COLOR });
+    segments.push({ name: "Other", percent, color: palette.otherColor });
   }
   return segments.filter((s) => s.percent > 0);
 }
@@ -11465,7 +11477,8 @@ function heatLevel(count, max) {
   if (count <= 0) return 0;
   return Math.min(4, Math.max(1, Math.ceil(count / max * 4)));
 }
-function renderActivitySvg(snapshot) {
+function renderActivitySvg(snapshot, options = {}) {
+  const palette = options.palette ?? LIGHT_PALETTE;
   const hasLanguages = snapshot.languages !== void 0 && snapshot.languages.length > 0;
   const hasContributions = snapshot.contributions !== void 0 && snapshot.contributions.days.length > 0;
   const hasCodingTime = snapshot.codingTime !== void 0;
@@ -11474,9 +11487,9 @@ function renderActivitySvg(snapshot) {
   const parts = [];
   let y = PAD;
   if (hasLanguages && snapshot.languages) {
-    const segments = languageSegments(snapshot.languages);
+    const segments = languageSegments(snapshot.languages, palette);
     const total = segments.reduce((sum, s) => sum + s.percent, 0);
-    parts.push(caption(PAD, y + 11, "Languages"));
+    parts.push(caption(PAD, y + 11, "Languages", palette.muted));
     y += 22;
     let x = PAD;
     for (const segment of segments) {
@@ -11493,7 +11506,7 @@ function renderActivitySvg(snapshot) {
       parts.push(
         text(cx + 16, cy + 9, `${segment.name} ${String(segment.percent)}%`, {
           size: 12,
-          fill: TEXT_COLOR
+          fill: palette.text
         })
       );
     });
@@ -11503,13 +11516,18 @@ function renderActivitySvg(snapshot) {
     const days = snapshot.contributions.days.slice(-MAX_CALENDAR_DAYS);
     const max = days.reduce((m, d) => Math.max(m, d.count), 1);
     parts.push(
-      caption(PAD, y + 11, `Contributions \xB7 ${groupDigits(snapshot.contributions.total)}`)
+      caption(
+        PAD,
+        y + 11,
+        `Contributions \xB7 ${groupDigits(snapshot.contributions.total)}`,
+        palette.muted
+      )
     );
     y += 22;
     days.forEach((day, i) => {
       const column = Math.floor(i / CALENDAR_ROWS);
       const row = i % CALENDAR_ROWS;
-      const fill = HEAT_COLORS[heatLevel(day.count, max)] ?? HEAT_COLORS[0];
+      const fill = palette.heatColors[heatLevel(day.count, max)] ?? palette.heatColors[0];
       parts.push(rect(PAD + column * CELL_PITCH, y + row * CELL_PITCH, CELL, CELL, fill, 1.5));
     });
     y += CALENDAR_ROWS * CELL_PITCH - (CELL_PITCH - CELL) + 12;
@@ -11518,21 +11536,21 @@ function renderActivitySvg(snapshot) {
     const rankX = PAD + INNER - 120;
     if (hasCodingTime && snapshot.codingTime) {
       const t = snapshot.codingTime;
-      parts.push(caption(PAD, y + 11, "Coding time"));
+      parts.push(caption(PAD, y + 11, "Coding time", palette.muted));
       parts.push(
         text(PAD, y + 38, `${groupDigits(t.hours)}h ${String(t.minutes)}m`, {
           size: 22,
-          fill: TEXT_COLOR,
+          fill: palette.text,
           weight: 700
         })
       );
     }
     if (hasRank && snapshot.rank) {
       const rank = snapshot.rank;
-      parts.push(caption(rankX, y + 11, "Rank"));
+      parts.push(caption(rankX, y + 11, "Rank", palette.muted));
       const centerY = y + 32;
       parts.push(
-        `<circle cx="${String(rankX + 14)}" cy="${String(centerY)}" r="14" fill="${ACCENT_COLOR}"/>`
+        `<circle cx="${String(rankX + 14)}" cy="${String(centerY)}" r="14" fill="${palette.accent}"/>`
       );
       parts.push(
         `<text x="${String(rankX + 14)}" y="${String(centerY)}" font-family="${FONT_FAMILY}" font-size="14" font-weight="700" fill="#ffffff" text-anchor="middle" dominant-baseline="central">${escapeXml(rank.tier)}</text>`
@@ -11540,7 +11558,7 @@ function renderActivitySvg(snapshot) {
       parts.push(
         text(rankX + 36, centerY + 4, `score ${String(rank.score)}`, {
           size: 12,
-          fill: MUTED_COLOR
+          fill: palette.muted
         })
       );
     }
@@ -11549,13 +11567,14 @@ function renderActivitySvg(snapshot) {
   parts.push(
     text(WIDTH - PAD, y + 11, `Last synced ${snapshot.lastSyncedAt.slice(0, 10)}`, {
       size: 11,
-      fill: MUTED_COLOR,
+      fill: palette.muted,
       anchor: "end"
     })
   );
   y += 22;
   const height = y + PAD - 12;
-  return `<svg xmlns="http://www.w3.org/2000/svg" width="${String(WIDTH)}" height="${String(height)}" viewBox="0 0 ${String(WIDTH)} ${String(height)}" role="img" aria-label="Developer activity"><title>Developer activity</title>${parts.join("")}</svg>`;
+  const background = rect(0, 0, WIDTH, height, palette.background);
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="${String(WIDTH)}" height="${String(height)}" viewBox="0 0 ${String(WIDTH)} ${String(height)}" role="img" aria-label="Developer activity"><title>Developer activity</title>${background}${parts.join("")}</svg>`;
 }
 
 // src/cv.ts
@@ -12077,8 +12096,10 @@ var SCHEMA_VERSION = "0.5.0";
 export {
   ACCEPTED_IMAGE_MIME_TYPES,
   ConflictError,
+  DARK_PALETTE,
   IMAGE_EXTENSIONS,
   ImportError,
+  LIGHT_PALETTE,
   MAX_IMAGE_BYTES,
   MAX_IMAGE_DIMENSION,
   MAX_IMAGE_FRAMES,