@elaraai/east-ui 1.0.67 → 1.0.69

package/dist/src/pick/index.d.ts

@@ -0,0 +1,443 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The `Pick` namespace — choosing which of a component's declared things show.
+ *
+ * @remarks
+ * Assembled HERE rather than beside the contract, for the same reason `Slice`
+ * is: `Pick.Panel` needs `UIComponentType`, and `component.ts` imports the
+ * contract. Splitting the namespace from the vocabulary is what keeps
+ * `contracts/pick.ts` importable by `component.ts` with no cycle.
+ *
+ * @packageDocumentation
+ */
+import { createPickState, createPickBind, pickActive, pickVisible, pickItems } from "../contracts/pick.js";
+import { createPickPanel } from "./panel/index.js";
+export { type PickPanelOptions, createPickPanel } from "./panel/index.js";
+/**
+ * The `Pick` namespace.
+ *
+ * @remarks
+ * Bind a list with {@link Pick.bind}, feed the survivors to the component with
+ * {@link Pick.active}, and render the library with {@link Pick.Panel}. The
+ * handle is what decouples them: the panel never imports the component, and the
+ * component never learns a panel exists.
+ *
+ * @example
+ * ```tsx
+ * const shown = $.let(Pick.bind("ops.series", all, { id: s => s.key, title: s => s.name }));
+ * <Pick.Panel value={shown} title="Series" />
+ * <Plan axis={axis} data={ops} series={Pick.active(shown)} />
+ * ```
+ */
+export declare const Pick: {
+    /** Build a state seed — the ids switched off. */
+    readonly state: typeof createPickState;
+    /** Bind a list of things to a persisted pick. */
+    readonly bind: typeof createPickBind;
+    /** The items still switched on, in declaration order. */
+    readonly active: typeof pickActive;
+    /** The derivation alone — items minus a hidden list, no state binding. */
+    readonly visible: typeof pickVisible;
+    /** The library entries alone — described, with no state binding. */
+    readonly items: typeof pickItems;
+    /** The library panel — one row per thing, with an eye. */
+    readonly Panel: typeof createPickPanel;
+    /** East types — the contract, for `$.const` / `$.let` annotations. */
+    readonly Types: {
+        /** The ids switched off (an empty list shows everything). */
+        readonly State: import("@elaraai/east").ArrayType<import("@elaraai/east").StringType>;
+        /** One pickable thing as the panel sees it. */
+        readonly Item: import("@elaraai/east").StructType<{
+            readonly id: import("@elaraai/east").StringType;
+            readonly title: import("@elaraai/east").StringType;
+            readonly subtitle: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+            readonly icon: import("@elaraai/east").OptionType<import("@elaraai/east").StructType<{
+                readonly name: import("@elaraai/east").StringType;
+                readonly prefix: import("@elaraai/east").StringType;
+                readonly label: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                readonly style: import("@elaraai/east").OptionType<import("@elaraai/east").StructType<{
+                    readonly size: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                        readonly xs: import("@elaraai/east").NullType;
+                        readonly sm: import("@elaraai/east").NullType;
+                        readonly md: import("@elaraai/east").NullType;
+                        readonly lg: import("@elaraai/east").NullType;
+                        readonly xl: import("@elaraai/east").NullType;
+                        readonly "2xl": import("@elaraai/east").NullType;
+                    }>>;
+                    readonly variant: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                        readonly solid: import("@elaraai/east").NullType;
+                        readonly regular: import("@elaraai/east").NullType;
+                        readonly light: import("@elaraai/east").NullType;
+                        readonly thin: import("@elaraai/east").NullType;
+                        readonly brands: import("@elaraai/east").NullType;
+                    }>>;
+                    readonly color: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                    readonly background: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                    readonly colorPalette: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                        readonly brand: import("@elaraai/east").NullType;
+                        readonly gray: import("@elaraai/east").NullType;
+                        readonly red: import("@elaraai/east").NullType;
+                        readonly orange: import("@elaraai/east").NullType;
+                        readonly yellow: import("@elaraai/east").NullType;
+                        readonly green: import("@elaraai/east").NullType;
+                        readonly teal: import("@elaraai/east").NullType;
+                        readonly blue: import("@elaraai/east").NullType;
+                        readonly cyan: import("@elaraai/east").NullType;
+                        readonly purple: import("@elaraai/east").NullType;
+                        readonly pink: import("@elaraai/east").NullType;
+                        readonly success: import("@elaraai/east").NullType;
+                        readonly warning: import("@elaraai/east").NullType;
+                        readonly danger: import("@elaraai/east").NullType;
+                        readonly info: import("@elaraai/east").NullType;
+                        readonly neutral: import("@elaraai/east").NullType;
+                    }>>;
+                    readonly opacity: import("@elaraai/east").OptionType<import("@elaraai/east").FloatType>;
+                    readonly borderRadius: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                    readonly overflow: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                        readonly visible: import("@elaraai/east").NullType;
+                        readonly hidden: import("@elaraai/east").NullType;
+                        readonly scroll: import("@elaraai/east").NullType;
+                        readonly auto: import("@elaraai/east").NullType;
+                    }>>;
+                    readonly overflowX: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                        readonly visible: import("@elaraai/east").NullType;
+                        readonly hidden: import("@elaraai/east").NullType;
+                        readonly scroll: import("@elaraai/east").NullType;
+                        readonly auto: import("@elaraai/east").NullType;
+                    }>>;
+                    readonly overflowY: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                        readonly visible: import("@elaraai/east").NullType;
+                        readonly hidden: import("@elaraai/east").NullType;
+                        readonly scroll: import("@elaraai/east").NullType;
+                        readonly auto: import("@elaraai/east").NullType;
+                    }>>;
+                    readonly width: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                    readonly height: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                    readonly minWidth: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                    readonly minHeight: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                    readonly maxWidth: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                    readonly maxHeight: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                    readonly padding: import("@elaraai/east").OptionType<import("@elaraai/east").StructType<{
+                        readonly top: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                        readonly right: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                        readonly bottom: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                        readonly left: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                    }>>;
+                    readonly margin: import("@elaraai/east").OptionType<import("@elaraai/east").StructType<{
+                        readonly top: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                        readonly right: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                        readonly bottom: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                        readonly left: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                    }>>;
+                }>>;
+            }>>;
+            readonly count: import("@elaraai/east").OptionType<import("@elaraai/east").IntegerType>;
+            readonly narrowed: import("@elaraai/east").BooleanType;
+        }>;
+        /** The state binding — `State.bind`'s shape at {@link PickStateType}. */
+        readonly StateHandle: import("@elaraai/east").StructType<{
+            readonly read: import("@elaraai/east").FunctionType<[], import("@elaraai/east").ArrayType<import("@elaraai/east").StringType>>;
+            readonly write: import("@elaraai/east").FunctionType<[import("@elaraai/east").ArrayType<import("@elaraai/east").StringType>], import("@elaraai/east").NullType>;
+            readonly has: import("@elaraai/east").FunctionType<[], import("@elaraai/east").BooleanType>;
+        }>;
+        /** The non-generic contract a component's IR holds. */
+        readonly Bind: import("@elaraai/east").StructType<{
+            readonly key: import("@elaraai/east").StringType;
+            readonly state: import("@elaraai/east").StructType<{
+                readonly read: import("@elaraai/east").FunctionType<[], import("@elaraai/east").ArrayType<import("@elaraai/east").StringType>>;
+                readonly write: import("@elaraai/east").FunctionType<[import("@elaraai/east").ArrayType<import("@elaraai/east").StringType>], import("@elaraai/east").NullType>;
+                readonly has: import("@elaraai/east").FunctionType<[], import("@elaraai/east").BooleanType>;
+            }>;
+            readonly items: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+                readonly id: import("@elaraai/east").StringType;
+                readonly title: import("@elaraai/east").StringType;
+                readonly subtitle: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                readonly icon: import("@elaraai/east").OptionType<import("@elaraai/east").StructType<{
+                    readonly name: import("@elaraai/east").StringType;
+                    readonly prefix: import("@elaraai/east").StringType;
+                    readonly label: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                    readonly style: import("@elaraai/east").OptionType<import("@elaraai/east").StructType<{
+                        readonly size: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                            readonly xs: import("@elaraai/east").NullType;
+                            readonly sm: import("@elaraai/east").NullType;
+                            readonly md: import("@elaraai/east").NullType;
+                            readonly lg: import("@elaraai/east").NullType;
+                            readonly xl: import("@elaraai/east").NullType;
+                            readonly "2xl": import("@elaraai/east").NullType;
+                        }>>;
+                        readonly variant: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                            readonly solid: import("@elaraai/east").NullType;
+                            readonly regular: import("@elaraai/east").NullType;
+                            readonly light: import("@elaraai/east").NullType;
+                            readonly thin: import("@elaraai/east").NullType;
+                            readonly brands: import("@elaraai/east").NullType;
+                        }>>;
+                        readonly color: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                        readonly background: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                        readonly colorPalette: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                            readonly brand: import("@elaraai/east").NullType;
+                            readonly gray: import("@elaraai/east").NullType;
+                            readonly red: import("@elaraai/east").NullType;
+                            readonly orange: import("@elaraai/east").NullType;
+                            readonly yellow: import("@elaraai/east").NullType;
+                            readonly green: import("@elaraai/east").NullType;
+                            readonly teal: import("@elaraai/east").NullType;
+                            readonly blue: import("@elaraai/east").NullType;
+                            readonly cyan: import("@elaraai/east").NullType;
+                            readonly purple: import("@elaraai/east").NullType;
+                            readonly pink: import("@elaraai/east").NullType;
+                            readonly success: import("@elaraai/east").NullType;
+                            readonly warning: import("@elaraai/east").NullType;
+                            readonly danger: import("@elaraai/east").NullType;
+                            readonly info: import("@elaraai/east").NullType;
+                            readonly neutral: import("@elaraai/east").NullType;
+                        }>>;
+                        readonly opacity: import("@elaraai/east").OptionType<import("@elaraai/east").FloatType>;
+                        readonly borderRadius: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                        readonly overflow: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                            readonly visible: import("@elaraai/east").NullType;
+                            readonly hidden: import("@elaraai/east").NullType;
+                            readonly scroll: import("@elaraai/east").NullType;
+                            readonly auto: import("@elaraai/east").NullType;
+                        }>>;
+                        readonly overflowX: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                            readonly visible: import("@elaraai/east").NullType;
+                            readonly hidden: import("@elaraai/east").NullType;
+                            readonly scroll: import("@elaraai/east").NullType;
+                            readonly auto: import("@elaraai/east").NullType;
+                        }>>;
+                        readonly overflowY: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                            readonly visible: import("@elaraai/east").NullType;
+                            readonly hidden: import("@elaraai/east").NullType;
+                            readonly scroll: import("@elaraai/east").NullType;
+                            readonly auto: import("@elaraai/east").NullType;
+                        }>>;
+                        readonly width: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                        readonly height: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                        readonly minWidth: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                        readonly minHeight: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                        readonly maxWidth: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                        readonly maxHeight: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                        readonly padding: import("@elaraai/east").OptionType<import("@elaraai/east").StructType<{
+                            readonly top: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly right: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly bottom: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly left: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                        }>>;
+                        readonly margin: import("@elaraai/east").OptionType<import("@elaraai/east").StructType<{
+                            readonly top: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly right: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly bottom: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly left: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                        }>>;
+                    }>>;
+                }>>;
+                readonly count: import("@elaraai/east").OptionType<import("@elaraai/east").IntegerType>;
+                readonly narrowed: import("@elaraai/east").BooleanType;
+            }>>;
+        }>;
+        /** The `Pick.Panel` component payload. */
+        readonly Panel: import("@elaraai/east").StructType<{
+            readonly pick: import("@elaraai/east").StructType<{
+                readonly key: import("@elaraai/east").StringType;
+                readonly state: import("@elaraai/east").StructType<{
+                    readonly read: import("@elaraai/east").FunctionType<[], import("@elaraai/east").ArrayType<import("@elaraai/east").StringType>>;
+                    readonly write: import("@elaraai/east").FunctionType<[import("@elaraai/east").ArrayType<import("@elaraai/east").StringType>], import("@elaraai/east").NullType>;
+                    readonly has: import("@elaraai/east").FunctionType<[], import("@elaraai/east").BooleanType>;
+                }>;
+                readonly items: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+                    readonly id: import("@elaraai/east").StringType;
+                    readonly title: import("@elaraai/east").StringType;
+                    readonly subtitle: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                    readonly icon: import("@elaraai/east").OptionType<import("@elaraai/east").StructType<{
+                        readonly name: import("@elaraai/east").StringType;
+                        readonly prefix: import("@elaraai/east").StringType;
+                        readonly label: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                        readonly style: import("@elaraai/east").OptionType<import("@elaraai/east").StructType<{
+                            readonly size: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                                readonly xs: import("@elaraai/east").NullType;
+                                readonly sm: import("@elaraai/east").NullType;
+                                readonly md: import("@elaraai/east").NullType;
+                                readonly lg: import("@elaraai/east").NullType;
+                                readonly xl: import("@elaraai/east").NullType;
+                                readonly "2xl": import("@elaraai/east").NullType;
+                            }>>;
+                            readonly variant: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                                readonly solid: import("@elaraai/east").NullType;
+                                readonly regular: import("@elaraai/east").NullType;
+                                readonly light: import("@elaraai/east").NullType;
+                                readonly thin: import("@elaraai/east").NullType;
+                                readonly brands: import("@elaraai/east").NullType;
+                            }>>;
+                            readonly color: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly background: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly colorPalette: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                                readonly brand: import("@elaraai/east").NullType;
+                                readonly gray: import("@elaraai/east").NullType;
+                                readonly red: import("@elaraai/east").NullType;
+                                readonly orange: import("@elaraai/east").NullType;
+                                readonly yellow: import("@elaraai/east").NullType;
+                                readonly green: import("@elaraai/east").NullType;
+                                readonly teal: import("@elaraai/east").NullType;
+                                readonly blue: import("@elaraai/east").NullType;
+                                readonly cyan: import("@elaraai/east").NullType;
+                                readonly purple: import("@elaraai/east").NullType;
+                                readonly pink: import("@elaraai/east").NullType;
+                                readonly success: import("@elaraai/east").NullType;
+                                readonly warning: import("@elaraai/east").NullType;
+                                readonly danger: import("@elaraai/east").NullType;
+                                readonly info: import("@elaraai/east").NullType;
+                                readonly neutral: import("@elaraai/east").NullType;
+                            }>>;
+                            readonly opacity: import("@elaraai/east").OptionType<import("@elaraai/east").FloatType>;
+                            readonly borderRadius: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly overflow: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                                readonly visible: import("@elaraai/east").NullType;
+                                readonly hidden: import("@elaraai/east").NullType;
+                                readonly scroll: import("@elaraai/east").NullType;
+                                readonly auto: import("@elaraai/east").NullType;
+                            }>>;
+                            readonly overflowX: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                                readonly visible: import("@elaraai/east").NullType;
+                                readonly hidden: import("@elaraai/east").NullType;
+                                readonly scroll: import("@elaraai/east").NullType;
+                                readonly auto: import("@elaraai/east").NullType;
+                            }>>;
+                            readonly overflowY: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                                readonly visible: import("@elaraai/east").NullType;
+                                readonly hidden: import("@elaraai/east").NullType;
+                                readonly scroll: import("@elaraai/east").NullType;
+                                readonly auto: import("@elaraai/east").NullType;
+                            }>>;
+                            readonly width: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly height: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly minWidth: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly minHeight: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly maxWidth: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly maxHeight: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly padding: import("@elaraai/east").OptionType<import("@elaraai/east").StructType<{
+                                readonly top: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                                readonly right: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                                readonly bottom: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                                readonly left: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            }>>;
+                            readonly margin: import("@elaraai/east").OptionType<import("@elaraai/east").StructType<{
+                                readonly top: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                                readonly right: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                                readonly bottom: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                                readonly left: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            }>>;
+                        }>>;
+                    }>>;
+                    readonly count: import("@elaraai/east").OptionType<import("@elaraai/east").IntegerType>;
+                    readonly narrowed: import("@elaraai/east").BooleanType;
+                }>>;
+            }>;
+            readonly title: import("@elaraai/east").StringType;
+        }>;
+        /** The author's handle, at an item type. */
+        readonly Handle: <I extends import("@elaraai/east").EastType>(i: I) => import("@elaraai/east").StructType<{
+            readonly pick: import("@elaraai/east").StructType<{
+                readonly key: import("@elaraai/east").StringType;
+                readonly state: import("@elaraai/east").StructType<{
+                    readonly read: import("@elaraai/east").FunctionType<[], import("@elaraai/east").ArrayType<import("@elaraai/east").StringType>>;
+                    readonly write: import("@elaraai/east").FunctionType<[import("@elaraai/east").ArrayType<import("@elaraai/east").StringType>], import("@elaraai/east").NullType>;
+                    readonly has: import("@elaraai/east").FunctionType<[], import("@elaraai/east").BooleanType>;
+                }>;
+                readonly items: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+                    readonly id: import("@elaraai/east").StringType;
+                    readonly title: import("@elaraai/east").StringType;
+                    readonly subtitle: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                    readonly icon: import("@elaraai/east").OptionType<import("@elaraai/east").StructType<{
+                        readonly name: import("@elaraai/east").StringType;
+                        readonly prefix: import("@elaraai/east").StringType;
+                        readonly label: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                        readonly style: import("@elaraai/east").OptionType<import("@elaraai/east").StructType<{
+                            readonly size: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                                readonly xs: import("@elaraai/east").NullType;
+                                readonly sm: import("@elaraai/east").NullType;
+                                readonly md: import("@elaraai/east").NullType;
+                                readonly lg: import("@elaraai/east").NullType;
+                                readonly xl: import("@elaraai/east").NullType;
+                                readonly "2xl": import("@elaraai/east").NullType;
+                            }>>;
+                            readonly variant: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                                readonly solid: import("@elaraai/east").NullType;
+                                readonly regular: import("@elaraai/east").NullType;
+                                readonly light: import("@elaraai/east").NullType;
+                                readonly thin: import("@elaraai/east").NullType;
+                                readonly brands: import("@elaraai/east").NullType;
+                            }>>;
+                            readonly color: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly background: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly colorPalette: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                                readonly brand: import("@elaraai/east").NullType;
+                                readonly gray: import("@elaraai/east").NullType;
+                                readonly red: import("@elaraai/east").NullType;
+                                readonly orange: import("@elaraai/east").NullType;
+                                readonly yellow: import("@elaraai/east").NullType;
+                                readonly green: import("@elaraai/east").NullType;
+                                readonly teal: import("@elaraai/east").NullType;
+                                readonly blue: import("@elaraai/east").NullType;
+                                readonly cyan: import("@elaraai/east").NullType;
+                                readonly purple: import("@elaraai/east").NullType;
+                                readonly pink: import("@elaraai/east").NullType;
+                                readonly success: import("@elaraai/east").NullType;
+                                readonly warning: import("@elaraai/east").NullType;
+                                readonly danger: import("@elaraai/east").NullType;
+                                readonly info: import("@elaraai/east").NullType;
+                                readonly neutral: import("@elaraai/east").NullType;
+                            }>>;
+                            readonly opacity: import("@elaraai/east").OptionType<import("@elaraai/east").FloatType>;
+                            readonly borderRadius: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly overflow: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                                readonly visible: import("@elaraai/east").NullType;
+                                readonly hidden: import("@elaraai/east").NullType;
+                                readonly scroll: import("@elaraai/east").NullType;
+                                readonly auto: import("@elaraai/east").NullType;
+                            }>>;
+                            readonly overflowX: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                                readonly visible: import("@elaraai/east").NullType;
+                                readonly hidden: import("@elaraai/east").NullType;
+                                readonly scroll: import("@elaraai/east").NullType;
+                                readonly auto: import("@elaraai/east").NullType;
+                            }>>;
+                            readonly overflowY: import("@elaraai/east").OptionType<import("@elaraai/east").VariantType<{
+                                readonly visible: import("@elaraai/east").NullType;
+                                readonly hidden: import("@elaraai/east").NullType;
+                                readonly scroll: import("@elaraai/east").NullType;
+                                readonly auto: import("@elaraai/east").NullType;
+                            }>>;
+                            readonly width: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly height: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly minWidth: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly minHeight: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly maxWidth: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly maxHeight: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            readonly padding: import("@elaraai/east").OptionType<import("@elaraai/east").StructType<{
+                                readonly top: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                                readonly right: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                                readonly bottom: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                                readonly left: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            }>>;
+                            readonly margin: import("@elaraai/east").OptionType<import("@elaraai/east").StructType<{
+                                readonly top: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                                readonly right: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                                readonly bottom: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                                readonly left: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                            }>>;
+                        }>>;
+                    }>>;
+                    readonly count: import("@elaraai/east").OptionType<import("@elaraai/east").IntegerType>;
+                    readonly narrowed: import("@elaraai/east").BooleanType;
+                }>>;
+            }>;
+            readonly all: import("@elaraai/east").ArrayType<I>;
+            readonly id: import("@elaraai/east").FunctionType<[I], import("@elaraai/east").StringType>;
+        }>;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/src/pick/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pick/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;GAUG;AAEH,OAAO,EACH,eAAe,EACf,cAAc,EACd,UAAU,EACV,WAAW,EACX,SAAS,EAOZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,KAAK,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE1E;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,IAAI;IACb,iDAAiD;;IAEjD,iDAAiD;;IAEjD,yDAAyD;;IAEzD,0EAA0E;;IAE1E,oEAAoE;;IAEpE,0DAA0D;;IAE1D,sEAAsE;;QAElE,6DAA6D;;QAE7D,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAE/C,yEAAyE;;;;;;QAEzE,uDAAuD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAEvD,0CAA0C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAE1C,4CAA4C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAG1C,CAAC"}

