@ultimat3/core 20.2.0 → 20.2.1

package/CLAUDE.md

@@ -139,6 +139,7 @@ shape against a locally declared sample interface for exactly that reason.
 | is this `unknown` a keyed record? | `json-object.ts` | `isJsonObject`, which was the same three terms in both those packages' `stable.ts`. A `Date` and a class instance PASS: it narrows a shape, it does not certify provenance |
 | a value that must not be printed | `secret.ts` | redacted by VALUE; `revealSecret()` is the one way out, on purpose greppable |
 | an `Intl` formatter cache, and the screen in front of it | `intl-cache.ts` (`cachedFormatter`, `canonicalLocale`, `assertLocale`, `MAX_CACHED_FORMATTERS`, `MAX_LOCALE_EXCERPT`) | a locale and a zone arrive from a request header, so the tag must be REFUSED when it is not a tag (`X_LOCALE_INVALID`), the key must be canonical AND the cache bounded — never a second copy of any of the three. The refusal is bounded too: the `cause` quotes back at most `MAX_LOCALE_EXCERPT` (35, RFC 5646 §4.4.1) code points and says so when it cut, and the whole tag rides in `meta.locale` — a `cause` reaches the 400 body and the log line, where a value with no key has nothing a redactor can address |
+| the text direction of a locale | `locale-direction.ts` (`directionOf`, `isRtl`, `Direction`) | a script fact, moved here from `@ultimat3/i18n` (which re-exports it) on 2026-09-19: `@ultimat3/ui`'s provider reflects `dir` onto `<html>` from the locale it was handed, and reaching the i18n barrel for that one function put the framework catalog it installs at import into every browser chunk with a `UiProvider` (issue #490) |
 | the committed encrypted values | `secrets.ts` (envelope) + `secrets-store.ts` (files, `installSecrets`) | plaintext is a flat map of ENV NAMES; there is no `secrets.get()` |
 
 `installSecrets()` is the ONLY path from `secrets.enc.json` to an app value, and it lands in

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/core",
-  "version": "20.2.0",
+  "version": "20.2.1",
   "description": "Ultimate's foundation: errors, context, env, config, clock, ids, logging, telemetry, lifecycle",
   "license": "MIT",
   "type": "module",
@@ -37,6 +37,6 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/schema": "20.2.0"
+    "@ultimat3/schema": "20.2.1"
   }
 }

package/src/index.ts

@@ -517,6 +517,8 @@ export {
   shutdownHookCount,
 } from './lifecycle';
 export { isSelfOrigin, listeningOrigins, markListening, resetListeners } from './listeners';
+export type { Direction } from './locale-direction';
+export { directionOf, isRtl } from './locale-direction';
 export { isMcpExposed, type McpExposureDeclaration } from './mcp-exposure';
 export { nearestName } from './nearest-name';
 export { type CappedBody, readWithinLimit } from './read-capped';

package/src/locale-direction.ts

@@ -0,0 +1,37 @@
+// Text direction of a locale — a fact about the locale's script, and nothing about catalogs or
+// requests, which is why it is tier 0 rather than `@ultimat3/i18n`'s: `@ultimat3/ui`'s provider
+// reflects `dir` onto `<html>` from the locale it was handed, and reaching the i18n barrel for
+// that one function put the whole framework catalog into every browser chunk with a `UiProvider`
+// in it (issue #490). i18n re-exports these under the same names, so no caller moved.
+
+export type Direction = 'ltr' | 'rtl';
+
+/**
+ * Right-to-left scripts, by primary subtag. A static CLDR-derived set rather than
+ * `Intl.Locale.prototype.getTextInfo` so direction is deterministic across runtimes.
+ */
+const RTL_LOCALES: ReadonlySet<string> = new Set([
+  'ar',
+  'arc',
+  'ckb',
+  'dv',
+  'fa',
+  'he',
+  'ks',
+  'ku',
+  'nqo',
+  'ps',
+  'sd',
+  'ug',
+  'ur',
+  'yi',
+]);
+
+export function isRtl(locale: string): boolean {
+  const primary = locale.split('-')[0]?.toLowerCase() ?? '';
+  return RTL_LOCALES.has(primary);
+}
+
+export function directionOf(locale: string): Direction {
+  return isRtl(locale) ? 'rtl' : 'ltr';
+}