@fusion.dev/helix-core 0.205.2 → 0.207.0

package/dist/words/held.d.ts

@@ -5,6 +5,12 @@ export type Pack = Record<string, Record<string, Message | MessageTable>>;
 export type Speaker = Element & {
     locale?: string | undefined;
 };
+/**
+ * What an element's locale is worked out from: its `locale`, then the `lang`
+ * read for it or `null` for none, and on a server or while hydrating, the
+ * default. See `sourceOf` in `words-locale.ts`.
+ */
+export type LocaleSource = readonly [own: string, lang: string | null, fallback?: string];
 /** What the page has registered, kept on `globalThis`. */
 interface Held {
     /** Each locale's words, under its lowercase tag. */
@@ -19,8 +25,10 @@ interface Held {
     observed?: boolean;
     /** Finds a registered word for an element, set by the first `registerWords`. */
     find?: (host: Speaker, tag: string, name: string) => [Message | MessageTable, string] | undefined;
-    /** Reads the locale an element speaks, set where `wordsLocale` is loaded. */
-    locale?: (host: Speaker) => string;
+    /** Reads what an element's locale is worked out from, set where `wordsLocale` is loaded. */
+    source?: (host: Speaker) => LocaleSource;
+    /** Works out the locale from what `source` read. */
+    from?: (source: LocaleSource) => string;
 }
 /**
  * The page's words, held on `globalThis`.
@@ -32,7 +40,7 @@ interface Held {
  * **What every element reads, and nothing more.** An element with a word
  * property reads its English until a page registers words, so the lookup and
  * the locale chain arrive with `registerWords`, which puts its lookup in
- * `find`, and the locale with `wordsLocale`, which puts itself in `locale`. A
+ * `find`, and the locale with `wordsLocale`, which puts its reads in `source` and `from`. A
  * page that registers no words and formats no numbers ships neither: measured
  * on Button, 474 bytes of its 13,437 compressed.
  */

package/dist/words/words-locale.js

@@ -1,4 +1,4 @@
-import { localeOf, runtimeLocale } from '../utils/locale-of/locale-of.js';
+import { localeOf, nearestLang, runtimeLocale, usableLocale } from '../utils/locale-of/locale-of.js';
 import { held, watchLang } from './held.js';
 const checked = new Map();
 const tagOf = (written) => {
@@ -14,18 +14,30 @@ const tagOf = (written) => {
     }
     return found;
 };
-export const wordsLocale = (element) => {
+export const wordsLocale = (element) => localeFrom(sourceOf(element));
+const sourceOf = (element) => {
     watchLang();
-    const own = tagOf(element.locale || '');
-    if (own) {
-        return own;
+    const own = element.locale || '';
+    if (tagOf(own)) {
+        return [own, null];
     }
     if (typeof element.closest !== 'function' || element.hydrating) {
-        return tagOf(element.getAttribute?.('lang') ?? '') || held.fallback;
+        return [own, element.getAttribute?.('lang') ?? '', held.fallback];
     }
-    return localeOf(element) || runtimeLocale();
+    return [own, nearestLang(element) ?? null];
 };
-held.locale = wordsLocale;
+const localeFrom = ([own, lang, fallback]) => {
+    const tag = tagOf(own);
+    if (tag) {
+        return tag;
+    }
+    if (fallback !== undefined) {
+        return tagOf(lang ?? '') || fallback;
+    }
+    return (lang === null ? '' : usableLocale(lang)) || runtimeLocale();
+};
+held.source = sourceOf;
+held.from = localeFrom;
 export const handedLocale = (element) => {
     const own = typeof element.locale === 'string' ? element.locale : '';
     return element.hydrating ? own : localeOf(element, own);

package/dist/words/words.js

@@ -39,17 +39,22 @@ const recheck = (host) => {
         }
     }
 };
+const localeMoved = (before, after) => before !== undefined &&
+    after !== undefined &&
+    (before.length !== after.length || before.some((one, at) => one !== after[at])) &&
+    held.from?.(before) !== held.from?.(after);
 const watcher = (host) => {
     let stop;
-    let locale = '';
+    let source;
     return {
         hostConnected: () => {
-            locale = held.locale?.(host) ?? '';
+            source = held.source?.(host);
             stop = watchWords(() => {
                 recheck(host);
-                const now = held.locale?.(host) ?? '';
-                if (now !== locale) {
-                    locale = now;
+                const now = held.source?.(host);
+                const moved = localeMoved(source, now);
+                source = now;
+                if (moved) {
                     host.requestUpdate();
                 }
             });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-core",
   "description": "Helix element primitives: base classes, mixins, decorators, utilities.",
-  "version": "0.205.2",
+  "version": "0.207.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -35,6 +35,12 @@
       "helix-development": "./dist/utils/audit-nesting/audit-nesting.js",
       "default": "./dist/utils/audit-nesting/audit-nesting-off.js"
     },
+    "./audits/number": {
+      "types": "./dist/utils/audit-number/audit-number.d.ts",
+      "development": "./dist/utils/audit-number/audit-number.js",
+      "helix-development": "./dist/utils/audit-number/audit-number.js",
+      "default": "./dist/utils/audit-number/audit-number-off.js"
+    },
     "./audits/react": {
       "types": "./dist/helix-element/react-audit.d.ts",
       "development": "./dist/helix-element/react-audit.js",
@@ -54,6 +60,7 @@
       "default": "./dist/utils/audit-source/audit-source-off.js"
     },
     "./custom-elements.json": "./custom-elements.json",
+    "./package.json": "./package.json",
     "./words": {
       "types": "./dist/words/index.d.ts",
       "default": "./dist/words/index.js"
@@ -74,12 +81,12 @@
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
     "@floating-ui/dom": "^1.8.0",
-    "@fusion.dev/helix-icons": "0.205.2",
+    "@fusion.dev/helix-icons": "0.207.0",
     "tslib": "^2.8.1"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.205.2",
-    "@fusion.dev/helix-testing": "0.205.2",
+    "@fusion.dev/helix-cem": "0.207.0",
+    "@fusion.dev/helix-testing": "0.207.0",
     "@lit-labs/ssr": "^4.1.0",
     "lit": "^3.2.1"
   },
@@ -100,6 +107,11 @@
       "helix-development": "./src/utils/audit-nesting/audit-nesting.ts",
       "default": "./src/utils/audit-nesting/audit-nesting-off.ts"
     },
+    "#audit-number": {
+      "development": "./src/utils/audit-number/audit-number.ts",
+      "helix-development": "./src/utils/audit-number/audit-number.ts",
+      "default": "./src/utils/audit-number/audit-number-off.ts"
+    },
     "#audit-served": {
       "development": "./src/utils/audit-served/audit-served.ts",
       "helix-development": "./src/utils/audit-served/audit-served.ts",