@unbound-app/api 2.0.0 → 2.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@unbound-app/api",
-	"version": "2.0.0",
+	"version": "2.2.0",
 	"author": {
 		"name": "Mario P.",
 		"email": "contact@marioparaschiv.com",

package/src/_internal.d.ts

@@ -4980,6 +4980,8 @@ export type NewerDesignComponents = {
 	SearchBar: DesignBarrelComponents['TextField'];
 	/** Discord's status label, such as New or Beta, or custom text. */
 	Badge: React$1.ComponentType<BadgeProps>;
+	/** Discord 354's settings slider row: its label and live value over a `Slider`. */
+	TableSliderRow: React$1.ComponentType<TableSliderRowProps>;
 };
 export type NitroGem12LottieComponent = React$1.ComponentType<
 	NitroGem12LottieProps & Record<string, unknown>
@@ -5822,10 +5824,6 @@ export type StringSettingSchema = {
 	placeholder?: string;
 	/** `color`: also takes an alpha channel, `#RRGGBBAA`. */
 	alpha?: boolean;
-	/** `color`: colors offered first. */
-	presets?: string[];
-	/** `color`: draws `presets` inline instead of a swatch row. */
-	palette?: boolean;
 	/** `image`: the largest file accepted, in bytes. */
 	maxSize?: number;
 };
@@ -6073,6 +6071,28 @@ export type TableRowTrailingTextComponent = React$1.ComponentType<TableRowTraili
 export type TableRowTrailingTextProps = {
 	text?: DesignTextProps['children'];
 };
+/**
+ * The props of Discord's `TableSliderRow`, read from Discord 354's `design/components/TableRow/native/TableSliderRow.native.tsx`.
+ * Any other prop, such as `maxValue` or `step`, goes to its `Slider`.
+ */
+export type TableSliderRowProps = {
+	/** The title, drawn left of the formatted value. */
+	label: string;
+	/** The value the slider starts at and follows. */
+	value: number;
+	/** The value the slider marks on its track. */
+	defaultValue?: number;
+	/** The lowest value; `0` when omitted. */
+	minValue?: number;
+	/** Formats the value shown right of the label; no value is shown when omitted. */
+	formatValue?: (value: number) => string;
+	/** Called with each value while dragging. */
+	onChange?: (value: number) => void;
+	/** Whether the row starts its group's card, when it is not in a `TableRowGroup`. */
+	start?: boolean;
+	/** Whether the row ends its group's card, when it is not in a `TableRowGroup`. */
+	end?: boolean;
+};
 export type TableSwitchRowComponent = React$1.ComponentType<
 	TableSwitchRowProps & Record<string, unknown>
 >;

package/src/global.d.ts

@@ -472,6 +472,7 @@ export type {
 	TableRowStatics,
 	TableRowTrailingTextComponent,
 	TableRowTrailingTextProps,
+	TableSliderRowProps,
 	TableSwitchRowComponent,
 	TableSwitchRowProps,
 	TabsComponent,

package/src/ui.d.ts

@@ -14,8 +14,8 @@ import { ComponentProps, ComponentType, FunctionComponent, ReactElement, ReactNo
 import * as RN from 'react-native';
 import { ImageStyle, TextStyle, ViewStyle } from 'react-native';
 /**
- * @description Discord's full-width Row Button, which runs something when pressed and asks first when `confirmation` is set;
- * `danger` leads with a red trash icon.
+ * @description A pressable `TableRow` in its settings group, as Discord draws actions such as Log Out; it asks first when
+ * `confirmation` is set. `danger` draws the label red behind a red trash icon.
  * @param props The row's label, variant, confirmation and press handler.
  * @returns The row.
  */
@@ -54,7 +54,7 @@ export declare function ChecklistRow({
 	onChange,
 }: ChecklistRowProps): React$1.ReactElement;
 /**
- * @description A settings row that shows a color swatch, opens Discord's color picker when pressed, takes a typed hex code and offers a reset back to the default. A typed code is saved even when it matches the default, which the picker cannot do: Discord's picker reports its current color when it is dismissed, so a pick that matches the color already shown is ignored.
+ * @description A settings row that shows a color swatch, opens Discord's color picker when pressed and offers a reset back to the default. Discord's picker reports its current color when dismissed, so a pick matching the shown color is ignored.
  * @param props The row's label, chosen color, the default it falls back to and the change handler.
  * @returns The row.
  */
@@ -94,7 +94,7 @@ export declare function EntityRow({
 }: EntityRowProps): React$1.ReactElement;
 /**
  * @description A settings row, Discord's way: the label, and the saved text trailing (masked when secret). Pressing
- * it opens Discord's titled action sheet with the input, its description and error, which saves only on Save.
+ * it opens Discord's dialog with the focused input, its description and error, which saves only on Save.
  * @param props The row's label, saved text, variant, validation and change handler.
  * @returns The row.
  */
@@ -111,7 +111,9 @@ export declare function InputRow({
 	onChange,
 }: InputRowProps): React$1.ReactElement;
 /**
- * @description A titled, editable list of strings: each row moves up or down or is removed, and an input adds one.
+ * @description A titled, editable list of strings: each row moves up or down, or is deleted after a confirmation; the
+ * delete button stands apart from the arrows so it is hard to hit by mistake. An Add row opens
+ * Discord's input dialog for a new one.
  * @param props The group's title, saved strings, limit, validation and change handler.
  * @returns The group.
  */
@@ -149,19 +151,6 @@ export declare function NumberRow({
  * it as the root of every settings page.
  */
 export declare function Page({ children }: PageProps): React$1.ReactElement;
-/**
- * @description A settings row with a grid of color swatches, the picked one ringed, for a fixed set of colors.
- * @param props The row's label, picked color, colors and change handler.
- * @returns The row.
- */
-export declare function PaletteRow({
-	label,
-	subLabel,
-	value,
-	presets,
-	disabled,
-	onChange,
-}: PaletteRowProps): React$1.ReactElement;
 /**
  * @description A row showing the picked option that opens Discord's action sheet listing every option, for choices too many for a radio group.
  * @param props The row's label, picked value, options and change handler.
@@ -194,8 +183,9 @@ export declare function RadioRow({
  */
 export declare function ResetRow({ label, onReset }: ResetRowProps): React$1.ReactElement;
 /**
- * @description A card saying a change applies after Discord restarts, with a full-width button that restarts it now.
- * @returns The card.
+ * @description Discord's `InlineNotice` saying a change applies after Discord restarts, with a button that restarts
+ * it now; on builds without one, a card holding the same text and button.
+ * @returns The notice.
  */
 export declare function RestartRow(): React$1.ReactElement;
 /**
@@ -245,9 +235,9 @@ export declare function SegmentedRow({
 	onChange,
 }: SegmentedRowProps): React$1.ReactElement;
 /**
- * @description A settings row with Discord's form slider, as its own settings draw one: the label, then the slider
- * with its value label and default mark. The value updates while dragging and is saved when the drag ends; Android's
- * slider and iOS's take differently named props, so it passes both.
+ * @description Discord's `TableSliderRow`, as its own settings draw one: the label and live value over the slider
+ * with its default mark. A sub-label, which that row cannot show, moves it to a `TableRow` holding the same slider.
+ * The value is saved when the drag ends; Android's slider and iOS's take differently named props, so it passes both.
  * @param props The row's label, value, default, range and change handler.
  * @returns The row, or `null` when Discord's slider is unavailable.
  */
@@ -350,11 +340,11 @@ export type ColorRowProps = {
 	label: string;
 	/** The chosen color as a `#RRGGBB` hex code, or `undefined` when the default applies. */
 	color: string | undefined;
-	/** The default color, swatched while `color` is unset and used as the hex input's placeholder. */
+	/** The default color, swatched and opened in the picker while `color` is unset. */
 	fallbackColor: string;
 	/** The text shown under the label while `color` is unset, in place of the hex code. */
 	fallbackLabel: string;
-	/** Called with the new `#RRGGBB` hex code, or `undefined` when the user resets or clears it. */
+	/** Called with the new `#RRGGBB` hex code, or `undefined` when the user resets it. */
 	onChange: (color: string | undefined) => void;
 };
 /** What `storage.define` returns: a schema's settings, bound to one Bucket. */
@@ -485,21 +475,6 @@ export type PageProps = {
 	/** The page's form groups, laid out top to bottom with a 24px gap. */
 	children: React$1.ReactNode;
 };
-/** Props for `PaletteRow`. */
-export type PaletteRowProps = {
-	/** The row's label. */
-	label: string;
-	/** Text shown under the label; none when omitted. */
-	subLabel?: string;
-	/** The picked color, `#RRGGBB`. */
-	value: string;
-	/** The colors offered, `#RRGGBB`. */
-	presets: string[];
-	/** Dims the row and ignores input. Defaults to false. */
-	disabled?: boolean;
-	/** Called with the color the user presses. */
-	onChange: (color: string) => void;
-};
 /** Props for `PickerRow`. */
 export type PickerRowProps = {
 	/** The row's label. */

package/testing/fake-components.ts

@@ -34,7 +34,6 @@ const UI = [
 	'MultilineRow',
 	'NumberRow',
 	'Page',
-	'PaletteRow',
 	'PickerRow',
 	'RadioRow',
 	'ResetRow',

package/testing/fake-settings-panel.ts

@@ -48,10 +48,6 @@ function rowName(node: SchemaNode): string {
 	const display = String(node.displayAs);
 	const entity = ['user', 'channel', 'guild', 'role'].includes(display);
 
-	if (display === 'color' && node.palette === true) {
-		return 'PaletteRow';
-	}
-
 	return (
 		ROWS[kind] ??
 		ROWS[`${kind}:${display}`] ??

package/testing/fake-settings.ts

@@ -65,7 +65,7 @@ type Options = FakeModule;
 
 const COMMON = ['title', 'subtitle', 'hidden', 'requiresRestart'];
 const CONDITIONS = ['visibleWhen', 'disabledWhen'];
-const STRING = ['minLength', 'maxLength', 'placeholder', 'alpha', 'presets', 'palette', 'maxSize'];
+const STRING = ['minLength', 'maxLength', 'placeholder', 'alpha', 'maxSize'];
 
 // Mirrors the build's builders: the JSON keeps these options, and a predicate becomes `{ predicate: true }`.
 function meta(kind: string, displayAs: string, options: Options, keys: string[] = []): SchemaNode {