@elaraai/e3-ui 1.0.30 → 1.0.32

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

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

package/dist/src/experiment/index.js

@@ -30,19 +30,26 @@
  *
  * @packageDocumentation
  */
-import { NullType, BooleanType, ArrayType, StructType, VariantType, OptionType, East, none, some, variant, } from '@elaraai/east';
+import { NullType, BooleanType, ArrayType, StringType, StructType, VariantType, OptionType, East, none, some, variant, } from '@elaraai/east';
 import { EastUI } from '@elaraai/east-ui';
 import { DiffBindingType } from '../bind/data.js';
 import { FuncBindingType } from '../bind/func.js';
-import { ExperimentConfigType, ExperimentResultType, DoseResponseType, JournalType, ColumnMetaType, PopulationType, ConfigurationType, DesignConfigType, ExperimentDesignType, CiType, BalanceRowType, OverlapDiagnosticType, RefutationType, SensitivityCurveType, AdjustedEffectType, ExperimentVerdictType, } from './types.js';
+import { ExperimentConfigType, ExperimentResultType, DoseResponseType, JournalType, ColumnMetaType, PopulationType, ConfigurationType, DesignConfigType, ExperimentDesignType, CiType, BalanceRowType, OverlapDiagnosticType, RefutationType, SensitivityCurveType, SensitivityBenchmarkType, AdjustedEffectType, ExperimentVerdictType, VerdictReasonType, } from './types.js';
 // Re-export the contract types so consumers can reach them from the component
 // module too (the canonical home is `./types`).
-export { CiType, WeightingSchemeType, EstimatorType, TargetUnitsType, BootstrapConfigType, RefuteSpecType, ExperimentConfigType, BalanceRowType, OverlapDiagnosticType, RefutationType, DoseResponseType, ExperimentVerdictType, ExperimentResultType, JournalRowType, JournalType, ColumnMetaType, PopulationType, ConfigurationType, } from './types.js';
+export { CiType, WeightingSchemeType, EstimatorType, TargetUnitsType, BootstrapConfigType, RefuteSpecType, ExperimentConfigType, BalanceRowType, SensitivityBenchmarkType, OverlapDiagnosticType, RefutationType, DoseResponseType, ExperimentVerdictType, VerdictReasonType, ExperimentResultType, JournalRowType, JournalType, ColumnMetaType, PopulationType, ConfigurationType, } from './types.js';
 // ============================================================================
 // Component payload — descriptors only (binding handles + options).
 // ============================================================================
 /** Initial result tab variant — `answer` (default), `trust`, `dose`, or `validate`. */
 export const ExperimentTabType = VariantType({ answer: NullType, trust: NullType, dose: NullType, validate: NullType });
+/**
+ * The domain noun for one row of the bound dataset — singular + plural (e.g.
+ * `{ one: 'batch', many: 'batches' }`). The surface interpolates it everywhere
+ * it speaks about rows ("Which batches?", "480 batches", the guidance
+ * glossary), replacing the neutral default `record(s)`.
+ */
+export const ExperimentSubjectType = StructType({ one: StringType, many: StringType });
 /**
  * The `Experiment` component payload — binding descriptors + options. Renderers
  * decode this and resolve each binding to a live, reactive value / call handle.
@@ -58,6 +65,7 @@ export const ExperimentTabType = VariantType({ answer: NullType, trust: NullType
  * @property design - Optional {@link FuncBindingType} for the universal `design` function
  *   (the "Validate" tab); applies to any question.
  * @property columnMeta - Optional per-column display metadata.
+ * @property subject - Optional domain noun for a row ({@link ExperimentSubjectType}).
  * @property readonly - Render without the Apply / Commit / edit affordances.
  * @property defaultTab - Initial result tab ({@link ExperimentTabType}).
  */
@@ -68,6 +76,7 @@ export const ExperimentPayloadType = StructType({
     journal: OptionType(DiffBindingType),
     design: OptionType(FuncBindingType),
     columnMeta: OptionType(ColumnMetaType),
+    subject: OptionType(ExperimentSubjectType),
     readonly: OptionType(BooleanType),
     defaultTab: OptionType(ExperimentTabType),
 });
