@terrafirmagreg-team/crowdin 0.0.0-stage → 1.0.1

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "@terrafirmagreg-team/crowdin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.1",
+  "type": "module",
+  "description": "Crowdin project members (translator avatars)",
+  "license": "LGPL-3.0-only",
+  "exports": {
+    "./lib/*": [
+      "./src/lib/*.ts",
+      "./src/lib/*/index.ts"
+    ],
+    "./components/*": [
+      "./src/components/*.tsx",
+      "./src/components/*/index.tsx",
+      "./src/components/*/index.ts"
+    ]
+  },
+  "files": [
+    "src"
+  ],
+  "dependencies": {
+    "@terrafirmagreg-team/data": "^1.2.5",
+    "@terrafirmagreg-team/kit": "^1.2.18",
+    "@terrafirmagreg-team/translate": "^1.2.9",
+    "@terrafirmagreg-team/ui": "^1.2.12",
+    "lucide-react": "^1.70.0",
+    "server-only": "^0.0.1"
+  },
+  "peerDependencies": {
+    "react": ">=19",
+    "react-dom": ">=19"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.6",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TerraFirmaGreg-Team/Web-Foundation.git",
+    "directory": "packages/crowdin"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
 }

package/src/components/members-grid.tsx

@@ -0,0 +1,59 @@
+'use client';
+
+import type { CrowdinMember } from '../lib/members';
+import {
+  Avatar,
+  AvatarFallback,
+  AvatarImage,
+} from '@terrafirmagreg-team/ui/components/ui/avatar';
+import { Hint } from '@terrafirmagreg-team/ui/components/blocks/tooltip/hint';
+import { useTranslations } from '@terrafirmagreg-team/translate/hooks/use-translations';
+import { Users } from 'lucide-react';
+
+export function MembersGrid({
+  url,
+  members,
+}: {
+  url: string;
+  members: CrowdinMember[];
+}) {
+  const t = useTranslations();
+  return (
+    <section className="not-prose mt-8 border-t pt-6">
+      <h2 className="mb-4 flex items-center gap-2 text-sm font-medium text-muted-foreground">
+        <Users className="size-4" />
+        <a
+          href={url}
+          target="_blank"
+          rel="noreferrer noopener"
+          className="hover:text-foreground hover:underline"
+        >
+          {t('Translators', { note: 'crowdin.translators' })}
+        </a>
+      </h2>
+      <ul className="flex flex-wrap gap-1.5">
+        {members.map((m) => (
+          <li key={m.username}>
+            <Hint label={m.fullName ?? m.username}>
+              <a
+                href={`https://crowdin.com/profile/${m.username}`}
+                target="_blank"
+                rel="noreferrer noopener"
+              >
+                <Avatar>
+                  <AvatarImage
+                    src={m.avatarUrl}
+                    alt={m.fullName ?? m.username}
+                  />
+                  <AvatarFallback>
+                    {m.username.slice(0, 1).toUpperCase()}
+                  </AvatarFallback>
+                </Avatar>
+              </a>
+            </Hint>
+          </li>
+        ))}
+      </ul>
+    </section>
+  );
+}

package/src/components/members.tsx

@@ -0,0 +1,16 @@
+import 'server-only';
+import { sectionConfig } from '@terrafirmagreg-team/kit/lib/config';
+import type { SectionPageContext } from '@terrafirmagreg-team/kit/types/features';
+import { crowdinMembers, crowdinProjectSlug } from '../lib/members';
+import { MembersGrid } from './members-grid';
+
+export async function CrowdinMembers({ ctx }: { ctx: SectionPageContext }) {
+  const url =
+    ctx.datasetId && ctx.page.slugs.length === 2
+      ? sectionConfig().datasetConfig[ctx.datasetId]?.crowdin
+      : undefined;
+  const slug = crowdinProjectSlug(url);
+  const members = slug ? await crowdinMembers(slug) : undefined;
+  if (!url || !members?.length) return null;
+  return <MembersGrid url={url} members={members} />;
+}

package/src/lib/members.ts

@@ -0,0 +1,59 @@
+import 'server-only';
+import { createAsyncCache } from '@terrafirmagreg-team/data/lib/async-cache';
+
+const CROWDIN_ORG = 'terrafirmagreg';
+const API = `https://${CROWDIN_ORG}.api.crowdin.com/api/v2`;
+const PAGE_SIZE = 500;
+
+export type CrowdinMember = {
+  username: string;
+  fullName: string | null;
+  avatarUrl: string;
+  roles?: { name: string }[];
+};
+
+async function api<T>(path: string): Promise<T | undefined> {
+  const token = process.env.CROWDIN_API_TOKEN;
+  if (!token) return undefined;
+  const res = await fetch(`${API}${path}`, {
+    headers: { Authorization: `Bearer ${token}` },
+    next: { revalidate: 3600 },
+  } as RequestInit);
+  if (!res.ok) return undefined;
+  return (await res.json()) as T;
+}
+
+const projectId = createAsyncCache(async (identifier: string) => {
+  const res = await api<{
+    data: { data: { id: number; identifier: string } }[];
+  }>(`/projects?limit=${PAGE_SIZE}`);
+  return res?.data.find((p) => p.data.identifier === identifier)?.data.id;
+});
+
+export const crowdinMembers = createAsyncCache(
+  async (identifier: string): Promise<CrowdinMember[] | undefined> => {
+    const id = await projectId(identifier);
+    if (id === undefined) return undefined;
+    const members: CrowdinMember[] = [];
+    for (let offset = 0; ; offset += PAGE_SIZE) {
+      const res = await api<{ data: { data: CrowdinMember }[] }>(
+        `/projects/${id}/members?limit=${PAGE_SIZE}&offset=${offset}`,
+      );
+      const batch = res?.data ?? [];
+      members.push(...batch.map((m) => m.data));
+      if (batch.length < PAGE_SIZE) break;
+    }
+    return members;
+  },
+  (id) => id,
+  3_600_000,
+);
+
+export function crowdinProjectSlug(url: string | undefined) {
+  if (!url) return undefined;
+  try {
+    return new URL(url).pathname.split('/').filter(Boolean).pop();
+  } catch {
+    return undefined;
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.