@godxjp/ui 31.31.8 → 32.0.0

package/dist/components/layout/separator.js

@@ -1,4 +1,74 @@
-import { Separator } from "../ui/separator.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { Separator as AriaSeparator } from "react-aria-components";
+import { padStepToken } from "../../lib/variants.js";
+import { cn } from "../../lib/utils.js";
+import { isDevelopment } from "../../lib/dev.js";
+const Separator = React.forwardRef(
+  ({
+    className,
+    labelSize,
+    space,
+    hideBelow,
+    hideFrom,
+    style,
+    orientation = "horizontal",
+    decorative,
+    label,
+    labelAlign = "center",
+    tone = "default",
+    ...props
+  }, ref) => {
+    const hasLabel = typeof label === "string" && label.trim() !== "";
+    const labelled = hasLabel && orientation === "horizontal";
+    if (isDevelopment()) {
+      if (hasLabel && orientation === "vertical") {
+        console.warn(
+          'Separator: `label` is rendered on orientation="horizontal" only; it was ignored. Use a horizontal rule for a day divider / unread watermark.'
+        );
+      }
+    }
+    const isDecorative = decorative ?? !labelled;
+    return /* @__PURE__ */ jsx(
+      AriaSeparator,
+      {
+        ref,
+        elementType: "div",
+        "data-slot": "separator",
+        "data-label-size": labelSize,
+        "data-hide-below": hideBelow,
+        "data-hide-from": hideFrom,
+        style: {
+          ...style,
+          ...space === void 0 ? void 0 : { marginBlock: padStepToken(space) }
+        },
+        "data-orientation": orientation,
+        "data-tone": tone,
+        "data-labelled": labelled ? "" : void 0,
+        "data-label-align": labelled ? labelAlign : void 0,
+        orientation,
+        "aria-label": labelled && !isDecorative ? label : void 0,
+        className: cn("ui-separator", className),
+        ...props,
+        render: ({ role, "aria-orientation": ariaOrientation, ...domProps }) => /* @__PURE__ */ jsx(
+          "div",
+          {
+            role: isDecorative ? "none" : role,
+            "aria-orientation": isDecorative ? void 0 : ariaOrientation,
+            ...props,
+            ...domProps,
+            children: labelled ? /* @__PURE__ */ jsxs(Fragment, { children: [
+              /* @__PURE__ */ jsx("span", { className: "ui-separator-rule", "aria-hidden": "true" }),
+              /* @__PURE__ */ jsx("span", { className: "ui-separator-label", "aria-hidden": isDecorative ? void 0 : true, children: label }),
+              /* @__PURE__ */ jsx("span", { className: "ui-separator-rule", "aria-hidden": "true" })
+            ] }) : null
+          }
+        )
+      }
+    );
+  }
+);
+Separator.displayName = "Separator";
 export {
   Separator
 };

package/dist/components/navigation/{app-setting-toggle.d.ts → app-setting-cycle.d.ts}

@@ -1,8 +1,7 @@
 import * as React from "react";
-import type { AppSettingToggleProp } from "../../props/components/app.prop.js";
-export type { AppSettingToggleKind, AppSettingToggleProp, AppSettingToggleProp as AppSettingToggleProps, } from "../../props/components/app.prop.js";
+import type { AppSettingPickerCycleProp } from "../../props/components/app.prop.js";
 /**
- * AppSettingToggle — ONE button that steps a single AppProvider setting to its next value.
+ * `AppSettingPicker menu={false}` (the former AppSettingToggle, v32 #1223) — ONE button that steps a single AppProvider setting to its next value.
  *
  * The no-menu counterpart to {@link AppSettingPicker}: same binding contract, same option order,
  * one tap instead of open-then-choose. Reach for it when the value set is closed and short (theme,
@@ -13,4 +12,4 @@ export type { AppSettingToggleKind, AppSettingToggleProp, AppSettingToggleProp a
  * glyph is the only visible state and a screen-reader user would otherwise be told only which
  * setting they are standing on, never where it currently is.
  */
-export declare const AppSettingToggle: React.ForwardRefExoticComponent<AppSettingToggleProp & React.RefAttributes<HTMLButtonElement>>;
+export declare const AppSettingCycle: React.ForwardRefExoticComponent<AppSettingPickerCycleProp & React.RefAttributes<HTMLButtonElement>>;

