@elaraai/e3-ui 1.0.85 → 1.0.87

package/dist/src/flowchart/window.d.ts

@@ -0,0 +1,521 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** Paged flow records: preserve index order in the list and primary identity in edits. */
+import { ArrayType, BlobType, OptionType, StringType, StructType, FunctionType, variant } from "@elaraai/east";
+import { type RecordSliceChromeOptions } from "@elaraai/east-ui/internal";
+/** A list entry retains the record's primary key even when sorted by an index. */
+export declare const FlowchartEntryType: StructType<{
+    readonly name: StringType;
+    readonly flow: StructType<{
+        readonly description: OptionType<StringType>;
+        readonly lanes: ArrayType<StructType<{
+            readonly key: StringType;
+            readonly label: OptionType<StringType>;
+        }>>;
+        readonly states: ArrayType<StructType<{
+            readonly key: StringType;
+            readonly label: OptionType<StringType>;
+            readonly lane: StringType;
+            readonly members: OptionType<import("@elaraai/east").IntegerType>;
+            readonly notes: OptionType<StringType>;
+        }>>;
+        readonly links: ArrayType<StructType<{
+            readonly key: OptionType<StringType>;
+            readonly from: StringType;
+            readonly to: StringType;
+            readonly kind: OptionType<import("@elaraai/east").VariantType<{
+                readonly planned: import("@elaraai/east").NullType;
+                readonly observed: import("@elaraai/east").NullType;
+            }>>;
+            readonly trigger: OptionType<StringType>;
+            readonly evidence: OptionType<StructType<{
+                readonly volume: OptionType<import("@elaraai/east").FloatType>;
+                readonly count: OptionType<import("@elaraai/east").IntegerType>;
+                readonly measuredAt: OptionType<import("@elaraai/east").DateTimeType>;
+                readonly unit: OptionType<StringType>;
+            }>>;
+        }>>;
+        readonly triggers: ArrayType<StructType<{
+            readonly key: StringType;
+            readonly label: StringType;
+            readonly letter: OptionType<StringType>;
+            readonly owner: OptionType<StringType>;
+            readonly queue: OptionType<ArrayType<StringType>>;
+            readonly outcomes: OptionType<StringType>;
+        }>>;
+    }>;
+}>;
+/** The normalized, snapshot-pinned list of flows. */
+export declare const FlowchartWindowType: StructType<{
+    readonly id: StringType;
+    readonly page: FunctionType<[import("@elaraai/east").IntegerType, import("@elaraai/east").IntegerType], OptionType<ArrayType<StructType<{
+        readonly name: StringType;
+        readonly flow: StructType<{
+            readonly description: OptionType<StringType>;
+            readonly lanes: ArrayType<StructType<{
+                readonly key: StringType;
+                readonly label: OptionType<StringType>;
+            }>>;
+            readonly states: ArrayType<StructType<{
+                readonly key: StringType;
+                readonly label: OptionType<StringType>;
+                readonly lane: StringType;
+                readonly members: OptionType<import("@elaraai/east").IntegerType>;
+                readonly notes: OptionType<StringType>;
+            }>>;
+            readonly links: ArrayType<StructType<{
+                readonly key: OptionType<StringType>;
+                readonly from: StringType;
+                readonly to: StringType;
+                readonly kind: OptionType<import("@elaraai/east").VariantType<{
+                    readonly planned: import("@elaraai/east").NullType;
+                    readonly observed: import("@elaraai/east").NullType;
+                }>>;
+                readonly trigger: OptionType<StringType>;
+                readonly evidence: OptionType<StructType<{
+                    readonly volume: OptionType<import("@elaraai/east").FloatType>;
+                    readonly count: OptionType<import("@elaraai/east").IntegerType>;
+                    readonly measuredAt: OptionType<import("@elaraai/east").DateTimeType>;
+                    readonly unit: OptionType<StringType>;
+                }>>;
+            }>>;
+            readonly triggers: ArrayType<StructType<{
+                readonly key: StringType;
+                readonly label: StringType;
+                readonly letter: OptionType<StringType>;
+                readonly owner: OptionType<StringType>;
+                readonly queue: OptionType<ArrayType<StringType>>;
+                readonly outcomes: OptionType<StringType>;
+            }>>;
+        }>;
+    }>>>>;
+    readonly total: FunctionType<[], OptionType<import("@elaraai/east").IntegerType>>;
+    readonly seek: OptionType<FunctionType<[import("@elaraai/east").VariantType<{
+        readonly key: StringType;
+        readonly prefix: StringType;
+        readonly fields: StructType<{
+            readonly values: ArrayType<StringType>;
+            readonly prefix: OptionType<StringType>;
+        }>;
+        readonly range: StructType<{
+            readonly from: ArrayType<StringType>;
+            readonly to: ArrayType<StringType>;
+        }>;
+    }>], OptionType<StructType<{
+        readonly found: import("@elaraai/east").BooleanType;
+        readonly row: import("@elaraai/east").IntegerType;
+        readonly count: import("@elaraai/east").IntegerType;
+    }>>>>;
+    readonly revision: FunctionType<[], OptionType<StringType>>;
+    readonly refresh: FunctionType<[OptionType<StringType>], import("@elaraai/east").NullType>;
+}>;
+/** Read by primary identity: outer none is pending; inner none is confirmed absence. */
+export declare const FlowchartReadEntryType: FunctionType<[StringType], OptionType<OptionType<BlobType>>>;
+/** The shared record filter controls, independent of the list's current query. */
+export declare const FlowchartRecordChromeType: OptionType<StructType<{
+    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<import("@elaraai/east").VariantType<{
+                    readonly number: import("@elaraai/east").NullType;
+                    readonly currency: StructType<{
+                        readonly code: import("@elaraai/east").StringType;
+                        readonly compact: import("@elaraai/east").BooleanType;
+                    }>;
+                    readonly percent: import("@elaraai/east").NullType;
+                    readonly compact: import("@elaraai/east").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, import("@elaraai/east").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, import("@elaraai/east").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<import("@elaraai/east").VariantType<{
+                readonly auto: import("@elaraai/east").NullType;
+                readonly hour: import("@elaraai/east").NullType;
+                readonly day: import("@elaraai/east").NullType;
+                readonly week: import("@elaraai/east").NullType;
+                readonly month: import("@elaraai/east").NullType;
+                readonly quarter: import("@elaraai/east").NullType;
+                readonly year: import("@elaraai/east").NullType;
+            }>>;
+        }>>;
+        readonly write: import("@elaraai/east").FunctionType<[StructType<{
+            readonly where: import("@elaraai/east").DictType<import("@elaraai/east").StringType, import("@elaraai/east").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<import("@elaraai/east").VariantType<{
+                readonly auto: import("@elaraai/east").NullType;
+                readonly hour: import("@elaraai/east").NullType;
+                readonly day: import("@elaraai/east").NullType;
+                readonly week: import("@elaraai/east").NullType;
+                readonly month: import("@elaraai/east").NullType;
+                readonly quarter: import("@elaraai/east").NullType;
+                readonly year: import("@elaraai/east").NullType;
+            }>>;
+        }>], import("@elaraai/east").NullType>;
+        readonly choose: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType, ArrayType<import("@elaraai/east").StringType>], import("@elaraai/east").NullType>;
+        readonly range: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType, import("@elaraai/east").StringType, import("@elaraai/east").StringType], import("@elaraai/east").NullType>;
+        readonly prefix: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType, import("@elaraai/east").StringType], import("@elaraai/east").NullType>;
+        readonly clear: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType], import("@elaraai/east").NullType>;
+        readonly clearAll: import("@elaraai/east").FunctionType<[], import("@elaraai/east").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, import("@elaraai/east").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], import("@elaraai/east").NullType>;
+        readonly setResolution: import("@elaraai/east").FunctionType<[OptionType<import("@elaraai/east").VariantType<{
+            readonly auto: import("@elaraai/east").NullType;
+            readonly hour: import("@elaraai/east").NullType;
+            readonly day: import("@elaraai/east").NullType;
+            readonly week: import("@elaraai/east").NullType;
+            readonly month: import("@elaraai/east").NullType;
+            readonly quarter: import("@elaraai/east").NullType;
+            readonly year: import("@elaraai/east").NullType;
+        }>>], import("@elaraai/east").NullType>;
+        readonly retry: import("@elaraai/east").FunctionType<[], import("@elaraai/east").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, import("@elaraai/east").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 affordances: ArrayType<import("@elaraai/east").VariantType<{
+        readonly fields: import("@elaraai/east").NullType;
+        readonly search: import("@elaraai/east").NullType;
+        readonly range: import("@elaraai/east").NullType;
+        readonly presets: import("@elaraai/east").NullType;
+        readonly resolution: import("@elaraai/east").NullType;
+        readonly brush: import("@elaraai/east").NullType;
+        readonly summary: import("@elaraai/east").NullType;
+    }>>;
+    readonly persist: OptionType<import("@elaraai/east").VariantType<{
+        readonly local: import("@elaraai/east").NullType;
+        readonly session: import("@elaraai/east").NullType;
+        readonly url: import("@elaraai/east").NullType;
+    }>>;
+}>>;
+/**
+ * Normalize a record window without reading the whole record.
+ * @param window - Data.bindPaged(record), or Slice.rows of its record slice
+ * @param slice - Shared record Slice controls; required for an indexed window
+ * @returns The window, primary-key reader and optional Slice chrome
+ * @throws {Error} When the window does not contain complete, pinned flow entries
+ * @internal
+ */
+export declare function flowchartWindow(window: unknown, slice: RecordSliceChromeOptions | undefined): {
+    window: import("@elaraai/east").StructExpr<{
+        readonly id: StringType;
+        readonly page: FunctionType<[import("@elaraai/east").IntegerType, import("@elaraai/east").IntegerType], OptionType<ArrayType<StructType<{
+            readonly name: StringType;
+            readonly flow: StructType<{
+                readonly description: OptionType<StringType>;
+                readonly lanes: ArrayType<StructType<{
+                    readonly key: StringType;
+                    readonly label: OptionType<StringType>;
+                }>>;
+                readonly states: ArrayType<StructType<{
+                    readonly key: StringType;
+                    readonly label: OptionType<StringType>;
+                    readonly lane: StringType;
+                    readonly members: OptionType<import("@elaraai/east").IntegerType>;
+                    readonly notes: OptionType<StringType>;
+                }>>;
+                readonly links: ArrayType<StructType<{
+                    readonly key: OptionType<StringType>;
+                    readonly from: StringType;
+                    readonly to: StringType;
+                    readonly kind: OptionType<import("@elaraai/east").VariantType<{
+                        readonly planned: import("@elaraai/east").NullType;
+                        readonly observed: import("@elaraai/east").NullType;
+                    }>>;
+                    readonly trigger: OptionType<StringType>;
+                    readonly evidence: OptionType<StructType<{
+                        readonly volume: OptionType<import("@elaraai/east").FloatType>;
+                        readonly count: OptionType<import("@elaraai/east").IntegerType>;
+                        readonly measuredAt: OptionType<import("@elaraai/east").DateTimeType>;
+                        readonly unit: OptionType<StringType>;
+                    }>>;
+                }>>;
+                readonly triggers: ArrayType<StructType<{
+                    readonly key: StringType;
+                    readonly label: StringType;
+                    readonly letter: OptionType<StringType>;
+                    readonly owner: OptionType<StringType>;
+                    readonly queue: OptionType<ArrayType<StringType>>;
+                    readonly outcomes: OptionType<StringType>;
+                }>>;
+            }>;
+        }>>>>;
+        readonly total: FunctionType<[], OptionType<import("@elaraai/east").IntegerType>>;
+        readonly seek: OptionType<FunctionType<[import("@elaraai/east").VariantType<{
+            readonly key: StringType;
+            readonly prefix: StringType;
+            readonly fields: StructType<{
+                readonly values: ArrayType<StringType>;
+                readonly prefix: OptionType<StringType>;
+            }>;
+            readonly range: StructType<{
+                readonly from: ArrayType<StringType>;
+                readonly to: ArrayType<StringType>;
+            }>;
+        }>], OptionType<StructType<{
+            readonly found: import("@elaraai/east").BooleanType;
+            readonly row: import("@elaraai/east").IntegerType;
+            readonly count: import("@elaraai/east").IntegerType;
+        }>>>>;
+        readonly revision: FunctionType<[], OptionType<StringType>>;
+        readonly refresh: FunctionType<[OptionType<StringType>], import("@elaraai/east").NullType>;
+    }>;
+    entry: import("@elaraai/east").CallableFunctionExpr<[StringType], OptionType<OptionType<BlobType>>>;
+    chrome: variant<"none", null> | variant<"some", import("@elaraai/east").StructExpr<{
+        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<import("@elaraai/east").VariantType<{
+                        readonly number: import("@elaraai/east").NullType;
+                        readonly currency: StructType<{
+                            readonly code: import("@elaraai/east").StringType;
+                            readonly compact: import("@elaraai/east").BooleanType;
+                        }>;
+                        readonly percent: import("@elaraai/east").NullType;
+                        readonly compact: import("@elaraai/east").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, import("@elaraai/east").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, import("@elaraai/east").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<import("@elaraai/east").VariantType<{
+                    readonly auto: import("@elaraai/east").NullType;
+                    readonly hour: import("@elaraai/east").NullType;
+                    readonly day: import("@elaraai/east").NullType;
+                    readonly week: import("@elaraai/east").NullType;
+                    readonly month: import("@elaraai/east").NullType;
+                    readonly quarter: import("@elaraai/east").NullType;
+                    readonly year: import("@elaraai/east").NullType;
+                }>>;
+            }>>;
+            readonly write: import("@elaraai/east").FunctionType<[StructType<{
+                readonly where: import("@elaraai/east").DictType<import("@elaraai/east").StringType, import("@elaraai/east").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<import("@elaraai/east").VariantType<{
+                    readonly auto: import("@elaraai/east").NullType;
+                    readonly hour: import("@elaraai/east").NullType;
+                    readonly day: import("@elaraai/east").NullType;
+                    readonly week: import("@elaraai/east").NullType;
+                    readonly month: import("@elaraai/east").NullType;
+                    readonly quarter: import("@elaraai/east").NullType;
+                    readonly year: import("@elaraai/east").NullType;
+                }>>;
+            }>], import("@elaraai/east").NullType>;
+            readonly choose: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType, ArrayType<import("@elaraai/east").StringType>], import("@elaraai/east").NullType>;
+            readonly range: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType, import("@elaraai/east").StringType, import("@elaraai/east").StringType], import("@elaraai/east").NullType>;
+            readonly prefix: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType, import("@elaraai/east").StringType], import("@elaraai/east").NullType>;
+            readonly clear: import("@elaraai/east").FunctionType<[import("@elaraai/east").StringType], import("@elaraai/east").NullType>;
+            readonly clearAll: import("@elaraai/east").FunctionType<[], import("@elaraai/east").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, import("@elaraai/east").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], import("@elaraai/east").NullType>;
+            readonly setResolution: import("@elaraai/east").FunctionType<[OptionType<import("@elaraai/east").VariantType<{
+                readonly auto: import("@elaraai/east").NullType;
+                readonly hour: import("@elaraai/east").NullType;
+                readonly day: import("@elaraai/east").NullType;
+                readonly week: import("@elaraai/east").NullType;
+                readonly month: import("@elaraai/east").NullType;
+                readonly quarter: import("@elaraai/east").NullType;
+                readonly year: import("@elaraai/east").NullType;
+            }>>], import("@elaraai/east").NullType>;
+            readonly retry: import("@elaraai/east").FunctionType<[], import("@elaraai/east").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, import("@elaraai/east").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 affordances: ArrayType<import("@elaraai/east").VariantType<{
+            readonly fields: import("@elaraai/east").NullType;
+            readonly search: import("@elaraai/east").NullType;
+            readonly range: import("@elaraai/east").NullType;
+            readonly presets: import("@elaraai/east").NullType;
+            readonly resolution: import("@elaraai/east").NullType;
+            readonly brush: import("@elaraai/east").NullType;
+            readonly summary: import("@elaraai/east").NullType;
+        }>>;
+        readonly persist: OptionType<import("@elaraai/east").VariantType<{
+            readonly local: import("@elaraai/east").NullType;
+            readonly session: import("@elaraai/east").NullType;
+            readonly url: import("@elaraai/east").NullType;
+        }>>;
+    }>>;
+};
+//# sourceMappingURL=window.d.ts.map

