@elaraai/east-ui 1.0.94 → 1.0.95

package/dist/src/platform/slice/record-chrome.d.ts

@@ -4,7 +4,7 @@
  */
 /** Record-only chrome, separate from the frozen local Slice wire. */
 import { ArrayType, NullType, OptionType, StructType, VariantType, type SubtypeExprOrValue, type ExprType } from "@elaraai/east";
-import { RecordSliceBindType } from "./record-types.js";
+import { RecordSliceBindType, RecordSlicesBindType } from "./record-types.js";
 import { SlicePersistType } from "./index.js";
 /** Controls a record can answer without evaluating row predicates. */
 export declare const RecordSliceAffordanceType: VariantType<{
@@ -174,6 +174,14 @@ export declare const RecordSliceChromeType: StructType<{
             }>;
             readonly prefix: import("@elaraai/east").StringType;
         }>>, import("@elaraai/east").StringType], OptionType<import("@elaraai/east").BooleanType>>;
+        readonly containsRow: import("@elaraai/east").FunctionType<[import("@elaraai/east").DictType<import("@elaraai/east").StringType, VariantType<{
+            readonly values: ArrayType<import("@elaraai/east").StringType>;
+            readonly range: StructType<{
+                readonly from: import("@elaraai/east").StringType;
+                readonly to: import("@elaraai/east").StringType;
+            }>;
+            readonly prefix: import("@elaraai/east").StringType;
+        }>>, import("@elaraai/east").StringType, import("@elaraai/east").BlobType], OptionType<import("@elaraai/east").BooleanType>>;
     }>;
     readonly affordances: ArrayType<VariantType<{
         readonly fields: NullType;
@@ -208,4 +216,293 @@ export declare function isRecordSlice(input: unknown): boolean;
  * @returns The record chrome payload.
  */
 export declare function recordSliceChrome(options: RecordSliceChromeOptions): ExprType<RecordSliceChromeType>;
+/**
+ * Narrowing over several records in a component's existing toolbar: one rail
+ * for every source.
+ * @property slice - The product's non-generic handle; each source's typed data stays in the component's source.
+ * @property affordances - Explicit controls the host offers, for every source.
+ * @property persist - Optional store persistence, for every source under its own key.
+ */
+export declare const RecordSlicesChromeType: StructType<{
+    readonly slice: StructType<{
+        readonly key: import("@elaraai/east").StringType;
+        readonly parts: ArrayType<StructType<{
+            readonly source: import("@elaraai/east").StringType;
+            readonly label: OptionType<import("@elaraai/east").StringType>;
+            readonly icon: OptionType<StructType<{
+                readonly name: import("@elaraai/east").StringType;
+                readonly prefix: import("@elaraai/east").StringType;
+                readonly label: OptionType<import("@elaraai/east").StringType>;
+                readonly style: OptionType<StructType<{
+                    readonly size: OptionType<VariantType<{
+                        readonly xs: NullType;
+                        readonly sm: NullType;
+                        readonly md: NullType;
+                        readonly lg: NullType;
+                        readonly xl: NullType;
+                        readonly "2xl": NullType;
+                    }>>;
+                    readonly variant: OptionType<VariantType<{
+                        readonly solid: NullType;
+                    }>>;
+                    readonly color: OptionType<import("@elaraai/east").StringType>;
+                    readonly background: OptionType<import("@elaraai/east").StringType>;
+                    readonly colorPalette: OptionType<VariantType<{
+                        readonly brand: NullType;
+                        readonly gray: NullType;
+                        readonly red: NullType;
+                        readonly orange: NullType;
+                        readonly yellow: NullType;
+                        readonly green: NullType;
+                        readonly teal: NullType;
+                        readonly blue: NullType;
+                        readonly cyan: NullType;
+                        readonly purple: NullType;
+                        readonly pink: NullType;
+                        readonly success: NullType;
+                        readonly warning: NullType;
+                        readonly danger: NullType;
+                        readonly info: NullType;
+                        readonly neutral: NullType;
+                    }>>;
+                    readonly opacity: OptionType<import("@elaraai/east").FloatType>;
+                    readonly borderRadius: OptionType<import("@elaraai/east").StringType>;
+                    readonly overflow: OptionType<VariantType<{
+                        readonly visible: NullType;
+                        readonly hidden: NullType;
+                        readonly scroll: NullType;
+                        readonly auto: NullType;
+                    }>>;
+                    readonly overflowX: OptionType<VariantType<{
+                        readonly visible: NullType;
+                        readonly hidden: NullType;
+                        readonly scroll: NullType;
+                        readonly auto: NullType;
+                    }>>;
+                    readonly overflowY: OptionType<VariantType<{
+                        readonly visible: NullType;
+                        readonly hidden: NullType;
+                        readonly scroll: NullType;
+                        readonly auto: NullType;
+                    }>>;
+                    readonly width: OptionType<import("@elaraai/east").StringType>;
+                    readonly height: OptionType<import("@elaraai/east").StringType>;
+                    readonly minWidth: OptionType<import("@elaraai/east").StringType>;
+                    readonly minHeight: OptionType<import("@elaraai/east").StringType>;
+                    readonly maxWidth: OptionType<import("@elaraai/east").StringType>;
+                    readonly maxHeight: OptionType<import("@elaraai/east").StringType>;
+                    readonly padding: OptionType<StructType<{
+                        readonly top: OptionType<import("@elaraai/east").StringType>;
+                        readonly right: OptionType<import("@elaraai/east").StringType>;
+                        readonly bottom: OptionType<import("@elaraai/east").StringType>;
+                        readonly left: OptionType<import("@elaraai/east").StringType>;
+                    }>>;
+                    readonly margin: OptionType<StructType<{
+                        readonly top: OptionType<import("@elaraai/east").StringType>;
+                        readonly right: OptionType<import("@elaraai/east").StringType>;
+                        readonly bottom: OptionType<import("@elaraai/east").StringType>;
+                        readonly left: OptionType<import("@elaraai/east").StringType>;
+                    }>>;
+                }>>;
+            }>>;
+            readonly slice: StructType<{
+                readonly key: import("@elaraai/east").StringType;
+                readonly config: StructType<{
+                    readonly fields: ArrayType<StructType<{
+                        readonly fieldId: import("@elaraai/east").StringType;
+                        readonly label: import("@elaraai/east").StringType;
+                        readonly kind: import("@elaraai/east").StringType;
+                        readonly optional: import("@elaraai/east").BooleanType;
+                        readonly multiple: import("@elaraai/east").BooleanType;
+                        readonly set: import("@elaraai/east").BooleanType;
+                        readonly values: ArrayType<StructType<{
+                            readonly value: import("@elaraai/east").StringType;
+                            readonly label: import("@elaraai/east").StringType;
+                        }>>;
+                        readonly format: OptionType<VariantType<{
+                            readonly number: NullType;
+                            readonly currency: StructType<{
+                                readonly code: import("@elaraai/east").StringType;
+                                readonly compact: import("@elaraai/east").BooleanType;
+                            }>;
+                            readonly percent: NullType;
+                            readonly compact: NullType;
+                            readonly date: import("@elaraai/east").StringType;
+                            readonly time: import("@elaraai/east").StringType;
+                            readonly datetime: import("@elaraai/east").StringType;
+                        }>>;
+                    }>>;
+                    readonly indexes: ArrayType<StructType<{
+                        readonly name: import("@elaraai/east").StringType;
+                        readonly fields: ArrayType<import("@elaraai/east").StringType>;
+                        readonly sets: import("@elaraai/east").SetType<import("@elaraai/east").StringType>;
+                        readonly structured: import("@elaraai/east").BooleanType;
+                        readonly interval: OptionType<StructType<{
+                            readonly from: import("@elaraai/east").StringType;
+                            readonly to: import("@elaraai/east").StringType;
+                            readonly optional: import("@elaraai/east").BooleanType;
+                        }>>;
+                    }>>;
+                    readonly range: OptionType<import("@elaraai/east").StringType>;
+                    readonly search: ArrayType<import("@elaraai/east").StringType>;
+                    readonly presets: ArrayType<StructType<{
+                        readonly id: import("@elaraai/east").StringType;
+                        readonly name: import("@elaraai/east").StringType;
+                        readonly where: import("@elaraai/east").DictType<import("@elaraai/east").StringType, VariantType<{
+                            readonly values: ArrayType<import("@elaraai/east").StringType>;
+                            readonly range: StructType<{
+                                readonly from: import("@elaraai/east").StringType;
+                                readonly to: import("@elaraai/east").StringType;
+                            }>;
+                            readonly prefix: import("@elaraai/east").StringType;
+                        }>>;
+                    }>>;
+                }>;
+                readonly read: import("@elaraai/east").FunctionType<[], StructType<{
+                    readonly where: import("@elaraai/east").DictType<import("@elaraai/east").StringType, VariantType<{
+                        readonly values: ArrayType<import("@elaraai/east").StringType>;
+                        readonly range: StructType<{
+                            readonly from: import("@elaraai/east").StringType;
+                            readonly to: import("@elaraai/east").StringType;
+                        }>;
+                        readonly prefix: import("@elaraai/east").StringType;
+                    }>>;
+                    readonly preset: OptionType<import("@elaraai/east").StringType>;
+                    readonly resolution: OptionType<VariantType<{
+                        readonly auto: NullType;
+                        readonly hour: NullType;
+                        readonly day: NullType;
+                        readonly week: NullType;
+                        readonly month: NullType;
+                        readonly quarter: NullType;
+                        readonly year: NullType;
+                    }>>;
+                }>>;
+                readonly write: import("@elaraai/east").FunctionType<[StructType<{
+                    readonly where: import("@elaraai/east").DictType<import("@elaraai/east").StringType, VariantType<{
+                        readonly values: ArrayType<import("@elaraai/east").StringType>;
+                        readonly range: StructType<{
+                            readonly from: import("@elaraai/east").StringType;
+                            readonly to: import("@elaraai/east").StringType;
+                        }>;
+                        readonly prefix: import("@elaraai/east").StringType;
+                    }>>;
+                    readonly preset: OptionType<import("@elaraai/east").StringType>;
+                    readonly resolution: OptionType<VariantType<{
+                        readonly auto: NullType;
+                        readonly hour: NullType;
+                        readonly day: NullType;
+                        readonly week: NullType;
+                        readonly month: NullType;
+                        readonly quarter: NullType;
+                        readonly year: NullType;
+                    }>>;
+                }>], NullType>;
+                readonly choose: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType, ArrayType<import("@elaraai/east").StringType>], NullType>;
+                readonly range: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType, import("@elaraai/east").StringType, import("@elaraai/east").StringType], NullType>;
+                readonly prefix: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType, import("@elaraai/east").StringType], NullType>;
+                readonly clear: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType], NullType>;
+                readonly clearAll: import("@elaraai/east").FunctionType<[], NullType>;
+                readonly count: import("@elaraai/east").FunctionType<[], OptionType<import("@elaraai/east").IntegerType>>;
+                readonly countWhere: import("@elaraai/east").FunctionType<[import("@elaraai/east").DictType<import("@elaraai/east").StringType, VariantType<{
+                    readonly values: ArrayType<import("@elaraai/east").StringType>;
+                    readonly range: StructType<{
+                        readonly from: import("@elaraai/east").StringType;
+                        readonly to: import("@elaraai/east").StringType;
+                    }>;
+                    readonly prefix: import("@elaraai/east").StringType;
+                }>>], OptionType<import("@elaraai/east").IntegerType>>;
+                readonly total: import("@elaraai/east").FunctionType<[], OptionType<import("@elaraai/east").IntegerType>>;
+                readonly domain: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType], OptionType<StructType<{
+                    readonly from: import("@elaraai/east").StringType;
+                    readonly to: import("@elaraai/east").StringType;
+                }>>>;
+                readonly values: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType], ArrayType<StructType<{
+                    readonly value: import("@elaraai/east").StringType;
+                    readonly label: import("@elaraai/east").StringType;
+                    readonly count: OptionType<import("@elaraai/east").IntegerType>;
+                    readonly selected: import("@elaraai/east").BooleanType;
+                    readonly error: OptionType<import("@elaraai/east").StringType>;
+                }>>>;
+                readonly suggest: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType, import("@elaraai/east").StringType], OptionType<ArrayType<StructType<{
+                    readonly value: import("@elaraai/east").StringType;
+                    readonly label: import("@elaraai/east").StringType;
+                    readonly count: OptionType<import("@elaraai/east").IntegerType>;
+                    readonly selected: import("@elaraai/east").BooleanType;
+                    readonly error: OptionType<import("@elaraai/east").StringType>;
+                }>>>>;
+                readonly replaces: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType], ArrayType<import("@elaraai/east").StringType>>;
+                readonly togglePreset: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType], NullType>;
+                readonly setResolution: import("@elaraai/east").FunctionType<[OptionType<VariantType<{
+                    readonly auto: NullType;
+                    readonly hour: NullType;
+                    readonly day: NullType;
+                    readonly week: NullType;
+                    readonly month: NullType;
+                    readonly quarter: NullType;
+                    readonly year: NullType;
+                }>>], NullType>;
+                readonly retry: import("@elaraai/east").FunctionType<[], NullType>;
+                readonly sourceId: import("@elaraai/east").StringType;
+                readonly readEntry: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType], OptionType<OptionType<import("@elaraai/east").BlobType>>>;
+                readonly contains: import("@elaraai/east").FunctionType<[import("@elaraai/east").DictType<import("@elaraai/east").StringType, VariantType<{
+                    readonly values: ArrayType<import("@elaraai/east").StringType>;
+                    readonly range: StructType<{
+                        readonly from: import("@elaraai/east").StringType;
+                        readonly to: import("@elaraai/east").StringType;
+                    }>;
+                    readonly prefix: import("@elaraai/east").StringType;
+                }>>, import("@elaraai/east").StringType], OptionType<import("@elaraai/east").BooleanType>>;
+                readonly containsRow: import("@elaraai/east").FunctionType<[import("@elaraai/east").DictType<import("@elaraai/east").StringType, VariantType<{
+                    readonly values: ArrayType<import("@elaraai/east").StringType>;
+                    readonly range: StructType<{
+                        readonly from: import("@elaraai/east").StringType;
+                        readonly to: import("@elaraai/east").StringType;
+                    }>;
+                    readonly prefix: import("@elaraai/east").StringType;
+                }>>, import("@elaraai/east").StringType, import("@elaraai/east").BlobType], OptionType<import("@elaraai/east").BooleanType>>;
+            }>;
+        }>>;
+        readonly presets: ArrayType<StructType<{
+            readonly id: import("@elaraai/east").StringType;
+            readonly name: import("@elaraai/east").StringType;
+        }>>;
+        readonly clearAll: import("@elaraai/east").FunctionType<[], NullType>;
+        readonly togglePreset: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType], NullType>;
+    }>;
+    readonly affordances: ArrayType<VariantType<{
+        readonly fields: NullType;
+        readonly search: NullType;
+        readonly range: NullType;
+        readonly presets: NullType;
+        readonly resolution: NullType;
+        readonly brush: NullType;
+        readonly summary: NullType;
+    }>>;
+    readonly persist: OptionType<VariantType<{
+        readonly local: NullType;
+        readonly session: NullType;
+        readonly url: NullType;
+    }>>;
+}>;
+export type RecordSlicesChromeType = typeof RecordSlicesChromeType;
+/** Shared authoring options for a component narrowed over several records. */
+export interface RecordSlicesChromeOptions {
+    /** A `Slice.bindRecords` handle, including its typed authoring form. */
+    slice: SubtypeExprOrValue<RecordSlicesBindType>;
+    /** Controls to mount; defaults to field chips, presets and summary. */
+    affordances?: readonly RecordSliceAffordance[];
+    /** Persist validated narrowing in local/session storage or the URL. */
+    persist?: keyof SlicePersistType["cases"];
+}
+/** Recognise a `Slice.bindRecords` handle at authoring time. */
+export declare function isRecordSlices(input: unknown): boolean;
+/**
+ * Build the chrome over several records, evaluating the handle once and
+ * dropping each source's typed data.
+ * @param options - Bound handle, requested controls and persistence.
+ * @returns The chrome payload.
+ * @throws {Error} When the handle is not `Slice.bindRecords`', or an affordance is not a record one
+ */
+export declare function recordSlicesChrome(options: RecordSlicesChromeOptions): ExprType<RecordSlicesChromeType>;
 //# sourceMappingURL=record-chrome.d.ts.map

