@godxjp/ui 20.0.0 → 20.2.0

package/dist/lib/datetime/picker-format.js

@@ -0,0 +1,54 @@
+import {
+  format as formatDate,
+  isValid,
+  parse,
+  startOfDay,
+  startOfWeek,
+  startOfMonth,
+  startOfQuarter,
+  startOfYear
+} from "date-fns";
+import { parseDateInput, toIsoDate } from "./parse.js";
+function formatPickerDate(date, format, locale, withTime = false) {
+  if (!date || !isValid(date)) return "";
+  if (typeof format === "function") return format(date);
+  if (typeof format === "object") return new Intl.DateTimeFormat(locale, format).format(date);
+  if (typeof format === "string") return formatDate(date, format);
+  return withTime ? formatDate(date, "yyyy-MM-dd HH:mm") : toIsoDate(date);
+}
+function parsePickerDate(text, format, parser, withTime = false) {
+  const raw = text.trim();
+  if (!raw) return void 0;
+  const custom = parser?.(raw);
+  if (custom && isValid(custom)) return custom;
+  const pattern = typeof format === "string" ? format : withTime ? "yyyy-MM-dd HH:mm" : void 0;
+  if (pattern) {
+    const parsed = parse(raw, pattern, new Date(2e3, 0, 1));
+    if (isValid(parsed) && formatDate(parsed, pattern) === raw) return parsed;
+  }
+  if (withTime || !/^\d{4}-\d{2}-\d{2}$/.test(raw)) return void 0;
+  return parseDateInput(raw) ?? void 0;
+}
+function pickerDateAllowed(date, min, max, disabled) {
+  return isValid(date) && (!min || startOfDay(date) >= startOfDay(min)) && (!max || startOfDay(date) <= startOfDay(max)) && !disabled?.(date);
+}
+function pickerPeriodStart(date, picker, locale) {
+  switch (picker) {
+    case "week":
+      return startOfWeek(date, { locale });
+    case "month":
+      return startOfMonth(date);
+    case "quarter":
+      return startOfQuarter(date);
+    case "year":
+      return startOfYear(date);
+    default:
+      return date;
+  }
+}
+export {
+  formatPickerDate,
+  parsePickerDate,
+  pickerDateAllowed,
+  pickerPeriodStart
+};

package/dist/lib/overlay-portal.d.ts

@@ -0,0 +1,18 @@
+import * as React from "react";
+export interface OverlayPortalProviderProps {
+    /**
+     * The element overlays are rendered into. Pass the shadow root, or any element inside it.
+     * `undefined` restores the default, so a subtree can opt back out.
+     */
+    container: Element | undefined;
+    children: React.ReactNode;
+}
+export declare function OverlayPortalProvider({ container, children }: OverlayPortalProviderProps): React.JSX.Element;
+/**
+ * The container this overlay should render into. An explicit prop wins, so one panel can be placed
+ * elsewhere without unmounting the provider around it.
+ *
+ * Not exported from the public barrel: this is a contract between the provider and the overlays
+ * this library ships, not a knob for consumers — a consumer that needs the value has a provider.
+ */
+export declare function useOverlayPortalContainer(override?: Element): Element | undefined;

package/dist/lib/overlay-portal.js

@@ -0,0 +1,17 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import * as React from "react";
+import { enableShadowDOM } from "react-stately/private/flags/flags";
+const OverlayPortalContext = React.createContext(void 0);
+enableShadowDOM();
+function OverlayPortalProvider({ container, children }) {
+  return /* @__PURE__ */ jsx(OverlayPortalContext.Provider, { value: container, children });
+}
+function useOverlayPortalContainer(override) {
+  const fromContext = React.useContext(OverlayPortalContext);
+  return override ?? fromContext;
+}
+export {
+  OverlayPortalProvider,
+  useOverlayPortalContainer
+};

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

