@uniweb/kit 0.13.2 → 0.13.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/kit",
-  "version": "0.13.2",
+  "version": "0.13.4",
   "description": "Standard component library for Uniweb foundations",
   "type": "module",
   "exports": {
@@ -44,7 +44,7 @@
     "shiki": "^3.0.0",
     "tailwind-merge": "^3.6.0",
     "temml": "^0.13.2",
-    "@uniweb/core": "^0.11.1",
+    "@uniweb/core": "^0.11.3",
     "@uniweb/semantic-parser": "^1.3.0",
     "@uniweb/scene": "^0.1.3"
   },

package/src/hooks/useReadingDepth.js

@@ -47,6 +47,14 @@ const THROTTLE_MS = 200
  * bottom of the viewport, 100 once its bottom has. An element shorter than the
  * viewport reports 100 as soon as it is fully on screen, which is correct —
  * there was nothing further to read.
+ *
+ * ⛔ **So `100` is TWO different claims, and a consumer labelling a panel needs
+ * to know which.** Taller than the viewport: the visitor scrolled all the way
+ * through it. Shorter: it was entirely on screen, with no scrolling through it
+ * at all. The ratio that decides is not on the wire, so a collector cannot tell
+ * them apart — and `100` never means *"saw the whole page"*, which is what the
+ * retired document-scoped hook's `100` meant. Asserted by three cases in
+ * `tests/use-reading-depth.test.jsx`.
  */
 function depthOf(el) {
   const rect = el.getBoundingClientRect()

package/src/utils/index.js

@@ -15,47 +15,23 @@ export { twMerge, twJoin }
 // ─────────────────────────────────────────────────────────────────
 
 /**
- * Common locale display names (native language names)
- * Used as fallback when site.yml doesn't specify labels.
- * Tree-shakeable: only included if foundation uses getLocaleLabel().
+ * Locale display names and label resolution now live in `@uniweb/core`, because
+ * core is what BUILDS the locale objects a foundation reads (`getLocales()`,
+ * `website.langs`) and could not resolve a label from over here. Re-exported so
+ * `import { LOCALE_DISPLAY_NAMES } from '@uniweb/kit'` keeps working.
+ *
+ * Imported by leaf subpath, not bare `@uniweb/core`, to keep the graph kit drags
+ * into every foundation bundle small — the same reason `@uniweb/projections`
+ * reaches for `@uniweb/core/locale-config`.
  */
-export const LOCALE_DISPLAY_NAMES = {
-  en: 'English',
-  es: 'Español',
-  fr: 'Français',
-  de: 'Deutsch',
-  it: 'Italiano',
-  pt: 'Português',
-  nl: 'Nederlands',
-  pl: 'Polski',
-  ru: 'Русский',
-  ja: '日本語',
-  ko: '한국어',
-  zh: '中文',
-  'zh-CN': '简体中文',
-  'zh-TW': '繁體中文',
-  ar: 'العربية',
-  he: 'עברית',
-  hi: 'हिन्दी',
-  th: 'ไทย',
-  vi: 'Tiếng Việt',
-  tr: 'Türkçe',
-  uk: 'Українська',
-  cs: 'Čeština',
-  el: 'Ελληνικά',
-  hu: 'Magyar',
-  ro: 'Română',
-  sv: 'Svenska',
-  da: 'Dansk',
-  fi: 'Suomi',
-  no: 'Norsk',
-  id: 'Bahasa Indonesia',
-  ms: 'Bahasa Melayu'
-}
+export { LOCALE_DISPLAY_NAMES } from '@uniweb/core/locale-config'
 
 /**
- * Get display label for a locale
- * Priority: locale.label (from site config) → LOCALE_DISPLAY_NAMES → code.toUpperCase()
+ * Get display label for a locale.
+ * Priority: locale.label (from site config) -> LOCALE_DISPLAY_NAMES -> code.toUpperCase()
+ *
+ * Thin alias for core's `localeLabel` — kept so the kit-facing name and the
+ * existing foundation call sites do not move.
  *
  * @param {Object|string} locale - Locale object {code, label?} or locale code string
  * @returns {string} Display label for the locale
@@ -66,18 +42,7 @@ export const LOCALE_DISPLAY_NAMES = {
  * getLocaleLabel('es')                             // 'Español'
  * getLocaleLabel({ code: 'xx' })                   // 'XX'
  */
-export function getLocaleLabel(locale) {
-  // Handle string input (just a code)
-  if (typeof locale === 'string') {
-    return LOCALE_DISPLAY_NAMES[locale] || locale.toUpperCase()
-  }
-
-  // Handle object input
-  if (!locale || !locale.code) return ''
-
-  // Priority: explicit label → known display name → uppercase code
-  return locale.label || LOCALE_DISPLAY_NAMES[locale.code] || locale.code.toUpperCase()
-}
+export { localeLabel as getLocaleLabel } from '@uniweb/core/locale-config'
 
 // ─────────────────────────────────────────────────────────────────
 // Icon Utilities