package/dist/src/pick/index.js

@@ -0,0 +1,64 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The `Pick` namespace — choosing which of a component's declared things show.
+ *
+ * @remarks
+ * Assembled HERE rather than beside the contract, for the same reason `Slice`
+ * is: `Pick.Panel` needs `UIComponentType`, and `component.ts` imports the
+ * contract. Splitting the namespace from the vocabulary is what keeps
+ * `contracts/pick.ts` importable by `component.ts` with no cycle.
+ *
+ * @packageDocumentation
+ */
+import { createPickState, createPickBind, pickActive, pickVisible, pickItems, PickStateType, PickItemType, PickStateHandleType, PickBindType, PickPanelType, PickHandleType, } from "../contracts/pick.js";
+import { createPickPanel } from "./panel/index.js";
+export { createPickPanel } from "./panel/index.js";
+/**
+ * The `Pick` namespace.
+ *
+ * @remarks
+ * Bind a list with {@link Pick.bind}, feed the survivors to the component with
+ * {@link Pick.active}, and render the library with {@link Pick.Panel}. The
+ * handle is what decouples them: the panel never imports the component, and the
+ * component never learns a panel exists.
+ *
+ * @example
+ * ```tsx
+ * const shown = $.let(Pick.bind("ops.series", all, { id: s => s.key, title: s => s.name }));
+ * <Pick.Panel value={shown} title="Series" />
+ * <Plan axis={axis} data={ops} series={Pick.active(shown)} />
+ * ```
+ */
+export const Pick = {
+    /** Build a state seed — the ids switched off. */
+    state: createPickState,
+    /** Bind a list of things to a persisted pick. */
+    bind: createPickBind,
+    /** The items still switched on, in declaration order. */
+    active: pickActive,
+    /** The derivation alone — items minus a hidden list, no state binding. */
+    visible: pickVisible,
+    /** The library entries alone — described, with no state binding. */
+    items: pickItems,
+    /** The library panel — one row per thing, with an eye. */
+    Panel: createPickPanel,
+    /** East types — the contract, for `$.const` / `$.let` annotations. */
+    Types: {
+        /** The ids switched off (an empty list shows everything). */
+        State: PickStateType,
+        /** One pickable thing as the panel sees it. */
+        Item: PickItemType,
+        /** The state binding — `State.bind`'s shape at {@link PickStateType}. */
+        StateHandle: PickStateHandleType,
+        /** The non-generic contract a component's IR holds. */
+        Bind: PickBindType,
+        /** The `Pick.Panel` component payload. */
+        Panel: PickPanelType,
+        /** The author's handle, at an item type. */
+        Handle: PickHandleType,
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/src/pick/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/pick/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;GAUG;AAEH,OAAO,EACH,eAAe,EACf,cAAc,EACd,UAAU,EACV,WAAW,EACX,SAAS,EACT,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,cAAc,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAyB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE1E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAChB,iDAAiD;IACjD,KAAK,EAAE,eAAe;IACtB,iDAAiD;IACjD,IAAI,EAAE,cAAc;IACpB,yDAAyD;IACzD,MAAM,EAAE,UAAU;IAClB,0EAA0E;IAC1E,OAAO,EAAE,WAAW;IACpB,oEAAoE;IACpE,KAAK,EAAE,SAAS;IAChB,0DAA0D;IAC1D,KAAK,EAAE,eAAe;IACtB,sEAAsE;IACtE,KAAK,EAAE;QACH,6DAA6D;QAC7D,KAAK,EAAE,aAAa;QACpB,+CAA+C;QAC/C,IAAI,EAAE,YAAY;QAClB,yEAAyE;QACzE,WAAW,EAAE,mBAAmB;QAChC,uDAAuD;QACvD,IAAI,EAAE,YAAY;QAClB,0CAA0C;QAC1C,KAAK,EAAE,aAAa;QACpB,4CAA4C;QAC5C,MAAM,EAAE,cAAc;KACzB;CACK,CAAC"}

package/dist/src/pick/panel/index.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `Pick.Panel` — the component half of the pick contract (#590).
+ *
+ * The factory lives here rather than beside the contract in `contracts/pick.ts`
+ * for the reason every component factory does: it needs `UIComponentType`, and
+ * `component.ts` imports the contract. Keeping the contract free of the
+ * component type is what lets the arm reference `PickPanelType` by name instead
+ * of hand-syncing an inline copy.
+ *
+ * @packageDocumentation
+ */
+import { type EastType, type ExprType, type SubtypeExprOrValue, StringType } from "@elaraai/east";
+import { UIComponentType } from "../../component.js";
+import { type PickHandle } from "../../contracts/pick.js";
+/** Options for `Pick.Panel`. */
+export interface PickPanelOptions<I extends EastType> {
+    /** The handle from `Pick.bind`. */
+    value: PickHandle<I>;
+    /**
+     * The author's noun for what is being picked — `"Series"` / `"Columns"` /
+     * `"Layers"`. Required, because the contract holds identified things and
+     * genuinely cannot know what they are.
+     */
+    title: SubtypeExprOrValue<StringType>;
+}
+/**
+ * Creates a `Pick.Panel` — the library of a component's declared things, one
+ * row each, with an eye to switch it off.
+ *
+ * @remarks
+ * Only the handle's non-generic `pick` field is stored. That projection is the
+ * whole mechanism: the item type stops here, so a single `UIComponentType` arm
+ * serves every adopter and the panel mounts anywhere — beside the component, in
+ * a `Drawer`, behind a toolbar chip — without importing it.
+ *
+ * Mount it inside the SAME `Reactive.Root` that binds the handle and renders the
+ * component. A reactive body is a free function and cannot capture a `$.let`
+ * handle from an enclosing scope, so a panel that is its own root would have to
+ * re-bind with its own copy of the item list.
+ *
+ * @typeParam I - The item type being picked over
+ * @param options - The handle and the author's noun ({@link PickPanelOptions})
+ * @returns An East expression of type `UIComponentType`
+ *
+ * @example
+ * ```tsx
+ * <Reactive>{$ => {
+ *     const all = $.const(LIBRARY, ArrayType(ITEM));
+ *     const shown = $.let(Pick.bind("ops.series", all, { id: x => x.key, title: x => x.name }));
+ *     return (
+ *         <HStack gap="4" align="start">
+ *             <Pick.Panel value={shown} title="Series" />
+ *             <Plan axis={axis} data={ops} series={Pick.active(shown)} />
+ *         </HStack>
+ *     );
+ * }}</Reactive>
+ * ```
+ */
+export declare function createPickPanel<I extends EastType>(options: PickPanelOptions<I>): ExprType<UIComponentType>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/pick/panel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/pick/panel/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;GAUG;AAEH,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAEvB,UAAU,EAGb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAExE,gCAAgC;AAChC,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,QAAQ;IAChD,mCAAmC;IACnC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACrB;;;;OAIG;IACH,KAAK,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,QAAQ,EAC9C,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC7B,QAAQ,CAAC,eAAe,CAAC,CAQ3B"}