@@ -3,6 +3,7 @@ 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 { 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";
 /** @see AppProvider */
 export type AppProviderProp = {
@@ -26,8 +27,18 @@ export type AppProviderProp = {
     timezoneOptions?: readonly AppTimezone[];
     /** localStorage key. Default: `godxjp.app`. */
     storageKey?: string;
-    /** Persist user choices. Default: true. */
-    persist?: boolean;
+    /**
+     * Which viewer preferences survive a reload. `true` (default) every axis, `false` none, or a
+     * LIST of axes — `["theme", "density", "fontSize"]`.
+     *
+     * The list exists because the axes do not share an owner. `theme` / `brand` / `density` /
+     * `fontSize` / `scaling` are the VIEWER's and belong in this browser. `locale` / `timezone` /
+     * `timeFormat` / `dateFormat` are frequently the SERVER's, resolved per request from a cookie,
+     * an account row or a header — and a stored copy then WINS over the value the server just sent,
+     * because storage is read after the props. Faced with one all-or-nothing flag, that consumer
+     * sets `persist={false}` and loses the viewer's theme along with it; naming the axes keeps both.
+     */
+    persist?: boolean | readonly AppPreferenceAxis[];
     /**
      * Initial theme choice. `"light"` / `"dark"` are written straight to `<html data-theme>`;
      * `"system"` defers to `prefers-color-scheme` and is re-resolved whenever the OS changes.

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

@@ -22,6 +22,13 @@ type ChartCartesianBase = {
     categoryKey: string;
     /** Accessible name + visible caption for the chart. REQUIRED (role="img" needs a name). */
     label: LabelProp;
+    /**
+     * Paint `label` as a visible caption above the plot. Set `false` when the chart already sits
+     * under a heading that says the same thing (a `CardTitle`, a section `<h2>`): the caption stays
+     * in the DOM as `sr-only`, so `role="img"` keeps its accessible name and only the duplicated
+     * visible title goes away.
+     */
+    showCaption?: boolean;
     /** Extra context appended to the screen-reader description. */
     description?: DescriptionProp;
     /** Canvas height preset — `xs|sm|md|lg`. Ignored when `height` is set. */
@@ -67,6 +74,13 @@ export type CompactBarTrendProp = {
     valueKey: string;
     /** Accessible name + visible caption for the chart. REQUIRED (role="img" needs a name). */
     label: LabelProp;
+    /**
+     * Paint `label` as a visible caption above the plot. Set `false` when the chart already sits
+     * under a heading that says the same thing (a `CardTitle`, a section `<h2>`): the caption stays
+     * in the DOM as `sr-only`, so `role="img"` keeps its accessible name and only the duplicated
+     * visible title goes away.
+     */
+    showCaption?: boolean;
     /** Extra context appended to the screen-reader description. */
     description?: DescriptionProp;
     /** Plot-height tier — `xs|sm|md|lg`. Defaults to `xs` (dashboard summary-card density). */
@@ -107,6 +121,13 @@ export type PieChartProp = {
     colors?: string[];
     /** Accessible name + visible caption for the chart. REQUIRED. */
     label: LabelProp;
+    /**
+     * Paint `label` as a visible caption above the plot. Set `false` when the chart already sits
+     * under a heading that says the same thing (a `CardTitle`, a section `<h2>`): the caption stays
+     * in the DOM as `sr-only`, so `role="img"` keeps its accessible name and only the duplicated
+     * visible title goes away.
+     */
+    showCaption?: boolean;
     /** Extra context appended to the screen-reader description. */
     description?: DescriptionProp;
     /** Canvas height preset — `xs|sm|md|lg`. Ignored when `height` is set. */

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

@@ -7,7 +7,9 @@ export type CodeBlockProp = {
     /** Soft-wrap long lines (default true). `false` scrolls horizontally instead. */
     wrap?: boolean;
     /** Scroll inside the block past this height. Default `none` (grows with the content). */
-    maxHeight?: "sm" | "md" | "lg" | "none";
+    maxHeight?: "sm" | "md" | "lg" | "none" | {
+        value: string;
+    };
     /** Type size. Default `sm`. */
     size?: Extract<SizeProp, "xs" | "sm">;
     /** Cosmetic: lands on `data-language`; no highlighter is bundled. */
@@ -26,7 +28,7 @@ export type ProseProp = {
     className?: ClassNameProp;
     children?: ChildrenProp;
 };
-import type { ActionProp, ClassNameProp, DescriptionProp, IconProp, TitleProp, ColumnDefProp, GetRowIdProp, OnRowClickProp, OnSelectChangeProp, OnSortChangeProp, OnTableDensityChangeProp, SelectedIdsProp, SortStateProp, TableDensityProp, TablePresetProp, BreakpointProp, DensityProp, ChildrenProp, ToneProp, AvatarShapeProp, HeadingLevelProp, HandlerProp, SizeProp, LabelProp, IdProp, DescriptionsLayoutProp } from "../vocabulary/index.js";
+import type { ActionProp, ClassNameProp, DescriptionProp, IconProp, TitleProp, ColumnDefProp, GetRowIdProp, OnRowClickProp, OnSelectChangeProp, OnSortChangeProp, OnTableDensityChangeProp, SelectedIdsProp, SortStateProp, TableDensityProp, TablePresetProp, BreakpointProp, DensityProp, ChildrenProp, ToneProp, AvatarShapeProp, HeadingLevelProp, HandlerProp, SizeProp, LabelProp, IdProp, DescriptionsLayoutProp, DescriptionsColumnProp, DescriptionsSpanProp, DescriptionsItemsProp, SortDirectionProp, OnColumnFilterChangeProp, OnRowProp, TableExpandableProp, TableRowSelectionProp, TableScrollProp, TableStickyProp, TableSummaryProp } from "../vocabulary/index.js";
 /**
  * One key in a `Legend`: a tone, and the words that tone stands for.
  *
@@ -77,18 +79,28 @@ export type EmptyStateProp = {
  */
 export type DescriptionsProp = {
     /** `Descriptions.Item` children — one label/value pair each. */
-    children: React.ReactNode;
-    columns?: 1 | 2 | 3;
+    children?: React.ReactNode;
+    /**
+     * Column count. `1 | 2 | 3` keeps this library's own mobile-first ladder; any other number, or
+     * antd's responsive `{ sm, md, lg, xl }` object, drives the token-published grid instead.
+     */
+    columns?: DescriptionsColumnProp;
     /** Label placement within each item. Default `vertical` (label over value). */
     layout?: DescriptionsLayoutProp;
     /** Label text alignment inside the label column. Applies only to `layout="horizontal"`. */
     labelAlign?: "start" | "end";
+    /** Draw the grid as a bordered table with shaded label cells (antd `bordered`). */
+    bordered?: boolean;
+    /** Declarative items (antd `items`) — the alternative to composing `Descriptions.Item`. */
+    items?: DescriptionsItemsProp;
     className?: ClassNameProp;
 };
 export type DescriptionsItemProp = {
     label: React.ReactNode;
     value: React.ReactNode;
     mono?: boolean;
+    /** Columns this item occupies — number | `"filled"` | responsive object (antd `span`). */
+    span?: DescriptionsSpanProp;
 };
 /**
  * @see Avatar
@@ -264,6 +276,26 @@ export type DataTableProp<T> = {
      * measures. Default `"sm"`.
      */
     collapseBelow?: BreakpointProp;
+    /** Full row-selection configuration (antd `rowSelection`). */
+    rowSelection?: TableRowSelectionProp<T>;
+    /** Expandable detail rows (antd `expandable`). */
+    expandable?: TableExpandableProp<T>;
+    /** Footer totals row, rendered in a real `<tfoot>` (antd `summary`). */
+    summary?: TableSummaryProp<T>;
+    /** Scroll envelope — `x` a minimum inline size, `y` a maximum body block size (antd `scroll`). */
+    scroll?: TableScrollProp;
+    /** Sticky header; the object form carries `offsetHeader` (antd `sticky`). */
+    sticky?: TableStickyProp;
+    /** Per-row DOM props merged onto the `<tr>` (antd `onRow`). */
+    onRow?: OnRowProp<T>;
+    /** Outer frame + vertical rules between columns (antd `bordered`). */
+    bordered?: boolean;
+    /** Explain the next sort step in a tooltip on sortable headers (antd `showSorterTooltip`). */
+    showSorterTooltip?: boolean;
+    /** Table-wide sort cycle; a column's own `sortDirections` wins (antd `sortDirections`). */
+    sortDirections?: SortDirectionProp[];
+    /** Column filters changed — pair with a column's `filteredValue` for server filtering. */
+    onFilterChange?: OnColumnFilterChangeProp;
     className?: ClassNameProp;
     children?: ChildrenProp;
 };
@@ -362,7 +394,26 @@ export type PermissionMatrixProp = {
  */
 export type ScrollAreaAnchorProp = "none" | "bottom";
 /** @see ScrollArea */
+/**
+ * @see ScrollArea — which AXES scroll. This is not decoration: Radix sets the viewport's
+ * `overflowX`/`overflowY` inline from which scrollbars are mounted, so an axis with no `ScrollBar`
+ * is `overflow: hidden` and its content is CLIPPED, not merely un-barred.
+ *
+ * `both` is a third value rather than an array or a pair of booleans because the axes are one
+ * decision — a pane scrolls down, across, or freely — and a closed union is what `check:prop-vocabulary`
+ * and the MCP catalog can carry.
+ */
+export type ScrollAreaOrientationProp = "vertical" | "horizontal" | "both";
 export type ScrollAreaProp = {
+    /**
+     * Axes that scroll, and therefore which scrollbars render. Default `vertical` — the previous
+     * behaviour, unchanged.
+     *
+     * Reach for `horizontal` for a strip of non-shrinking columns (a board, a lane of cards): the
+     * viewport keeps its tab stop, so the strip is scrollable from the keyboard, and the consumer
+     * writes no overflow styling of its own.
+     */
+    orientation?: ScrollAreaOrientationProp;
     /**
      * Ref to the element that actually SCROLLS — the Radix viewport — not the root. The root is
      * `overflow: hidden` and never scrolls, so the component's own `ref` cannot serve.