@godxjp/ui 31.31.8 → 32.0.1

package/dist/email/tokens.generated.js

@@ -1,4 +1,120 @@
 const EMAIL_COLOR_SOURCE = {
+  "background": {
+    "cssVar": "--background",
+    "hsl": "60 33% 99%"
+  },
+  "foreground": {
+    "cssVar": "--foreground",
+    "hsl": "48 8% 13%"
+  },
+  "surface": {
+    "cssVar": "--card",
+    "hsl": "60 33% 99%"
+  },
+  "surfaceForeground": {
+    "cssVar": "--card-foreground",
+    "hsl": "48 8% 13%"
+  },
+  "muted": {
+    "cssVar": "--muted",
+    "hsl": "45 15% 95%"
+  },
+  "mutedForeground": {
+    "cssVar": "--muted-foreground",
+    "hsl": "44 5% 39%"
+  },
+  "border": {
+    "cssVar": "--border",
+    "hsl": "30 7% 93%"
+  },
+  "primary": {
+    "cssVar": "--primary",
+    "hsl": "240 6% 10%"
+  },
+  "primaryForeground": {
+    "cssVar": "--primary-foreground",
+    "hsl": "60 33% 99%"
+  },
+  "focus": {
+    "cssVar": "--primary",
+    "hsl": "240 6% 10%"
+  },
+  "brand": {
+    "cssVar": "--brand",
+    "hsl": "240 6% 10%"
+  },
+  "brandForeground": {
+    "cssVar": "--brand-foreground",
+    "hsl": "60 33% 99%"
+  },
+  "urgency": {
+    "cssVar": "--attention",
+    "hsl": "25 99% 46%"
+  },
+  "urgencyForeground": {
+    "cssVar": "--attention-foreground",
+    "hsl": "48 8% 13%"
+  }
+};
+const EMAIL_COLOR_SOURCE_DARK = {
+  "background": {
+    "cssVar": "--background",
+    "hsl": "48 9% 9%"
+  },
+  "foreground": {
+    "cssVar": "--foreground",
+    "hsl": "60 20% 96%"
+  },
+  "surface": {
+    "cssVar": "--card",
+    "hsl": "48 8% 12%"
+  },
+  "surfaceForeground": {
+    "cssVar": "--card-foreground",
+    "hsl": "60 20% 96%"
+  },
+  "muted": {
+    "cssVar": "--muted",
+    "hsl": "45 6% 18%"
+  },
+  "mutedForeground": {
+    "cssVar": "--muted-foreground",
+    "hsl": "44 6% 64%"
+  },
+  "border": {
+    "cssVar": "--border",
+    "hsl": "45 6% 19%"
+  },
+  "primary": {
+    "cssVar": "--primary",
+    "hsl": "0 0% 98%"
+  },
+  "primaryForeground": {
+    "cssVar": "--primary-foreground",
+    "hsl": "48 9% 9%"
+  },
+  "focus": {
+    "cssVar": "--primary",
+    "hsl": "0 0% 98%"
+  },
+  "brand": {
+    "cssVar": "--brand",
+    "hsl": "0 0% 98%"
+  },
+  "brandForeground": {
+    "cssVar": "--brand-foreground",
+    "hsl": "48 9% 9%"
+  },
+  "urgency": {
+    "cssVar": "--attention",
+    "hsl": "25 95% 56%"
+  },
+  "urgencyForeground": {
+    "cssVar": "--attention-foreground",
+    "hsl": "48 9% 9%"
+  }
+};
+const EMAIL_COLOR_SOURCE_GODX = {
   "background": {
     "cssVar": "--background",
     "hsl": "60 33% 99%"
@@ -56,7 +172,7 @@ const EMAIL_COLOR_SOURCE = {
     "hsl": "48 8% 13%"
   }
 };
-const EMAIL_COLOR_SOURCE_DARK = {
+const EMAIL_COLOR_SOURCE_GODX_DARK = {
   "background": {
     "cssVar": "--background",
     "hsl": "48 9% 9%"
@@ -164,6 +280,8 @@ const EMAIL_MARK_SOURCE = {
 export {
   EMAIL_COLOR_SOURCE,
   EMAIL_COLOR_SOURCE_DARK,
+  EMAIL_COLOR_SOURCE_GODX,
+  EMAIL_COLOR_SOURCE_GODX_DARK,
   EMAIL_GEOMETRY_SOURCE,
   EMAIL_MARK_SOURCE
 };

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;

package/dist/i18n/translate.js

@@ -1,7 +1,10 @@
+"use client";
 import en from "./messages/en.json" with { type: "json" };
 import ja from "./messages/ja.json" with { type: "json" };
 import vi from "./messages/vi.json" with { type: "json" };
 import { numberFormat, pluralRules } from "../lib/intl-cache.js";
+import { getAppSettingsState } from "../app/settings-scope.js";
+import { resolveDefaultLocale, warnUnknownLocale } from "./locale-tags.js";
 const MESSAGE_CATALOG = {
   vi,
   en,
@@ -11,6 +14,11 @@ const LIBRARY_NAMESPACES = new Set(
   Object.values(MESSAGE_CATALOG).flatMap((messages) => Object.keys(messages))
 );
 function registerMessages(locale, messages) {
+  if (!Object.hasOwn(MESSAGE_CATALOG, locale)) {
+    throw new Error(
+      `@godxjp/ui i18n: locale "${locale}" is not registered. Call registerLocale({ code: "${locale}", messages }) instead \u2014 it registers the locale and its strings together.`
+    );
+  }
   const reserved = [...LIBRARY_NAMESPACES].filter((key) => Object.hasOwn(messages, key));
   if (reserved.length > 0) {
     throw new Error(
@@ -19,6 +27,13 @@ function registerMessages(locale, messages) {
   }
   MESSAGE_CATALOG[locale] = mergeDeep(MESSAGE_CATALOG[locale] ?? {}, messages);
 }
+function registerLocaleMessages(locale, messages, allowLibraryNamespaces) {
+  if (!allowLibraryNamespaces) {
+    registerMessages(locale, messages);
+    return;
+  }
+  MESSAGE_CATALOG[locale] = mergeDeep(MESSAGE_CATALOG[locale] ?? {}, messages);
+}
 function mergeDeep(target, source) {
   const merged = { ...target };
   for (const [key, value] of Object.entries(source)) {
@@ -71,41 +86,37 @@ function interpolate(template, locale, params) {
   );
 }
 function translate(locale, fallbackLocale, key, params) {
-  const primary = getNested(MESSAGE_CATALOG[locale], key);
-  const fallback = getNested(MESSAGE_CATALOG[fallbackLocale], key);
+  const catalog = MESSAGE_CATALOG[locale];
+  if (!catalog) warnUnknownLocale(locale, fallbackLocale);
+  const primary = catalog ? getNested(catalog, key) : void 0;
+  const fallback = getNested(MESSAGE_CATALOG[fallbackLocale] ?? {}, key);
   const value = primary ?? fallback ?? key;
   return interpolate(selectPlural(value, locale, params), locale, params);
 }
 function translateCurrent(key, params) {
   return translate(getSyncedLocale(), getSyncedFallbackLocale(), key, params);
 }
-let syncedLocale = "vi";
-let syncedFallbackLocale = "en";
-let syncedByCaller = false;
 function syncI18nLocale(locale, fallbackLocale) {
-  syncedLocale = locale;
-  syncedFallbackLocale = fallbackLocale;
-  syncedByCaller = true;
+  getAppSettingsState().i18n = { locale, fallbackLocale };
 }
 function isI18nLocaleSynced() {
-  return syncedByCaller;
+  return getAppSettingsState().i18n?.locale !== void 0;
 }
 function getSyncedLocale() {
-  return syncedLocale;
+  return getAppSettingsState().i18n?.locale ?? resolveDefaultLocale();
 }
 function getSyncedFallbackLocale() {
-  return syncedFallbackLocale;
+  return getAppSettingsState().i18n?.fallbackLocale ?? "en";
 }
 function resetI18nLocale() {
-  syncedLocale = "vi";
-  syncedFallbackLocale = "en";
-  syncedByCaller = false;
+  getAppSettingsState().i18n = void 0;
 }
 export {
   MESSAGE_CATALOG,
   getSyncedFallbackLocale,
   getSyncedLocale,
   isI18nLocaleSynced,
+  registerLocaleMessages,
   registerMessages,
   resetI18nLocale,
   syncI18nLocale,

package/dist/i18n/use-translation.d.ts

@@ -4,13 +4,13 @@ import { type MessageKey, type TranslateParams } from "./translate.js";
 export declare function resetOutsideProviderWarningForTests(): void;
 type DayPickerLocale = NonNullable<DayPickerProps["locale"]>;
 export declare function useTranslation(): {
-    locale: import("../app/index.js").AppLocale;
-    fallbackLocale: import("../app/index.js").AppLocale;
+    locale: string;
+    fallbackLocale: string;
     t: (key: MessageKey, params?: TranslateParams) => string;
 };
 /** date-fns + react-day-picker locales + datetime prefs from AppProvider. */
 export declare function usePickerLocales(dayPickerOverride?: DayPickerLocale): {
-    locale: import("../app/index.js").AppLocale;
+    locale: string;
     timezone: string;
     timeFormat: import("../app/index.js").AppTimeFormat;
     dateFormat: import("../app/index.js").AppDateFormat;

package/dist/i18n/use-translation.js

@@ -3,6 +3,8 @@ import { useMemo } from "react";
 import { useOptionalAppContext } from "../app/app-provider.js";
 import { getDateFnsLocale, getDayPickerLocale } from "../app/locales.js";
 import { resolveHydrationSafeTimezone } from "../app/timezones.js";
+import { resolveDefaultDateFormat } from "../app/date-format-labels.js";
+import { resolveDefaultTimeFormat } from "../app/time-format-labels.js";
 import { isDevelopment } from "../lib/dev.js";
 import {
   getSyncedFallbackLocale,
@@ -45,8 +47,8 @@ function usePickerLocales(dayPickerOverride) {
       // AppProvider's own unconfigured answer (gh#968) — a zone that looks right when it is wrong
       // (Asia/Ho_Chi_Minh) is worse than one that is visibly not local.
       timezone: ctx?.timezone ?? resolveHydrationSafeTimezone("browser"),
-      timeFormat: ctx?.timeFormat ?? "24h",
-      dateFormat: ctx?.dateFormat ?? "dmy",
+      timeFormat: ctx?.timeFormat ?? resolveDefaultTimeFormat(locale),
+      dateFormat: ctx?.dateFormat ?? resolveDefaultDateFormat(locale),
       dateFnsLocale: ctx?.dateFnsLocale ?? getDateFnsLocale(locale),
       dayPickerLocale: dayPickerOverride ?? ctx?.dayPickerLocale ?? getDayPickerLocale(locale)
     }),

package/dist/{components/navigation → lab}/anchor.d.ts

@@ -1,6 +1,6 @@
 import * as React from "react";
-import type { AnchorProp } from "../../props/components/navigation.prop.js";
-export type { AnchorContainerProp, AnchorDirectionProp, AnchorItemProp, AnchorProp, AnchorProp as AnchorProps, } from "../../props/components/navigation.prop.js";
+import type { AnchorProp } from "../props/components/navigation.prop.js";
+export type { AnchorContainerProp, AnchorDirectionProp, AnchorItemProp, AnchorProp, AnchorProp as AnchorProps, } from "../props/components/navigation.prop.js";
 /**
  * Anchor — Ant Design `Anchor` (6.6.5): the in-page section navigation, and — the part that makes
  * it a component rather than a composition — the thing that WORKS OUT which section is current.

package/dist/{components/navigation → lab}/anchor.js

@@ -1,11 +1,11 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
 import * as React from "react";
-import { useTranslation } from "../../i18n/use-translation.js";
-import { isDevelopment } from "../../lib/dev.js";
-import { scrollBoxOf, useControlledLatch } from "../../lib/hooks.js";
-import { cn, prefersReducedMotion } from "../../lib/utils.js";
-import { Affix } from "../layout/affix.js";
+import { useTranslation } from "../i18n/use-translation.js";
+import { isDevelopment } from "../lib/dev.js";
+import { scrollBoxOf, useControlledLatch } from "../lib/hooks.js";
+import { cn, prefersReducedMotion } from "../lib/utils.js";
+import { Affix } from "../components/layout/affix.js";
 const SHARP_MATCHER = /#([^\t\r\n\f\v]+)$/;
 const DEFAULT_BOUNDS = 5;
 const SCROLL_SETTLE_MS = 120;

package/dist/{components/data-display → lab}/carousel.js

@@ -3,8 +3,8 @@ import { jsx, jsxs } from "react/jsx-runtime";
 import * as React from "react";
 import useEmblaCarousel from "embla-carousel-react";
 import { ChevronLeft, ChevronRight } from "lucide-react";
-import { useTranslation } from "../../i18n/use-translation.js";
-import { cn } from "../../lib/utils.js";
+import { useTranslation } from "../i18n/use-translation.js";
+import { cn } from "../lib/utils.js";
 const CarouselContext = React.createContext(null);
 const useCarousel = () => {
   const context = React.useContext(CarouselContext);

package/dist/{components/layout → lab}/draggable-panel.d.ts

@@ -1,12 +1,12 @@
 import * as React from "react";
-import type { DragAxisProp, DraggablePanelPositionProp } from "../../props/components/layout.prop.js";
-export type { DraggablePanelProp, DraggablePanelProp as DraggablePanelProps, DraggablePanelPlacementProp, DraggablePanelPositionProp, DraggablePanelLabels, DragAxisProp, DragBoundsProp, } from "../../props/components/layout.prop.js";
+import type { DragAxisProp, DraggablePanelPositionProp } from "../props/components/layout.prop.js";
+export type { DraggablePanelProp, DraggablePanelProp as DraggablePanelProps, DraggablePanelPlacementProp, DraggablePanelPositionProp, DraggablePanelLabels, DragAxisProp, DragBoundsProp, } from "../props/components/layout.prop.js";
 export declare const DraggablePanel: React.ForwardRefExoticComponent<Omit<React.HTMLAttributes<HTMLElement>, "children" | "onDrag" | "title"> & {
-    title: import("../../props/index.js").TitleProp;
-    children?: import("../../props/index.js").ChildrenProp;
-    extra?: import("../../props/index.js").ExtraProp;
+    title: import("../props/index.js").TitleProp;
+    children?: import("../props/index.js").ChildrenProp;
+    extra?: import("../props/index.js").ExtraProp;
     placement?: import("./draggable-panel.js").DraggablePanelPlacementProp;
-    width?: Extract<import("../../props/index.js").SizeProp, "sm" | "md" | "lg"> | "xl";
+    width?: Extract<import("../props/index.js").SizeProp, "sm" | "md" | "lg"> | "xl";
     axis?: DragAxisProp;
     bounds?: import("./draggable-panel.js").DragBoundsProp;
     position?: DraggablePanelPositionProp;
@@ -14,6 +14,6 @@ export declare const DraggablePanel: React.ForwardRefExoticComponent<Omit<React.
     onPositionChange?: (position: DraggablePanelPositionProp) => void;
     onClose?: () => void;
     labels?: import("./draggable-panel.js").DraggablePanelLabels;
-    disabled?: import("../../props/index.js").DisabledProp;
-    className?: import("../../props/index.js").ClassNameProp;
+    disabled?: import("../props/index.js").DisabledProp;
+    className?: import("../props/index.js").ClassNameProp;
 } & React.RefAttributes<HTMLElement>>;

package/dist/{components/layout → lab}/draggable-panel.js

@@ -2,8 +2,8 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import * as React from "react";
 import { GripVertical, X } from "lucide-react";
-import { cn } from "../../lib/utils.js";
-import { useTranslation } from "../../i18n/use-translation.js";
+import { cn } from "../lib/utils.js";
+import { useTranslation } from "../i18n/use-translation.js";
 const AXIS_ALLOWS_X = {
   both: true,
   x: true,

package/dist/{components/data-entry → lab}/emoji-picker.d.ts

@@ -1,6 +1,6 @@
 import * as React from "react";
-import type { EmojiPickerProp } from "../../props/components/data-entry.prop.js";
-export type { EmojiPickerProp, EmojiPickerProp as EmojiPickerProps, } from "../../props/components/data-entry.prop.js";
+import type { EmojiPickerProp } from "../props/components/data-entry.prop.js";
+export type { EmojiPickerProp, EmojiPickerProp as EmojiPickerProps, } from "../props/components/data-entry.prop.js";
 /**
  * EmojiPicker (gh#1164) — a page icon / reaction picker in a Popover: search by ja / en / vi
  * keywords (emojibase-data, the CLDR annotations, loaded for the active locale only when it first

package/dist/{components/data-entry → lab}/emoji-picker.js

@@ -14,13 +14,13 @@ import {
   User,
   UtensilsCrossed
 } from "lucide-react";
-import { useTranslation } from "../../i18n/use-translation.js";
-import { cn } from "../../lib/utils.js";
-import { Popover, PopoverContent, PopoverTrigger } from "../data-display/popover.js";
-import { Button } from "../general/button.js";
-import { Text } from "../general/typography.js";
+import { useTranslation } from "../i18n/use-translation.js";
+import { cn } from "../lib/utils.js";
+import { Popover, PopoverContent, PopoverTrigger } from "../components/data-display/popover.js";
+import { Button } from "../components/general/button.js";
+import { Text } from "../components/general/typography.js";
 import { EMOJI_GROUPS, loadEmoji, searchEmoji } from "./emoji-data.js";
-import { SearchInput } from "./search-input.js";
+import { SearchInput } from "../components/data-entry/search-input.js";
 const COLUMNS = 8;
 const ICON_SIZE = { xs: "icon-xs", sm: "icon-sm", md: "icon", lg: "icon-lg" };
 const RECENTS_LIMIT = 24;

package/dist/{components/general → lab}/float-button.d.ts

@@ -1,6 +1,6 @@
 import * as React from "react";
-import type { FloatButtonBackTopProp, FloatButtonGroupProp, FloatButtonShapeProp, FloatButtonTooltipProp, FloatButtonTypeProp } from "../../props/components/general.prop.js";
-export type { FloatButtonBackTopProp, FloatButtonBackTopProp as FloatButtonBackTopProps, FloatButtonBadgeProp, FloatButtonGroupProp, FloatButtonGroupProp as FloatButtonGroupProps, FloatButtonPlacementProp, FloatButtonProp, FloatButtonProp as FloatButtonProps, FloatButtonShapeProp, FloatButtonTooltipProp, FloatButtonTriggerProp, FloatButtonTypeProp, } from "../../props/components/general.prop.js";
+import type { FloatButtonBackTopProp, FloatButtonGroupProp, FloatButtonShapeProp, FloatButtonTooltipProp, FloatButtonTypeProp } from "../props/components/general.prop.js";
+export type { FloatButtonBackTopProp, FloatButtonBackTopProp as FloatButtonBackTopProps, FloatButtonBadgeProp, FloatButtonGroupProp, FloatButtonGroupProp as FloatButtonGroupProps, FloatButtonPlacementProp, FloatButtonProp, FloatButtonProp as FloatButtonProps, FloatButtonShapeProp, FloatButtonTooltipProp, FloatButtonTriggerProp, FloatButtonTypeProp, } from "../props/components/general.prop.js";
 /**
  * FloatButton.Group — a stack of corner actions, optionally behind one trigger.
  *
@@ -23,18 +23,18 @@ declare function FloatButtonBackTop({ visibilityHeight, target, duration, showPr
  * screen writes `<FloatButton.Group>` / `<FloatButton.BackTop>` unchanged.
  */
 export declare const FloatButton: React.ForwardRefExoticComponent<Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "color" | "content" | "type"> & {
-    icon?: import("../../props/index.js").ChildrenProp;
-    description?: import("../../props/index.js").DescriptionProp;
-    content?: import("../../props/index.js").ChildrenProp;
+    icon?: import("../props/index.js").ChildrenProp;
+    description?: import("../props/index.js").DescriptionProp;
+    content?: import("../props/index.js").ChildrenProp;
     type?: FloatButtonTypeProp;
     shape?: FloatButtonShapeProp;
-    tooltip?: import("../../props/index.js").ChildrenProp | FloatButtonTooltipProp;
+    tooltip?: import("../props/index.js").ChildrenProp | FloatButtonTooltipProp;
     href?: string;
     target?: React.HTMLAttributeAnchorTarget;
     badge?: import("./float-button.js").FloatButtonBadgeProp;
-    disabled?: import("../../props/index.js").DisabledProp;
+    disabled?: import("../props/index.js").DisabledProp;
     htmlType?: "button" | "submit" | "reset";
-    className?: import("../../props/index.js").ClassNameProp;
+    className?: import("../props/index.js").ClassNameProp;
 } & React.RefAttributes<HTMLElement>> & {
     Group: typeof FloatButtonGroup;
     BackTop: typeof FloatButtonBackTop;

package/dist/{components/general → lab}/float-button.js

@@ -2,13 +2,13 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import * as React from "react";
 import { ChevronUp, FileText, X } from "lucide-react";
-import { useTranslation } from "../../i18n/use-translation.js";
-import { useMediaQuery } from "../../lib/hooks.js";
-import { numberFormat } from "../../lib/intl-cache.js";
-import { cn } from "../../lib/utils.js";
-import { Tooltip, TooltipContent, TooltipTrigger } from "../feedback/tooltip.js";
-import { Button } from "./button.js";
-import { isDevelopment } from "../../lib/dev.js";
+import { useTranslation } from "../i18n/use-translation.js";
+import { useMediaQuery } from "../lib/hooks.js";
+import { numberFormat } from "../lib/intl-cache.js";
+import { cn } from "../lib/utils.js";
+import { Tooltip, TooltipContent, TooltipTrigger } from "../components/feedback/tooltip.js";
+import { Button } from "../components/general/button.js";
+import { isDevelopment } from "../lib/dev.js";
 const GroupContext = React.createContext(null);
 const DEFAULT_ICON = /* @__PURE__ */ jsx(FileText, { "aria-hidden": "true" });
 const BUTTON_VARIANT = {

package/dist/lab/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * `@godxjp/ui/lab` — opt-in components (v32 #1223, decision B3).
+ *
+ * Real behaviour and a known pattern, but niche (a website or novelty surface): no consumer should
+ * pay their catalog and context cost by default. They ship with the SAME gates as core — tests,
+ * a11y, i18n, tokens — and the stylesheet is the core one. The MCP lists them only when asked.
+ *
+ * Promotion to core: once a component is imported by >= 2 repos. Demotion: never automatic.
+ */
+export { FloatButton } from "./float-button.js";
+export type { FloatButtonBackTopProp, FloatButtonBackTopProps, FloatButtonBadgeProp, FloatButtonGroupProp, FloatButtonGroupProps, FloatButtonPlacementProp, FloatButtonProp, FloatButtonProps, FloatButtonShapeProp, FloatButtonTooltipProp, FloatButtonTriggerProp, FloatButtonTypeProp, } from "./float-button.js";
+export { PageCover } from "./page-cover.js";
+export type { PageCoverProp, PageCoverProps } from "./page-cover.js";
+export { DraggablePanel } from "./draggable-panel.js";
+export type { DraggablePanelProp, DraggablePanelProps, DraggablePanelPlacementProp, DraggablePanelPositionProp, DraggablePanelLabels, DragAxisProp, DragBoundsProp, } from "./draggable-panel.js";
+export { LegalDocumentShell } from "./legal-document-shell.js";
+export type { LegalDocumentSectionProp, LegalDocumentShellProp, LegalDocumentShellProps, } from "./legal-document-shell.js";
+export { Masonry } from "./masonry.js";
+export type { MasonryColumnsProp, MasonryGapProp, MasonryItemProp, MasonryLayoutEntryProp, MasonryProp, MasonryProps, } from "./masonry.js";
+export { Marquee } from "./marquee.js";
+export type { MarqueeDirectionProp, MarqueeProp, MarqueeProps, MarqueeSpeedProp } from "./marquee.js";
+export { TextDiff, diffText, tokenizeText } from "./text-diff.js";
+export type { TextDiffGranularity, TextDiffProp, TextDiffProps, TextDiffSegment, } from "./text-diff.js";
+export { TimelineGrid } from "./timeline-grid.js";
+export type { TimelineGridColumnProp, TimelineGridEventProp, TimelineGridProp, TimelineGridProps, } from "./timeline-grid.js";
+export { Carousel, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, CarouselDots, useCarousel, } from "./carousel.js";
+export type { CarouselApi } from "./carousel.js";
+export { RangeTimeline } from "./range-timeline.js";
+export type { RangeTimelineProps, RangeTimelineRow } from "./range-timeline.js";
+export { OrgChart } from "./org-chart.js";
+export type { OrgChartNodeProp, OrgChartNodeVariantProp, OrgChartProp, OrgChartProps, } from "./org-chart.js";
+export { EmojiPicker } from "./emoji-picker.js";
+export type { EmojiPickerProp, EmojiPickerProps } from "./emoji-picker.js";
+export { SortableList } from "./sortable-list.js";
+export type { SortableListItemProp, SortableListProp, SortableListProps } from "./sortable-list.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 { Anchor } from "./anchor.js";
+export type { AnchorContainerProp, AnchorDirectionProp, AnchorItemProp, AnchorProp, AnchorProps, } from "./anchor.js";

package/dist/lab/index.js

@@ -0,0 +1,48 @@
+import { FloatButton } from "./float-button.js";
+import { PageCover } from "./page-cover.js";
+import { DraggablePanel } from "./draggable-panel.js";
+import { LegalDocumentShell } from "./legal-document-shell.js";
+import { Masonry } from "./masonry.js";
+import { Marquee } from "./marquee.js";
+import { TextDiff, diffText, tokenizeText } from "./text-diff.js";
+import { TimelineGrid } from "./timeline-grid.js";
+import {
+  Carousel,
+  CarouselContent,
+  CarouselItem,
+  CarouselNext,
+  CarouselPrevious,
+  CarouselDots,
+  useCarousel
+} from "./carousel.js";
+import { RangeTimeline } from "./range-timeline.js";
+import { OrgChart } from "./org-chart.js";
+import { EmojiPicker } from "./emoji-picker.js";
+import { SortableList } from "./sortable-list.js";
+import { MegaMenu } from "./mega-menu.js";
+import { Anchor } from "./anchor.js";
+export {
+  Anchor,
+  Carousel,
+  CarouselContent,
+  CarouselDots,
+  CarouselItem,
+  CarouselNext,
+  CarouselPrevious,
+  DraggablePanel,
+  EmojiPicker,
+  FloatButton,
+  LegalDocumentShell,
+  Marquee,
+  Masonry,
+  MegaMenu,
+  OrgChart,
+  PageCover,
+  RangeTimeline,
+  SortableList,
+  TextDiff,
+  TimelineGrid,
+  diffText,
+  tokenizeText,
+  useCarousel
+};