@nxgt/material-core 0.11.1 → 0.12.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @nxgt/material-core
 
+## 0.12.0
+
+### Minor Changes
+
+- [#624](https://github.com/softistx/nxgt-material/pull/624) [`94a77a7`](https://github.com/softistx/nxgt-material/commit/94a77a76b54834bda18d1e2acc494d5a089d245d) Thanks [@SteveGT96](https://github.com/SteveGT96)! - `@nxgt/material-core/initials`: `initials(name)`, an avatar's initials from a name (`'Ada Lovelace'` → `'AL'`), the first letter of the first and last word, upper-cased, a whole code point each. Both libraries' new `AccountMenu` use it ([#585](https://github.com/softistx/nxgt-material/issues/585)).
+
 ## 0.11.1
 
 ### Patch Changes

package/README.md

@@ -104,6 +104,7 @@ built-in.
 | `/csp-nonce` | `getCspNonce`, `setCspNonce`, `claimCspNonce(nonce, depth)`, `createNoncedStyle`, and `getNonce` / `setNonce` (the `get-nonce` API) — the page's Content Security Policy nonce, for a `<style>` created at runtime; browser only |
 | `/lazy-object` | `lazyObject`, `buildOnce` — a value built on its first use rather than when its module loads: the libraries' zod schemas |
 | `/debounce` | `debounce`, the type `Debounced` — a function called once calls pause, with `cancel` and `flush` (`SearchField`'s `debounceMs`) |
+| `/initials` | `initials` — an avatar's initials from a name, `'Ada Lovelace'` → `'AL'` (`AccountMenu`) |
 | `/text-match` | `foldText`, `matchesText` — case- and accent-insensitive matching (`'e'` finds "École"), lowercased for a locale |
 | `/async-search` | `createAsyncSearch`, `searchAnnouncement`, `DEFAULT_SEARCH_DEBOUNCE_MS`, `DEFAULT_MIN_QUERY_LENGTH` and the types `AsyncSearch`, `AsyncSearchConfig`, `AsyncSearchState`, `AsyncSearchStatus`, `SearchFn`, `SearchContext`, `SearchAnnouncement` — `Autocomplete`'s server search: debounced, each run aborting the last, a stale response dropped |
 | `/submit-guard` | `createSubmitGuard`, `busySettler` and the types `SubmitGuard`, `SubmitOnceOptions` — one submit in flight until its request ends, behind both libraries' `useSubmitOnce` |
@@ -407,6 +408,20 @@ save('ab'); // 300 ms later: "save ab", once
 save.flush(); // or now
 ```
 
+### An avatar's initials: `/initials`
+
+What both libraries' `AccountMenu` shows in its avatar when there is no
+picture: the first letter of the first and of the last word, upper-cased, a
+whole code point each.
+
+```ts
+import { initials } from '@nxgt/material-core/initials';
+
+initials('Ada Lovelace'); // 'AL'
+initials('Ada'); // 'A'
+initials('   '); // ''
+```
+
 ### Matching text as the user types: `/text-match`
 
 `foldText(text, locale?)` lowercases `text` for `locale` (the runtime's when

package/dist/lib/initials.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The initials an avatar shows in place of a picture: the first letter of the
+ * first and of the last word of `name`, upper-cased — `'Ada Lovelace'` →
+ * `'AL'`, `'Ada'` → `'A'`, `'Jean-Paul Sartre'` → `'JS'` — and `''` for a
+ * blank name. A letter is a whole code point, so an emoji or an astral
+ * character is never cut in half. Locale-free (`toUpperCase`, not
+ * `toLocaleUpperCase`): a server and a browser in Turkish or Azeri would
+ * otherwise upper-case an `i` differently, and the hydration would differ.
+ * Both libraries' `AccountMenu` use it.
+ */
+export declare function initials(name: string): string;
+//# sourceMappingURL=initials.d.ts.map

package/dist/lib/initials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initials.d.ts","sourceRoot":"","sources":["../../src/lib/initials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS7C"}

package/dist/lib/initials.js

@@ -0,0 +1,15 @@
+// src/lib/initials.ts
+function initials(name) {
+  const words = name.trim().split(/\s+/).filter(Boolean);
+  if (words.length === 0)
+    return "";
+  const first = words[0];
+  const last = words.length > 1 ? words.at(-1) : "";
+  return [first, last].map((word) => Array.from(word)[0] ?? "").join("").toUpperCase();
+}
+export {
+  initials
+};
+
+//# debugId=BB7FB6C4C0A3758264756E2164756E21
+//# sourceMappingURL=initials.js.map

package/dist/lib/initials.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/lib/initials.ts"],
+  "sourcesContent": [
+    "/**\n * The initials an avatar shows in place of a picture: the first letter of the\n * first and of the last word of `name`, upper-cased — `'Ada Lovelace'` →\n * `'AL'`, `'Ada'` → `'A'`, `'Jean-Paul Sartre'` → `'JS'` — and `''` for a\n * blank name. A letter is a whole code point, so an emoji or an astral\n * character is never cut in half. Locale-free (`toUpperCase`, not\n * `toLocaleUpperCase`): a server and a browser in Turkish or Azeri would\n * otherwise upper-case an `i` differently, and the hydration would differ.\n * Both libraries' `AccountMenu` use it.\n */\nexport function initials(name: string): string {\n\tconst words = name.trim().split(/\\s+/).filter(Boolean);\n\tif (words.length === 0) return '';\n\tconst first = words[0] as string;\n\tconst last = words.length > 1 ? (words.at(-1) as string) : '';\n\treturn [first, last]\n\t\t.map((word) => Array.from(word)[0] ?? '')\n\t\t.join('')\n\t\t.toUpperCase();\n}\n"
+  ],
+  "mappings": ";AAUO,SAAS,QAAQ,CAAC,MAAsB;AAAA,EAC9C,MAAM,QAAQ,KAAK,KAAK,EAAE,MAAM,KAAK,EAAE,OAAO,OAAO;AAAA,EACrD,IAAI,MAAM,WAAW;AAAA,IAAG,OAAO;AAAA,EAC/B,MAAM,QAAQ,MAAM;AAAA,EACpB,MAAM,OAAO,MAAM,SAAS,IAAK,MAAM,GAAG,EAAE,IAAe;AAAA,EAC3D,OAAO,CAAC,OAAO,IAAI,EACjB,IAAI,CAAC,SAAS,MAAM,KAAK,IAAI,EAAE,MAAM,EAAE,EACvC,KAAK,EAAE,EACP,YAAY;AAAA;",
+  "debugId": "BB7FB6C4C0A3758264756E2164756E21",
+  "names": []
+}

package/docs/roadmap.md

@@ -76,6 +76,9 @@ Nothing is in progress.
 
 ## Shipped
 
+- **An avatar's initials** (`/initials`) — the first letter of a name's
+  first and last word, upper-cased and never cut inside a character, behind
+  both libraries' `AccountMenu`.
 - **A repeatable row group's focus rules** (`/repeatable-group`) — where the
   focus goes after a row is added, removed or moved, the add and remove
   limits, and what the live region announces, behind both libraries'

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@nxgt/material-core",
-	"version": "0.11.1",
-	"description": "The framework-free core of @nxgt/material and @nxgt/material-vue: the PDF document model and its react-pdf renderer, print formatters, PDF file helpers, the PDF viewer's pure modules, the currency digits, the file-size formatter, the field-blur layers, a field's first focusable control, a repeatable row group's focus and announcement rules, the aria-describedby joiner, the inert background of a modal layer, Escape forwarded while an overlay closes, the Toaster's touch-hover guard and its focus hand-back, the page's Content Security Policy nonce, an object built on first use, the zod issue messages, the date range presets, the debounce, accent-insensitive text matching and the race-free async search behind Autocomplete and SearchField, the submit guard, the code error map, the two-factor helpers (a grouped TOTP secret, the recovery codes' file, a text download), printing one element of the page, the file preview's kind detection and text reader, the pdfkit fonts Vite plugin, a CSP-safe Vite assetsInlineLimit and the Node-only pdfkit fonts resolution for Next.js and Nuxt builds",
+	"version": "0.12.0",
+	"description": "The framework-free core of @nxgt/material and @nxgt/material-vue: the PDF document model and its react-pdf renderer, print formatters, PDF file helpers, the PDF viewer's pure modules, the currency digits, the file-size formatter, the field-blur layers, a field's first focusable control, a repeatable row group's focus and announcement rules, the aria-describedby joiner, the inert background of a modal layer, Escape forwarded while an overlay closes, the Toaster's touch-hover guard and its focus hand-back, the page's Content Security Policy nonce, an object built on first use, the zod issue messages, the date range presets, the debounce, accent-insensitive text matching and the race-free async search behind Autocomplete and SearchField, the submit guard, the code error map, an avatar's initials, the two-factor helpers (a grouped TOTP secret, the recovery codes' file, a text download), printing one element of the page, the file preview's kind detection and text reader, the pdfkit fonts Vite plugin, a CSP-safe Vite assetsInlineLimit and the Node-only pdfkit fonts resolution for Next.js and Nuxt builds",
 	"license": "MIT",
 	"bugs": {
 		"email": "stevegires@gmail.com"
@@ -178,6 +178,11 @@
 			"import": "./dist/lib/debounce.js",
 			"default": "./dist/lib/debounce.js"
 		},
+		"./initials": {
+			"types": "./dist/lib/initials.d.ts",
+			"import": "./dist/lib/initials.js",
+			"default": "./dist/lib/initials.js"
+		},
 		"./text-match": {
 			"types": "./dist/lib/text-match.d.ts",
 			"import": "./dist/lib/text-match.js",
@@ -288,6 +293,7 @@
 			"src/lib/csp-nonce.ts",
 			"src/lib/lazy-object.ts",
 			"src/lib/debounce.ts",
+			"src/lib/initials.ts",
 			"src/lib/text-match.ts",
 			"src/lib/async-search.ts",
 			"src/lib/submit-guard.ts",