@godxjp/ui 31.31.8 → 32.0.0

package/dist/{components/data-display → lab}/text-diff.d.ts

@@ -1,6 +1,6 @@
 import * as React from "react";
-import type { TextDiffProp, TextDiffSegment } from "../../props/components/data-display.prop.js";
-export type { TextDiffProp, TextDiffProp as TextDiffProps, TextDiffSegment, } from "../../props/components/data-display.prop.js";
+import type { TextDiffProp, TextDiffSegment } from "../props/components/data-display.prop.js";
+export type { TextDiffProp, TextDiffProp as TextDiffProps, TextDiffSegment, } from "../props/components/data-display.prop.js";
 /** The unit a change is measured in — see `TextDiffProp["granularity"]`. */
 export type TextDiffGranularity = NonNullable<TextDiffProp["granularity"]>;
 /**
@@ -41,5 +41,5 @@ export declare const TextDiff: React.ForwardRefExoticComponent<Omit<React.HTMLAt
     beforeLabel?: React.ReactNode;
     afterLabel?: React.ReactNode;
     lang?: string;
-    className?: import("../../props/index.js").ClassNameProp;
+    className?: import("../props/index.js").ClassNameProp;
 } & React.RefAttributes<HTMLDivElement>>;

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

@@ -1,10 +1,10 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import * as React from "react";
-import { useTranslation } from "../../i18n/use-translation.js";
-import { cn } from "../../lib/utils.js";
-import { Button } from "../general/button.js";
-import { VisuallyHidden } from "../general/visually-hidden.js";
+import { useTranslation } from "../i18n/use-translation.js";
+import { cn } from "../lib/utils.js";
+import { Button } from "../components/general/button.js";
+import { VisuallyHidden } from "../components/general/visually-hidden.js";
 const CJK = /[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}]/u;
 const DEFAULT_MAX_CELLS = 4e6;
 const MIN_HIDDEN_LINES = 2;

package/dist/{components/data-display → lab}/timeline-grid.d.ts

@@ -1,6 +1,6 @@
 import * as React from "react";
-import type { TimelineGridProp } from "../../props/components/data-display.prop.js";
-export type { TimelineGridColumnProp, TimelineGridEventProp, TimelineGridProp, TimelineGridProp as TimelineGridProps, } from "../../props/components/data-display.prop.js";
+import type { TimelineGridProp } from "../props/components/data-display.prop.js";
+export type { TimelineGridColumnProp, TimelineGridEventProp, TimelineGridProp, TimelineGridProp as TimelineGridProps, } from "../props/components/data-display.prop.js";
 /**
  * TimelineGrid — the time-axis half of the Timeline family: a vertical hour axis, one column per
  * day (or room, or machine) and event blocks placed by start time and duration.

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

@@ -1,7 +1,7 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import * as React from "react";
-import { cn } from "../../lib/utils.js";
+import { cn } from "../lib/utils.js";
 const MINUTES_PER_DAY = 24 * 60;
 const CLOCK = /^(\d{1,2}):(\d{2})$/;
 function toMinutes(value) {

package/dist/lib/control-styles.js

@@ -5,7 +5,7 @@ const controlOpenRingClass = "ui-control-trigger";
 const controlTriggerBaseClass = (
   // PER-EDGE RADIUS THROUGH A KNOB, same repair as Input's `--input-radius-start`/`-end`
   // (gh#841): a plain `rounded-[var(--control-radius)]` is a utility, and `@layer utilities`
-  // outranks `@layer components`, so a joined-control seam (SpaceCompact) can never zero one
+  // outranks `@layer components`, so a joined-control seam (`Flex attached`) can never zero one
   // side of it from a components-layer rule. Unset, both knobs fall back to `--control-radius`
   // exactly as before — no existing trigger changes.
   "ui-control ui-control-trigger flex items-center justify-between gap-2 whitespace-nowrap rounded-s-[var(--control-trigger-radius-start,var(--control-radius))] rounded-e-[var(--control-trigger-radius-end,var(--control-radius))] transition-[color,box-shadow] [&>[data-slot=select-value]]:line-clamp-1 [&>[data-slot=select-value]]:whitespace-normal [&>[data-slot=select-value]]:text-ellipsis"

package/dist/lib/datetime/format.js

@@ -1,7 +1,7 @@
 import { TZDate } from "@date-fns/tz";
 import { format, formatDistanceToNow } from "date-fns";
 import { getDateFnsLocale } from "../../app/locales.js";
-import { getDatePattern, getDateTimePattern } from "../../app/date-formats.js";
+import { getDateTimePattern, getLocaleAwareDatePattern } from "../../app/date-formats.js";
 import { getTimePattern } from "../../app/time-formats.js";
 import { calendarDateToTZDate, hhmmToTZDate, parseDateInput } from "./parse.js";
 import { isDateOnlyString } from "./detect.js";
@@ -13,8 +13,10 @@ function resolveLocale(locale) {
 }
 function resolveOptions(options) {
   const ctx = getDatetimeContext();
+  const locale = resolveLocale(options?.locale);
   return {
-    locale: resolveLocale(options?.locale),
+    locale,
+    tag: typeof options?.locale === "string" ? options.locale : options?.locale?.code ?? ctx.locale,
     timezone: options?.timezone ?? ctx.timezone,
     timeFormat: options?.timeFormat ?? ctx.timeFormat,
     dateFormat: options?.dateFormat ?? ctx.dateFormat
@@ -31,19 +33,31 @@ function formatCalendarDate(value, options) {
   if (!value) return EMPTY;
   const resolved = resolveOptions(options);
   const zoned = calendarDateToTZDate(value, resolved.timezone);
-  return formatTZDate(zoned, getDatePattern(resolved.dateFormat), resolved);
+  return formatTZDate(
+    zoned,
+    getLocaleAwareDatePattern(resolved.dateFormat, resolved.tag),
+    resolved
+  );
 }
 function formatAppDate(value, options) {
   const resolved = resolveOptions(options);
   if (typeof value === "string" && isDateOnlyString(value)) {
     const [year, month, day] = value.split("-").map(Number);
     const zoned2 = new TZDate(year, month - 1, day, resolved.timezone);
-    return formatTZDate(zoned2, getDatePattern(resolved.dateFormat), resolved);
+    return formatTZDate(
+      zoned2,
+      getLocaleAwareDatePattern(resolved.dateFormat, resolved.tag),
+      resolved
+    );
   }
   const parsed = parseDateInput(value);
   if (!parsed) return EMPTY;
   const zoned = instantToTZDate(parsed, resolved.timezone);
-  return formatTZDate(zoned, getDatePattern(resolved.dateFormat), resolved);
+  return formatTZDate(
+    zoned,
+    getLocaleAwareDatePattern(resolved.dateFormat, resolved.tag),
+    resolved
+  );
 }
 function formatAppDateTime(value, options) {
   const parsed = parseDateInput(value);
@@ -52,7 +66,7 @@ function formatAppDateTime(value, options) {
   const zoned = instantToTZDate(parsed, resolved.timezone);
   return formatTZDate(
     zoned,
-    getDateTimePattern(resolved.timeFormat, resolved.dateFormat),
+    getDateTimePattern(resolved.timeFormat, resolved.dateFormat, resolved.tag),
     resolved
   );
 }

package/dist/lib/datetime/sync.d.ts

@@ -7,13 +7,17 @@ export type DatetimeContext = {
     timeFormat: AppTimeFormat;
     dateFormat: AppDateFormat;
 };
-/** Sync module-level datetime prefs from AppProvider (mirrors syncI18nLocale). */
+/**
+ * Sync the CURRENT scope's datetime prefs (mirrors `syncI18nLocale`). AppProvider calls it while
+ * rendering; inside `runWithAppSettings` it writes that request's state only.
+ */
 export declare function syncDatetimeContext(prefs: Pick<DatetimeContext, "locale" | "timezone" | "timeFormat" | "dateFormat"> & {
     dateFnsLocale?: Locale;
 }): void;