package/dist/src/platform/slice/record-chrome.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"record-chrome.d.ts","sourceRoot":"","sources":["../../../../src/platform/slice/record-chrome.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qEAAqE;AACrE,OAAO,EAAE,SAAS,EAAc,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAkC,KAAK,kBAAkB,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7K,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,sEAAsE;AACtE,eAAO,MAAM,yBAAyB;;;;;;;;EAGpC,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,OAAO,yBAAyB,CAAC;AACzE,8EAA8E;AAC9E,MAAM,MAAM,qBAAqB,GAAG,MAAM,yBAAyB,CAAC,OAAO,CAAC,CAAC;AAE7E;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIhC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAC;AAEjE,6DAA6D;AAC7D,MAAM,WAAW,wBAAwB;IACrC,iEAAiE;IACjE,KAAK,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,CAAC;IAC/C,uEAAuE;IACvE,WAAW,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC/C,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;CAC7C;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGrD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,QAAQ,CAAC,qBAAqB,CAAC,CAapG"}
+{"version":3,"file":"record-chrome.d.ts","sourceRoot":"","sources":["../../../../src/platform/slice/record-chrome.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qEAAqE;AACrE,OAAO,EAAE,SAAS,EAAc,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAkC,KAAK,kBAAkB,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7K,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,sEAAsE;AACtE,eAAO,MAAM,yBAAyB;;;;;;;;EAGpC,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,OAAO,yBAAyB,CAAC;AACzE,8EAA8E;AAC9E,MAAM,MAAM,qBAAqB,GAAG,MAAM,yBAAyB,CAAC,OAAO,CAAC,CAAC;AAE7E;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIhC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAC;AAEjE,6DAA6D;AAC7D,MAAM,WAAW,wBAAwB;IACrC,iEAAiE;IACjE,KAAK,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,CAAC;IAC/C,uEAAuE;IACvE,WAAW,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC/C,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;CAC7C;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGrD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,QAAQ,CAAC,qBAAqB,CAAC,CAapG;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIjC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,sBAAsB,CAAC;AAEnE,8EAA8E;AAC9E,MAAM,WAAW,yBAAyB;IACtC,wEAAwE;IACxE,KAAK,EAAE,kBAAkB,CAAC,oBAAoB,CAAC,CAAC;IAChD,uEAAuE;IACvE,WAAW,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC/C,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;CAC7C;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGtD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,QAAQ,CAAC,sBAAsB,CAAC,CAgBvG"}

package/dist/src/platform/slice/record-chrome.js

@@ -4,7 +4,7 @@
  */
 /** Record-only chrome, separate from the frozen local Slice wire. */
 import { ArrayType, East, Expr, NullType, OptionType, StructType, VariantType, isSubtype, none, some, variant } from "@elaraai/east";
-import { RecordSliceBindType } from "./record-types.js";
+import { RecordSliceBindType, RecordSlicesBindType } from "./record-types.js";
 import { SlicePersistType } from "./index.js";
 /** Controls a record can answer without evaluating row predicates. */
 export const RecordSliceAffordanceType = VariantType({
@@ -49,4 +49,48 @@ export function recordSliceChrome(options) {
     }
     return East.value({ slice, affordances: affordances.map(value => variant(value, null)), persist: options.persist === undefined ? none : some(variant(options.persist, null)) }, RecordSliceChromeType);
 }
+/**
+ * Narrowing over several records in a component's existing toolbar: one rail
+ * for every source.
+ * @property slice - The product's non-generic handle; each source's typed data stays in the component's source.
+ * @property affordances - Explicit controls the host offers, for every source.
+ * @property persist - Optional store persistence, for every source under its own key.
+ */
+export const RecordSlicesChromeType = StructType({
+    slice: RecordSlicesBindType,
+    affordances: ArrayType(RecordSliceAffordanceType),
+    persist: OptionType(SlicePersistType),
+});
+/** Recognise a `Slice.bindRecords` handle at authoring time. */
+export function isRecordSlices(input) {
+    const type = Expr.type(East.value(input));
+    return type.type === "Struct" && type.fields.parts !== undefined && type.fields.togglePreset !== undefined;
+}
+/**
+ * Build the chrome over several records, evaluating the handle once and
+ * dropping each source's typed data.
+ * @param options - Bound handle, requested controls and persistence.
+ * @returns The chrome payload.
+ * @throws {Error} When the handle is not `Slice.bindRecords`', or an affordance is not a record one
+ */
+export function recordSlicesChrome(options) {
+    const source = East.value(options.slice);
+    const type = Expr.type(source);
+    if (type.type !== "Struct")
+        throw new Error("A Slice.bindRecords handle is required");
+    for (const [field, expected] of Object.entries(RecordSlicesBindType.fields)) {
+        if (type.fields[field] === undefined || !isSubtype(type.fields[field], expected))
+            throw new Error(`Invalid Slice.bindRecords member '${field}'`);
+    }
+    const affordances = options.affordances ?? ["fields", "presets", "summary"];
+    for (const affordance of affordances) {
+        if (!(affordance in RecordSliceAffordanceType.cases))
+            throw new Error(`Record slices do not support '${affordance}'; use indexed field choices`);
+    }
+    const slice = East.function([], RecordSlicesBindType, $ => {
+        const handle = $.const(source);
+        return Object.fromEntries(Object.keys(RecordSlicesBindType.fields).map(field => [field, handle[field]]));
+    })();
+    return East.value({ slice, affordances: affordances.map(value => variant(value, null)), persist: options.persist === undefined ? none : some(variant(options.persist, null)) }, RecordSlicesChromeType);
+}
 //# sourceMappingURL=record-chrome.js.map

package/dist/src/platform/slice/record-chrome.js.map

@@ -1 +1 @@
-{"version":3,"file":"record-chrome.js","sourceRoot":"","sources":["../../../../src/platform/slice/record-chrome.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"record-chrome.js","sourceRoot":"","sources":["../../../../src/platform/slice/record-chrome.ts"],"names":[],"mappings":"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"}

package/dist/src/platform/slice/record-sources.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Several records narrowed together: the product of one record Slice per
+ * source. Each part is an ordinary `Slice.bindRecord`, under its own store
+ * key; no index relates two records, so no choice in one part reaches another.
+ * The product adds Clear all and presets over several sources, both East
+ * functions over its parts, and keeps no state of its own.
+ */
+import { StringType, StructType, type EastType, type ExprType, type SubtypeExprOrValue, type TypeOf, type VariantType } from "@elaraai/east";
+import type { IndexedSource } from "../../contracts/indexed-source.js";
+import { type IconName, type SolidIconPrefix } from "../../display/icon/types.js";
+import { bindRecord, type RecordSliceOptions, type RecordSliceWhere } from "./record.js";
+import { RecordSlicesHandleType } from "./record-types.js";
+/** An indexed binding's type parameters, recovered from its expression. */
+type Parameters_<S> = S extends IndexedSource<infer K extends EastType, infer R extends StructType, infer P extends EastType, infer M extends StructType, infer IK extends VariantType> ? {
+    K: K;
+    R: R;
+    P: P;
+    M: M;
+    IK: IK;
+} : never;
+type RowOf<S> = Parameters_<S> extends {
+    R: infer R extends StructType;
+} ? R : never;
+type MetaOf<S> = Parameters_<S> extends {
+    M: infer M extends StructType;
+} ? M : never;
+/**
+ * One source of `Slice.bindRecords`: an indexed binding, how the rail names it,
+ * and its controls, typed against its own row and indexes. Presets belong to
+ * the product.
+ * @typeParam S - The indexed binding's expression type.
+ */
+export type RecordSlicesPart<S> = {
+    /** The indexed binding: `Data.bindPaged(record, { indexes })`. */
+    source: S;
+    /** How the rail names the source (`Bays`): the heading over its fields in the folded rail. With none, the host's noun for it. */
+    label?: string;
+    /** Its icon on the rail, a Font Awesome solid icon (`{ prefix: "fas", name: "warehouse" }`): on its heading and its fields' chips. With none, the rail's own. */
+    icon?: {
+        prefix: SolidIconPrefix;
+        name: IconName;
+    };
+} & Omit<RecordSliceOptions<RowOf<S>, MetaOf<S>>, "presets">;
+/**
+ * Each source's narrowing in a preset: a source it does not name is cleared.
+ * @typeParam S - Each source's indexed binding expression type, by name.
+ */
+export type RecordSlicesWhere<S> = {
+    [N in keyof S]?: RecordSliceWhere<RowOf<S[N]>, MetaOf<S[N]>>;
+};
+/**
+ * Options of `Slice.bindRecords` beyond its sources.
+ * @typeParam S - Each source's indexed binding expression type, by name.
+ */
+export interface RecordSlicesOptions<S> {
+    /** Named narrowings over any sources, selected one at a time. */
+    presets?: readonly {
+        id: string;
+        name: string;
+        where: RecordSlicesWhere<S>;
+    }[];
+}
+/** The typed handle of one part, as `Slice.bindRecord` returns it. */
+type PartHandle<S> = Parameters_<S> extends {
+    K: infer K extends EastType;
+    R: infer R extends StructType;
+    P: infer P extends EastType;
+    M: infer M extends StructType;
+    IK: infer IK extends VariantType;
+} ? TypeOf<ReturnType<typeof bindRecord<K, R, P, M, IK>>> : never;
+/**
+ * The typed handle `Slice.bindRecords` returns.
+ * @typeParam S - Each source's indexed binding expression type, by name.
+ */
+export type RecordSlicesHandle<S> = ExprType<ReturnType<typeof RecordSlicesHandleType<{
+    [N in keyof S & string]: PartHandle<S[N]>;
+}>>>;
+/**
+ * Narrow several records together from one set of controls: one record Slice
+ * per source, under `${key}.${source}`, read with `Slice.rows(slice, source)`.
+ * A choice in one source never changes another's rows or counts. A preset is
+ * every source's narrowing at once; a source it does not name is cleared.
+ *
+ * @param key - Stable UI state key.
+ * @param parts - Each source by name: an indexed binding (`Data.bindPaged(record, { indexes })`), how the rail names it (`label`, `icon`), and its fields, range, search and initial narrowing.
+ * @param options - Presets over the sources.
+ * @returns A serializable handle with each source's typed narrowed data.
+ * @throws {Error} When there is no source, a preset repeats, a preset names a source the Slice lacks, a part declares its own presets, a label is empty or an icon is not a Font Awesome solid one; and as `Slice.bindRecord` refuses a part, naming its source
+ */
+export declare function bindRecords<S extends Record<string, unknown>>(key: SubtypeExprOrValue<StringType>, parts: {
+    [N in keyof S]: RecordSlicesPart<S[N]>;
+}, options?: RecordSlicesOptions<NoInfer<S>>): RecordSlicesHandle<S>;
+export {};
+//# sourceMappingURL=record-sources.d.ts.map

package/dist/src/platform/slice/record-sources.d.ts.map

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

package/dist/src/platform/slice/record-sources.js

@@ -0,0 +1,100 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Several records narrowed together: the product of one record Slice per
+ * source. Each part is an ordinary `Slice.bindRecord`, under its own store
+ * key; no index relates two records, so no choice in one part reaches another.
+ * The product adds Clear all and presets over several sources, both East
+ * functions over its parts, and keeps no state of its own.
+ */
+import { ArrayType, East, Expr, NullType, OptionType, StringType, StructType, isValueOf, none, some, } from "@elaraai/east";
+import { refuseNonSolid } from "../../display/icon/types.js";
+import { bindRecord } from "./record.js";
+import { RecordSliceBindType, RecordSlicePartType, RecordSlicesHandleType } from "./record-types.js";
+/**
+ * Narrow several records together from one set of controls: one record Slice
+ * per source, under `${key}.${source}`, read with `Slice.rows(slice, source)`.
+ * A choice in one source never changes another's rows or counts. A preset is
+ * every source's narrowing at once; a source it does not name is cleared.
+ *
+ * @param key - Stable UI state key.
+ * @param parts - Each source by name: an indexed binding (`Data.bindPaged(record, { indexes })`), how the rail names it (`label`, `icon`), and its fields, range, search and initial narrowing.
+ * @param options - Presets over the sources.
+ * @returns A serializable handle with each source's typed narrowed data.
+ * @throws {Error} When there is no source, a preset repeats, a preset names a source the Slice lacks, a part declares its own presets, a label is empty or an icon is not a Font Awesome solid one; and as `Slice.bindRecord` refuses a part, naming its source
+ */
+export function bindRecords(key, parts, options = {}) {
+    const names = Object.keys(parts);
+    if (names.length === 0)
+        throw new Error("Slice.bindRecords needs at least one source: Slice.bindRecords(key, { name: { source, fields } })");
+    const presets = options.presets ?? [];
+    const ids = new Set();
+    for (const preset of presets) {
+        if (ids.has(preset.id))
+            throw new Error(`Slice.bindRecords: repeated preset '${preset.id}'`);
+        ids.add(preset.id);
+        for (const source of Object.keys(preset.where)) {
+            if (!names.includes(source))
+                throw new Error(`Slice.bindRecords: preset '${preset.id}' narrows '${source}', which is not one of its sources (${names.join(", ")})`);
+        }
+    }
+    // How the rail names each source: its label and its icon, as the Icon definition holds one.
+    const named = names.map(name => {
+        const { label, icon } = parts[name];
+        if (label !== undefined && label.trim() === "")
+            throw new Error(`Slice.bindRecords: '${name}' has an empty label; give it a name or leave it out`);
+        refuseNonSolid(`Slice.bindRecords: '${name}'`, icon);
+        return {
+            label: label === undefined ? none : some(label),
+            icon: icon === undefined ? none : some({ prefix: icon.prefix, name: icon.name, label: none, style: none }),
+        };
+    });
+    const handles = names.map(name => {
+        const { source, label: _label, icon: _icon, ...controls } = parts[name];
+        if (controls.presets !== undefined)
+            throw new Error(`Slice.bindRecords: '${name}' declares presets; declare them once, in the options, over any sources`);
+        const where = (preset) => preset.where[name] ?? {};
+        const partKey = isValueOf(key, StringType) ? `${key}.${name}` : East.value(key, StringType).concat(`.${name}`);
+        try {
+            return bindRecord(partKey, source, { ...controls,
+                presets: presets.map(preset => ({ id: preset.id, name: preset.name, where: where(preset) })) });
+        }
+        catch (error) {
+            // A part's refusal names its source: several sources may hold fields of one name.
+            throw new Error(`Slice.bindRecords: the '${name}' source — ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+        }
+    });
+    const sources = Object.fromEntries(names.map((name, i) => [name, Expr.type(handles[i])]));
+    const type = RecordSlicesHandleType(sources);
+    return East.function([], type, $ => {
+        // Each part is bound once; the product's functions loop over their controls.
+        const bound = handles.map(handle => $.const(handle));
+        const controls = (handle) => Object.fromEntries(Object.keys(RecordSliceBindType.fields)
+            .map(field => [field, handle[field]]));
+        const all = $.const(names.map((name, i) => ({ source: name, ...named[i], slice: controls(bound[i]) })), ArrayType(RecordSlicePartType));
+        return {
+            key, parts: all, presets: presets.map(preset => ({ id: preset.id, name: preset.name })),
+            clearAll: East.function([], NullType, $2 => {
+                $2.for(all, ($3, part) => { $3(part.slice.clearAll()); });
+            }),
+            togglePreset: East.function([StringType], NullType, ($2, id) => {
+                const chosen = $2.const(some(id), OptionType(StringType));
+                const everywhere = $2.let(true);
+                $2.for(all, ($3, part) => {
+                    $3.if(East.notEqual(part.slice.read().preset, chosen), $4 => { $4.assign(everywhere, false); });
+                });
+                $2.if(everywhere, $3 => {
+                    $3.for(all, ($4, part) => { $4(part.slice.clearAll()); });
+                }).else($3 => {
+                    $3.for(all, ($4, part) => {
+                        $4.if(East.notEqual(part.slice.read().preset, chosen), $5 => { $5(part.slice.togglePreset(id)); });
+                    });
+                });
+            }),
+            sources: Object.fromEntries(names.map((name, i) => [name, bound[i]])),
+        };
+    })();
+}
+//# sourceMappingURL=record-sources.js.map

package/dist/src/platform/slice/record-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-sources.js","sourceRoot":"","sources":["../../../../src/platform/slice/record-sources.ts"],"names":[],"mappings":"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"}