@weasel-js/ui 1.5.1 → 1.6.0

package/dist/components/Properties/DialogRow.d.ts

@@ -0,0 +1,33 @@
+import { type ReactNode } from 'react';
+import { type PropertyMetricProps, type PropertyRowLayout } from './PropertyPanel';
+/** Props for `<DialogRow>`. */
+export interface DialogRowProps extends PropertyMetricProps {
+    label: ReactNode;
+    /** What the row shows of the value, on the button that opens the dialog. One
+     *  line; a longer one is cut off with an ellipsis. */
+    summary: ReactNode;
+    /** The dialog's body. A function runs only while the dialog is open, as a
+     *  component — it may use hooks — and is handed `close`. */
+    children: ReactNode | ((close: () => void) => ReactNode);
+    /** The dialog's heading. Defaults to `label`. */
+    title?: ReactNode;
+    /** Dialog footer. Defaults to a Done button; `null` draws none. */
+    footer?: ReactNode | null;
+    layout?: PropertyRowLayout;
+    description?: string;
+    /** Right-aligned readout shown next to the label — see `<PropertyRow readout>`. */
+    readout?: ReactNode;
+    /** Take the full width of the enclosing grid — see `<PropertyRow span>`. */
+    span?: boolean;
+    /** The row is auto — see `<PropertyRow auto>`. */
+    auto?: boolean;
+    /** Toggles `auto` from the row's label — see `<PropertyRow onAutoChange>`. */
+    onAutoChange?: (next: boolean) => void;
+}
+/**
+ * A row for a value too big to edit in place: it shows a one-line summary on a
+ * button, and the button opens a modal holding whatever editor the row is
+ * given. The body edits live — the dialog is room, not a transaction.
+ */
+export declare function DialogRow({ label, summary, children, title, footer, layout, description, readout, span, density, align, auto, onAutoChange, }: DialogRowProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=DialogRow.d.ts.map

package/dist/components/Properties/DialogRow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DialogRow.d.ts","sourceRoot":"","sources":["../../../src/components/Properties/DialogRow.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAC;AAGjD,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EAAe,MAAM,iBAAiB,CAAC;AAGhG,+BAA+B;AAC/B,MAAM,WAAW,cAAe,SAAQ,mBAAmB;IACzD,KAAK,EAAE,SAAS,CAAC;IACjB;0DACsD;IACtD,OAAO,EAAE,SAAS,CAAC;IACnB;gEAC4D;IAC5D,QAAQ,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,SAAS,CAAC,CAAC;IACzD,iDAAiD;IACjD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,mEAAmE;IACnE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kDAAkD;IAClD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8EAA8E;IAC9E,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,OAAO,EACP,QAAQ,EACR,KAAK,EACL,MAAM,EACN,MAAM,EACN,WAAW,EACX,OAAO,EACP,IAAI,EACJ,OAAO,EACP,KAAK,EACL,IAAI,EACJ,YAAY,GACb,EAAE,cAAc,2CAiDhB"}

package/dist/components/Properties/PropertyField.d.ts

@@ -0,0 +1,238 @@
+import { type ReactNode } from 'react';
+import { type FillStyle, type PaintKind } from '@weasel-js/core';
+import { type UnitTable } from '../../format/number';
+import type { PrefNumberFormat } from '../Prefs/schema';
+import { type PropertyMetricProps, type PropertyRowLayout } from './PropertyPanel';
+/**
+ * Which controls a field is drawn with.
+ *
+ *   - `'bare'` (the default): native inputs the property row's own stylesheet
+ *     draws — the compact controls of an inspector sidebar or a lab panel.
+ *   - `'framed'`: the kit's field components, each bringing its own frame —
+ *     for a surface whose row does not style its controls (`SelectionPanel`,
+ *     `ToolOptionsBar`), or that needs what only they do, such as reading a
+ *     unit typed into a number (`accepts`).
+ *
+ * The two differ only where the kit still has two widgets for one job; a
+ * slider, a switch, a font picker and a paint are the same in both.
+ */
+export type PropertyFieldChrome = 'bare' | 'framed';
+/** One choice of an enum field. */
+export interface PropertyOption<T extends string> {
+    value: T;
+    /** The option's name. A string also names its segment for a screen reader. */
+    label: ReactNode;
+    /** What a segment shows in place of `label` when the full one would not fit
+     *  — a glyph or a letter. `label` stays the accessible name. */
+    glyph?: ReactNode;
+    /** Shown but not choosable: a value the control reports and cannot author. */
+    disabled?: boolean;
+}
+/** Props every kind of field shares. */
+interface FieldBase {
+    /** The control's accessible name. A `<PropertyField>` takes it from a string
+     *  `label` when this is omitted. */
+    name?: string;
+    /** The sources the field reads disagree — a multi-selection whose nodes
+     *  differ. The control shows no value, in whatever form it has for that. */
+    mixed?: boolean;
+    /**
+     * The sources agree on holding nothing: whatever is in effect comes from a
+     * fallback further down. The control shows no chosen value rather than
+     * inventing one, since the next edit would write the invention back.
+     */
+    unset?: boolean;
+    chrome?: PropertyFieldChrome;
+    /** Class on the control element itself. */
+    className?: string;
+    /** Id for the control element, for a `<label htmlFor>` outside it. */
+    id?: string;
+}
+/** A boolean field. */
+export interface PropertyBooleanFieldProps extends FieldBase {
+    kind: 'boolean';
+    /** `checkbox` (default), `switch`, or `toggle` — a one-segment pressable bar. */
+    control?: 'checkbox' | 'switch' | 'toggle';
+    /** Absent reads as off. */
+    value: boolean | undefined;
+    onChange: (next: boolean) => void;
+    /** A `toggle`'s segment content. Defaults to the first letter of `name`. */
+    glyph?: ReactNode;
+}
+/** A number field. */
+export interface PropertyNumberFieldProps extends FieldBase {
+    kind: 'number';
+    /** `input` (default) for a typed number; `slider` for a track with an
+     *  editable readout, where the range matters more than the exact value. */
+    control?: 'input' | 'slider';
+    /** Absent reads as an empty field. */
+    value: number | null | undefined;
+    /**
+     * The committed value. Given `onInput` as well, it fires once a drag ends,
+     * or on blur or Enter in a typed field; on its own it fires on every move
+     * and keystroke. A `framed` typed field commits only on blur or Enter,
+     * whichever callbacks it has.
+     */
+    onChange: (next: number) => void;
+    /** The live value, fired continuously. Pass it alongside `onChange` when the
+     *  write is expensive — cheap state here, the costly work there. */
+    onInput?: (next: number) => void;
+    /** A slider's track runs 0..100 where these are omitted. */
+    min?: number;
+    max?: number;
+    step?: number;
+    /**
+     * Suffix after the value. A string becomes a dim word unit (`px`); pass JSX
+     * like `<sup>°</sup>` for a symbol. Display only — the value stays a number.
+     */
+    unit?: ReactNode;
+    /** Units a person may type into a `framed` field, each mapped to the factor
+     *  that turns it into the unit shown: `{ mm: 0.1, cm: 1 }`. */
+    accepts?: Readonly<UnitTable>;
+    /** A slider readout's display. Defaults to the value at `step`'s precision. */
+    format?: (value: number) => ReactNode;
+    /** A named display for the value: `compact` reads `2.00M`. `format` wins. */
+    notation?: PrefNumberFormat;
+    placeholder?: string;
+    /** A `framed` unitless field's stepper buttons. Default `true`. */
+    steppers?: boolean;
+}
+/** A text field. */
+export interface PropertyStringFieldProps extends FieldBase {
+    kind: 'string';
+    control?: 'input' | 'textarea';
+    /** Absent reads as an empty field. */
+    value: string | null | undefined;
+    /**
+     * The committed text. On its own it fires on every keystroke. Given
+     * `onInput` as well, the field drafts: `onInput` gets each keystroke and
+     * this fires once, on blur or Enter, and only if the text changed.
+     */
+    onChange: (next: string) => void;
+    onInput?: (next: string) => void;
+    placeholder?: string;
+    maxLength?: number;
+}
+/** A choice among fixed options. */
+export interface PropertyEnumFieldProps<T extends string = string> extends FieldBase {
+    kind: 'enum';
+    /**
+     * `select` (default) is a dropdown. `radio` and `toggle` show every option
+     * at once — a radio group chooses, and a toggle is a row of pressable
+     * segments. Drawn `bare`, both are segments.
+     */
+    control?: 'select' | 'radio' | 'toggle';
+    /** Absent, or not one of `options`, chooses nothing. */
+    value: T | undefined;
+    options: ReadonlyArray<PropertyOption<T>>;
+    onChange: (next: T) => void;
+    /** Shown while no option is chosen. Defaults to "Choose option…". */
+    placeholder?: string;
+}
+/** A single color. */
+export interface PropertyColorFieldProps extends FieldBase {
+    kind: 'color';
+    /** `#rrggbb`, or `#rrggbbaa` when `alpha` is `true`. */
+    value: string | undefined;
+    /**
+     * The committed color. `bare`: given `onInput` as well, it fires once the
+     * picker closes; on its own it fires on every move. `framed`: it fires once
+     * per gesture, whichever callbacks it has.
+     */
+    onChange: (next: string) => void;
+    onInput?: (next: string) => void;
+    /**
+     * Offer an opacity track. `true` keeps the alpha in `value` as `#rrggbbaa`;
+     * a number is the 0..1 alpha held apart from it, reported through
+     * `onAlphaChange` / `onAlphaInput`.
+     */
+    alpha?: boolean | number;
+    onAlphaChange?: (next: number) => void;
+    onAlphaInput?: (next: number) => void;
+    /** Draw the opacity track inert, for a consumer that drops alpha. */
+    alphaDisabled?: boolean;
+}
+/** A whole paint: a solid, a gradient, a pattern, or none. */
+export interface PropertyPaintFieldProps extends FieldBase {
+    kind: 'paint';
+    /** `swatch` (default) opens the editor in a popover, for a narrow slot;
+     *  `inline` draws the kind bar and its editor in place. */
+    control?: 'swatch' | 'inline';
+    /** `null` is an explicit "no paint"; `undefined` is nothing to show. */
+    value: FillStyle | null | undefined;
+    onChange: (next: FillStyle | null) => void;
+    onInput?: (next: FillStyle | null) => void;
+    /** Offer "None". Default `true`. */
+    allowNone?: boolean;
+    /** Restrict the kinds offered. Default: every registered kind. */
+    kinds?: readonly PaintKind[];
+}
+/** A font family, picked from the live font registry. */
+export interface PropertyFontFamilyFieldProps extends FieldBase {
+    kind: 'font-family';
+    value: string | undefined;
+    onChange: (next: string) => void;
+    /** The weight and slant the family is drawn at, so the picker names the
+     *  variant that will actually paint. */
+    weight?: number;
+    fontStyle?: 'normal' | 'italic';
+}
+/**
+ * One field for {@link PropertyControl} and {@link PropertyField}, keyed by
+ * `kind`.
+ */
+export type PropertyControlProps<T extends string = string> = PropertyBooleanFieldProps | PropertyNumberFieldProps | PropertyStringFieldProps | PropertyEnumFieldProps<T> | PropertyColorFieldProps | PropertyPaintFieldProps | PropertyFontFamilyFieldProps;
+/** The kinds a {@link PropertyControl} draws. */
+export type PropertyFieldKind = PropertyControlProps['kind'];
+/** Row props {@link PropertyField} adds to the field it draws. */
+export interface PropertyFieldRowProps extends PropertyMetricProps {
+    label: ReactNode;
+    /**
+     * Text beside the label. On a slider it replaces the editable readout —
+     * use it when the row is not showing a number a caller could type back,
+     * such as an auto row's `auto`.
+     */
+    readout?: ReactNode;
+    description?: string;
+    layout?: PropertyRowLayout;
+    /** Take the full width of the enclosing grid — see `<PropertyRow span>`. */
+    span?: boolean;
+    /** The row is auto — see `<PropertyRow auto>`. */
+    auto?: boolean;
+    /** Toggles `auto` from the row's label — see `<PropertyRow onAutoChange>`. */
+    onAutoChange?: (next: boolean) => void;
+    /** Class on the row. `controlClassName` reaches the control. */
+    rowClassName?: string;
+    controlClassName?: string;
+}
+/** Props for {@link PropertyField}: one field, and the row around it. */
+export type PropertyFieldProps<T extends string = string> = PropertyFieldRowProps & DistributiveOmit<PropertyControlProps<T>, 'className' | 'id'>;
+type DistributiveOmit<U, K extends PropertyKey> = U extends unknown ? Omit<U, K> : never;
+/**
+ * A labeled settings row for one field, its control chosen by `kind` (and
+ * `control`): `<PropertyField kind="number" control="slider" label="Blur" …>`.
+ *
+ * The row is a {@link PropertyRow}; the control is the one
+ * {@link PropertyControl} draws for the same props. Every schema-driven
+ * settings surface in the kit — `ControlPanel`, `PrefsForm`, `SelectionPanel`
+ * — draws its built-in kinds through that one mapping, so a kind's control
+ * is decided once.
+ *
+ * Callbacks follow the field's shape: a discrete control (a box, a choice)
+ * reports each pick; a continuous or typed one reports every change through
+ * `onChange` alone, or splits them into live `onInput` and settled
+ * `onChange` when given both. `mixed` and `unset` show a field whose sources
+ * disagree, or agree on holding nothing.
+ */
+export declare function PropertyField<T extends string = string>(props: PropertyFieldProps<T>): import("react/jsx-runtime").JSX.Element;
+/**
+ * The control for one field, with no row around it — for a cell that shares
+ * a row with others, or a surface that draws its own row. Keyed by `kind`
+ * (and `control`), the same mapping {@link PropertyField} draws.
+ *
+ * A slider brings its readout beside the track. Several elements come back
+ * as siblings rather than wrapped, so the surrounding row lays them out.
+ */
+export declare function PropertyControl<T extends string = string>(typed: PropertyControlProps<T>): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=PropertyField.d.ts.map

package/dist/components/Properties/PropertyField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PropertyField.d.ts","sourceRoot":"","sources":["../../../src/components/Properties/PropertyField.tsx"],"names":[],"mappings":"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"}

package/dist/components/Properties/PropertyGroup.d.ts

@@ -1,9 +1,17 @@
 import { type ReactNode } from 'react';
+import { type StanceProps } from '../stance';
 import { type PropertyListPack, type PropertyMetricProps } from './PropertyPanel';
 /** Props for `<PropertyGroup>`. */
-export interface PropertyGroupProps extends PropertyMetricProps {
+export interface PropertyGroupProps extends PropertyMetricProps, StanceProps {
     /** Title rendered between two rules at the top of the group. */
     title: ReactNode;
+    /** Before the title: a drag handle, an ordinal. Clicks here do not fold the group. */
+    leading?: ReactNode;
+    /** After the title: a summary of the group's value, a remove button. Clicks here do not fold the group. */
+    actions?: ReactNode;
+    /** Help text for the whole group, drawn under the title and above the
+     *  rows. `<PropertyRow description>` covers the per-row case. */
+    description?: ReactNode;
     /** When true the group renders nothing — useful for conditional sections. */
     hidden?: boolean;
     /**
@@ -23,6 +31,9 @@ export interface PropertyGroupProps extends PropertyMetricProps {
     onCollapsedChange?: (next: boolean) => void;
     children: ReactNode;
     className?: string;
+    /** Take the whole width of a packed grid, like `<PropertyRow span>`: a group
+     *  lays its own rows out, so half a column leaves them overlapping. */
+    span?: boolean;
     /** How rows pack into the 2-column grid — see `<PropertyList pack>`. */
     pack?: PropertyListPack;
 }
@@ -32,7 +43,11 @@ export interface PropertyGroupProps extends PropertyMetricProps {
  * inside a fill effect's controls).
  *
  * A collapsible group keeps its rows mounted and hides them, so a control's
- * local state survives being folded away.
+ * local state survives being folded away. `stance` and `tone` work as on
+ * `<PropertyPanel>`; a tone also draws the group's leading edge in it, which
+ * is how a list of like groups — effects, tails — tells its members apart.
+ * `leading` and `actions` put a handle and controls in the title row, and the
+ * groups of a `<PropertyList>` reorder with `useReorderDragList`.
  */
-export declare function PropertyGroup({ title, hidden, collapsible, defaultCollapsed, collapsed, onCollapsedChange, children, className, pack, density, align, }: PropertyGroupProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function PropertyGroup({ title, leading, actions, description, hidden, collapsible, defaultCollapsed, collapsed, onCollapsedChange, children, className, span, pack, density, align, stance, tone, }: PropertyGroupProps): import("react/jsx-runtime").JSX.Element | null;
 //# sourceMappingURL=PropertyGroup.d.ts.map

package/dist/components/Properties/PropertyGroup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PropertyGroup.d.ts","sourceRoot":"","sources":["../../../src/components/Properties/PropertyGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAmB,MAAM,OAAO,CAAC;AAGxD,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EAEzB,MAAM,iBAAiB,CAAC;AAEzB,mCAAmC;AACnC,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,gEAAgE;IAChE,KAAK,EAAE,SAAS,CAAC;IACjB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,MAAM,EACN,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,iBAAiB,EACjB,QAAQ,EACR,SAAS,EACT,IAAmB,EACnB,OAAO,EACP,KAAK,GACN,EAAE,kBAAkB,kDA2CpB"}
+{"version":3,"file":"PropertyGroup.d.ts","sourceRoot":"","sources":["../../../src/components/Properties/PropertyGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAmB,MAAM,OAAO,CAAC;AAExD,OAAO,EAAE,KAAK,WAAW,EAAa,MAAM,WAAW,CAAC;AAExD,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EAGzB,MAAM,iBAAiB,CAAC;AAEzB,mCAAmC;AACnC,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB,EAAE,WAAW;IAC1E,gEAAgE;IAChE,KAAK,EAAE,SAAS,CAAC;IACjB,sFAAsF;IACtF,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,2GAA2G;IAC3G,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;qEACiE;IACjE,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;2EACuE;IACvE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wEAAwE;IACxE,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,OAAO,EACP,OAAO,EACP,WAAW,EACX,MAAM,EACN,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,iBAAiB,EACjB,QAAQ,EACR,SAAS,EACT,IAAI,EACJ,IAAmB,EACnB,OAAO,EACP,KAAK,EACL,MAAM,EACN,IAAI,GACL,EAAE,kBAAkB,kDAuDpB"}