+/** The current scope's datetime prefs, with the neutral defaults for anything unset. */
 export declare function getDatetimeContext(): Readonly<DatetimeContext>;
 export declare function enableLiveRelativeFormatting(): void;
 export declare function disableLiveRelativeFormatting(): void;
 export declare function canUseLiveRelativeFormatting(): boolean;
-/** Vitest only — reset to defaults between cases. */
+/** Vitest only — reset the current scope to defaults between cases. */
 export declare function resetDatetimeContextForTests(): void;

package/dist/lib/datetime/sync.js

@@ -1,26 +1,22 @@
-import { getDateFnsLocale, isAppLocale } from "../../app/locales.js";
+import { getDateFnsLocale, normalizeAppLocale } from "../../app/locales.js";
 import { resolveDefaultDateFormat } from "../../app/date-format-labels.js";
+import { resolveDefaultTimeFormat } from "../../app/time-format-labels.js";
+import { getAppSettingsState } from "../../app/settings-scope.js";
 import { resolveHydrationSafeTimezone } from "../../app/timezones.js";
-const DEFAULT_LOCALE = "vi";
-function pageLocale() {
-  if (typeof document === "undefined") return DEFAULT_LOCALE;
-  const lang = (document.documentElement.lang || "").toLowerCase().split("-")[0];
-  return isAppLocale(lang) ? lang : DEFAULT_LOCALE;
-}
-const defaultContext = () => {
-  const locale = pageLocale();
+import { resolveDefaultLocale } from "../../i18n/locale-tags.js";
+function resolveContext(partial) {
+  const locale = partial?.locale ?? resolveDefaultLocale();
   return {
     locale,
-    dateFnsLocale: getDateFnsLocale(locale),
-    timezone: resolveHydrationSafeTimezone("browser"),
-    timeFormat: "24h",
-    dateFormat: resolveDefaultDateFormat(locale)
+    dateFnsLocale: partial?.dateFnsLocale ?? getDateFnsLocale(normalizeAppLocale(locale)),
+    timezone: partial?.timezone ?? resolveHydrationSafeTimezone("browser"),
+    timeFormat: partial?.timeFormat ?? resolveDefaultTimeFormat(locale),
+    dateFormat: partial?.dateFormat ?? resolveDefaultDateFormat(locale)
   };
-};
-let syncedContext = null;
+}
 let liveRelativeFormattingEnabled = true;
 function syncDatetimeContext(prefs) {
-  syncedContext = {
+  getAppSettingsState().datetime = {
     locale: prefs.locale,
     timezone: prefs.timezone,
     timeFormat: prefs.timeFormat,
@@ -29,7 +25,7 @@ function syncDatetimeContext(prefs) {
   };
 }
 function getDatetimeContext() {
-  return syncedContext ?? defaultContext();
+  return resolveContext(getAppSettingsState().datetime);
 }
 function enableLiveRelativeFormatting() {
   liveRelativeFormattingEnabled = true;
@@ -41,7 +37,7 @@ function canUseLiveRelativeFormatting() {
   return liveRelativeFormattingEnabled;
 }
 function resetDatetimeContextForTests() {
-  syncedContext = null;
+  getAppSettingsState().datetime = void 0;
   liveRelativeFormattingEnabled = true;
 }
 export {

package/dist/lib/platform.d.ts

@@ -18,7 +18,7 @@ export declare function isApplePlatform(): boolean;
  * crash.
  *
  * It lives here rather than beside its first caller because it had already been written twice
- * (`src/form/form-root.tsx`, `src/components/layout/legal-document-shell.tsx`) before a third
+ * (`src/form/form-root.tsx`, `src/lab/legal-document-shell.tsx`) before a third
  * caller needed it.
  */
 export declare function prefersReducedMotion(): boolean;

package/dist/props/components/app.prop.d.ts

@@ -2,9 +2,10 @@
 import type { Locale } from "date-fns";
 import type { DayPickerProps } from "react-day-picker";
 import type { AppLocale, AppRequestHeaders, AppTimeFormat, AppTimezone, AppTimezoneDefault, AppDateFormat } from "../../app/types.js";
+import type { AppPreset } from "../../app/preset.js";
 import type { AppBrand, AppDensity, AppFontSize, AppTheme } from "../../app/theme-axes.js";
 import type { AppPreferenceAxis } from "../../app/storage.js";
-import type { AppSettingPickerAppearanceProp, AppSettingToggleAppearanceProp, ChildrenProp, ClassNameProp, DisabledProp, IdProp, NameProp, OnValueChangeProp, ValueProp } from "../vocabulary/index.js";
+import type { AppSettingPickerAppearanceProp, AppSettingCycleAppearanceProp, ChildrenProp, ClassNameProp, DisabledProp, IdProp, NameProp, OnValueChangeProp, ValueProp } from "../vocabulary/index.js";
 /**
  * @see ThemeScope
  *
@@ -20,8 +21,16 @@ export type ThemeScopeProp = {
 /** @see AppProvider */
 export type AppProviderProp = {
     children: ChildrenProp;
-    /** Initial locale when nothing in storage. Default: `vi`. */
+    /**
+     * Initial locale when nothing is in storage. Default: `<html lang>` when it names a registered
+     * locale, then the preset's `defaultLocale`, then `en` (v32; was `vi`).
+     */
     defaultLocale?: AppLocale;
+    /**
+     * Product defaults the host opts into (`godxPreset` from `@godxjp/ui/themes/godx`). Fills only
+     * what the props leave unset; its `name` is written to `<html data-preset>`. Omit for neutral.
+     */
+    preset?: AppPreset;
     /** Fallback when a translation key is missing. Default: `en`. */
     fallbackLocale?: AppLocale;
     /** Initial timezone: IANA id, `browser`, or `system`. Default: `browser`. */
@@ -94,7 +103,9 @@ export type AppSettingKind = "locale" | "timezone" | "dateFormat" | "timeFormat"
  * Replaces the former Locale/Timezone/Date-format/Time-format pickers; pick the target
  * via `kind`. Bound to `<AppProvider>` by default; pass value + onValueChange to control.
  */
-export type AppSettingPickerProp = {
+export type AppSettingPickerMenuProp = {
+    /** `true` (default): open-then-choose from a menu. `false`: see {@link AppSettingPickerCycleProp}. */
+    menu?: true;
     kind: AppSettingKind;
     /**
      * Trigger presentation. `"labeled"` shows the leading icon + the selected value in a control
@@ -117,22 +128,24 @@ export type AppSettingPickerProp = {
     onValueChange?: OnValueChangeProp<string>;
 };
 /**
- * The {@link AppSettingToggle} subset of {@link AppSettingKind} — the settings whose value set is
+ * The `menu={false}` subset of {@link AppSettingKind} — the settings whose value set is
  * CLOSED and short enough to cycle by tapping. `locale`, `timezone`, `dateFormat` and `brand` are
  * deliberately absent: a 400-entry IANA list (or a palette a service extends) is a menu, not a
  * cycle, and tapping through it is not a control anyone can use.
  */
-export type AppSettingToggleKind = Extract<AppSettingKind, "theme" | "density" | "fontSize" | "timeFormat">;
+export type AppSettingCycleKind = Extract<AppSettingKind, "theme" | "density" | "fontSize" | "timeFormat">;
 /**
- * @see AppSettingToggle — one BUTTON that steps a single AppProvider setting to its next value and
- * shows that value as its glyph. The no-menu counterpart to {@link AppSettingPickerProp}: same
- * binding contract (context-bound by default, controlled via value + onValueChange), same option
- * order, one tap instead of open-then-choose.
+ * @see AppSettingPicker `menu={false}` — one BUTTON that steps a single AppProvider setting to its
+ * next value and shows that value as its glyph (the former `AppSettingToggle`, v32 #1223). Same
+ * binding contract as the menu (context-bound by default, controlled via value + onValueChange),
+ * same option order, one tap instead of open-then-choose.
  */
-export type AppSettingToggleProp = {
-    kind: AppSettingToggleKind;
-    /** Box the button takes. Default: `"bar"` — a toggle exists for a top bar. */
-    appearance?: AppSettingToggleAppearanceProp;
+export type AppSettingPickerCycleProp = {
+    /** `false`: no menu — each tap steps to the next value. */
+    menu: false;
+    kind: AppSettingCycleKind;
+    /** Box the button takes. Default: `"bar"` — a cycler exists for a top bar. */
+    appearance?: AppSettingCycleAppearanceProp;
     className?: ClassNameProp;
     disabled?: DisabledProp;
     id?: IdProp;
@@ -140,6 +153,8 @@ export type AppSettingToggleProp = {
     value?: ValueProp<string>;
     onValueChange?: OnValueChangeProp<string>;
 };
+/** @see AppSettingPicker — the menu (default) or, with `menu={false}`, the one-tap cycler. */
+export type AppSettingPickerProp = AppSettingPickerMenuProp | AppSettingPickerCycleProp;
 /** Value exposed by `useAppContext`. */
 export type AppContextValue = {
     locale: AppLocale;

package/dist/props/components/data-display.prop.d.ts

@@ -156,30 +156,6 @@ export type FeatureListProp = Omit<React.HTMLAttributes<HTMLUListElement>, "chil
     items: FeatureItemProp[];
     className?: ClassNameProp;
 };
-/**
- * Fixed BLOCK size of a `Thumbnail`; the inline size stays intrinsic.
- *
- * A subset of the shared `SizeProp` ladder — `xs` is off the bottom because a 48px frame with a
- * 1px hairline is a favicon, not a thumbnail, and nothing in the reported cases wanted one.
- */
-export type ThumbnailSizeProp = Extract<SizeProp, "sm" | "md" | "lg">;
-/**
- * @see Thumbnail — a framed image at a FIXED HEIGHT and its own intrinsic width, for a wrapping
- * row of pictures whose aspect ratios differ.
- */
-export type ThumbnailProp = Omit<React.ImgHTMLAttributes<HTMLImageElement>, "alt"> & {
-    /** Image URL. */
-    src: string;
-    /**
-     * Required, with no way to omit it. Pass `""` for a picture that carries no information the
-     * page does not already say — the empty string is a DECISION the author has to make, where a
-     * missing attribute is an omission nobody notices (WCAG 1.1.1).
-     */
-    alt: string;
-    /** Frame height. Default `md`. The width follows the picture's own ratio. */
-    size?: ThumbnailSizeProp;
-    className?: ClassNameProp;
-};
 /** @see EmptyState */
 /**
  * Semantic intent of the EmptyState icon medallion — a subset of the shared `ToneProp` vocabulary
@@ -1166,7 +1142,7 @@ export type MarqueeSpeedProp = "slow" | "base" | "fast";
  *
  * The clone count is MEASURED (content width against viewport width, re-measured on resize) —
  * the behaviour no CSS-only marquee can have — and the pause control is why this is a component
- * rather than a snippet. See `src/components/data-display/marquee.tsx` for the full argument and
+ * rather than a snippet. See `src/lab/marquee.tsx` for the full argument and
  * for what is deliberately not ported from `react-fast-marquee`.
  */
 export type MarqueeProp = Omit<React.HTMLAttributes<HTMLDivElement>, "onPlay" | "onPause" | "children"> & {
@@ -1330,7 +1306,7 @@ export type ImageProp = Omit<React.ImgHTMLAttributes<HTMLImageElement>, "alt" |
     /** Image URL. */
     src: string;
     /**
-     * Required, as on `Thumbnail`: `""` is a decision, a missing `alt` an omission (WCAG 1.1.1). It
+     * Required: `""` is a decision, a missing `alt` an omission (WCAG 1.1.1). It
      * also names the preview trigger ("Preview: {alt}").
      */
     alt: string;
@@ -1356,7 +1332,17 @@ export type ImageProp = Omit<React.ImgHTMLAttributes<HTMLImageElement>, "alt" |
      * `width`/`height`, which override the preset's side they name.
      */
     size?: ImageSizeProp;
-    /** How the picture fills a fixed frame (`object-fit`). Default `cover` once the height is fixed. */
+    /**
+     * How the picture fills a fixed frame. `cover` crops, `contain` letterboxes (both inside the
+     * 4:3 `size` frame or the `width`×`height` one). Default `cover` once the height is fixed.
+     *
+     * `intrinsic` keeps the picture's OWN ratio: the frame takes the `size` height and the picture's
+     * own width — nothing cropped, nothing letterboxed — drawn with the hairline thumbnail frame on a
+     * muted backdrop and clamped to its container. `width`/`height` then stay pure `<img>`
+     * attributes (the file's real pixels), so the browser reserves the final width before the
+     * bytes land. This is what the retired `Thumbnail` was (v32 #1223): a wrapping row of portrait
+     * and landscape shots at one height.
+     */
     fit?: ImageFitProp;
     /**
      * Text under the picture, held to the picture's width, so a long file name truncates instead of
@@ -1367,8 +1353,12 @@ export type ImageProp = Omit<React.ImgHTMLAttributes<HTMLImageElement>, "alt" |
 };
 /** `Image` thumbnail frame preset — the `Thumbnail` height scale. */
 export type ImageSizeProp = Extract<SizeProp, "sm" | "md" | "lg">;
-/** `Image` `fit` — the picture's `object-fit` inside a fixed frame. */
-export type ImageFitProp = "cover" | "contain";
+/**
+ * `Image` `fit` — `cover`/`contain` are the picture's `object-fit` inside a fixed frame;
+ * `intrinsic` sizes the frame to the picture's own ratio at the `size` height (the former
+ * `Thumbnail`).
+ */
+export type ImageFitProp = "cover" | "contain" | "intrinsic";
 /**
  * @see ImagePreviewGroup — pages the preview across a set of pictures (antd `Image.PreviewGroup`).
  *

package/dist/props/components/feedback.prop.d.ts

@@ -1,7 +1,7 @@
 /** Feedback component prop types — @see docs/COMPONENTS.md#feedback */
 import type * as React from "react";
 import type { QueryErrorCategory } from "../../lib/query-error.js";
-import type { AlertVariantProp, AvatarShapeProp, CalloutKindProp, CancelLabelProp, ChildrenProp, ClassNameProp, ConfirmLabelProp, ConfirmVariantProp, DefaultOpenProp, DescriptionProp, HandlerProp, IconProp, OpenProp, OnOpenChangeProp, PendingProp, ShapeProp, SizeProp, ToneProp, TitleProp, WidthProp } from "../vocabulary/index.js";
+import type { AlertVariantProp, AvatarShapeProp, CalloutKindProp, CancelLabelProp, ChildrenProp, ClassNameProp, ConfirmLabelProp, ConfirmVariantProp, DefaultOpenProp, DescriptionProp, HandlerProp, IconProp, OpenProp, OnOpenChangeProp, PendingProp, SizeProp, ToneProp, TitleProp, WidthProp } from "../vocabulary/index.js";
 /**
  * @see Dialog — the compound modal ROOT.
  *
@@ -91,7 +91,18 @@ export type AuthExpiryProviderProp = {
 };
 /** @see Alert */
 export type AlertProp = React.HTMLAttributes<HTMLDivElement> & {
+    /**
+     * `default` (inline status), `banner` (full-bleed page/shell strip; actions wrap below 640px) or
+     * `callout` (an aside INSIDE a document body: `role="note"`, never a live region). v32 #1223
+     * folded the former `Banner` and `Callout` components into these two values.
+     */
     variant?: AlertVariantProp;
+    /**
+     * `variant="callout"` only: the GitHub/Obsidian admonition preset — `note` (default), `tip`,
+     * `important`, `warning`, `caution`. Resolves `tone` + the leading glyph; pass `tone` or `icon`
+     * to override either per instance (gh#765).
+     */
+    kind?: CalloutKindProp;
     tone?: ToneProp;
     /** Pass `false` to hide the default variant icon. */
     icon?: IconProp | false;
@@ -99,23 +110,6 @@ export type AlertProp = React.HTMLAttributes<HTMLDivElement> & {
     className?: ClassNameProp;
     children?: ChildrenProp;
 };
-/**
- * @see Banner — the full-bleed attention strip (`<Alert variant="banner">` with the variant fixed).
- * Same contract as {@link AlertProp} minus `variant`: `tone` owns colour + live-region politeness,
- * `icon`/`icon={false}` owns the leading glyph, `onDismiss` renders the built-in dismiss button.
- */
-export type BannerProp = Omit<AlertProp, "variant">;
-/**
- * @see Callout — the in-prose aside (`<Alert variant="callout">` with the variant fixed).
- *
- * Same contract as {@link AlertProp} minus `variant` and `onDismiss`: a callout is part of the
- * document the reader is reading, so it is never a live region and never dismissible. `kind` is
- * the GitHub/Obsidian admonition preset and resolves `tone` + the leading glyph; pass `tone` or
- * `icon` to override either per instance (gh#765).
- */
-export type CalloutProp = Omit<AlertProp, "variant" | "onDismiss"> & {
-    kind?: CalloutKindProp;
-};
 /** @see AlertTitle */
 export type AlertTitleProp = React.HTMLAttributes<HTMLParagraphElement> & {
     className?: ClassNameProp;
@@ -194,23 +188,11 @@ export type SkeletonProp = React.HTMLAttributes<HTMLDivElement> & {
      */
     loading?: boolean;
 };
-/** @see SkeletonAvatar */
-export type SkeletonAvatarProp = {
+/** The leading avatar box of a {@link SkeletonArticleProp} (`avatar={{ size, shape }}`). */
+export type SkeletonArticleAvatarProp = {
     /** Box, from the `--control-height` tier — the same tier the real `Avatar` sizes from. */
     size?: SizeProp;
     shape?: AvatarShapeProp;
-    active?: boolean;
-    className?: ClassNameProp;
-};
-/** @see SkeletonButton */
-export type SkeletonButtonProp = {
-    size?: SizeProp;
-    /** Corner, in `Button`'s own vocabulary: `pill` is antd's `shape="round"`. */
-    shape?: ShapeProp;
-    /** Fill the inline axis, for a button that spans its column (antd's `block`). */
-    block?: boolean;
-    active?: boolean;
-    className?: ClassNameProp;
 };
 /** @see SkeletonInput */
 export type SkeletonInputProp = {
@@ -219,17 +201,6 @@ export type SkeletonInputProp = {
     active?: boolean;
     className?: ClassNameProp;
 };
-/** @see SkeletonNode — a square standing in for a media/custom slot; `children` centres in it. */
-export type SkeletonNodeProp = {
-    active?: boolean;
-    children?: ChildrenProp;
-    className?: ClassNameProp;
-};
-/** @see SkeletonImage */
-export type SkeletonImageProp = {
-    active?: boolean;
-    className?: ClassNameProp;
-};
 /**
  * @see SkeletonArticle — antd's own `<Skeleton>` shape (avatar + title + paragraph). It is a
  * SIBLING of `Skeleton`, not a replacement: `Skeleton` here is the block antd spells
@@ -237,7 +208,7 @@ export type SkeletonImageProp = {
  * renders.
  */
 export type SkeletonArticleProp = {
-    avatar?: boolean | Pick<SkeletonAvatarProp, "size" | "shape">;
+    avatar?: boolean | SkeletonArticleAvatarProp;
     /** The heading line. NOT a string title — `false` drops the line, `{ width }` re-measures it. */
     title?: boolean | {
         width?: SkeletonWidth;

package/dist/props/components/general.prop.d.ts

@@ -1,6 +1,6 @@
 /** Foundation component prop types — @see docs/COMPONENTS.md#foundation */
 import type * as React from "react";
-import type { ActivityAnnounceProp, ActivityVariantProp, AsChildProp, ButtonSizeProp, ButtonVariantProp, ChildrenProp, ClassNameProp, DescriptionProp, DisabledProp, FontWeightProp, HeadingLevelProp, IconSizeProp, IdProp, InViewAmountProp, LabelProp, OnClickProp, OnOpenChangeProp, OpenProp, PendingProp, RevealDelayProp, RevealTriggerProp, ShapeProp, SizeProp, TextAlignProp, TextSizeProp, TextToneProp, TextWhitespaceProp, TextBreakProp, TitleLevelProp, TypographyActionsConfigProp, TypographyCopyConfigProp, TypographyEditConfigProp, TypographyEllipsisConfigProp, TypographyTypeProp } from "../vocabulary/index.js";
+import type { ActivityAnnounceProp, ActivityVariantProp, AsChildProp, ButtonSizeProp, ButtonVariantProp, ChildrenProp, ClassNameProp, DescriptionProp, DisabledProp, FontWeightProp, HeadingLevelProp, IconSizeProp, IdProp, InViewAmountProp, LabelProp, OnClickProp, OnOpenChangeProp, OpenProp, PendingProp, RevealDelayProp, RevealTriggerProp, ShapeProp, SizeProp, TextAlignProp, TextSizeProp, TextToneProp, TextWhitespaceProp, TextBreakProp, TypographyActionsConfigProp, TypographyCopyConfigProp, TypographyEditConfigProp, TypographyEllipsisConfigProp, TypographyTypeProp } from "../vocabulary/index.js";
 /**
  * @see Text — typographic primitive; replaces hand-rolled `<span className="text-[13px] …">`.
  *
@@ -127,24 +127,7 @@ export type HeadingProp = Omit<React.HTMLAttributes<HTMLHeadingElement>, "color"
     weight?: FontWeightProp;
 };
 /**
- * @see Typography — antd's plain `<article>` wrapper for a run of prose (`TypographyProps`).
- *
- * It carries no emphasis of its own; it is the container `Title` / `Paragraph` / `Text` / `Link`
- * sit inside, and the thing `Typography.Text` etc. hang off as a compound component.
- */
-export type TypographyProp = Omit<React.HTMLAttributes<HTMLElement>, "color"> & {
-    /** Rendered element. Default `article`, matching antd. */
-    as?: string;
-    /**
-     * antd's (private) `component` — the rendered element.
-     *
-     * `as` is the spelling this library documents, and `as` WINS when both are passed. `component`
-     * exists so antd code pastes in unchanged.
-     */
-    component?: string;
-};
-/**
- * The antd `BlockProps` behaviour shared by `Text` / `Title` / `Paragraph` / `Link`.
+ * The antd `BlockProps` behaviour shared by `Text` / `Link`.
  *
  * The seven decoration flags each WRAP the content in a real element, in antd's own nesting order
  * (strong → u → del → code → mark → kbd → i), so the meaning reaches a screen reader instead of
@@ -189,51 +172,6 @@ export type TypographyBlockProp = {
     /** antd's (private) `component` alias for `as`; `as` wins when both are passed. */
     component?: string;
 };
-/**
- * @see Title — antd `Typography.Title`.
- *
- * A SIBLING of `Heading`, not a replacement: `Heading` is this library's own four-level heading and
- * stays exactly as it was. `Title` is antd's, so it reaches level 5 and carries the block
- * behaviours (`copyable`, `editable`, `ellipsis`, the decorations).
- *
- * antd omits `strong` from `TitleProps` because a heading is already `fontWeightStrong`; that
- * omission is ported.
- *
- * NAMED `TypographyTitleProp`, not `TitleProp`, for one measured reason: `TitleProp` is already a
- * VOCABULARY type (`vocabulary/content.prop.ts` — the ReactNode heading slot a Card / Dialog /
- * PageContainer takes), and `src/props/index.ts` re-exports `./vocabulary` and `./components`
- * through the same `export *`. A second `TitleProp` there is an ambiguous re-export, which TS
- * resolves by dropping BOTH. The component and its public `TitleProps` alias are still spelled
- * antd's way; only the internal type name moves.
- */
-export type TypographyTitleProp = Omit<React.HTMLAttributes<HTMLHeadingElement>, "color"> & Omit<TypographyBlockProp, "strong"> & {
-    /** Heading level 1…5 — sets the `--heading-h*` size token AND the `<h1>`…`<h5>` element. */
-    level?: TitleLevelProp;
-    /** Override the rendered element (a visual h2 that is a real `<h1>`). */
-    as?: "h1" | "h2" | "h3" | "h4" | "h5" | "div";
-    /** Semantic colour intent. Outranks antd's `type`. */
-    tone?: TextToneProp;
-    align?: TextAlignProp;
-    /** This library's single-line ellipsis. `ellipsis` outranks it when both are passed. */
-    truncate?: boolean;
-    /** Weight (system canon: 400 · 500 · 700). Default `medium`. */
-    weight?: FontWeightProp;
-    /** Truncation — `true` is one line; the object form is antd's full `EllipsisConfig`. */
-    ellipsis?: boolean | TypographyEllipsisConfigProp;
-};
-/**
- * @see Paragraph — antd `Typography.Paragraph`.
- *
- * antd renders it as a `<div>`, not a `<p>`, because the editing textarea and the action cluster
- * are block content that a `<p>` may not legally contain. That is ported verbatim; pass
- * `as="p"` when the content is known to be phrasing-only.
- */
-export type ParagraphProp = Omit<TextProp, "ellipsis" | "as"> & {
-    /** Rendered element. Default `div` — antd's choice; see above. */
-    as?: "div" | "p" | "span";
-    /** Truncation — `true` is one line; the object form is antd's full `EllipsisConfig`. */
-    ellipsis?: boolean | TypographyEllipsisConfigProp;
-};
 /**
  * @see Link — antd `Typography.Link`.
  *

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

@@ -6,5 +6,13 @@ export type { ChartDatum, ChartSeriesProp, LineChartProp, BarChartProp, AreaChar
 export type { AlertQueryErrorProp, AuthExpiryProviderProp, AlertProp, DialogProp, DialogContentProp, AlertTitleProp, AlertContentProp, AlertDescriptionProp, AlertActionsProp, SheetResponsiveProp, SkeletonRowsProp, } from "./feedback.prop.js";
 export type { DataStateProp, InfiniteQueryStateProp, InfiniteQueryHelpers, PrefetchLinkProp, } from "./query.prop.js";
 export type { DropdownMenuPlacementProp, DropdownMenuTriggerActionProp, PaginationProp, PaginationSizeProp, PaginationAlignProp, StepsProp, StepItemProp, StepStatusProp, StepsTypeProp, TabsProp, TabItemProp, TabsVariantProp, TabsPlacementProp, TabsExtraProp, TabsOnEditProp, } from "./navigation.prop.js";
-export type { AppProviderProp, AppContextValue, AppSettingKind, AppSettingPickerProp, AppSettingToggleKind, AppSettingToggleProp, ThemeScopeProp, } from "./app.prop.js";
+export type { AppProviderProp, AppContextValue, AppSettingKind, AppSettingPickerProp, AppSettingPickerMenuProp, AppSettingPickerCycleProp, AppSettingCycleKind, ThemeScopeProp, } from "./app.prop.js";
 export type { ZodSchemaProp, UseZodFormOptionsProp, UseZodFormReturnProp, FormRootProp, FormFieldControlProp, FieldErrorMessageProp, } from "./form.prop.js";
+export type { ChatBubbleListProp, ChatBubbleProp, ChatBubbleToneProp, ChatBubbleTypingProp, ThoughtChainItemProp, ThoughtChainProp, ThoughtChainStatusProp, WelcomeProp, } from "./data-display.prop.js";
+export type { AttachmentsItemProp, AttachmentsPlaceholderProp, AttachmentsProp, AttachmentsRefProp, ChatComposerProp, ChatSuggestionItemProp, ChatSuggestionProp, } from "./data-entry.prop.js";
+export type { ActionsCopyProp, ActionsFeedbackProp, ActionsItemProp, ActionsItemsProp, ActionsProp as ActionsBarProp, } from "./general.prop.js";
+export type { ConversationsCreationProp, ConversationsEntryProp, ConversationsGroupableProp, ConversationsItemProp, ConversationsMenuProp, ConversationsProp, } from "./navigation.prop.js";
+export type { ChatBubblePlacementProp, ChatBubbleVariantProp, ChatMessageProp, ThoughtChainItemsProp, ThoughtChainLineProp, ThoughtChainVariantProp, WelcomeVariantProp, } from "./data-display.prop.js";
+export type { AttachmentsOverflowProp, ChatComposerActionComponents, ChatComposerFooterProp, ChatComposerSubmitTypeProp, ChatSuggestionRenderProp, } from "./data-entry.prop.js";
+export type { ActionsFeedbackValueProp, ActionsStatusProp, ActionsVariantProp, } from "./general.prop.js";
+export type { ConversationsDividerProp, ConversationsMenuItemProp } from "./navigation.prop.js";