package/dist/components/navigation/{app-setting-toggle.js → app-setting-cycle.js}

@@ -45,8 +45,8 @@ const ARIA_KEY = {
   fontSize: "navigation.fontSizePicker.ariaLabel",
   timeFormat: "navigation.timeFormatPicker.ariaLabel"
 };
-const AppSettingToggle = React.forwardRef(
-  function AppSettingToggle2({ kind, appearance = "bar", className, disabled, id, value, onValueChange }, ref) {
+const AppSettingCycle = React.forwardRef(
+  function AppSettingCycle2({ kind, appearance = "bar", className, disabled, id, value, onValueChange }, ref) {
     const ctx = useOptionalAppContext();
     const { t, locale, fallbackLocale } = useTranslation();
     const raw = value ?? ctx?.[kind];
@@ -92,5 +92,5 @@ const AppSettingToggle = React.forwardRef(
   }
 );
 export {
-  AppSettingToggle
+  AppSettingCycle
 };

package/dist/components/navigation/app-setting-picker.d.ts

@@ -1,10 +1,14 @@
 import * as React from "react";
 import type { AppSettingPickerProp } from "../../props/components/app.prop.js";
-export type { AppSettingKind, AppSettingPickerProp, AppSettingPickerProp as AppSettingPickerProps, } from "../../props/components/app.prop.js";
+export type { AppSettingKind, AppSettingCycleKind, AppSettingPickerProp, AppSettingPickerProp as AppSettingPickerProps, AppSettingPickerMenuProp, AppSettingPickerCycleProp, } from "../../props/components/app.prop.js";
 /**
- * One provider-bound Select for any single AppProvider setting — locale / timezone /
+ * One provider-bound control for any single AppProvider setting — locale / timezone /
  * date-format / time-format and the four theme axes (theme / brand / density / fontSize).
  * Mount under `<AppProvider>` and it reads/writes the matching context (`kind`); or pass
  * value + onValueChange to control it.
+ *
+ * `menu={false}` (theme / density / fontSize / timeFormat only) swaps the open-then-choose menu
+ * for ONE button that steps to the next value on each tap and shows that value as its glyph — the
+ * former `AppSettingToggle` (v32 #1223).
  */
 export declare const AppSettingPicker: React.ForwardRefExoticComponent<AppSettingPickerProp & React.RefAttributes<HTMLButtonElement>>;

package/dist/components/navigation/app-setting-picker.js

@@ -14,6 +14,7 @@ import {
 import { APP_DATE_FORMAT_OPTIONS, getDateFormatLabel } from "../../app/date-format-labels.js";
 import { APP_TIME_FORMAT_OPTIONS, getTimeFormatLabel } from "../../app/time-format-labels.js";
 import { getTimezoneLabel, resolveTimezonePickerOptions } from "../../app/timezones.js";
+import { getRegisteredLocales } from "../../app/locales.js";
 import { APP_LOCALES } from "../../app/types.js";
 import {
   APP_BRANDS,
@@ -24,6 +25,7 @@ import {
 import { useOptionalAppContext } from "../../app/app-provider.js";
 import { useTranslation } from "../../i18n/use-translation.js";
 import { cn } from "../../lib/utils.js";
+import { AppSettingCycle } from "./app-setting-cycle.js";
 import {
   Select,
   SelectContent,
@@ -31,6 +33,14 @@ import {
   SelectTrigger,
   SelectValue
 } from "../data-entry/select.js";
+function localeEndonym(code) {
+  try {
+    const name = new Intl.DisplayNames([code], { type: "language" }).of(code);
+    return name ? name.charAt(0).toLocaleUpperCase(code) + name.slice(1) : void 0;
+  } catch {
+    return void 0;
+  }
+}
 const ICON = {
   locale: Languages,
   timezone: Globe,
@@ -53,7 +63,12 @@ const ARIA_KEY = {
 };
 const BRAND_NONE = "__app__";
 const AppSettingPicker = React.forwardRef(
-  function AppSettingPicker2({ kind, appearance, compact = false, className, disabled, id, name, value, onValueChange }, ref) {
+  function AppSettingPicker2(props, ref) {
+    return props.menu === false ? /* @__PURE__ */ jsx(AppSettingCycle, { ref, ...props }) : /* @__PURE__ */ jsx(AppSettingMenu, { ref, ...props });
+  }
+);
+const AppSettingMenu = React.forwardRef(
+  function AppSettingMenu2({ kind, appearance, compact = false, className, disabled, id, name, value, onValueChange }, ref) {
     const resolvedAppearance = appearance ?? (kind === "locale" ? "icon" : "labeled");
     const ctx = useOptionalAppContext();
     const { t, locale, fallbackLocale } = useTranslation();
@@ -73,7 +88,10 @@ const AppSettingPicker = React.forwardRef(
     const items = React.useMemo(() => {
       switch (kind) {
         case "locale":
-          return APP_LOCALES.map((code) => ({ value: code, label: t(`locale.${code}`) }));
+          return getRegisteredLocales().map((code) => ({
+            value: code,
+            label: APP_LOCALES.includes(code) ? t(`locale.${code}`) : localeEndonym(code) ?? code
+          }));
         case "timezone":
           return resolveTimezonePickerOptions(ctx?.timezoneOptions, current ?? "").map((tz) => ({
             value: tz,

package/dist/components/navigation/index.d.ts

@@ -1,17 +1,9 @@
 export { Tabs, TabsContent, TabsList, TabsTrigger } from "./tabs.js";
 export { Pagination, PaginationContent, PaginationItem, PaginationLink, PaginationEllipsis, PaginationPrevious, PaginationNext, } from "./pagination.js";
 export { Steps } from "./steps.js";
-export { FilterBar, FilterBarGroup, Toolbar, ToolbarGroup } from "./filter-bar.js";
-export type { FilterBarChipProp, FilterBarChipProps, FilterBarFilterProp, FilterBarFilterProps, FilterBarGroupProp, FilterBarGroupProps, FilterBarOverflowProp, FilterBarProp, FilterBarProps, FilterBarSearchProp, FilterBarSearchProps, ToolbarGroupProps, ToolbarProps, } from "./filter-bar.js";
+export { FilterBar, FilterBarGroup, Toolbar, ToolbarGroup } from "./toolbar.js";
+export type { FilterBarChipProp, FilterBarChipProps, FilterBarFilterProp, FilterBarFilterProps, FilterBarGroupProp, FilterBarGroupProps, FilterBarOverflowProp, FilterBarProp, FilterBarProps, FilterBarSearchProp, FilterBarSearchProps, ToolbarGroupProps, ToolbarProps, } from "./toolbar.js";
 export { AppSettingPicker } from "./app-setting-picker.js";
-export type { AppSettingPickerProp, AppSettingPickerProps, AppSettingKind, } from "./app-setting-picker.js";
-export { AppSettingToggle } from "./app-setting-toggle.js";
-export type { AppSettingToggleProp, AppSettingToggleProps, AppSettingToggleKind, } from "./app-setting-toggle.js";
+export type { AppSettingPickerProp, AppSettingPickerProps, AppSettingPickerMenuProp, AppSettingPickerCycleProp, AppSettingKind, AppSettingCycleKind, } from "./app-setting-picker.js";
 export type { BreadcrumbItemProp as BreadcrumbItem } from "../../props/vocabulary/navigation.prop.js";
 export { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, } from "./dropdown-menu.js";
-export { MegaMenu } from "./mega-menu.js";
-export type { MegaMenuProp, MegaMenuProps, MegaMenuItemProp, MegaMenuItemProps, MegaMenuPanelProp, MegaMenuPanelProps, MegaMenuGroupProp, MegaMenuGroupProps, MegaMenuLinkProp, MegaMenuLinkProps, MegaMenuLinkComponentProp, MegaMenuLinkComponentProps, MegaMenuTriggerActionProp, MegaMenuTriggerActionProps, } from "./mega-menu.js";
-export { Conversations } from "./conversations.js";
-export type { ConversationsProp, ConversationsProps, ConversationsItemProp, ConversationsDividerProp, ConversationsEntryProp, ConversationsMenuProp, ConversationsMenuItemProp, ConversationsGroupableProp, ConversationsCreationProp, } from "./conversations.js";
-export { Anchor } from "./anchor.js";
-export type { AnchorContainerProp, AnchorDirectionProp, AnchorItemProp, AnchorProp, AnchorProps, } from "./anchor.js";

package/dist/components/navigation/index.js

@@ -9,9 +9,8 @@ import {
   PaginationNext
 } from "./pagination.js";
 import { Steps } from "./steps.js";
-import { FilterBar, FilterBarGroup, Toolbar, ToolbarGroup } from "./filter-bar.js";
+import { FilterBar, FilterBarGroup, Toolbar, ToolbarGroup } from "./toolbar.js";
 import { AppSettingPicker } from "./app-setting-picker.js";
-import { AppSettingToggle } from "./app-setting-toggle.js";
 import {
   DropdownMenu,
   DropdownMenuCheckboxItem,
@@ -29,14 +28,8 @@ import {
   DropdownMenuSubTrigger,
   DropdownMenuTrigger
 } from "./dropdown-menu.js";
-import { MegaMenu } from "./mega-menu.js";
-import { Conversations } from "./conversations.js";
-import { Anchor } from "./anchor.js";
 export {
-  Anchor,
   AppSettingPicker,
-  AppSettingToggle,
-  Conversations,
   DropdownMenu,
   DropdownMenuCheckboxItem,
   DropdownMenuContent,
@@ -54,7 +47,6 @@ export {
   DropdownMenuTrigger,
   FilterBar,
   FilterBarGroup,
-  MegaMenu,
   Pagination,
   PaginationContent,
   PaginationEllipsis,

package/dist/components/navigation/tabs.js

@@ -8,7 +8,7 @@ import {
   Tabs as AriaTabs
 } from "react-aria-components";
 import { MoreHorizontal, Plus, X } from "lucide-react";
-import { useCounterPill } from "../ui/toggle.js";
+import { useCounterPill } from "../data-entry/toggle.js";
 import { useTranslation } from "../../i18n/use-translation.js";
 import { useMaxWidthBreakpoint } from "../../lib/breakpoint-token.js";
 import { cn } from "../../lib/utils.js";

package/dist/components/ui/carousel.d.ts

@@ -1 +1 @@
-export * from "../data-display/carousel.js";
+export * from "../../lab/carousel.js";

package/dist/components/ui/carousel.js

@@ -1,2 +1,2 @@
 "use client";
-export * from "../data-display/carousel.js";
+export * from "../../lab/carousel.js";

package/dist/components/ui/index.d.ts

@@ -1,7 +1,13 @@
+/**
+ * @deprecated `@godxjp/ui/ui` is the v31 shadcn-style alias, kept in v32 as RE-EXPORTS ONLY
+ * (#1223): every implementation lives in its group (`@godxjp/ui/general`, `/data-entry`,
+ * `/data-display`, `/feedback`, `/layout`, `/navigation`) — import from there. No file under
+ * `src/components/ui/` may hold an implementation again.
+ */
 export * from "./alert.js";
 export * from "./alert-dialog.js";
-export * from "./aspect-ratio.js";
-export * from "./avatar.js";
+export * from "../layout/aspect-ratio.js";
+export * from "../data-display/avatar.js";
 export * from "./badge.js";
 export * from "./button.js";
 export * from "./calendar.js";
@@ -13,7 +19,7 @@ export * from "./command.js";
 export * from "./resizable.js";
 export * from "./date-picker.js";
 export * from "./dialog.js";
-export { Separator } from "./separator.js";
+export { Separator } from "../layout/separator.js";
 export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider } from "../feedback/tooltip.js";
 export * from "./dropdown-menu.js";
 export * from "./input.js";
@@ -33,6 +39,6 @@ export * from "./table.js";
 export * from "./tabs.js";
 export * from "./textarea.js";
 export * from "./time-picker.js";
-export * from "./toggle.js";
-export * from "./toggle-group.js";
+export * from "../data-entry/toggle.js";
+export * from "../data-entry/toggle-group.js";
 export * from "./upload.js";

package/dist/components/ui/index.js

@@ -1,8 +1,8 @@
 "use client";
 export * from "./alert.js";
 export * from "./alert-dialog.js";
-export * from "./aspect-ratio.js";
-export * from "./avatar.js";
+export * from "../layout/aspect-ratio.js";
+export * from "../data-display/avatar.js";
 export * from "./badge.js";
 export * from "./button.js";
 export * from "./calendar.js";
@@ -14,7 +14,7 @@ export * from "./command.js";
 export * from "./resizable.js";
 export * from "./date-picker.js";
 export * from "./dialog.js";
-import { Separator } from "./separator.js";
+import { Separator } from "../layout/separator.js";
 import { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider } from "../feedback/tooltip.js";
 export * from "./dropdown-menu.js";
 export * from "./input.js";
@@ -34,8 +34,8 @@ export * from "./table.js";
 export * from "./tabs.js";
 export * from "./textarea.js";
 export * from "./time-picker.js";
-export * from "./toggle.js";
-export * from "./toggle-group.js";
+export * from "../data-entry/toggle.js";
+export * from "../data-entry/toggle-group.js";
 export * from "./upload.js";
 export {
   Separator,

package/dist/contracts/measurement.json

@@ -1,6 +1,6 @@
 {
   "$comment": "AUTO-GENERATED by scripts/gen-measurement-contract.mjs — do not edit. Read this instead of guessing: docs/MEASUREMENT-CONTRACT.md.",
-  "version": "31.31.8",
+  "version": "32.0.0",
   "targetSize": {
     "standard": "WCAG 2.2 SC 2.5.8 Target Size (Minimum), level AA — 24×24 CSS px",
     "min": 24,
@@ -17,7 +17,7 @@
           "badge",
           "date-picker",
           "input",
-          "tag-input",
+          "select-tags-inline",
           "textarea",
           "time-picker"
         ]

package/dist/email/brand-mark.d.ts

@@ -32,8 +32,9 @@ export interface EmailBrandMarkOptions {
     /** Internal glyph fill. Default `EMAIL_COLORS.brandForeground`. */
     glyphColor?: EmailHex;
     /**
-     * Accessible name. Pass `""` for a decorative mark that sits next to a readable wordmark — the
-     * markup then carries `alt=""` / `aria-hidden` instead of a redundant announcement.
+     * Accessible name — the product name, from the caller or the active preset's `emailBrandLabel`.
+     * There is no default name (v32, gh#1220): omitted or `""`, the mark is decorative and carries
+     * `aria-hidden` instead of an announcement, which is right beside a readable wordmark.
      */
     label?: string;
 }

package/dist/email/brand-mark.js

@@ -32,7 +32,7 @@ function options(o = {}) {
     height: o.height ?? DEFAULT_HEIGHT,
     color: o.color ?? EMAIL_COLORS.brand,
     glyphColor: o.glyphColor ?? EMAIL_COLORS.brandForeground,
-    label: o.label ?? "GoDX"
+    label: o.label ?? ""
   };
 }
 const attr = (value) => value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");

package/dist/email/tokens.generated.d.ts

@@ -37,7 +37,7 @@ export declare const EMAIL_COLOR_SOURCE: {
     };
     readonly primary: {
         readonly cssVar: "--primary";
-        readonly hsl: "268.7 100% 50%";
+        readonly hsl: "240 6% 10%";
     };
     readonly primaryForeground: {
         readonly cssVar: "--primary-foreground";
@@ -45,11 +45,11 @@ export declare const EMAIL_COLOR_SOURCE: {
     };
     readonly focus: {
         readonly cssVar: "--primary";
-        readonly hsl: "268.7 100% 50%";
+        readonly hsl: "240 6% 10%";
     };
     readonly brand: {
         readonly cssVar: "--brand";
-        readonly hsl: "268.7 100% 50%";
+        readonly hsl: "240 6% 10%";
     };
     readonly brandForeground: {
         readonly cssVar: "--brand-foreground";
@@ -96,7 +96,7 @@ export declare const EMAIL_COLOR_SOURCE_DARK: {
     };
     readonly primary: {
         readonly cssVar: "--primary";
-        readonly hsl: "268.7 100% 86.9%";
+        readonly hsl: "0 0% 98%";
     };
     readonly primaryForeground: {
         readonly cssVar: "--primary-foreground";
@@ -104,11 +104,11 @@ export declare const EMAIL_COLOR_SOURCE_DARK: {
     };
     readonly focus: {
         readonly cssVar: "--primary";
-        readonly hsl: "268.7 100% 86.9%";
+        readonly hsl: "0 0% 98%";
     };
     readonly brand: {
         readonly cssVar: "--brand";
-        readonly hsl: "268.7 100% 86.9%";
+        readonly hsl: "0 0% 98%";
     };
     readonly brandForeground: {
         readonly cssVar: "--brand-foreground";

package/dist/email/tokens.generated.js

@@ -29,7 +29,7 @@ const EMAIL_COLOR_SOURCE = {
   },
   "primary": {
     "cssVar": "--primary",
-    "hsl": "268.7 100% 50%"
+    "hsl": "240 6% 10%"
   },
   "primaryForeground": {
     "cssVar": "--primary-foreground",
@@ -37,11 +37,11 @@ const EMAIL_COLOR_SOURCE = {
   },
   "focus": {
     "cssVar": "--primary",
-    "hsl": "268.7 100% 50%"
+    "hsl": "240 6% 10%"
   },
   "brand": {
     "cssVar": "--brand",
-    "hsl": "268.7 100% 50%"
+    "hsl": "240 6% 10%"
   },
   "brandForeground": {
     "cssVar": "--brand-foreground",
@@ -87,7 +87,7 @@ const EMAIL_COLOR_SOURCE_DARK = {
   },
   "primary": {
     "cssVar": "--primary",
-    "hsl": "268.7 100% 86.9%"
+    "hsl": "0 0% 98%"
   },
   "primaryForeground": {
     "cssVar": "--primary-foreground",
@@ -95,11 +95,11 @@ const EMAIL_COLOR_SOURCE_DARK = {
   },
   "focus": {
     "cssVar": "--primary",
-    "hsl": "268.7 100% 86.9%"
+    "hsl": "0 0% 98%"
   },
   "brand": {
     "cssVar": "--brand",
-    "hsl": "268.7 100% 86.9%"
+    "hsl": "0 0% 98%"
   },
   "brandForeground": {
     "cssVar": "--brand-foreground",

package/dist/i18n/locale-tags.d.ts

@@ -0,0 +1,25 @@
+/** The tags the library ships its own catalog for — their library namespaces are reserved. */
+export declare function isBuiltInLocale(tag: string): boolean;
+/** `pt-br` → `pt-BR`. Throws `RangeError` on a string that is not a well-formed BCP-47 tag. */
+export declare function canonicalLocaleTag(tag: string): string;
+/** @internal Called by `registerLocale` only. */
+export declare function markLocaleRegistered(tag: string): void;
+export declare function getRegisteredLocales(): readonly string[];
+/**
+ * The registered tag that serves `tag`, by BCP-47 lookup (RFC 4647 §3.4): the exact tag first,
+ * then the tag with its last subtag removed, and so on — `de-AT` is served by `de`, `ja-JP` by
+ * `ja`. `undefined` when nothing registered matches.
+ */
+export declare function resolveRegisteredLocale(tag: string | null | undefined): string | undefined;
+/** `<html lang>` when it names a registered locale. Read at CALL time — `lang` is often set late. */
+export declare function resolvePageLocale(): string | undefined;
+/**
+ * The locale nothing chose (decision A2): the page's `<html lang>` if it is registered, else
+ * `en`. NEVER `navigator.language` — a server cannot see it, so the first client render would
+ * disagree with the server's HTML.
+ */
+export declare function resolveDefaultLocale(): string;
+/** One development warning per unknown tag, then silence. */
+export declare function warnUnknownLocale(tag: string, fallback: string): void;
+/** Test seam: the once-per-tag warning is module state. */
+export declare function resetUnknownLocaleWarningsForTests(): void;

package/dist/i18n/locale-tags.js

@@ -0,0 +1,59 @@
+import { isDevelopment } from "../lib/dev.js";
+const BUILT_IN = ["vi", "en", "ja"];
+const registered = new Set(BUILT_IN);
+function isBuiltInLocale(tag) {
+  return BUILT_IN.includes(tag);
+}
+function canonicalLocaleTag(tag) {
+  return Intl.getCanonicalLocales(tag)[0] ?? tag;
+}
+function markLocaleRegistered(tag) {
+  registered.add(tag);
+}
+function getRegisteredLocales() {
+  return [...registered];
+}
+function resolveRegisteredLocale(tag) {
+  if (!tag) return void 0;
+  let candidate;
+  try {
+    candidate = canonicalLocaleTag(tag);
+  } catch {
+    return void 0;
+  }
+  for (; ; ) {
+    if (registered.has(candidate)) return candidate;
+    const cut = candidate.lastIndexOf("-");
+    if (cut <= 0) return void 0;
+    candidate = candidate.slice(0, cut);
+  }
+}
+function resolvePageLocale() {
+  if (typeof document === "undefined") return void 0;
+  return resolveRegisteredLocale(document.documentElement.lang);
+}
+function resolveDefaultLocale() {
+  return resolvePageLocale() ?? "en";
+}
+const warnedTags = /* @__PURE__ */ new Set();
+function warnUnknownLocale(tag, fallback) {
+  if (warnedTags.has(tag) || !isDevelopment()) return;
+  warnedTags.add(tag);
+  console.warn(
+    `[@godxjp/ui] Locale "${tag}" is not registered, so "${fallback}" is used instead. Call registerLocale({ code: "${tag}", \u2026 }) before rendering. Shown once.`
+  );
+}
+function resetUnknownLocaleWarningsForTests() {
+  warnedTags.clear();
+}
+export {
+  canonicalLocaleTag,
+  getRegisteredLocales,
+  isBuiltInLocale,
+  markLocaleRegistered,
+  resetUnknownLocaleWarningsForTests,
+  resolveDefaultLocale,
+  resolvePageLocale,
+  resolveRegisteredLocale,
+  warnUnknownLocale
+};

package/dist/i18n/translate.d.ts

@@ -22,15 +22,32 @@ export type MessageKey = string;
  * instead; every string this library renders has one.
  */
 export declare function registerMessages(locale: AppLocale, messages: Record<string, unknown>): void;
+/**
+ * @internal `registerLocale`'s half of the catalog. For a locale the library does NOT ship
+ * (`allowLibraryNamespaces`), the pack translates the library's own strings, so its `dataEntry.*`
+ * and friends are exactly what it is for; for `vi` / `en` / `ja` the reserved-namespace rule of
+ * `registerMessages` still applies.
+ */
+export declare function registerLocaleMessages(locale: AppLocale, messages: Record<string, unknown>, allowLibraryNamespaces: boolean): void;
 export type TranslateParams = Record<string, string | number>;
 /** Resolve a dot-path message with fallback locale chain, CLDR plurals, and locale number formatting. */
 export declare function translate(locale: AppLocale, fallbackLocale: AppLocale, key: MessageKey, params?: TranslateParams): string;
-/** Non-React translate using module-synced locale (see `syncI18nLocale`). */
+/** Non-React translate using the CURRENT scope's locale (see `syncI18nLocale`, `runWithAppSettings`). */
 export declare function translateCurrent(key: MessageKey, params?: TranslateParams): string;
+/**
+ * Tell non-React callers in the CURRENT scope which locale to use. `AppProvider` calls it while
+ * rendering; inside `runWithAppSettings` it writes that request's state only.
+ */
 export declare function syncI18nLocale(locale: AppLocale, fallbackLocale: AppLocale): void;
-/** Whether anything has ever called `syncI18nLocale` — the resting "vi" was never CHOSEN. */
+/** Whether anything chose a locale for the current scope — the resting default was never CHOSEN. */
 export declare function isI18nLocaleSynced(): boolean;
+/**
+ * The current scope's locale; unset → `<html lang>` if registered, else `en`.
+ * @deprecated Inside React read `useTranslation().locale`; outside it, this reads the current
+ * `runWithAppSettings` scope.
+ */
 export declare function getSyncedLocale(): AppLocale;
+/** @deprecated Inside React read `useTranslation().fallbackLocale`. */
 export declare function getSyncedFallbackLocale(): AppLocale;
-/** Reset for tests. */
+/** Reset the current scope's locale — for tests. */
 export declare function resetI18nLocale(): void;