package/dist/src/flowchart/window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../../../src/flowchart/window.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,0FAA0F;AAC1F,OAAO,EACH,SAAS,EAAE,QAAQ,EAAQ,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAClD,OAAO,EACnC,MAAM,eAAe,CAAC;AACvB,OAAO,EAEuC,KAAK,wBAAwB,EAC1E,MAAM,2BAA2B,CAAC;AAGnC,kFAAkF;AAClF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA4D,CAAC;AAC5F,qDAAqD;AACrD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAkD,CAAC;AACnF,wFAAwF;AACxF,eAAO,MAAM,sBAAsB,8DAA+D,CAAC;AACnG,kFAAkF;AAClF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAoC,CAAC;AAE3E;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,wBAAwB,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4C3F"}

package/dist/src/flowchart/window.js

@@ -0,0 +1,69 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** Paged flow records: preserve index order in the list and primary identity in edits. */
+import { ArrayType, BlobType, East, OptionType, StringType, StructType, FunctionType, isTypeEqual, none, some, variant, } from "@elaraai/east";
+import { buildRowSource, resolveRowSource, PinnedSourceType, RecordSliceChromeType, recordSliceChrome, } from "@elaraai/east-ui/internal";
+import { FlowchartFlowType, FlowchartFlowsType } from "./types.js";
+/** A list entry retains the record's primary key even when sorted by an index. */
+export const FlowchartEntryType = StructType({ name: StringType, flow: FlowchartFlowType });
+/** The normalized, snapshot-pinned list of flows. */
+export const FlowchartWindowType = PinnedSourceType(ArrayType(FlowchartEntryType));
+/** Read by primary identity: outer none is pending; inner none is confirmed absence. */
+export const FlowchartReadEntryType = FunctionType([StringType], OptionType(OptionType(BlobType)));
+/** The shared record filter controls, independent of the list's current query. */
+export const FlowchartRecordChromeType = OptionType(RecordSliceChromeType);
+/**
+ * Normalize a record window without reading the whole record.
+ * @param window - Data.bindPaged(record), or Slice.rows of its record slice
+ * @param slice - Shared record Slice controls; required for an indexed window
+ * @returns The window, primary-key reader and optional Slice chrome
+ * @throws {Error} When the window does not contain complete, pinned flow entries
+ * @internal
+ */
+export function flowchartWindow(window, slice) {
+    const resolved = resolveRowSource(window, "Flowchart");
+    const joined = resolved.kind === "ordered" && resolved.elementType.type === "Struct"
+        ? resolved.elementType.fields.row : undefined;
+    const indexed = resolved.kind === "ordered" && isTypeEqual(resolved.keyType, StringType)
+        && joined?.type === "Variant" && joined.cases.some !== undefined
+        && isTypeEqual(joined.cases.some, FlowchartFlowType);
+    if (resolved.kind === "inline" || !resolved.pinned
+        || (!isTypeEqual(resolved.collectionType, FlowchartFlowsType) && !indexed)) {
+        throw new Error("Flowchart: `window` must page complete flows from the bound record — Data.bindPaged(record), or Slice.rows(recordSlice) with joined rows");
+    }
+    if (indexed && slice === undefined) {
+        throw new Error("Flowchart: an indexed `window` needs slice={{ slice: recordSlice }} so Save confirms changes by their original record IDs");
+    }
+    const rowsType = ArrayType(FlowchartEntryType);
+    const source = buildRowSource(resolved, rowsType, (collection) => {
+        if (!indexed)
+            return collection.toArray((_$, flow, name) => ({ name, flow }));
+        const rows = collection;
+        return rows.map((_$, entry) => ({ name: entry.key, flow: entry.row.unwrap("some") }));
+    }).unwrap("pinned");
+    const chrome = slice === undefined ? undefined : recordSliceChrome(slice);
+    const entry = chrome !== undefined ? chrome.slice.readEntry
+        : East.function([StringType], OptionType(OptionType(BlobType)), ($, name) => {
+            const src = $.const(source);
+            const answer = $.let(none, OptionType(OptionType(BlobType)));
+            $.match(src.seek, { some: ($, seek) => {
+                    $.match(seek(variant("key", East.print(name))), { some: ($, found) => {
+                            $.if(found.found.not(), ($) => { $.assign(answer, some(none)); });
+                            $.if(found.found, ($) => {
+                                $.match(src.page(found.row, 1n), { some: ($, rows) => {
+                                        const flow = $.let(none, OptionType(BlobType));
+                                        $.for(rows, ($, row) => {
+                                            $.if(row.name.equal(name), ($) => { $.assign(flow, some(East.Blob.encodeBeast(row.flow, "v2"))); });
+                                        });
+                                        $.assign(answer, some(flow));
+                                    } });
+                            });
+                        } });
+                } });
+            return answer;
+        });
+    return { window: source, entry, chrome: chrome === undefined ? none : some(chrome) };
+}
+//# sourceMappingURL=window.js.map

package/dist/src/flowchart/window.js.map

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