@@ -76,6 +85,16 @@ export const ExperimentPayloadType = StructType({
  * against this in `@elaraai/e3-ui-components`.
  */
 export const ExperimentComponent = EastUI.component('Experiment', ExperimentPayloadType, { optional: true });
+/** Naive English plural for a {@link ExperimentOptions.subject} noun given as a
+ *  bare string — `batch` → `batches`, `delivery` → `deliveries`, `customer` →
+ *  `customers`. Pass `{ one, many }` for anything irregular. */
+function pluralize(one) {
+    if (/[^aeiou]y$/i.test(one))
+        return `${one.slice(0, -1)}ies`;
+    if (/(s|x|z|ch|sh)$/i.test(one))
+        return `${one}es`;
+    return `${one}s`;
+}
 /**
  * Build an Experiment surface bound to an input dataset + the single experiment
  * function.
@@ -96,6 +115,11 @@ function createExperiment(options) {
                 unit: c?.unit !== undefined ? some(c.unit) : none,
                 higherIsBetter: c?.higherIsBetter !== undefined ? some(c.higherIsBetter) : none,
             }])), ColumnMetaType));
+    const subject = options.subject === undefined
+        ? none
+        : some(East.value(typeof options.subject === 'string'
+            ? { one: options.subject, many: pluralize(options.subject) }
+            : options.subject, ExperimentSubjectType));
     // `configs` is a binding to a full Array<Configuration> (each entry's `spec` is a
     // complete ExperimentConfigType + optional precomputed result/design) — no
     // friendly-partial completion here; the bound dataset carries full values.
@@ -106,6 +130,7 @@ function createExperiment(options) {
         journal: options.journal !== undefined ? some(options.journal.binding) : none,
         design: options.design !== undefined ? some(options.design.binding) : none,
         columnMeta,
+        subject,
         readonly: options.readonly === undefined ? none : some(options.readonly),
         defaultTab,
     });
@@ -143,8 +168,12 @@ export const Experiment = {
         Refutation: RefutationType,
         /** The unobserved-confounder sensitivity (tipping) curve. */
         Sensitivity: SensitivityCurveType,
+        /** One observed confounder benchmarked on the sensitivity strengths axis. */
+        SensitivityBenchmark: SensitivityBenchmarkType,
         /** The honesty verdict tag. */
         Verdict: ExperimentVerdictType,
+        /** Machine-readable reason a verdict fell short of `causal`. */
+        VerdictReason: VerdictReasonType,
         /** The ALE dose-response curve value type (the "How much?" tab). */
         DoseResponse: DoseResponseType,
         /** The committed-experiment journal value type. */
@@ -159,6 +188,8 @@ export const Experiment = {
         Configuration: ConfigurationType,
         /** Optional per-column display metadata. */
         ColumnMeta: ColumnMetaType,
+        /** Optional domain noun for a row (singular + plural). */
+        Subject: ExperimentSubjectType,
         /** Initial result tab variant. */
         Tab: ExperimentTabType,
     },

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

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

package/dist/src/experiment/types.d.ts

@@ -162,9 +162,24 @@ export declare const BalanceRowType: StructType<{
     readonly treated_mean: FloatType;
     readonly control_mean: FloatType;
     readonly std_diff: FloatType;
+    /** Post-adjustment SMD (weighted means, same pooled-sd denominator) — proof the
+     *  adjustment closed the gap. `some` only for the propensity estimator with
+     *  computable scores.
+     *  twin: east-py-datascience BalanceRowType.std_diff_adjusted */
+    readonly std_diff_adjusted: OptionType<FloatType>;
 }>;
 /** Type alias for {@link BalanceRowType}. */
 export type BalanceRowType = typeof BalanceRowType;
+/** One observed confounder placed on the sensitivity strengths axis — the simulated
+ *  strength whose effect-shift equals the shift from omitting that confounder, so
+ *  "tips at 0.9" reads as "a hidden cause as strong as `column`".
+ *  twin: east-py-datascience `SensitivityBenchmarkType` */
+export declare const SensitivityBenchmarkType: StructType<{
+    readonly column: StringType;
+    readonly strength: FloatType;
+}>;
+/** Type alias for {@link SensitivityBenchmarkType}. */
+export type SensitivityBenchmarkType = typeof SensitivityBenchmarkType;
 /**
  * Graded common-support tier — `refused` (below `min_overlap`), `thin` (clears the
  * refuse gate but below `strong_overlap`), `strong` (≥ `strong_overlap`). Vacuously
@@ -200,6 +215,13 @@ export type OverlapDiagnosticType = typeof OverlapDiagnosticType;
 export declare const SensitivityCurveType: StructType<{
     readonly strengths: VectorType<FloatType>;
     readonly effects: VectorType<FloatType>;
+    /** Observed-confounder benchmarks on the SAME strengths axis (empty when none is
+     *  computable) — lets the surface say "survives a hidden cause as strong as
+     *  `incoming_grade`". Clamped to the last simulated strength. */
+    readonly benchmarks: ArrayType<StructType<{
+        readonly column: StringType;
+        readonly strength: FloatType;
+    }>>;
 }>;
 /** Type alias for {@link SensitivityCurveType}. */
 export type SensitivityCurveType = typeof SensitivityCurveType;
@@ -222,6 +244,13 @@ export declare const RefutationType: StructType<{
     readonly sensitivity: OptionType<StructType<{
         readonly strengths: VectorType<FloatType>;
         readonly effects: VectorType<FloatType>;
+        /** Observed-confounder benchmarks on the SAME strengths axis (empty when none is
+         *  computable) — lets the surface say "survives a hidden cause as strong as
+         *  `incoming_grade`". Clamped to the last simulated strength. */
+        readonly benchmarks: ArrayType<StructType<{
+            readonly column: StringType;
+            readonly strength: FloatType;
+        }>>;
     }>>;
     /** Sign-prior check (when `config.expected_sign` is set): `some(true)` if a material
      *  effect matches the expected direction, `some(false)` if it points the other way,
@@ -256,6 +285,28 @@ export declare const ExperimentVerdictType: VariantType<{
 }>;
 /** Type alias for {@link ExperimentVerdictType}. */
 export type ExperimentVerdictType = typeof ExperimentVerdictType;
+/**
+ * Machine-readable reason a verdict fell short of `causal` — every FAILING gate
+ * (the verdict tag is chosen by severity precedence, but explaining "why modest?"
+ * needs all of them). Empty for `causal` and for the two refusal verdicts.
+ * twin: east-py-datascience `VerdictReasonType`
+ */
+export declare const VerdictReasonType: VariantType<{
+    /** The placebo (shuffle) refuter didn't collapse to ~0. */
+    readonly placebo_failed: NullType;
+    /** |effect| below the materiality band (0.10 × outcome_sd). */
+    readonly not_material: NullType;
+    /** The adjusted CI straddles zero. */
+    readonly ci_spans_zero: NullType;
+    /** Material + CI-clear but pointing against `config.expected_sign`. */
+    readonly wrong_sign: NullType;
+    /** Common support cleared the refuse gate but is below `strong_overlap`. */
+    readonly thin_support: NullType;
+    /** E-value below the (opt-in) `evalue_floor`. */
+    readonly low_robustness: NullType;
+}>;
+/** Type alias for {@link VerdictReasonType}. */
+export type VerdictReasonType = typeof VerdictReasonType;
 /** The adjusted (like-for-like) effect + its CI — `none` on the result when the engine refuses. */
 export declare const AdjustedEffectType: StructType<{
     readonly effect: FloatType;
@@ -287,6 +338,8 @@ export declare const ExperimentResultType: StructType<{
     readonly n_total: IntegerType;
     readonly n_treated: IntegerType;
     readonly n_control: IntegerType;
+    /** Rows OUTSIDE the propensity common support — units with no like-for-like
+     *  counterpart on the other side. Display-only; nothing is dropped. */
     readonly n_dropped: IntegerType;
     readonly balance: ArrayType<StructType<{
         readonly column: StringType;
@@ -296,6 +349,11 @@ export declare const ExperimentResultType: StructType<{
         readonly treated_mean: FloatType;
         readonly control_mean: FloatType;
         readonly std_diff: FloatType;
+        /** Post-adjustment SMD (weighted means, same pooled-sd denominator) — proof the
+         *  adjustment closed the gap. `some` only for the propensity estimator with
+         *  computable scores.
+         *  twin: east-py-datascience BalanceRowType.std_diff_adjusted */
+        readonly std_diff_adjusted: OptionType<FloatType>;
     }>>;
     readonly overlap: StructType<{
         readonly treated_propensity: VectorType<FloatType>;
@@ -330,6 +388,13 @@ export declare const ExperimentResultType: StructType<{
         readonly sensitivity: OptionType<StructType<{
             readonly strengths: VectorType<FloatType>;
             readonly effects: VectorType<FloatType>;
+            /** Observed-confounder benchmarks on the SAME strengths axis (empty when none is
+             *  computable) — lets the surface say "survives a hidden cause as strong as
+             *  `incoming_grade`". Clamped to the last simulated strength. */
+            readonly benchmarks: ArrayType<StructType<{
+                readonly column: StringType;
+                readonly strength: FloatType;
+            }>>;
         }>>;
         /** Sign-prior check (when `config.expected_sign` is set): `some(true)` if a material
          *  effect matches the expected direction, `some(false)` if it points the other way,
@@ -354,6 +419,31 @@ export declare const ExperimentResultType: StructType<{
         readonly non_identifiable_positivity: NullType;
         readonly not_estimable: StringType;
     }>;
+    /** Why the verdict fell short of `causal` — every failing gate (empty for
+     *  `causal` and for the refusals, where the tag itself is the reason). */
+    readonly verdict_reasons: ArrayType<VariantType<{
+        /** The placebo (shuffle) refuter didn't collapse to ~0. */
+        readonly placebo_failed: NullType;
+        /** |effect| below the materiality band (0.10 × outcome_sd). */
+        readonly not_material: NullType;
+        /** The adjusted CI straddles zero. */
+        readonly ci_spans_zero: NullType;
+        /** Material + CI-clear but pointing against `config.expected_sign`. */
+        readonly wrong_sign: NullType;
+        /** Common support cleared the refuse gate but is below `strong_overlap`. */
+        readonly thin_support: NullType;
+        /** E-value below the (opt-in) `evalue_floor`. */
+        readonly low_robustness: NullType;
+    }>>;
+    /** The outcome's standard deviation — the scale the materiality band is on. */
+    readonly outcome_sd: FloatType;
+    /** The materiality band the verdict applied (0.10 × outcome_sd), echoed so the
+     *  surface can say "smaller than what would matter here (±x)". */
+    readonly materiality_threshold: FloatType;
+    /** Raw outcome mean of the treated arm (`none` when the arm is empty). */
+    readonly treated_outcome_mean: OptionType<FloatType>;
+    /** Raw outcome mean of the control arm (`none` when the arm is empty). */
+    readonly control_outcome_mean: OptionType<FloatType>;
 }>;
 /** Type alias for {@link ExperimentResultType}. */
 export type ExperimentResultType = typeof ExperimentResultType;
@@ -679,6 +769,8 @@ export declare const ConfigurationType: StructType<{
         readonly n_total: IntegerType;
         readonly n_treated: IntegerType;
         readonly n_control: IntegerType;
+        /** Rows OUTSIDE the propensity common support — units with no like-for-like
+         *  counterpart on the other side. Display-only; nothing is dropped. */
         readonly n_dropped: IntegerType;
         readonly balance: ArrayType<StructType<{
             readonly column: StringType;
@@ -688,6 +780,11 @@ export declare const ConfigurationType: StructType<{
             readonly treated_mean: FloatType;
             readonly control_mean: FloatType;
             readonly std_diff: FloatType;
+            /** Post-adjustment SMD (weighted means, same pooled-sd denominator) — proof the
+             *  adjustment closed the gap. `some` only for the propensity estimator with
+             *  computable scores.
+             *  twin: east-py-datascience BalanceRowType.std_diff_adjusted */
+            readonly std_diff_adjusted: OptionType<FloatType>;
         }>>;
         readonly overlap: StructType<{
             readonly treated_propensity: VectorType<FloatType>;
@@ -722,6 +819,13 @@ export declare const ConfigurationType: StructType<{
             readonly sensitivity: OptionType<StructType<{
                 readonly strengths: VectorType<FloatType>;
                 readonly effects: VectorType<FloatType>;
+                /** Observed-confounder benchmarks on the SAME strengths axis (empty when none is
+                 *  computable) — lets the surface say "survives a hidden cause as strong as
+                 *  `incoming_grade`". Clamped to the last simulated strength. */
+                readonly benchmarks: ArrayType<StructType<{
+                    readonly column: StringType;
+                    readonly strength: FloatType;
+                }>>;
             }>>;
             /** Sign-prior check (when `config.expected_sign` is set): `some(true)` if a material
              *  effect matches the expected direction, `some(false)` if it points the other way,
@@ -746,6 +850,31 @@ export declare const ConfigurationType: StructType<{
             readonly non_identifiable_positivity: NullType;
             readonly not_estimable: StringType;
         }>;
+        /** Why the verdict fell short of `causal` — every failing gate (empty for
+         *  `causal` and for the refusals, where the tag itself is the reason). */
+        readonly verdict_reasons: ArrayType<VariantType<{
+            /** The placebo (shuffle) refuter didn't collapse to ~0. */
+            readonly placebo_failed: NullType;
+            /** |effect| below the materiality band (0.10 × outcome_sd). */
+            readonly not_material: NullType;
+            /** The adjusted CI straddles zero. */
+            readonly ci_spans_zero: NullType;
+            /** Material + CI-clear but pointing against `config.expected_sign`. */
+            readonly wrong_sign: NullType;
+            /** Common support cleared the refuse gate but is below `strong_overlap`. */
+            readonly thin_support: NullType;
+            /** E-value below the (opt-in) `evalue_floor`. */
+            readonly low_robustness: NullType;
+        }>>;
+        /** The outcome's standard deviation — the scale the materiality band is on. */
+        readonly outcome_sd: FloatType;
+        /** The materiality band the verdict applied (0.10 × outcome_sd), echoed so the
+         *  surface can say "smaller than what would matter here (±x)". */
+        readonly materiality_threshold: FloatType;
+        /** Raw outcome mean of the treated arm (`none` when the arm is empty). */
+        readonly treated_outcome_mean: OptionType<FloatType>;
+        /** Raw outcome mean of the control arm (`none` when the arm is empty). */
+        readonly control_outcome_mean: OptionType<FloatType>;
     }>>;
     /** Optional precomputed "Validate" recipe ({@link ExperimentDesignType}) for this
      *  question; `none` ⇒ compute live via the `design` function (if bound). */

package/dist/src/experiment/types.d.ts.map

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

package/dist/src/experiment/types.js

@@ -120,6 +120,19 @@ export const BalanceRowType = StructType({
     treated_mean: FloatType,
     control_mean: FloatType,
     std_diff: FloatType,
+    /** Post-adjustment SMD (weighted means, same pooled-sd denominator) — proof the
+     *  adjustment closed the gap. `some` only for the propensity estimator with
+     *  computable scores.
+     *  twin: east-py-datascience BalanceRowType.std_diff_adjusted */
+    std_diff_adjusted: OptionType(FloatType),
+});
+/** One observed confounder placed on the sensitivity strengths axis — the simulated
+ *  strength whose effect-shift equals the shift from omitting that confounder, so
+ *  "tips at 0.9" reads as "a hidden cause as strong as `column`".
+ *  twin: east-py-datascience `SensitivityBenchmarkType` */
+export const SensitivityBenchmarkType = StructType({
+    column: StringType,
+    strength: FloatType,
 });
 /**
  * Graded common-support tier — `refused` (below `min_overlap`), `thin` (clears the
@@ -148,6 +161,10 @@ export const OverlapDiagnosticType = StructType({
 export const SensitivityCurveType = StructType({
     strengths: VectorType(FloatType),
     effects: VectorType(FloatType),
+    /** Observed-confounder benchmarks on the SAME strengths axis (empty when none is
+     *  computable) — lets the surface say "survives a hidden cause as strong as
+     *  `incoming_grade`". Clamped to the last simulated strength. */
+    benchmarks: ArrayType(SensitivityBenchmarkType),
 });
 /** The robustness summary the verdict + trust tab consume. */
 export const RefutationType = StructType({
@@ -193,6 +210,26 @@ export const ExperimentVerdictType = VariantType({
     non_identifiable_positivity: NullType,
     not_estimable: StringType,
 });
+/**
+ * Machine-readable reason a verdict fell short of `causal` — every FAILING gate
+ * (the verdict tag is chosen by severity precedence, but explaining "why modest?"
+ * needs all of them). Empty for `causal` and for the two refusal verdicts.
+ * twin: east-py-datascience `VerdictReasonType`
+ */
+export const VerdictReasonType = VariantType({
+    /** The placebo (shuffle) refuter didn't collapse to ~0. */
+    placebo_failed: NullType,
+    /** |effect| below the materiality band (0.10 × outcome_sd). */
+    not_material: NullType,
+    /** The adjusted CI straddles zero. */
+    ci_spans_zero: NullType,
+    /** Material + CI-clear but pointing against `config.expected_sign`. */
+    wrong_sign: NullType,
+    /** Common support cleared the refuse gate but is below `strong_overlap`. */
+    thin_support: NullType,
+    /** E-value below the (opt-in) `evalue_floor`. */
+    low_robustness: NullType,
+});
 /** The adjusted (like-for-like) effect + its CI — `none` on the result when the engine refuses. */
 export const AdjustedEffectType = StructType({ effect: FloatType, ci: OptionType(CiType) });
 /**
@@ -207,6 +244,8 @@ export const ExperimentResultType = StructType({
     n_total: IntegerType,
     n_treated: IntegerType,
     n_control: IntegerType,
+    /** Rows OUTSIDE the propensity common support — units with no like-for-like
+     *  counterpart on the other side. Display-only; nothing is dropped. */
     n_dropped: IntegerType,
     balance: ArrayType(BalanceRowType),
     overlap: OverlapDiagnosticType,
@@ -214,6 +253,18 @@ export const ExperimentResultType = StructType({
     /** ALE dose-response of `dose_feature` (present when `config.dose_feature` is set). */
     dose_response: OptionType(DoseResponseType),
     verdict: ExperimentVerdictType,
+    /** Why the verdict fell short of `causal` — every failing gate (empty for
+     *  `causal` and for the refusals, where the tag itself is the reason). */
+    verdict_reasons: ArrayType(VerdictReasonType),
+    /** The outcome's standard deviation — the scale the materiality band is on. */
+    outcome_sd: FloatType,
+    /** The materiality band the verdict applied (0.10 × outcome_sd), echoed so the
+     *  surface can say "smaller than what would matter here (±x)". */
+    materiality_threshold: FloatType,
+    /** Raw outcome mean of the treated arm (`none` when the arm is empty). */
+    treated_outcome_mean: OptionType(FloatType),
+    /** Raw outcome mean of the control arm (`none` when the arm is empty). */
+    control_outcome_mean: OptionType(FloatType),
 });
 // ============================================================================
 // Validation-design contract (= Causal.Types.ExperimentDesign*)

package/dist/src/experiment/types.js.map

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

package/dist/src/runtime/decision/queue.d.ts

@@ -32,6 +32,21 @@ import { DecisionQueue as DecisionQueueFactory } from "../../decision/queue.js";
  * ));
  * ```
  *
+ * @example
+ * ```tsx
+ * // Grouped queue — `groupBy` mounts the Group-by toolbar (built-in Urgency /
+ * // Kind / None plus the custom `groups` accessors); sections collapse.
+ * <DecisionQueue
+ *     handle={handle}
+ *     heading="Decisions waiting"
+ *     groupBy="urgency"
+ *     groups={{
+ *         'Value band': d => d.value.greater(50000.0).ifElse(() => 'High', () => 'Standard'),
+ *     }}
+ *     collapsible
+ * />
+ * ```
+ *
  * @remarks
  * Carries `DecisionQueue.Types`. Desugars to `DecisionQueue.Root(options)`. The
  * renderer registers against `DecisionQueue.Component` (from

package/dist/src/runtime/decision/queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../../src/runtime/decision/queue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sDAAsD;AAEtD,OAAO,EAAc,KAAK,YAAY,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,aAAa,IAAI,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,YAAY,CAAC,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,GAAG;IACjF,KAAK,EAAE,OAAO,oBAAoB,CAAC,KAAK,CAAC;CACkD,CAAC"}
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../../src/runtime/decision/queue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sDAAsD;AAEtD,OAAO,EAAc,KAAK,YAAY,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,aAAa,IAAI,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,YAAY,CAAC,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,GAAG;IACjF,KAAK,EAAE,OAAO,oBAAoB,CAAC,KAAK,CAAC;CACkD,CAAC"}

package/dist/src/runtime/decision/queue.js

@@ -32,6 +32,21 @@ import { DecisionQueue as DecisionQueueFactory } from "../../decision/queue.js";
  * ));
  * ```
  *
+ * @example
+ * ```tsx
+ * // Grouped queue — `groupBy` mounts the Group-by toolbar (built-in Urgency /
+ * // Kind / None plus the custom `groups` accessors); sections collapse.
+ * <DecisionQueue
+ *     handle={handle}
+ *     heading="Decisions waiting"
+ *     groupBy="urgency"
+ *     groups={{
+ *         'Value band': d => d.value.greater(50000.0).ifElse(() => 'High', () => 'Standard'),
+ *     }}
+ *     collapsible
+ * />
+ * ```
+ *
  * @remarks
  * Carries `DecisionQueue.Types`. Desugars to `DecisionQueue.Root(options)`. The
  * renderer registers against `DecisionQueue.Component` (from

package/dist/src/runtime/decision/queue.js.map

@@ -1 +1 @@
-{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../../../src/runtime/decision/queue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sDAAsD;AAEtD,OAAO,EAAE,UAAU,EAAkC,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,aAAa,IAAI,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,CAAC,MAAM,aAAa,GAEtB,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,oBAAoB,CAAC,KAAK,EAAE,CAAC,CAAC"}
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../../../src/runtime/decision/queue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sDAAsD;AAEtD,OAAO,EAAE,UAAU,EAAkC,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,aAAa,IAAI,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,CAAC,MAAM,aAAa,GAEtB,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,oBAAoB,CAAC,KAAK,EAAE,CAAC,CAAC"}

package/dist/test/decision/queue.examples.d.ts

@@ -272,4 +272,5 @@ export declare const decisionQueueOptions: import("@elaraai/east").ExampleDef<[]
 export declare const decisionQueueNarrow: import("@elaraai/east").ExampleDef<[], any>;
 export declare const decisionQueueScroll: import("@elaraai/east").ExampleDef<[], any>;
 export declare const decisionQueueSlice: import("@elaraai/east").ExampleDef<[], any>;
+export declare const decisionQueueGrouped: import("@elaraai/east").ExampleDef<[], any>;
 //# sourceMappingURL=queue.examples.d.ts.map

package/dist/test/decision/queue.examples.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue.examples.d.ts","sourceRoot":"","sources":["../../../test/decision/queue.examples.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wCAAwC;AAExC;;;;;;;;;;;GAWG;AAEH,OAAO,EACG,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAC7E,QAAQ,EAAE,WAAW,EAAc,OAAO,EAC7C,MAAM,eAAe,CAAC;AAGvB,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAQlC,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;EAW3B,CAAC;AAeH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uEAmH1B,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wEAa3B,CAAC;AAMF,eAAO,MAAM,iBAAiB,6CAgF5B,CAAC;AAOH,eAAO,MAAM,sBAAsB,6CAuBjC,CAAC;AAEH,eAAO,MAAM,mBAAmB,6CAuB9B,CAAC;AAEH,eAAO,MAAM,sBAAsB,6CAsBjC,CAAC;AAMH,eAAO,MAAM,oBAAoB,6CAuB/B,CAAC;AAQH,eAAO,MAAM,mBAAmB,6CAyB9B,CAAC;AAMH,eAAO,MAAM,mBAAmB,6CAc9B,CAAC;AASH,eAAO,MAAM,kBAAkB,6CA0B7B,CAAC"}
+{"version":3,"file":"queue.examples.d.ts","sourceRoot":"","sources":["../../../test/decision/queue.examples.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wCAAwC;AAExC;;;;;;;;;;;GAWG;AAEH,OAAO,EACG,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAC7E,QAAQ,EAAE,WAAW,EAAc,OAAO,EAC7C,MAAM,eAAe,CAAC;AAGvB,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAQlC,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;EAW3B,CAAC;AAeH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uEAmH1B,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wEAa3B,CAAC;AAMF,eAAO,MAAM,iBAAiB,6CAgF5B,CAAC;AAOH,eAAO,MAAM,sBAAsB,6CAuBjC,CAAC;AAEH,eAAO,MAAM,mBAAmB,6CAuB9B,CAAC;AAEH,eAAO,MAAM,sBAAsB,6CAsBjC,CAAC;AAMH,eAAO,MAAM,oBAAoB,6CAuB/B,CAAC;AAQH,eAAO,MAAM,mBAAmB,6CAyB9B,CAAC;AAMH,eAAO,MAAM,mBAAmB,6CAc9B,CAAC;AASH,eAAO,MAAM,kBAAkB,6CA0B7B,CAAC;AAUH,eAAO,MAAM,oBAAoB,6CAwB/B,CAAC"}

package/dist/test/decision/queue.examples.js

@@ -349,4 +349,25 @@ export const decisionQueueSlice = example({
     }),
     inputs: [],
 });
+// ============================================================================
+// 8. Grouped queue — `groupBy` mounts the Group-by toolbar (built-in Urgency /
+//    Kind / None plus the custom `groups` accessors); sections collapse with a
+//    Collapse-all control, and the urgency grouping's Routine section ships
+//    collapsed hosting the bulk Accept all.
+// ============================================================================
+export const decisionQueueGrouped = example({
+    keywords: ['DecisionQueue', 'Decide', 'grouping', 'groupBy', 'groups', 'collapsible', 'urgency', 'kind', 'custom', 'accessor', 'Accept all'],
+    description: 'Grouped queue — Group-by Urgency (default) / Kind / a custom Value-band accessor; collapsible sections with Collapse-all, the Routine section collapsed with its bulk Accept all',
+    fn: East.function([], UIComponentType, (_$) => {
+        return (_jsx(Reactive, { children: $ => {
+                const decisions = $.let(Data.bind(queueDecisions, { mode: 'direct' }));
+                const judgements = $.let(Data.bind(queueJudgements, { mode: 'direct' }));
+                const handle = $.let(Decision.bind([RosterConstraint], { decisions: [decisions], judgements }));
+                return (_jsx(DecisionQueue, { handle: handle, heading: "Decisions waiting", groupBy: "urgency", groups: {
+                        'Value band': d => d.value.greater(50000.0).ifElse(() => 'High', () => 'Standard'),
+                    }, collapsible: true }));
+            } }));
+    }),
+    inputs: [],
+});
 //# sourceMappingURL=queue.examples.js.map