@eifi1/ui-kit 0.28.0 → 0.29.0

package/dist/lib/person-name.js

@@ -0,0 +1,65 @@
+"use client";
+const CJK = /\p{Script=Han}|\p{Script=Hiragana}|\p{Script=Katakana}|\p{Script=Hangul}/u;
+function language(locale) {
+  return (locale ?? "").split(/[-_]/)[0].toLowerCase();
+}
+function nameOrder(locale, first, last) {
+  const lang = language(locale);
+  if (lang === "hu") return "family-first";
+  if (lang === "zh" && (!first || CJK.test(first)) && (!last || CJK.test(last))) {
+    return "family-first-joined";
+  }
+  return "given-first";
+}
+function clean(part) {
+  return (part ?? "").trim();
+}
+function formatPersonName(name, locale) {
+  const first = clean(name.first);
+  const last = clean(name.last);
+  if (!last) return first;
+  if (!first) return last;
+  switch (nameOrder(locale, first, last)) {
+    case "family-first":
+      return `${last} ${first}`;
+    case "family-first-joined":
+      return `${last}${first}`;
+    default:
+      return `${first} ${last}`;
+  }
+}
+let graphemes;
+function firstGrapheme(text) {
+  graphemes ??= typeof Intl !== "undefined" && "Segmenter" in Intl ? new Intl.Segmenter(void 0, { granularity: "grapheme" }) : null;
+  if (graphemes) {
+    const segment = graphemes.segment(text)[Symbol.iterator]().next();
+    if (!segment.done) return segment.value.segment;
+  }
+  return [...text][0] ?? "";
+}
+function upper(text, locale) {
+  try {
+    return text.toLocaleUpperCase(locale);
+  } catch {
+    return text.toUpperCase();
+  }
+}
+function personInitials(name, locale) {
+  const first = clean(name.first);
+  const last = clean(name.last);
+  if (!first && !last) return "";
+  const order = nameOrder(locale, first, last);
+  if (order === "family-first-joined") return upper(firstGrapheme(last || first), locale);
+  if (!first || !last) {
+    const words = (first || last).split(/\s+/);
+    const initials = words.length >= 2 ? firstGrapheme(words[0]) + firstGrapheme(words[1]) : [...words[0]].slice(0, 2).join("");
+    return upper(initials, locale);
+  }
+  const pair = order === "family-first" ? [last, first] : [first, last];
+  return upper(firstGrapheme(pair[0]) + firstGrapheme(pair[1]), locale);
+}
+export {
+  formatPersonName,
+  personInitials
+};
+//# sourceMappingURL=person-name.js.map

