@tailor-platform/app-shell 1.15.0 → 1.16.0

package/dist/app-shell.d.ts

@@ -1088,14 +1088,15 @@ export declare type BuildQueryVariables<TTable extends TableMetadata> = {
  * <Button variant="destructive">Delete</Button>
  * ```
  */
-export declare function Button({ className, variant, size, render, children, ...props }: ButtonProps): React_2.ReactElement<unknown, string | React_2.JSXElementConstructor<any>>;
+export declare function Button({ className, variant, size, render, children, ref: forwardedRef, ...props }: ButtonProps): React_2.ReactElement<unknown, string | React_2.JSXElementConstructor<any>>;
 
 export declare type ButtonProps = React_2.ComponentProps<"button"> & VariantProps<typeof buttonVariants> & {
+    /** Custom element to render as (Base UI render prop) */
     render?: React_2.ReactElement;
 };
 
 export declare const buttonVariants: (props?: ({
-    variant?: "default" | "destructive" | "outline" | "secondary" | "ghost" | "link" | null | undefined;
+    variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
     size?: "default" | "xs" | "sm" | "lg" | "icon" | null | undefined;
 } & ClassProp) | undefined) => string;
 
@@ -1897,7 +1898,7 @@ declare namespace ComboboxGroupLabel {
     var displayName: string;
 }
 
-declare function ComboboxInput({ className, ...props }: React_2.ComponentProps<typeof Combobox_2.Input>): JSX.Element;
+declare function ComboboxInput({ className, ref: forwardedRef, ...props }: React_2.ComponentProps<typeof Combobox_2.Input>): JSX.Element;
 
 declare namespace ComboboxInput {
     var displayName: string;
@@ -2547,6 +2548,8 @@ export declare const DataTable: {
      * `useCollectionVariables()`, otherwise this component throws at render time.
      */
     readonly Filters: typeof DataTableFilters;
+    /** Built-in column visibility, ordering, and pinning controls. */
+    readonly ColumnSettings: typeof DataTableColumnSettings;
     /**
      * Renders `<table>` with built-in `Headers` and `Body`.
      * Place inside `DataTable.Root`.
@@ -2572,6 +2575,22 @@ export declare const DataTable: {
 
 declare type DataTableBooleanFilterOperator = OperatorForFilterType["boolean"];
 
+/**
+ * A "Columns" toolbar popover with three drop zones — **Fixed left**,
+ * **Scrollable**, and **Fixed right**. Drag a column into a zone to pin it to
+ * that edge (or unpin it), and drag within a zone to reorder. Each row has a
+ * visibility checkbox. State persists when `useDataTable` has a `tableId`.
+ *
+ * Place inside any toolbar or other action layout within `DataTable.Root`.
+ */
+declare function DataTableColumnSettings({ className }: {
+    className?: string;
+}): JSX.Element;
+
+declare namespace DataTableColumnSettings {
+    var displayName: string;
+}
+
 /**
  * Context value provided by `DataTable.Root`.
  *
@@ -4232,6 +4251,13 @@ declare namespace Group {
     var displayName: string;
 }
 
+/** A related group of controls within a toolbar row. */
+declare function Group_2({ className, ...props }: ToolbarGroupProps): JSX.Element;
+
+declare namespace Group_2 {
+    var displayName: string;
+}
+
 /** An accessible label that is automatically associated with its parent group. */
 declare function GroupLabel({ className, ...props }: React_2.ComponentProps<typeof Menu_2.GroupLabel>): JSX.Element;
 
@@ -4439,7 +4465,7 @@ declare type InferredFieldFilterType<TTable extends TableMetadata, TFieldName ex
  * <Input type="email" disabled />
  * ```
  */
-export declare function Input({ className, type, ...props }: InputProps): JSX.Element;
+export declare function Input({ className, type, ref: forwardedRef, ...props }: InputProps): JSX.Element;
 
 export declare type InputProps = React_2.ComponentProps<"input">;
 
@@ -4670,6 +4696,11 @@ declare type LocalizedString = string | ((locale: string) => string);
 
 export { Location_2 as Location }
 
+declare type Login = {
+    (): ReturnType<AuthClient["login"]>;
+    (options: NonNullable<Parameters<AuthClient["login"]>[0]>): ReturnType<AuthClient["login"]>;
+};
+
 /** Shape returned by `mapItem` to describe how an item appears in the dropdown. */
 export declare interface MappedItem {
     /** Display text — used for filtering, a11y, and fallback display. */
@@ -5324,6 +5355,13 @@ declare namespace Root_12 {
     var displayName: string;
 }
 
+/** A full-width visual container for one or more rows of related controls. */
+declare function Root_13({ className, ...props }: ToolbarProps): JSX.Element;
+
+declare namespace Root_13 {
+    var displayName: string;
+}
+
 /**
  * Provides the shared time range used by all timeline primitives.
  *
@@ -5338,9 +5376,9 @@ declare namespace Root_12 {
  * </Timeline.Root>
  * ```
  */
-declare function Root_13({ start, end, children, className, style }: TimelineRootProps): JSX.Element;
+declare function Root_14({ start, end, children, className, style }: TimelineRootProps): JSX.Element;
 
-declare namespace Root_13 {
+declare namespace Root_14 {
     var displayName: string;
 }
 
@@ -5510,8 +5548,11 @@ declare type RootConfiguration = {
 };
 
 declare type RootProps = React_2.ComponentProps<"div"> & VariantProps<typeof alertVariants> & {
+    /** Action element rendered below the description */
     action?: React_2.ReactNode;
+    /** Shows a dismiss button; hides the alert when clicked */
     dismissible?: boolean;
+    /** Callback invoked when the dismiss button is clicked */
     onDismiss?: () => void;
 };
 
@@ -5550,6 +5591,13 @@ declare namespace Row {
     var displayName: string;
 }
 
+/** One independently navigable horizontal row of toolbar controls. */
+declare function Row_2({ className, justify, onKeyDown, ref: forwardedRef, ...props }: ToolbarRowProps): JSX.Element;
+
+declare namespace Row_2 {
+    var displayName: string;
+}
+
 /**
  * A single body row.
  *
@@ -5563,9 +5611,9 @@ declare namespace Row {
  * </Timeline.Row>
  * ```
  */
-declare function Row_2({ children, className, style, height, background }: TimelineRowProps): JSX.Element;
+declare function Row_3({ children, className, style, height, background }: TimelineRowProps): JSX.Element;
 
-declare namespace Row_2 {
+declare namespace Row_3 {
     var displayName: string;
 }
 
@@ -5894,7 +5942,7 @@ declare type SelectStandaloneProps<I> = ({
     items: I[];
 } & SelectPropsMultiple<ExtractItem<I>>);
 
-declare function SelectTrigger({ className, children, ...props }: React_2.ComponentProps<typeof Select_2.Trigger>): JSX.Element;
+declare function SelectTrigger({ className, children, ref: forwardedRef, ...props }: React_2.ComponentProps<typeof Select_2.Trigger>): JSX.Element;
 
 declare namespace SelectTrigger {
     var displayName: string;
@@ -5906,6 +5954,13 @@ declare namespace SelectValue {
     var displayName: string;
 }
 
+/** A vertical separator for groups within a horizontal toolbar row. */
+declare function Separator({ className, ...props }: ToolbarSeparatorProps): JSX.Element;
+
+declare namespace Separator {
+    var displayName: string;
+}
+
 /**
  * Shared props between `AppShellProps` and the internal `WithPages` wrapper.
  *
@@ -6212,10 +6267,10 @@ export declare type SidebarItemProps = {
      */
     to: string;
     /**
-     * Override title.
+     * Override title (i18n supported).
      * When omitted, title is auto-resolved from resource meta.
      */
-    title?: string;
+    title?: LocalizedString;
     /**
      * Override icon.
      * When omitted, icon is auto-resolved from resource meta.
@@ -6579,7 +6634,7 @@ declare function Suggestions({ className, children, ...props }: SuggestionsProps
 declare type SuggestionsProps = React_2.ComponentProps<"div">;
 
 /** An individual interactive tab button that toggles the corresponding panel. */
-declare function Tab({ className, children, ...props }: React_2.ComponentProps<typeof Tabs_2.Tab>): JSX.Element;
+declare function Tab({ className, children, ref: forwardedRef, ...props }: React_2.ComponentProps<typeof Tabs_2.Tab>): JSX.Element;
 
 declare namespace Tab {
     var displayName: string;
@@ -6738,9 +6793,9 @@ export { Time }
  * ```
  */
 export declare const Timeline: {
-    Root: typeof Root_13;
+    Root: typeof Root_14;
     Viewport: typeof Viewport;
-    Row: typeof Row_2;
+    Row: typeof Row_3;
     Interval: typeof Interval;
     Link: typeof TimelineLink;
 };
@@ -7123,6 +7178,25 @@ export { To }
  */
 declare function Tool({ className, children, ...props }: ToolProps): JSX.Element;
 
+export declare const Toolbar: {
+    Root: typeof Root_13;
+    Row: typeof Row_2;
+    Group: typeof Group_2;
+    Separator: typeof Separator;
+};
+
+declare type ToolbarGroupProps = React_2.ComponentProps<"div">;
+
+export declare type ToolbarProps = React_2.ComponentProps<"div">;
+
+declare type ToolbarRowProps = Omit<React_2.ComponentProps<"div">, "role" | "onKeyDown"> & {
+    /** Distribute the row's outer groups between its two edges. */
+    justify?: "start" | "between";
+    onKeyDown?: React_2.KeyboardEventHandler<HTMLDivElement>;
+};
+
+declare type ToolbarSeparatorProps = Omit<React_2.ComponentProps<"div">, "role" | "aria-orientation">;
+
 declare function ToolContent({ className, ...props }: ToolContentProps): JSX.Element;
 
 declare type ToolContentProps = ComponentProps<typeof DisclosurePanel>;
@@ -7566,7 +7640,7 @@ declare type UseAttachmentReturn = {
  *   const { isAuthenticated, isReady, login, logout } = useAuth();
  *
  *   if (!isReady) return <Loading />;
- *   if (!isAuthenticated) return <button onClick={login}>Log In</button>;
+ *   if (!isAuthenticated) return <button onClick={() => void login()}>Log In</button>;
  *
  *   return <button onClick={logout}>Log Out</button>;
  * }
@@ -7576,7 +7650,7 @@ export declare const useAuth: () => {
     error: string | null;
     isAuthenticated: boolean;
     isReady: boolean;
-    login: () => Promise<void>;
+    login: Login;
     logout: () => Promise<void>;
     checkAuthStatus: () => Promise<AuthState>;
 };
@@ -7620,7 +7694,7 @@ export declare const useAuth: () => {
  *   // isReady is guaranteed to be true here (Suspense handles loading)
  *
  *   if (!isAuthenticated) {
- *     return <button onClick={login}>Log In</button>;
+ *     return <button onClick={() => void login()}>Log In</button>;
  *   }
  *
  *   return (
@@ -7635,7 +7709,7 @@ export declare const useAuth: () => {
 export declare const useAuthSuspense: () => {
     error: string | null;
     isAuthenticated: boolean;
-    login: () => Promise<void>;
+    login: Login;
     logout: () => Promise<void>;
     checkAuthStatus: () => Promise<AuthState>;
 };
@@ -8502,12 +8576,17 @@ declare namespace Root {
 }
 
 
-declare namespace Image {
+declare namespace List {
     var displayName: string;
 }
 
 
-declare namespace Fallback {
+declare namespace Tab {
+    var displayName: string;
+}
+
+
+declare namespace Panel {
     var displayName: string;
 }
 
@@ -8517,12 +8596,12 @@ declare namespace Root {
 }
 
 
-declare namespace Header {
+declare namespace Image {
     var displayName: string;
 }
 
 
-declare namespace Content {
+declare namespace Fallback {
     var displayName: string;
 }
 
@@ -8532,47 +8611,52 @@ declare namespace Root {
 }
 
 
-declare namespace Legend {
+declare namespace Header {
     var displayName: string;
 }
 
 
-declare namespace Root {
+declare namespace Body {
     var displayName: string;
 }
 
 
-declare namespace Trigger {
+declare namespace Footer {
     var displayName: string;
 }
 
 
-declare namespace Close {
+declare namespace Row {
     var displayName: string;
 }
 
 
-declare namespace Content {
+declare namespace Head {
     var displayName: string;
 }
 
 
-declare namespace Header {
+declare namespace Cell {
     var displayName: string;
 }
 
 
-declare namespace Footer {
+declare namespace Caption {
     var displayName: string;
 }
 
 
-declare namespace Title {
+declare namespace Root {
     var displayName: string;
 }
 
 
-declare namespace Description {
+declare namespace Header {
+    var displayName: string;
+}
+
+
+declare namespace Content {
     var displayName: string;
 }
 
@@ -8582,37 +8666,37 @@ declare namespace Root {
 }
 
 
-declare namespace Header {
+declare namespace Trigger {
     var displayName: string;
 }
 
 
-declare namespace Body {
+declare namespace Close {
     var displayName: string;
 }
 
 
-declare namespace Footer {
+declare namespace Content {
     var displayName: string;
 }
 
 
-declare namespace Row {
+declare namespace Header {
     var displayName: string;
 }
 
 
-declare namespace Head {
+declare namespace Footer {
     var displayName: string;
 }
 
 
-declare namespace Cell {
+declare namespace Title {
     var displayName: string;
 }
 
 
-declare namespace Caption {
+declare namespace Description {
     var displayName: string;
 }
 
@@ -8647,7 +8731,12 @@ declare namespace Validity {
 }
 
 
-declare namespace Provider {
+declare namespace Root {
+    var displayName: string;
+}
+
+
+declare namespace Legend {
     var displayName: string;
 }
 
@@ -8667,357 +8756,362 @@ declare namespace Content {
 }
 
 
-declare namespace SelectRoot {
+declare namespace Item {
     var displayName: string;
 }
 
 
-declare namespace SelectTrigger {
+declare namespace LinkItem {
     var displayName: string;
 }
 
 
-declare namespace SelectValue {
+declare namespace CheckboxItem {
     var displayName: string;
 }
 
 
-declare namespace SelectContent {
+declare namespace CheckboxItemIndicator {
     var displayName: string;
 }
 
 
-declare namespace SelectItem {
+declare namespace RadioItem {
     var displayName: string;
 }
 
 
-declare namespace SelectGroup {
+declare namespace RadioItemIndicator {
     var displayName: string;
 }
 
 
-declare namespace SelectGroupLabel {
+declare namespace RadioGroup {
     var displayName: string;
 }
 
 
-declare namespace SelectSeparator {
+declare namespace Group {
     var displayName: string;
 }
 
 
-declare namespace ComboboxRoot {
+declare namespace GroupLabel {
     var displayName: string;
 }
 
 
-declare namespace ComboboxInput {
+declare namespace MenuSeparator {
     var displayName: string;
 }
 
 
-declare namespace ComboboxTrigger {
+declare namespace SubmenuRoot {
     var displayName: string;
 }
 
 
-declare namespace ComboboxInputGroup {
+declare namespace SubmenuTrigger {
     var displayName: string;
 }
 
 
-declare namespace ComboboxContent {
+declare namespace Root {
     var displayName: string;
 }
 
 
-declare namespace ComboboxList {
+declare namespace Trigger {
     var displayName: string;
 }
 
 
-declare namespace ComboboxItem {
+declare namespace Close {
     var displayName: string;
 }
 
 
-declare namespace ComboboxEmpty {
+declare namespace Content {
     var displayName: string;
 }
 
 
-declare namespace ComboboxGroup {
+declare namespace Header {
     var displayName: string;
 }
 
 
-declare namespace ComboboxGroupLabel {
+declare namespace Footer {
     var displayName: string;
 }
 
 
-declare namespace ComboboxClear {
+declare namespace Title {
     var displayName: string;
 }
 
 
-declare namespace ComboboxChips {
+declare namespace Description {
     var displayName: string;
 }
 
 
-declare namespace ComboboxChip {
+declare namespace Root {
     var displayName: string;
 }
 
 
-declare namespace ComboboxChipRemove {
+declare namespace Row {
     var displayName: string;
 }
 
 
-declare namespace ComboboxValue {
+declare namespace Group {
     var displayName: string;
 }
 
 
-declare namespace ComboboxStatus {
+declare namespace Separator {
     var displayName: string;
 }
 
 
-declare namespace ComboboxCollection {
+declare namespace SelectRoot {
     var displayName: string;
 }
 
 
-declare namespace Root {
+declare namespace SelectTrigger {
     var displayName: string;
 }
 
 
-declare namespace Trigger {
+declare namespace SelectValue {
     var displayName: string;
 }
 
 
-declare namespace Close {
+declare namespace SelectContent {
     var displayName: string;
 }
 
 
-declare namespace Content {
+declare namespace SelectItem {
     var displayName: string;
 }
 
 
-declare namespace Header {
+declare namespace SelectGroup {
     var displayName: string;
 }
 
 
-declare namespace Footer {
+declare namespace SelectGroupLabel {
     var displayName: string;
 }
 
 
-declare namespace Title {
+declare namespace SelectSeparator {
     var displayName: string;
 }
 
 
-declare namespace Description {
+declare namespace Provider {
     var displayName: string;
 }
 
 
-declare namespace DataTableRoot {
+declare namespace Root {
     var displayName: string;
 }
 
 
-declare namespace DataTableTable {
+declare namespace Trigger {
     var displayName: string;
 }
 
 
-declare namespace DataTableFooter {
+declare namespace Content {
     var displayName: string;
 }
 
 
-declare namespace AutocompleteStandalone {
+declare namespace ComboboxRoot {
     var displayName: string;
 }
 
 
-declare namespace AutocompleteAsyncStandalone {
+declare namespace ComboboxInput {
     var displayName: string;
 }
 
 
-declare namespace AutocompleteRoot {
+declare namespace ComboboxTrigger {
     var displayName: string;
 }
 
 
-declare namespace AutocompleteValue {
+declare namespace ComboboxInputGroup {
     var displayName: string;
 }
 
 
-declare namespace AutocompleteInput {
+declare namespace ComboboxContent {
     var displayName: string;
 }
 
 
-declare namespace AutocompleteTrigger {
+declare namespace ComboboxList {
     var displayName: string;
 }
 
 
-declare namespace AutocompleteInputGroup {
+declare namespace ComboboxItem {
     var displayName: string;
 }
 
 
-declare namespace AutocompleteContent {
+declare namespace ComboboxEmpty {
     var displayName: string;
 }
 
 
-declare namespace AutocompleteList {
+declare namespace ComboboxGroup {
     var displayName: string;
 }
 
 
-declare namespace AutocompleteItem {
+declare namespace ComboboxGroupLabel {
     var displayName: string;
 }
 
 
-declare namespace AutocompleteEmpty {
+declare namespace ComboboxClear {
     var displayName: string;
 }
 
 
-declare namespace AutocompleteClear {
+declare namespace ComboboxChips {
     var displayName: string;
 }
 
 
-declare namespace AutocompleteGroup {
+declare namespace ComboboxChip {
     var displayName: string;
 }
 
 
-declare namespace AutocompleteGroupLabel {
+declare namespace ComboboxChipRemove {
     var displayName: string;
 }
 
 
-declare namespace AutocompleteCollection {
+declare namespace ComboboxValue {
     var displayName: string;
 }
 
 
-declare namespace AutocompleteStatus {
+declare namespace ComboboxStatus {
     var displayName: string;
 }
 
 
-declare namespace Root {
+declare namespace ComboboxCollection {
     var displayName: string;
 }
 
 
-declare namespace List {
+declare namespace AutocompleteStandalone {
     var displayName: string;
 }
 
 
-declare namespace Tab {
+declare namespace AutocompleteAsyncStandalone {
     var displayName: string;
 }
 
 
-declare namespace Panel {
+declare namespace AutocompleteRoot {
     var displayName: string;
 }
 
 
-declare namespace Root {
+declare namespace AutocompleteValue {
     var displayName: string;
 }
 
 
-declare namespace Trigger {
+declare namespace AutocompleteInput {
     var displayName: string;
 }
 
 
-declare namespace Content {
+declare namespace AutocompleteTrigger {
     var displayName: string;
 }
 
 
-declare namespace Item {
+declare namespace AutocompleteInputGroup {
     var displayName: string;
 }
 
 
-declare namespace LinkItem {
+declare namespace AutocompleteContent {
     var displayName: string;
 }
 
 
-declare namespace CheckboxItem {
+declare namespace AutocompleteList {
     var displayName: string;
 }
 
 
-declare namespace CheckboxItemIndicator {
+declare namespace AutocompleteItem {
     var displayName: string;
 }
 
 
-declare namespace RadioItem {
+declare namespace AutocompleteEmpty {
     var displayName: string;
 }
 
 
-declare namespace RadioItemIndicator {
+declare namespace AutocompleteClear {
     var displayName: string;
 }
 
 
-declare namespace RadioGroup {
+declare namespace AutocompleteGroup {
     var displayName: string;
 }
 
 
-declare namespace Group {
+declare namespace AutocompleteGroupLabel {
     var displayName: string;
 }
 
 
-declare namespace GroupLabel {
+declare namespace AutocompleteCollection {
     var displayName: string;
 }
 
 
-declare namespace MenuSeparator {
+declare namespace AutocompleteStatus {
     var displayName: string;
 }
 
 
-declare namespace SubmenuRoot {
+declare namespace DataTableRoot {
     var displayName: string;
 }
 
 
-declare namespace SubmenuTrigger {
+declare namespace DataTableTable {
+    var displayName: string;
+}
+
+
+declare namespace DataTableFooter {
     var displayName: string;
 }
 
@@ -9037,21 +9131,21 @@ declare namespace Item {
 }
 
 
-declare namespace DataTableToolbar {
+declare namespace DataTableColumnSettings {
     var displayName: string;
 }
 
 
-declare namespace DataTableFilters {
+declare namespace DataTableToolbar {
     var displayName: string;
 }
 
 
-declare namespace AsyncErrorState {
+declare namespace DataTableFilters {
     var displayName: string;
 }
 
 
-declare namespace DataTableColumnSettings {
+declare namespace AsyncErrorState {
     var displayName: string;
 }