@elaraai/e3-ui 1.0.3 → 1.0.5

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/decision/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAuC,MAAM,WAAW,CAAC;AAElH,eAAO,MAAM,QAAQ;IAEjB;;;OAGG;;;QAIC;sEAC8D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAE9D,uDAAuD;;QAEvD,wCAAwC;;;;;;;QAExC;;gDAEwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGtC,CAAC"}

package/dist/src/decision/index.js

@@ -0,0 +1,36 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The Decision platform namespace — constructors for the decision envelope
+ * (`make` / `option` / `reference` / `judgement`), the per-surface handle
+ * (`bind`), and the East `Types`.
+ *
+ * @packageDocumentation
+ */
+import { Decision as constructors } from './types.js';
+import { decisionBind, decisionHandleType, judgementsType, DecisionHandleType, CommitStateType } from './bind.js';
+export const Decision = {
+    ...constructors,
+    /**
+     * Build the per-surface decision handle from bound decision views + the
+     * bound judgements view — see {@link decisionBind}.
+     */
+    bind: decisionBind,
+    Types: {
+        ...constructors.Types,
+        /** The default handle struct returned by {@link decisionBind};
+         *  `HandleFor(Contract)` builds the contract-specific one. */
+        Handle: DecisionHandleType,
+        /** Build the handle type for a constraint contract. */
+        HandleFor: decisionHandleType,
+        /** The derived per-case commit gate. */
+        CommitState: CommitStateType,
+        /** Build the judgements dataset type for a constraint contract —
+         *  `Decision.Types.Judgements(Contract)`; call with no argument for
+         *  the default primitive op-variant. */
+        Judgements: judgementsType,
+    },
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/decision/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAElH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACpB,GAAG,YAAY;IACf;;;OAGG;IACH,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE;QACH,GAAG,YAAY,CAAC,KAAK;QACrB;sEAC8D;QAC9D,MAAM,EAAE,kBAAkB;QAC1B,uDAAuD;QACvD,SAAS,EAAE,kBAAkB;QAC7B,wCAAwC;QACxC,WAAW,EAAE,eAAe;QAC5B;;gDAEwC;QACxC,UAAU,EAAE,cAAc;KAC7B;CACK,CAAC"}

package/dist/src/decision/journal.d.ts

@@ -0,0 +1,405 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `DecisionJournal` — the Decide↔Trust seam (the spec's `Decision.Journal`):
+ * the read-back of resolved cases. Each entry is a staged judgement whose
+ * verdict is set — how the case left the queue (accepted / rejected /
+ * deferred / handoff), when, with the operator's captured knowledge and
+ * injected constraints. The exact complement of the queue's projection:
+ * the queue shows cases *without* verdicts, the journal shows cases *with*
+ * them.
+ *
+ * @packageDocumentation
+ */
+import { StructType, OptionType, StringType, type ExprType, type SubtypeExprOrValue } from '@elaraai/east';
+import { UIComponentType } from '@elaraai/east-ui';
+import { type DecisionHandleLike } from './bind.js';
+/**
+ * The `DecisionJournal` component payload.
+ *
+ * @property handle - The surface's decision handle ref (binding descriptors).
+ * @property heading - Optional header label (e.g. `"Decision journal"`).
+ * @property maxHeight - Optional cap on the journal's height (a CSS length,
+ *   e.g. `"320px"`). The header stays pinned; the entries scroll.
+ */
+export declare const DecisionJournalPayloadType: StructType<{
+    readonly handle: StructType<{
+        readonly decisions: import("@elaraai/east").ArrayType<StructType<{
+            readonly source: import("@elaraai/east").ArrayType<import("@elaraai/east").VariantType<{
+                readonly field: StringType;
+            }>>;
+            readonly patch: OptionType<import("@elaraai/east").ArrayType<import("@elaraai/east").VariantType<{
+                readonly field: StringType;
+            }>>>;
+            readonly mode: import("@elaraai/east").VariantType<{
+                readonly staged: import("@elaraai/east").NullType;
+                readonly direct: import("@elaraai/east").NullType;
+            }>;
+        }>>;
+        readonly judgements: StructType<{
+            readonly source: import("@elaraai/east").ArrayType<import("@elaraai/east").VariantType<{
+                readonly field: StringType;
+            }>>;
+            readonly patch: OptionType<import("@elaraai/east").ArrayType<import("@elaraai/east").VariantType<{
+                readonly field: StringType;
+            }>>>;
+            readonly mode: import("@elaraai/east").VariantType<{
+                readonly staged: import("@elaraai/east").NullType;
+                readonly direct: import("@elaraai/east").NullType;
+            }>;
+        }>;
+        readonly slice: OptionType<StructType<{
+            readonly range: OptionType<import("@elaraai/east").VariantType<{
+                readonly datetime: StructType<{
+                    readonly from: import("@elaraai/east").DateTimeType;
+                    readonly to: import("@elaraai/east").DateTimeType;
+                }>;
+                readonly datetimePreset: import("@elaraai/east").VariantType<{
+                    readonly today: import("@elaraai/east").NullType;
+                    readonly last7d: import("@elaraai/east").NullType;
+                    readonly last30d: import("@elaraai/east").NullType;
+                    readonly last90d: import("@elaraai/east").NullType;
+                    readonly ytd: import("@elaraai/east").NullType;
+                }>;
+                readonly integer: StructType<{
+                    readonly from: import("@elaraai/east").IntegerType;
+                    readonly to: import("@elaraai/east").IntegerType;
+                }>;
+                readonly float: StructType<{
+                    readonly from: import("@elaraai/east").FloatType;
+                    readonly to: import("@elaraai/east").FloatType;
+                }>;
+            }>>;
+            readonly compare: OptionType<import("@elaraai/east").VariantType<{
+                readonly previousPeriod: import("@elaraai/east").NullType;
+                readonly previousYear: import("@elaraai/east").NullType;
+            }>>;
+            readonly filters: import("@elaraai/east").ArrayType<import("@elaraai/east").VariantType<{
+                readonly string: StructType<{
+                    readonly fieldId: StringType;
+                    readonly op: import("@elaraai/east").VariantType<{
+                        readonly eq: StringType;
+                        readonly neq: StringType;
+                        readonly in: import("@elaraai/east").SetType<StringType>;
+                        readonly notIn: import("@elaraai/east").SetType<StringType>;
+                        readonly contains: StringType;
+                        readonly matches: StringType;
+                    }>;
+                }>;
+                readonly integer: StructType<{
+                    readonly fieldId: StringType;
+                    readonly op: import("@elaraai/east").VariantType<{
+                        readonly eq: import("@elaraai/east").IntegerType;
+                        readonly neq: import("@elaraai/east").IntegerType;
+                        readonly lt: import("@elaraai/east").IntegerType;
+                        readonly lte: import("@elaraai/east").IntegerType;
+                        readonly gt: import("@elaraai/east").IntegerType;
+                        readonly gte: import("@elaraai/east").IntegerType;
+                        readonly in: import("@elaraai/east").SetType<import("@elaraai/east").IntegerType>;
+                    }>;
+                }>;
+                readonly float: StructType<{
+                    readonly fieldId: StringType;
+                    readonly op: import("@elaraai/east").VariantType<{
+                        readonly lt: import("@elaraai/east").FloatType;
+                        readonly lte: import("@elaraai/east").FloatType;
+                        readonly gt: import("@elaraai/east").FloatType;
+                        readonly gte: import("@elaraai/east").FloatType;
+                    }>;
+                }>;
+                readonly datetime: StructType<{
+                    readonly fieldId: StringType;
+                    readonly op: import("@elaraai/east").VariantType<{
+                        readonly before: import("@elaraai/east").DateTimeType;
+                        readonly after: import("@elaraai/east").DateTimeType;
+                        readonly between: StructType<{
+                            readonly from: import("@elaraai/east").DateTimeType;
+                            readonly to: import("@elaraai/east").DateTimeType;
+                        }>;
+                    }>;
+                }>;
+                readonly boolean: StructType<{
+                    readonly fieldId: StringType;
+                    readonly op: import("@elaraai/east").VariantType<{
+                        readonly is: import("@elaraai/east").BooleanType;
+                    }>;
+                }>;
+            }>>;
+            readonly cohorts: import("@elaraai/east").ArrayType<StructType<{
+                readonly id: StringType;
+                readonly name: StringType;
+                readonly filters: import("@elaraai/east").ArrayType<import("@elaraai/east").VariantType<{
+                    readonly string: StructType<{
+                        readonly fieldId: StringType;
+                        readonly op: import("@elaraai/east").VariantType<{
+                            readonly eq: StringType;
+                            readonly neq: StringType;
+                            readonly in: import("@elaraai/east").SetType<StringType>;
+                            readonly notIn: import("@elaraai/east").SetType<StringType>;
+                            readonly contains: StringType;
+                            readonly matches: StringType;
+                        }>;
+                    }>;
+                    readonly integer: StructType<{
+                        readonly fieldId: StringType;
+                        readonly op: import("@elaraai/east").VariantType<{
+                            readonly eq: import("@elaraai/east").IntegerType;
+                            readonly neq: import("@elaraai/east").IntegerType;
+                            readonly lt: import("@elaraai/east").IntegerType;
+                            readonly lte: import("@elaraai/east").IntegerType;
+                            readonly gt: import("@elaraai/east").IntegerType;
+                            readonly gte: import("@elaraai/east").IntegerType;
+                            readonly in: import("@elaraai/east").SetType<import("@elaraai/east").IntegerType>;
+                        }>;
+                    }>;
+                    readonly float: StructType<{
+                        readonly fieldId: StringType;
+                        readonly op: import("@elaraai/east").VariantType<{
+                            readonly lt: import("@elaraai/east").FloatType;
+                            readonly lte: import("@elaraai/east").FloatType;
+                            readonly gt: import("@elaraai/east").FloatType;
+                            readonly gte: import("@elaraai/east").FloatType;
+                        }>;
+                    }>;
+                    readonly datetime: StructType<{
+                        readonly fieldId: StringType;
+                        readonly op: import("@elaraai/east").VariantType<{
+                            readonly before: import("@elaraai/east").DateTimeType;
+                            readonly after: import("@elaraai/east").DateTimeType;
+                            readonly between: StructType<{
+                                readonly from: import("@elaraai/east").DateTimeType;
+                                readonly to: import("@elaraai/east").DateTimeType;
+                            }>;
+                        }>;
+                    }>;
+                    readonly boolean: StructType<{
+                        readonly fieldId: StringType;
+                        readonly op: import("@elaraai/east").VariantType<{
+                            readonly is: import("@elaraai/east").BooleanType;
+                        }>;
+                    }>;
+                }>>;
+            }>>;
+            readonly activeCohorts: import("@elaraai/east").SetType<StringType>;
+            readonly breakdown: OptionType<StructType<{
+                readonly fieldId: StringType;
+                readonly limit: OptionType<import("@elaraai/east").IntegerType>;
+            }>>;
+            readonly search: OptionType<StringType>;
+            readonly visible: OptionType<import("@elaraai/east").SetType<StringType>>;
+            readonly selectedIndex: OptionType<import("@elaraai/east").IntegerType>;
+        }>>;
+    }>;
+    readonly heading: OptionType<StringType>;
+    readonly maxHeight: OptionType<StringType>;
+}>;
+/** Type alias for {@link DecisionJournalPayloadType}. */
+export type DecisionJournalPayloadType = typeof DecisionJournalPayloadType;
+/**
+ * Internal {@link EastUI.component} carrier. The React renderer registers
+ * against this in `@elaraai/e3-ui-components` via `implementUIComponent`.
+ */
+export declare const DecisionJournalComponent: import("@elaraai/east-ui").UIComponentDef<StructType<{
+    readonly handle: StructType<{
+        readonly decisions: import("@elaraai/east").ArrayType<StructType<{
+            readonly source: import("@elaraai/east").ArrayType<import("@elaraai/east").VariantType<{
+                readonly field: StringType;
+            }>>;
+            readonly patch: OptionType<import("@elaraai/east").ArrayType<import("@elaraai/east").VariantType<{
+                readonly field: StringType;
+            }>>>;
+            readonly mode: import("@elaraai/east").VariantType<{
+                readonly staged: import("@elaraai/east").NullType;
+                readonly direct: import("@elaraai/east").NullType;
+            }>;
+        }>>;
+        readonly judgements: StructType<{
+            readonly source: import("@elaraai/east").ArrayType<import("@elaraai/east").VariantType<{
+                readonly field: StringType;
+            }>>;
+            readonly patch: OptionType<import("@elaraai/east").ArrayType<import("@elaraai/east").VariantType<{
+                readonly field: StringType;
+            }>>>;
+            readonly mode: import("@elaraai/east").VariantType<{
+                readonly staged: import("@elaraai/east").NullType;
+                readonly direct: import("@elaraai/east").NullType;
+            }>;
+        }>;
+        readonly slice: OptionType<StructType<{
+            readonly range: OptionType<import("@elaraai/east").VariantType<{
+                readonly datetime: StructType<{
+                    readonly from: import("@elaraai/east").DateTimeType;
+                    readonly to: import("@elaraai/east").DateTimeType;
+                }>;
+                readonly datetimePreset: import("@elaraai/east").VariantType<{
+                    readonly today: import("@elaraai/east").NullType;
+                    readonly last7d: import("@elaraai/east").NullType;
+                    readonly last30d: import("@elaraai/east").NullType;
+                    readonly last90d: import("@elaraai/east").NullType;
+                    readonly ytd: import("@elaraai/east").NullType;
+                }>;
+                readonly integer: StructType<{
+                    readonly from: import("@elaraai/east").IntegerType;
+                    readonly to: import("@elaraai/east").IntegerType;
+                }>;
+                readonly float: StructType<{
+                    readonly from: import("@elaraai/east").FloatType;
+                    readonly to: import("@elaraai/east").FloatType;
+                }>;
+            }>>;
+            readonly compare: OptionType<import("@elaraai/east").VariantType<{
+                readonly previousPeriod: import("@elaraai/east").NullType;
+                readonly previousYear: import("@elaraai/east").NullType;
+            }>>;
+            readonly filters: import("@elaraai/east").ArrayType<import("@elaraai/east").VariantType<{
+                readonly string: StructType<{
+                    readonly fieldId: StringType;
+                    readonly op: import("@elaraai/east").VariantType<{
+                        readonly eq: StringType;
+                        readonly neq: StringType;
+                        readonly in: import("@elaraai/east").SetType<StringType>;
+                        readonly notIn: import("@elaraai/east").SetType<StringType>;
+                        readonly contains: StringType;
+                        readonly matches: StringType;
+                    }>;
+                }>;
+                readonly integer: StructType<{
+                    readonly fieldId: StringType;
+                    readonly op: import("@elaraai/east").VariantType<{
+                        readonly eq: import("@elaraai/east").IntegerType;
+                        readonly neq: import("@elaraai/east").IntegerType;
+                        readonly lt: import("@elaraai/east").IntegerType;
+                        readonly lte: import("@elaraai/east").IntegerType;
+                        readonly gt: import("@elaraai/east").IntegerType;
+                        readonly gte: import("@elaraai/east").IntegerType;
+                        readonly in: import("@elaraai/east").SetType<import("@elaraai/east").IntegerType>;
+                    }>;
+                }>;
+                readonly float: StructType<{
+                    readonly fieldId: StringType;
+                    readonly op: import("@elaraai/east").VariantType<{
+                        readonly lt: import("@elaraai/east").FloatType;
+                        readonly lte: import("@elaraai/east").FloatType;
+                        readonly gt: import("@elaraai/east").FloatType;
+                        readonly gte: import("@elaraai/east").FloatType;
+                    }>;
+                }>;
+                readonly datetime: StructType<{
+                    readonly fieldId: StringType;
+                    readonly op: import("@elaraai/east").VariantType<{
+                        readonly before: import("@elaraai/east").DateTimeType;
+                        readonly after: import("@elaraai/east").DateTimeType;
+                        readonly between: StructType<{
+                            readonly from: import("@elaraai/east").DateTimeType;
+                            readonly to: import("@elaraai/east").DateTimeType;
+                        }>;
+                    }>;
+                }>;
+                readonly boolean: StructType<{
+                    readonly fieldId: StringType;
+                    readonly op: import("@elaraai/east").VariantType<{
+                        readonly is: import("@elaraai/east").BooleanType;
+                    }>;
+                }>;
+            }>>;
+            readonly cohorts: import("@elaraai/east").ArrayType<StructType<{
+                readonly id: StringType;
+                readonly name: StringType;
+                readonly filters: import("@elaraai/east").ArrayType<import("@elaraai/east").VariantType<{
+                    readonly string: StructType<{
+                        readonly fieldId: StringType;
+                        readonly op: import("@elaraai/east").VariantType<{
+                            readonly eq: StringType;
+                            readonly neq: StringType;
+                            readonly in: import("@elaraai/east").SetType<StringType>;
+                            readonly notIn: import("@elaraai/east").SetType<StringType>;
+                            readonly contains: StringType;
+                            readonly matches: StringType;
+                        }>;
+                    }>;
+                    readonly integer: StructType<{
+                        readonly fieldId: StringType;
+                        readonly op: import("@elaraai/east").VariantType<{
+                            readonly eq: import("@elaraai/east").IntegerType;
+                            readonly neq: import("@elaraai/east").IntegerType;
+                            readonly lt: import("@elaraai/east").IntegerType;
+                            readonly lte: import("@elaraai/east").IntegerType;
+                            readonly gt: import("@elaraai/east").IntegerType;
+                            readonly gte: import("@elaraai/east").IntegerType;
+                            readonly in: import("@elaraai/east").SetType<import("@elaraai/east").IntegerType>;
+                        }>;
+                    }>;
+                    readonly float: StructType<{
+                        readonly fieldId: StringType;
+                        readonly op: import("@elaraai/east").VariantType<{
+                            readonly lt: import("@elaraai/east").FloatType;
+                            readonly lte: import("@elaraai/east").FloatType;
+                            readonly gt: import("@elaraai/east").FloatType;
+                            readonly gte: import("@elaraai/east").FloatType;
+                        }>;
+                    }>;
+                    readonly datetime: StructType<{
+                        readonly fieldId: StringType;
+                        readonly op: import("@elaraai/east").VariantType<{
+                            readonly before: import("@elaraai/east").DateTimeType;
+                            readonly after: import("@elaraai/east").DateTimeType;
+                            readonly between: StructType<{
+                                readonly from: import("@elaraai/east").DateTimeType;
+                                readonly to: import("@elaraai/east").DateTimeType;
+                            }>;
+                        }>;
+                    }>;
+                    readonly boolean: StructType<{
+                        readonly fieldId: StringType;
+                        readonly op: import("@elaraai/east").VariantType<{
+                            readonly is: import("@elaraai/east").BooleanType;
+                        }>;
+                    }>;
+                }>>;
+            }>>;
+            readonly activeCohorts: import("@elaraai/east").SetType<StringType>;
+            readonly breakdown: OptionType<StructType<{
+                readonly fieldId: StringType;
+                readonly limit: OptionType<import("@elaraai/east").IntegerType>;
+            }>>;
+            readonly search: OptionType<StringType>;
+            readonly visible: OptionType<import("@elaraai/east").SetType<StringType>>;
+            readonly selectedIndex: OptionType<import("@elaraai/east").IntegerType>;
+        }>>;
+    }>;
+    readonly heading: OptionType<StringType>;
+    readonly maxHeight: OptionType<StringType>;
+}>>;
+/**
+ * Options for {@link DecisionJournal.Root}.
+ *
+ * @property handle - The surface's decision handle from `Decision.bind`.
+ * @property heading - Optional header label.
+ * @property maxHeight - Optional cap on the journal's height (a CSS length,
+ *   e.g. `"320px"`). The header stays pinned; the entries scroll. Unset,
+ *   the journal grows with its content.
+ */
+export interface DecisionJournalOptions {
+    handle: DecisionHandleLike;
+    heading?: SubtypeExprOrValue<StringType>;
+    maxHeight?: SubtypeExprOrValue<StringType>;
+}
+/**
+ * The Decision journal component namespace — the resolved-cases read-back.
+ *
+ * @remarks
+ * Use `DecisionJournal.Root({ handle })` inside a `Reactive` block, with the
+ * same handle the queue consumes — as cases resolve they leave the queue and
+ * appear here, newest first. The `Component` property is the
+ * {@link EastUI.component} carrier the renderer registers against.
+ */
+export declare const DecisionJournal: {
+    Root(options: DecisionJournalOptions): ExprType<UIComponentType>;
+    Component: typeof DecisionJournalComponent;
+    Types: {
+        Payload: DecisionJournalPayloadType;
+    };
+};
+//# sourceMappingURL=journal.d.ts.map

package/dist/src/decision/journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../../src/decision/journal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;GAUG;AAEH,OAAO,EAEH,UAAU,EACV,UAAU,EACV,UAAU,EAGV,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAU,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAyB,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAM3E;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIrC,CAAC;AACH,yDAAyD;AACzD,MAAM,MAAM,0BAA0B,GAAG,OAAO,0BAA0B,CAAC;AAE3E;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAsF,CAAC;AAM5H;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAsB;IACnC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACzC,SAAS,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;CAC9C;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,EAAE;IAC1B,IAAI,CAAC,OAAO,EAAE,sBAAsB,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC;IACjE,SAAS,EAAE,OAAO,wBAAwB,CAAC;IAC3C,KAAK,EAAE;QAAE,OAAO,EAAE,0BAA0B,CAAA;KAAE,CAAC;CAyBzC,CAAC"}

package/dist/src/decision/journal.js

@@ -0,0 +1,74 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `DecisionJournal` — the Decide↔Trust seam (the spec's `Decision.Journal`):
+ * the read-back of resolved cases. Each entry is a staged judgement whose
+ * verdict is set — how the case left the queue (accepted / rejected /
+ * deferred / handoff), when, with the operator's captured knowledge and
+ * injected constraints. The exact complement of the queue's projection:
+ * the queue shows cases *without* verdicts, the journal shows cases *with*
+ * them.
+ *
+ * @packageDocumentation
+ */
+import { East, StructType, OptionType, StringType, some, none, } from '@elaraai/east';
+import { EastUI, UIComponentType } from '@elaraai/east-ui';
+import { DecisionHandleRefType } from './bind.js';
+// ============================================================================
+// Payload — the fixed IR shape the renderer decodes.
+// ============================================================================
+/**
+ * The `DecisionJournal` component payload.
+ *
+ * @property handle - The surface's decision handle ref (binding descriptors).
+ * @property heading - Optional header label (e.g. `"Decision journal"`).
+ * @property maxHeight - Optional cap on the journal's height (a CSS length,
+ *   e.g. `"320px"`). The header stays pinned; the entries scroll.
+ */
+export const DecisionJournalPayloadType = StructType({
+    handle: DecisionHandleRefType,
+    heading: OptionType(StringType),
+    maxHeight: OptionType(StringType),
+});
+/**
+ * Internal {@link EastUI.component} carrier. The React renderer registers
+ * against this in `@elaraai/e3-ui-components` via `implementUIComponent`.
+ */
+export const DecisionJournalComponent = EastUI.component("DecisionJournal", DecisionJournalPayloadType, { optional: true });
+/**
+ * The Decision journal component namespace — the resolved-cases read-back.
+ *
+ * @remarks
+ * Use `DecisionJournal.Root({ handle })` inside a `Reactive` block, with the
+ * same handle the queue consumes — as cases resolve they leave the queue and
+ * appear here, newest first. The `Component` property is the
+ * {@link EastUI.component} carrier the renderer registers against.
+ */
+export const DecisionJournal = {
+    /**
+     * Build a decision journal bound to a decision handle.
+     *
+     * @param options - {@link DecisionJournalOptions}. Only `handle` is required.
+     * @returns An East expression of {@link UIComponentType}.
+     */
+    Root(options) {
+        return DecisionJournalComponent.Root({
+            handle: East.value({
+                decisions: options.handle.decisions,
+                judgements: options.handle.judgements,
+                slice: options.handle.sliceInit,
+            }, DecisionHandleRefType),
+            heading: options.heading !== undefined ? some(options.heading) : none,
+            maxHeight: options.maxHeight !== undefined ? some(options.maxHeight) : none,
+        });
+    },
+    /** The internal {@link EastUI.component} carrier renderers register against. */
+    Component: DecisionJournalComponent,
+    Types: {
+        /** The rendered payload struct. */
+        Payload: DecisionJournalPayloadType,
+    },
+};
+//# sourceMappingURL=journal.js.map

package/dist/src/decision/journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../../src/decision/journal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;GAUG;AAEH,OAAO,EACH,IAAI,EACJ,UAAU,EACV,UAAU,EACV,UAAU,EACV,IAAI,EACJ,IAAI,GAGP,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,qBAAqB,EAA2B,MAAM,WAAW,CAAC;AAE3E,+EAA+E;AAC/E,qDAAqD;AACrD,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,UAAU,CAAC;IACjD,MAAM,EAAE,qBAAqB;IAC7B,OAAO,EAAE,UAAU,CAAC,UAAU,CAAC;IAC/B,SAAS,EAAE,UAAU,CAAC,UAAU,CAAC;CACpC,CAAC,CAAC;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,SAAS,CAAC,iBAAiB,EAAE,0BAA0B,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AAqB5H;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,eAAe,GAIxB;IACA;;;;;OAKG;IACH,IAAI,CAAC,OAA+B;QAChC,OAAO,wBAAwB,CAAC,IAAI,CAAC;YACjC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;gBACf,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;gBACnC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU;gBACrC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;aAClC,EAAE,qBAAqB,CAAC;YACzB,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;YACrE,SAAS,EAAE,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI;SAC9E,CAAC,CAAC;IACP,CAAC;IACD,gFAAgF;IAChF,SAAS,EAAE,wBAAwB;IACnC,KAAK,EAAE;QACH,mCAAmC;QACnC,OAAO,EAAE,0BAA0B;KACtC;CACK,CAAC"}