package/dist/lib/person-name.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/person-name.ts"],"sourcesContent":["/**\n * A person's name as the reader's language writes it — the one rule of\n * docs/auth-harmonization.md §3.2 for every place a name is shown: the top bar, the\n * account menu, user lists, avatars, feedback, the greeting in a mail.\n *\n * WHY A FUNCTION AND NOT `${first} ${last}`. The three apps move from one free-text\n * `display_name` to `first_name` + `last_name` (§2.3), and the moment a name has two\n * parts, their ORDER is a language rule, not a data rule:\n *\n *  - \"First Last\" in de-CH, en, fr, it and es — \"Ada Example\";\n *  - **\"Last First\" in hu** — Hungarian puts the family name first: \"Example Ada\";\n *  - **\"LastFirst\" with no space in zh** — a Chinese name is written family name first\n *    and run together: 李 + 小龙 → \"李小龙\". Only a name written in CJK characters,\n *    though: BOTH parts must hold Han (or kana, or hangul) characters. A Latin name read\n *    in Chinese stays as it is written — \"Ada Lovelace\", not \"LovelaceAda\" (the\n *    coordinator's refinement of §3.2, 2026-10-06).\n *\n * WHOSE language (§3.2, §10.6): on screen the READER's, so this takes the locale of the\n * UI, never the locale stored with the person. A mail uses the recipient's and a frozen\n * stamp the author's — that is server-kit's `full_name(first, last, locale)`, which\n * follows exactly these rules so a name reads the same in the app and in its mails.\n *\n * NOTHING IS GUESSED. Both parts are trimmed, and an empty part simply drops out: a\n * migrated keksdose or Kurvenschmiede user keeps the whole old display name as the\n * first name and an empty last name until they complete it (§3.3), and \"Ada Example\"\n * with no last name must still read \"Ada Example\" — not \"Ada Example \" and not a split\n * at the space. Inner spaces are the person's own and stay as typed.\n *\n * Only the language subtag counts (\"de-CH\" → \"de\", \"zh-Hant-TW\" → \"zh\"), and a language\n * this does not know reads \"First Last\", the order of the kit's five other languages.\n */\n\n/** The two parts of a person's name. Either may be missing or blank: a migrated row\n *  has an empty `last` until it is completed (§3.3), and APIs send `null` for \"none\". */\nexport interface PersonName {\n  /** The given name — `first_name`. */\n  first?: string | null;\n  /** The family name — `last_name`. */\n  last?: string | null;\n}\n\ntype NameOrder = \"given-first\" | \"family-first\" | \"family-first-joined\";\n\n/** A part written in CJK characters: Han, and kana or hangul where they occur (a\n *  Japanese or Korean name in a Chinese UI). One such character is enough. */\nconst CJK = /\\p{Script=Han}|\\p{Script=Hiragana}|\\p{Script=Katakana}|\\p{Script=Hangul}/u;\n\nfunction language(locale: string | undefined): string {\n  return (locale ?? \"\").split(/[-_]/)[0]!.toLowerCase();\n}\n\n/**\n * The order the reader's language writes THIS name in. See the module note: hu puts the\n * family name first for every name; zh runs a CJK name together family-first and leaves\n * any other name as it is written; the rest write the given name first. A part that is\n * empty passes the CJK test, so a one-part name orders by the part it has. Called with\n * at least one part filled in.\n */\nfunction nameOrder(locale: string | undefined, first: string, last: string): NameOrder {\n  const lang = language(locale);\n  if (lang === \"hu\") return \"family-first\";\n  if (lang === \"zh\" && (!first || CJK.test(first)) && (!last || CJK.test(last))) {\n    return \"family-first-joined\";\n  }\n  return \"given-first\";\n}\n\nfunction clean(part: string | null | undefined): string {\n  return (part ?? \"\").trim();\n}\n\n/**\n * The full name in the reader's order: \"Ada Example\" (en, de, fr, it, es), \"Example Ada\"\n * (hu), \"李小龙\" (zh, for a name in CJK characters — \"Ada Lovelace\" stays so). Trimmed;\n * with one part empty, the other alone; with both empty, `\"\"` — so a caller can fall\n * back with `||` (`formatPersonName(p, l) || email`).\n *\n * `locale` is the READER's — the UI language, `useKitLocale()` in a component. Left out,\n * the given-name-first order.\n */\nexport function formatPersonName(name: PersonName, locale?: string): string {\n  const first = clean(name.first);\n  const last = clean(name.last);\n  if (!last) return first;\n  if (!first) return last;\n  switch (nameOrder(locale, first, last)) {\n    case \"family-first\":\n      return `${last} ${first}`;\n    case \"family-first-joined\":\n      return `${last}${first}`;\n    default:\n      return `${first} ${last}`;\n  }\n}\n\n/** One segmenter for every avatar on the page, made on first use. `null`: the runtime\n *  has none, and code points have to do. */\nlet graphemes: Intl.Segmenter | null | undefined;\n\n/** The first user-perceived character — \"É\" whether it was typed as one code point or\n *  as E + a combining accent, a whole emoji rather than half a surrogate pair. */\nfunction firstGrapheme(text: string): string {\n  graphemes ??=\n    typeof Intl !== \"undefined\" && \"Segmenter\" in Intl\n      ? new Intl.Segmenter(undefined, { granularity: \"grapheme\" })\n      : null;\n  if (graphemes) {\n    const segment = graphemes.segment(text)[Symbol.iterator]().next();\n    if (!segment.done) return segment.value.segment;\n  }\n  return [...text][0] ?? \"\";\n}\n\n/** Upper case under the reader's rules (Turkish \"i\" → \"İ\"), and plain upper case for a\n *  locale tag the runtime refuses rather than a thrown RangeError in a render. */\nfunction upper(text: string, locale: string | undefined): string {\n  try {\n    return text.toLocaleUpperCase(locale);\n  } catch {\n    return text.toUpperCase();\n  }\n}\n\n/**\n * The initials for an avatar, in the same order as {@link formatPersonName}:\n *\n *  - \"AE\" for Ada Example in en, de, fr, it and es;\n *  - \"EA\" in hu, family name first;\n *  - **one character in zh for a name in CJK characters, the family name's first** —\n *    \"李\" for 李小龙. Two Chinese characters are not initials, they are most of a name.\n *    A Latin name in zh is \"AE\", as it is written.\n *\n * With only one part (a migrated user's whole old display name in `first`, §3.3), the\n * initials are what {@link avatarInitials} has always made of a display name: the first\n * letters of its first two words (\"Ada Example\" → \"AE\"), or the first two letters of a\n * single word (\"Ada\" → \"AD\") — so nobody's avatar changes when their account migrates.\n * In zh, a part in CJK characters gives its first character.\n *\n * `\"\"` when both parts are blank; {@link UserAvatar} then falls back to the email.\n */\nexport function personInitials(name: PersonName, locale?: string): string {\n  const first = clean(name.first);\n  const last = clean(name.last);\n  if (!first && !last) return \"\";\n  const order = nameOrder(locale, first, last);\n  if (order === \"family-first-joined\") return upper(firstGrapheme(last || first), locale);\n  if (!first || !last) {\n    const words = (first || last).split(/\\s+/);\n    const initials =\n      words.length >= 2\n        ? firstGrapheme(words[0]!) + firstGrapheme(words[1]!)\n        : [...words[0]!].slice(0, 2).join(\"\");\n    return upper(initials, locale);\n  }\n  const pair = order === \"family-first\" ? [last, first] : [first, last];\n  return upper(firstGrapheme(pair[0]!) + firstGrapheme(pair[1]!), locale);\n}\n"],"mappings":";AA6CA,MAAM,MAAM;AAEZ,SAAS,SAAS,QAAoC;AACpD,UAAQ,UAAU,IAAI,MAAM,MAAM,EAAE,CAAC,EAAG,YAAY;AACtD;AASA,SAAS,UAAU,QAA4B,OAAe,MAAyB;AACrF,QAAM,OAAO,SAAS,MAAM;AAC5B,MAAI,SAAS,KAAM,QAAO;AAC1B,MAAI,SAAS,SAAS,CAAC,SAAS,IAAI,KAAK,KAAK,OAAO,CAAC,QAAQ,IAAI,KAAK,IAAI,IAAI;AAC7E,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEA,SAAS,MAAM,MAAyC;AACtD,UAAQ,QAAQ,IAAI,KAAK;AAC3B;AAWO,SAAS,iBAAiB,MAAkB,QAAyB;AAC1E,QAAM,QAAQ,MAAM,KAAK,KAAK;AAC9B,QAAM,OAAO,MAAM,KAAK,IAAI;AAC5B,MAAI,CAAC,KAAM,QAAO;AAClB,MAAI,CAAC,MAAO,QAAO;AACnB,UAAQ,UAAU,QAAQ,OAAO,IAAI,GAAG;AAAA,IACtC,KAAK;AACH,aAAO,GAAG,IAAI,IAAI,KAAK;AAAA,IACzB,KAAK;AACH,aAAO,GAAG,IAAI,GAAG,KAAK;AAAA,IACxB;AACE,aAAO,GAAG,KAAK,IAAI,IAAI;AAAA,EAC3B;AACF;AAIA,IAAI;AAIJ,SAAS,cAAc,MAAsB;AAC3C,gBACE,OAAO,SAAS,eAAe,eAAe,OAC1C,IAAI,KAAK,UAAU,QAAW,EAAE,aAAa,WAAW,CAAC,IACzD;AACN,MAAI,WAAW;AACb,UAAM,UAAU,UAAU,QAAQ,IAAI,EAAE,OAAO,QAAQ,EAAE,EAAE,KAAK;AAChE,QAAI,CAAC,QAAQ,KAAM,QAAO,QAAQ,MAAM;AAAA,EAC1C;AACA,SAAO,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK;AACzB;AAIA,SAAS,MAAM,MAAc,QAAoC;AAC/D,MAAI;AACF,WAAO,KAAK,kBAAkB,MAAM;AAAA,EACtC,QAAQ;AACN,WAAO,KAAK,YAAY;AAAA,EAC1B;AACF;AAmBO,SAAS,eAAe,MAAkB,QAAyB;AACxE,QAAM,QAAQ,MAAM,KAAK,KAAK;AAC9B,QAAM,OAAO,MAAM,KAAK,IAAI;AAC5B,MAAI,CAAC,SAAS,CAAC,KAAM,QAAO;AAC5B,QAAM,QAAQ,UAAU,QAAQ,OAAO,IAAI;AAC3C,MAAI,UAAU,sBAAuB,QAAO,MAAM,cAAc,QAAQ,KAAK,GAAG,MAAM;AACtF,MAAI,CAAC,SAAS,CAAC,MAAM;AACnB,UAAM,SAAS,SAAS,MAAM,MAAM,KAAK;AACzC,UAAM,WACJ,MAAM,UAAU,IACZ,cAAc,MAAM,CAAC,CAAE,IAAI,cAAc,MAAM,CAAC,CAAE,IAClD,CAAC,GAAG,MAAM,CAAC,CAAE,EAAE,MAAM,GAAG,CAAC,EAAE,KAAK,EAAE;AACxC,WAAO,MAAM,UAAU,MAAM;AAAA,EAC/B;AACA,QAAM,OAAO,UAAU,iBAAiB,CAAC,MAAM,KAAK,IAAI,CAAC,OAAO,IAAI;AACpE,SAAO,MAAM,cAAc,KAAK,CAAC,CAAE,IAAI,cAAc,KAAK,CAAC,CAAE,GAAG,MAAM;AACxE;","names":[]}