@weasel-js/ui 1.5.2 → 1.6.0

package/dist/components/Prefs/PrefsForm.d.ts

@@ -1,24 +1,8 @@
-import { type ReactNode } from 'react';
-import { type PrefGroup, type PrefLeaf } from './schema';
-/** What a {@link PrefRenderer} is given for the leaf it is rendering. */
-export interface PrefRenderContext {
-    /** Dotted path of the leaf within the schema root. */
-    path: string;
-    /** The schema node. App renderers narrow this to their own kind shape. */
-    pref: PrefLeaf;
-    /** Current value — `values` at `path`, falling back to `pref.default`. */
-    value: unknown;
-    setValue: (value: unknown) => void;
-    /** Whether this leaf is currently auto — not pinned, computed by the owner. */
-    auto: boolean;
-    /** Toggle this leaf's auto state. */
-    setAuto: (next: boolean) => void;
-}
-/**
- * Renders the control cell for one preference leaf. Returning `null`
- * collapses the row.
- */
-export type PrefRenderer = (ctx: PrefRenderContext) => ReactNode;
+import { type PrefGroup } from './schema';
+import { type PrefRenderer } from './PrefsRow';
+export type { PrefRenderer, PrefRenderContext } from './PrefsRow';
+/** How a {@link PrefsForm} lays its groups out. */
+export type PrefsLayout = 'columns' | 'rail';
 /** Props for {@link PrefsForm}. */
 export interface PrefsFormProps {
     /** Root of the schema tree. Core `ToolPrefGroup`s assign structurally. */
@@ -40,13 +24,30 @@ export interface PrefsFormProps {
     renderers?: Record<string, PrefRenderer>;
     /** Reveal `hidden` leaves (dev tooling). Default false. */
     showHidden?: boolean;
+    /**
+     * `'columns'` (the default) wraps each top-level group into its own panel
+     * column. `'rail'` puts a two-level navigation rail beside one group's
+     * settings at a time — what a dialog-sized surface wants, since columns
+     * overflow sideways once there are more than two.
+     */
+    layout?: PrefsLayout;
+    /** Show a filter field that narrows the form to matching leaves. */
+    filterable?: boolean;
+    /** Rail layout: path of the open top-level group. Controlled. */
+    section?: string;
+    /** Rail layout: path of the group open before the reader picks one.
+     *  Defaults to the first in the schema. */
+    defaultSection?: string;
+    onSectionChange?: (path: string) => void;
     className?: string;
 }
 /**
- * Schema-driven preferences form. Top-level groups render as columns,
- * nested groups as indented sub-panels, leaves as label + control rows.
- * Storage-agnostic: pair with `PrefsDialog` for the modal composition,
- * and persist however the app likes via `onChange`.
+ * Schema-driven preferences form. Leaves render as label + control rows;
+ * how the groups around them are arranged is `layout`'s to say — columns of
+ * panels, or a navigation rail beside one group at a time.
+ *
+ * Storage-agnostic: pair with `PrefsDialog` for the modal composition, and
+ * persist however the app likes via `onChange`.
  */
 export declare function PrefsForm(props: PrefsFormProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=PrefsForm.d.ts.map

package/dist/components/Prefs/PrefsForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PrefsForm.d.ts","sourceRoot":"","sources":["../../../src/components/Prefs/PrefsForm.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAehD,OAAO,EAML,KAAK,SAAS,EACd,KAAK,QAAQ,EACd,MAAM,UAAU,CAAC;AAGlB,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,IAAI,EAAE,QAAQ,CAAC;IACf,0EAA0E;IAC1E,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,+EAA+E;IAC/E,IAAI,EAAE,OAAO,CAAC;IACd,qCAAqC;IACrC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,iBAAiB,KAAK,SAAS,CAAC;AAEjE,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,MAAM,EAAE,SAAS,CAAC;IAClB;8DAC0D;IAC1D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;0CACsC;IACtC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACjD;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,2DAA2D;IAC3D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,2CAsB9C"}
+{"version":3,"file":"PrefsForm.d.ts","sourceRoot":"","sources":["../../../src/components/Prefs/PrefsForm.tsx"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,UAAU,CAAC;AAClB,OAAO,EAAW,KAAK,YAAY,EAAgB,MAAM,YAAY,CAAC;AAKtE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAElE,mDAAmD;AACnD,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;AAE7C,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,MAAM,EAAE,SAAS,CAAC;IAClB;8DAC0D;IAC1D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;0CACsC;IACtC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACjD;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,2DAA2D;IAC3D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,oEAAoE;IACpE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;+CAC2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,2CAgE9C"}

package/dist/components/Prefs/PrefsPane.d.ts

@@ -0,0 +1,24 @@
+import { type RefObject } from 'react';
+import { type PrefGroup } from './schema';
+import { type WalkCtx } from './PrefsRow';
+/** Props for {@link PrefsPane}. */
+export interface PrefsPaneProps {
+    ctx: WalkCtx;
+    /** The open group, or a synthetic one holding the root's loose leaves. */
+    group: PrefGroup;
+    /** Dotted path of `group`. Empty for the loose-leaf pane. */
+    path: string;
+    /** The pane's scroll container, for the rail's scroll spy. */
+    scrollRef: RefObject<HTMLDivElement | null>;
+    className?: string;
+}
+/**
+ * One rail section's settings: the group's own leaves, then one headed
+ * section per nested group.
+ *
+ * Nothing here draws a panel. The rail is the layout's structure, and a card
+ * inside a dialog that already has a border only restates it — the columns
+ * layout's sunken panels are what this is the alternative to.
+ */
+export declare function PrefsPane(props: PrefsPaneProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=PrefsPane.d.ts.map

package/dist/components/Prefs/PrefsPane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrefsPane.d.ts","sourceRoot":"","sources":["../../../src/components/Prefs/PrefsPane.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAc,KAAK,SAAS,EAAiB,MAAM,UAAU,CAAC;AACrE,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAGnD,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,OAAO,CAAC;IACb,0EAA0E;IAC1E,KAAK,EAAE,SAAS,CAAC;IACjB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,SAAS,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,2CAoC9C"}

package/dist/components/Prefs/PrefsRail.d.ts

@@ -0,0 +1,32 @@
+import type { ReactNode } from 'react';
+import type { PrefRailItem } from './schema';
+/** Props for {@link PrefsRail}. */
+export interface PrefsRailProps {
+    items: readonly PrefRailItem[];
+    /** Path of the open depth-0 group. */
+    section: string;
+    /** Path of the depth-1 group in view, from the pane's scroll spy. */
+    current: string | null;
+    /** A depth-0 entry was chosen: open its pane. */
+    onOpen: (path: string) => void;
+    /** A depth-1 entry was chosen: scroll the open pane to it. */
+    onScrollTo: (path: string) => void;
+    /** Accessible name for the rail's landmark. */
+    ariaLabel: string;
+    /** Rendered above the list — the filter field, when there is one. */
+    header?: ReactNode;
+    /** Show each entry's match count. Only meaningful while filtering. */
+    showCounts?: boolean;
+}
+/**
+ * The rail beside a `PrefsForm` pane: depth-0 groups, each followed by the
+ * depth-1 groups that scroll within it.
+ *
+ * A list of buttons rather than a tablist, because only half of these entries
+ * switch anything — the nested ones scroll the pane the selected entry already
+ * opened, and a tab that does not own a panel has no honest role. The open
+ * group is `aria-current="page"`; the nested group in view is
+ * `aria-current="location"`.
+ */
+export declare function PrefsRail(props: PrefsRailProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=PrefsRail.d.ts.map

package/dist/components/Prefs/PrefsRail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrefsRail.d.ts","sourceRoot":"","sources":["../../../src/components/Prefs/PrefsRail.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iDAAiD;IACjD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,8DAA8D;IAC9D,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,sEAAsE;IACtE,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,2CAyC9C"}

package/dist/components/Prefs/PrefsRow.d.ts

@@ -0,0 +1,32 @@
+import { type ReactNode } from 'react';
+import { type PrefLeaf } from './schema';
+/** What a {@link PrefRenderer} is given for the leaf it is rendering. */
+export interface PrefRenderContext {
+    /** Dotted path of the leaf within the schema root. */
+    path: string;
+    /** The schema node. App renderers narrow this to their own kind shape. */
+    pref: PrefLeaf;
+    /** Current value — `values` at `path`, falling back to `pref.default`. */
+    value: unknown;
+    setValue: (value: unknown) => void;
+    /** Whether this leaf is currently auto — not pinned, computed by the owner. */
+    auto: boolean;
+    /** Toggle this leaf's auto state. */
+    setAuto: (next: boolean) => void;
+}
+/**
+ * Renders the control cell for one preference leaf. Returning `null`
+ * collapses the row.
+ */
+export type PrefRenderer = (ctx: PrefRenderContext) => ReactNode;
+export interface WalkCtx {
+    values: unknown;
+    onChange: (path: string, value: unknown) => void;
+    renderers?: Record<string, PrefRenderer>;
+}
+export declare function PrefRow({ ctx, path, pref }: {
+    ctx: WalkCtx;
+    path: string;
+    pref: PrefLeaf;
+}): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=PrefsRow.d.ts.map

package/dist/components/Prefs/PrefsRow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrefsRow.d.ts","sourceRoot":"","sources":["../../../src/components/Prefs/PrefsRow.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,OAAO,EAIL,KAAK,QAAQ,EAEd,MAAM,UAAU,CAAC;AAGlB,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,IAAI,EAAE,QAAQ,CAAC;IACf,0EAA0E;IAC1E,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,+EAA+E;IAC/E,IAAI,EAAE,OAAO,CAAC;IACd,qCAAqC;IACrC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,iBAAiB,KAAK,SAAS,CAAC;AAEjE,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC1C;AAED,wBAAgB,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,kDA+B1F"}

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

@@ -1,4 +1,7 @@
-export { PrefsForm, type PrefsFormProps, type PrefRenderer, type PrefRenderContext } from './PrefsForm';
+export { PrefsForm, type PrefsFormProps, type PrefsLayout, type PrefRenderer, type PrefRenderContext, } from './PrefsForm';
+export { prefFieldProps, type PrefFieldState } from './prefField';
+export { PrefsRail, type PrefsRailProps } from './PrefsRail';
+export { PrefsPane, type PrefsPaneProps } from './PrefsPane';
 export { PrefsDialog, type PrefsDialogProps } from './PrefsDialog';
-export { isPrefLeaf, prefDisplayBounds, prefValueAtPath, visiblePrefSubtree, type BuiltinPref, type PrefBoolean, type PrefBooleanControl, type PrefColor, type PrefCustom, type PrefEnum, type PrefEnumControl, type PrefEnumEncoding, type PrefGroup, type PrefKind, type PrefLeaf, type PrefNumber, type PrefNumberControl, type PrefNumberFormat, type PrefNumberUnit, type PrefPaint, type PrefObject, type PrefString, type PrefStringControl, } from './schema';
+export { filterPrefSubtree, isPrefLeaf, prefDisplayBounds, prefRailItems, prefValueAtPath, visiblePrefSubtree, type PrefRailItem, type BuiltinPref, type PrefBoolean, type PrefBooleanControl, type PrefColor, type PrefCustom, type PrefEnum, type PrefEnumControl, type PrefEnumEncoding, type PrefGroup, type PrefKind, type PrefLeaf, type PrefNumber, type PrefNumberControl, type PrefNumberFormat, type PrefNumberUnit, type PrefPaint, type PrefObject, type PrefString, type PrefStringControl, } from './schema';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/Prefs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Prefs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACxG,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,iBAAiB,GACvB,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Prefs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,iBAAiB,GACvB,MAAM,UAAU,CAAC"}

package/dist/components/Prefs/index.js

@@ -1,3 +1,3 @@
-import { n as e, t } from "../../chunks/Prefs-CNC8tzyN.js";
-import { a as n, i as r, n as i, t as a } from "../../chunks/schema-Dft4Cu2p.js";
-export { t as PrefsDialog, e as PrefsForm, a as isPrefLeaf, i as prefDisplayBounds, r as prefValueAtPath, n as visiblePrefSubtree };
+import { a as e, i as t, n, o as r, r as i, s as a, t as o } from "../../chunks/prefField-CLkhrvYl.js";
+import { i as s, n as c, r as l, t as u } from "../../chunks/Prefs-Ctu0H4-b.js";
+export { u as PrefsDialog, c as PrefsForm, s as PrefsPane, l as PrefsRail, n as filterPrefSubtree, i as isPrefLeaf, t as prefDisplayBounds, o as prefFieldProps, e as prefRailItems, r as prefValueAtPath, a as visiblePrefSubtree };

package/dist/components/Prefs/prefField.d.ts

@@ -0,0 +1,36 @@
+import type { PropertyControlProps } from '../Properties/PropertyField';
+import { type PrefLeaf } from './schema';
+/** What {@link prefFieldProps} is told about one leaf's value. */
+export interface PrefFieldState {
+    /** The value held at the leaf. `undefined` when `mixed` or `unset`. */
+    value: unknown;
+    mixed?: boolean;
+    unset?: boolean;
+    /** The object the leaf is a field of, for an enum `encoding` and a font's
+     *  weight and slant. `undefined` for a top-level leaf. */
+    siblings?: Record<string, unknown>;
+    /** Writes a value in the leaf's stored form. */
+    setValue: (value: unknown) => void;
+    /** A font family's weight and slant, where they are not `siblings`' own
+     *  `fontWeight` / `fontStyle`. */
+    fontVariant?: {
+        weight?: unknown;
+        style?: unknown;
+    };
+}
+/**
+ * A schema leaf as {@link PropertyControl} props: its value, bounds and
+ * options in the form it is shown in, and a writer that stores what the
+ * control reports in the form the leaf holds.
+ *
+ * The conversions every schema-driven surface needs live here once — a
+ * number's display unit and its bounds, an enum's `encoding`, a color's
+ * alpha, an icon resolved to a glyph. A leaf that is not a single control —
+ * an `object`, whose fields each are, or an app-defined kind — returns
+ * `null`, and the surface draws it.
+ *
+ * Spread the result and add what the surface decides: `chrome`, `name`, a
+ * class, a different default `control`.
+ */
+export declare function prefFieldProps(leaf: PrefLeaf, state: PrefFieldState): PropertyControlProps | null;
+//# sourceMappingURL=prefField.d.ts.map

package/dist/components/Prefs/prefField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefField.d.ts","sourceRoot":"","sources":["../../../src/components/Prefs/prefField.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAsC,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAE7E,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;8DAC0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,gDAAgD;IAChD,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC;sCACkC;IAClC,WAAW,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACrD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,GAAG,oBAAoB,GAAG,IAAI,CAqIjG"}

package/dist/components/Prefs/schema.d.ts

@@ -30,4 +30,34 @@ export declare function prefValueAtPath(values: unknown, path: string): unknown;
  * that end up empty. Returns null when the entire subtree is hidden.
  */
 export declare function visiblePrefSubtree<T extends ToolPrefLeaf | ToolPrefGroup>(node: T, showHidden: boolean): T | null;
+/** One entry in a {@link PrefsForm} rail: a group the reader can navigate to. */
+export interface PrefRailItem {
+    /** Dotted path of the group. Empty for the entry holding loose root leaves. */
+    path: string;
+    name: string;
+    /** 0 opens a pane; 1 scrolls within the open one. The rail goes no deeper. */
+    depth: 0 | 1;
+    /** Path of the depth-0 ancestor — its own path when `depth` is 0. */
+    section: string;
+    /** Leaves surviving the active filter, counted over the whole subtree. */
+    matches: number;
+}
+/**
+ * The rail's model for a schema: depth-0 groups, each followed by its depth-1
+ * children. Deeper groups render inside a pane and get no entry — a schema
+ * that nests ten deep still navigates two levels.
+ *
+ * Loose leaves directly under the root lead the list under an entry named for
+ * the root itself, since they belong to no group that could name them.
+ */
+export declare function prefRailItems(root: ToolPrefGroup): PrefRailItem[];
+/**
+ * Drop every leaf that does not answer to `query`, pruning groups left empty.
+ * A group whose own name matches keeps all of its leaves — a reader who typed
+ * the group's name is asking for the group, not for leaves repeating it.
+ *
+ * An empty or whitespace query matches everything, so a cleared field restores
+ * the tree rather than emptying it.
+ */
+export declare function filterPrefSubtree<T extends ToolPrefLeaf | ToolPrefGroup>(node: T, query: string, path?: string): T | null;
 //# sourceMappingURL=schema.d.ts.map

package/dist/components/Prefs/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/components/Prefs/schema.ts"],"names":[],"mappings":"AAKA,YAAY,EACV,QAAQ,IAAI,WAAW,EACvB,eAAe,IAAI,WAAW,EAC9B,sBAAsB,IAAI,kBAAkB,EAC5C,aAAa,IAAI,SAAS,EAC1B,cAAc,IAAI,UAAU,EAC5B,YAAY,IAAI,QAAQ,EACxB,mBAAmB,IAAI,eAAe,EACtC,oBAAoB,IAAI,gBAAgB,EACxC,aAAa,IAAI,SAAS,EAC1B,YAAY,IAAI,QAAQ,EACxB,YAAY,IAAI,QAAQ,EACxB,cAAc,IAAI,UAAU,EAC5B,qBAAqB,IAAI,iBAAiB,EAC1C,oBAAoB,IAAI,gBAAgB,EACxC,kBAAkB,IAAI,cAAc,EACpC,cAAc,IAAI,UAAU,EAC5B,aAAa,IAAI,SAAS,EAC1B,cAAc,IAAI,UAAU,EAC5B,qBAAqB,IAAI,iBAAiB,GAC3C,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,IAAI,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE7H;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,cAAc,GAChB;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAU9C;AAED;2CAC2C;AAC3C,wBAAgB,eAAe,CAAC,IAAI,EAAE,kBAAkB,GAAG,QAAQ,CAAC,SAAS,CAAC,CAE7E;AAED,qEAAqE;AACrE,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,aAAa,GAAG,IAAI,IAAI,YAAY,CAEnF;AAED;kEACkE;AAClE,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAOtE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,YAAY,GAAG,aAAa,EACvE,IAAI,EAAE,CAAC,EACP,UAAU,EAAE,OAAO,GAClB,CAAC,GAAG,IAAI,CAUV"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/components/Prefs/schema.ts"],"names":[],"mappings":"AAKA,YAAY,EACV,QAAQ,IAAI,WAAW,EACvB,eAAe,IAAI,WAAW,EAC9B,sBAAsB,IAAI,kBAAkB,EAC5C,aAAa,IAAI,SAAS,EAC1B,cAAc,IAAI,UAAU,EAC5B,YAAY,IAAI,QAAQ,EACxB,mBAAmB,IAAI,eAAe,EACtC,oBAAoB,IAAI,gBAAgB,EACxC,aAAa,IAAI,SAAS,EAC1B,YAAY,IAAI,QAAQ,EACxB,YAAY,IAAI,QAAQ,EACxB,cAAc,IAAI,UAAU,EAC5B,qBAAqB,IAAI,iBAAiB,EAC1C,oBAAoB,IAAI,gBAAgB,EACxC,kBAAkB,IAAI,cAAc,EACpC,cAAc,IAAI,UAAU,EAC5B,aAAa,IAAI,SAAS,EAC1B,cAAc,IAAI,UAAU,EAC5B,qBAAqB,IAAI,iBAAiB,GAC3C,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,IAAI,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE7H;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,cAAc,GAChB;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAU9C;AAED;2CAC2C;AAC3C,wBAAgB,eAAe,CAAC,IAAI,EAAE,kBAAkB,GAAG,QAAQ,CAAC,SAAS,CAAC,CAE7E;AAED,qEAAqE;AACrE,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,aAAa,GAAG,IAAI,IAAI,YAAY,CAEnF;AAED;kEACkE;AAClE,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAOtE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,YAAY,GAAG,aAAa,EACvE,IAAI,EAAE,CAAC,EACP,UAAU,EAAE,OAAO,GAClB,CAAC,GAAG,IAAI,CAUV;AAED,iFAAiF;AACjF,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;IACb,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;CACjB;AAUD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,EAAE,CA2BjE;AASD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,YAAY,GAAG,aAAa,EACtE,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,MAAM,EACb,IAAI,SAAK,GACR,CAAC,GAAG,IAAI,CAaV"}

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,14 @@
 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;
@@ -38,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, description, hidden, collapsible, defaultCollapsed, collapsed, onCollapsedChange, children, className, span, 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,EAGzB,MAAM,iBAAiB,CAAC;AAEzB,mCAAmC;AACnC,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,gEAAgE;IAChE,KAAK,EAAE,SAAS,CAAC;IACjB;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;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,WAAW,EACX,MAAM,EACN,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,iBAAiB,EACjB,QAAQ,EACR,SAAS,EACT,IAAI,EACJ,IAAmB,EACnB,OAAO,EACP,KAAK,GACN,EAAE,kBAAkB,kDA4CpB"}
+{"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"}