@elaraai/e3-ui 1.0.11 → 1.0.13

package/dist/src/experiment/types.js

@@ -0,0 +1,292 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The `Experiment` render contract.
+ *
+ * These types are **replicated verbatim (snake_case)** from
+ * `east-py-datascience`'s `Causal.Types.*`, so the engine's `Causal.experiment`
+ * result unifies **structurally** with the component's binding — replicate, don't
+ * share (East type equality is structural; `e3-ui` never imports
+ * `east-py-datascience`). Keep these byte-identical to the datascience
+ * definitions — they are kept in sync by hand.
+ *
+ * The user edits an {@link ExperimentConfigType} (the staged "question + method")
+ * and **Apply** runs the one bound `experiment` function, which returns an
+ * {@link ExperimentResultType} — the naive vs adjusted effect, confounder
+ * balance, propensity overlap, a robustness summary, and an honesty
+ * {@link ExperimentVerdictType}. `adjusted` is `none` when the engine refuses.
+ *
+ * @packageDocumentation
+ */
+import { StructType, VariantType, OptionType, ArrayType, DictType, FloatType, IntegerType, BooleanType, StringType, NullType, DateTimeType, VectorType, } from '@elaraai/east';
+import { Slice } from '@elaraai/east-ui';
+// ============================================================================
+// Shared vocabulary (= Causal.Types.*)
+// ============================================================================
+/** A confidence interval. */
+export const CiType = StructType({ lower: FloatType, upper: FloatType });
+/** Inverse-propensity weighting scheme. */
+export const WeightingSchemeType = VariantType({
+    ips_weight: NullType,
+    ips_stabilized_weight: NullType,
+    ips_normalized_weight: NullType,
+});
+/** Backdoor-adjusted effect estimator. */
+export const EstimatorType = VariantType({
+    linear_regression: NullType,
+    propensity_score_weighting: StructType({
+        weighting_scheme: OptionType(WeightingSchemeType),
+    }),
+});
+/** Population the effect is reported for. */
+export const TargetUnitsType = VariantType({
+    ate: NullType,
+    att: NullType,
+    atc: NullType,
+});
+/** Bootstrap confidence-interval configuration. */
+export const BootstrapConfigType = StructType({
+    reps: IntegerType,
+    cluster_column: OptionType(StringType),
+    confidence_level: OptionType(FloatType),
+});
+/** Which robustness checks to run. */
+export const RefuteSpecType = StructType({
+    /** Permuted-treatment negative control — a real effect should vanish. */
+    placebo: BooleanType,
+    /** Inject an independent random common cause — the effect should hold. */
+    random_common_cause: BooleanType,
+    /** Re-estimate on random subsamples — the effect should be stable. */
+    data_subset: BooleanType,
+    /** Unobserved-confounder strengths to simulate → the sensitivity / tipping curve. */
+    sensitivity: OptionType(ArrayType(FloatType)),
+});
+// ============================================================================
+// The config the user edits (= CausalExperimentConfigType)
+// ============================================================================
+/**
+ * The experiment the user framed — the staged value the pickers write and
+ * **Apply** feeds to the bound `experiment` function.
+ *
+ * `treatment` / `outcome` / `common_causes` / `categorical` are **column names**
+ * introspected from the bound dataset's row struct (the `Table` pattern). The
+ * `method` / `estimand` advanced choices and the `min_*` guard thresholds are
+ * optional developer-defaulted, user-adjustable knobs.
+ */
+export const ExperimentConfigType = StructType({
+    treatment: StringType,
+    outcome: StringType,
+    common_causes: ArrayType(StringType),
+    categorical: OptionType(ArrayType(StringType)),
+    method: OptionType(EstimatorType),
+    estimand: OptionType(TargetUnitsType),
+    refute: OptionType(RefuteSpecType),
+    /** Continuous column for the ALE dose-response curve (the "How much?" view). */
+    dose_feature: OptionType(StringType),
+    min_overlap: OptionType(FloatType),
+    min_treatment_variation: OptionType(FloatType),
+    bootstrap: OptionType(BootstrapConfigType),
+    random_state: OptionType(IntegerType),
+});
+// ============================================================================
+// The result the engine returns (= CausalExperimentResultType)
+// ============================================================================
+/** One confounder's before-adjustment imbalance (categoricals → one row per level). */
+export const BalanceRowType = StructType({
+    column: StringType,
+    /** The original confounder this row belongs to — equals `column` for a numeric
+     *  confounder; the base confounder for a one-hot categorical level. */
+    base_column: StringType,
+    treated_mean: FloatType,
+    control_mean: FloatType,
+    std_diff: FloatType,
+});
+/** Positivity / common-support diagnostic (binary treatment). */
+export const OverlapDiagnosticType = StructType({
+    treated_propensity: VectorType(FloatType),
+    control_propensity: VectorType(FloatType),
+    common_support_frac: FloatType,
+    positivity_ok: BooleanType,
+});
+/** The robustness summary the verdict + trust tab consume. */
+export const RefutationType = StructType({
+    /** Effect under a permuted (placebo) treatment — should be ≈ 0. */
+    placebo_effect: OptionType(FloatType),
+    /** Whether the placebo effect vanished. */
+    placebo_passes: OptionType(BooleanType),
+    /** Whether a decoy random common cause left the estimate inside its CI. */
+    random_cc_within_ci: OptionType(BooleanType),
+    /** Mean effect across data subsamples (stability). */
+    data_subset_effect: OptionType(FloatType),
+    /** Std of the effect across data subsamples. */
+    data_subset_std: OptionType(FloatType),
+    /** Closed-form E-value — confounder strength needed to explain the effect away. */
+    robustness_value: OptionType(FloatType),
+    /** Unobserved-confounder sensitivity (tipping) curve: effect at each simulated strength. */
+    sensitivity: OptionType(StructType({
+        strengths: VectorType(FloatType),
+        effects: VectorType(FloatType),
+    })),
+});
+/** A dose-response (ALE) curve of a continuous feature on the outcome. */
+export const DoseResponseType = StructType({
+    feature: StringType,
+    grid: VectorType(FloatType),
+    effect: VectorType(FloatType),
+    lower: OptionType(VectorType(FloatType)),
+    upper: OptionType(VectorType(FloatType)),
+    /** Rows per dose bin — drives the surface's "you are here" (busiest bin) marker. */
+    size: VectorType(IntegerType),
+});
+/**
+ * The honesty verdict — a thin tag; the numbers live top-level on the result.
+ * Only `not_estimable` carries a human-readable reason.
+ */
+export const ExperimentVerdictType = VariantType({
+    causal: NullType,
+    modest: NullType,
+    adjustment_insufficient: NullType,
+    non_identifiable_positivity: NullType,
+    not_estimable: StringType,
+});
+/**
+ * The complete, honest result. `adjusted` is `none` when the engine refuses
+ * (positivity / no-variation); the `verdict` tag carries the headline; every
+ * word/colour on the surface is derived from these numbers.
+ */
+export const ExperimentResultType = StructType({
+    naive: FloatType,
+    naive_ci: OptionType(CiType),
+    adjusted: OptionType(StructType({ effect: FloatType, ci: OptionType(CiType) })),
+    n_total: IntegerType,
+    n_treated: IntegerType,
+    n_control: IntegerType,
+    n_dropped: IntegerType,
+    balance: ArrayType(BalanceRowType),
+    overlap: OverlapDiagnosticType,
+    refutation: OptionType(RefutationType),
+    /** ALE dose-response of `dose_feature` (present when `config.dose_feature` is set). */
+    dose_response: OptionType(DoseResponseType),
+    verdict: ExperimentVerdictType,
+});
+// ============================================================================
+// Validation-design contract (= Causal.Types.ExperimentDesign*)
+//
+// `Causal.designValidation(data, config, result, design_config)` turns a finished
+// experiment into the recipe for a REAL controlled trial that would confirm the
+// effect — how many units, the split, and which categories to match the groups
+// on — or, when a plain trial can't be run, what to change so one can. There is
+// ONE design family (a randomised controlled trial); the framing, the size
+// `basis`, and the visuals vary with the verdict. The renderer's "Validate" tab
+// paints it from these numbers (KPI + split meter + match chips + power curve).
+// Mirrors `Causal.Types.*` in east-py-datascience — kept in sync by hand.
+// ============================================================================
+/**
+ * Why the trial is sized the way it is — set from the verdict, so the tab's
+ * headline + visuals change with the result rather than reading the same twice.
+ */
+export const DesignBasisType = VariantType({
+    /** Clear effect → power the trial to detect the *observed* effect. */
+    detect_observed: NullType,
+    /** Fuzzy / maybe-nothing → power to the smallest effect worth acting on. */
+    resolve_vs_null: NullType,
+    /** A trust check failed → randomise to remove the bias adjustment couldn't. */
+    de_bias: NullType,
+    /** No overlap → randomise within the comparable range. */
+    restrict_to_overlap: NullType,
+    /** No control group exists → hold back a random sample next time. */
+    create_control: NullType,
+});
+/** One sizing option — a split and the head-count it needs (even split first). */
+export const TrialOptionType = StructType({
+    /** Plain label, e.g. "Even split" / "Treat fewer". */
+    label: StringType,
+    /** Fraction assigned to the treatment (0..1; 0.5 = even). */
+    treated_share: FloatType,
+    n_treated: IntegerType,
+    n_control: IntegerType,
+    n_total: IntegerType,
+});
+/** The "chance of detecting it" curve — total head-count → power (0..1). */
+export const PowerCurveType = StructType({
+    n: VectorType(IntegerType),
+    power: VectorType(FloatType),
+});
+/**
+ * The validation-trial recipe — a randomised controlled trial sized from the
+ * observed effect (or the materiality threshold) and the outcome spread, with
+ * the groups matched on the confounders that were most imbalanced. Everything
+ * the "Validate" tab paints is derived from these fields.
+ */
+export const ExperimentDesignType = StructType({
+    /** The verdict that drove the recommendation (echoed for framing). */
+    verdict: ExperimentVerdictType,
+    basis: DesignBasisType,
+    /** The effect size the trial is powered to detect (observed, or materiality). */
+    target_effect: FloatType,
+    /** Outcome spread (pooled SD) used to size it. */
+    outcome_sd: FloatType,
+    target_power: FloatType,
+    alpha: FloatType,
+    /** Chance the CURRENT sample would already detect `target_effect` (the "you're here" marker); `none` when there's no comparison group. */
+    current_power: OptionType(FloatType),
+    /** Categories both groups must be matched on (the most-imbalanced confounders). */
+    match_on: ArrayType(StringType),
+    /** Ranked split options (even split first; cost-saving alternates). */
+    options: ArrayType(TrialOptionType),
+    /** The detect-chance curve for the chart. */
+    power_curve: PowerCurveType,
+    /** One generated, plain-language sentence framing the recipe. */
+    rationale: StringType,
+});
+/** Optional knobs `Causal.designValidation` accepts (all developer-defaulted). */
+export const DesignConfigType = StructType({
+    /** Significance level (default 0.05). */
+    alpha: OptionType(FloatType),
+    /** Target chance of detecting the effect (default 0.8). */
+    target_power: OptionType(FloatType),
+    /** Smallest effect worth acting on — sizes the trial to this when set / when there's no trustworthy observed effect. */
+    materiality: OptionType(FloatType),
+    /** Treatment shares to offer as options (default [0.5]). */
+    treated_shares: OptionType(ArrayType(FloatType)),
+});
+// ============================================================================
+// UI-only types (not part of the engine contract)
+// ============================================================================
+/**
+ * The UI-side population filter — a set of {@link Slice} predicates the Step-4
+ * rail edits. It narrows the rows **client-side, before** the `experiment` call,
+ * so it is deliberately **not** a field of {@link ExperimentConfigType} (the
+ * bound function never sees it; the config stays byte-identical to the causal
+ * library's contract). Bound as its own optional staged dataset so a surface can
+ * seed / persist / commit the framing filters.
+ */
+export const PopulationType = ArrayType(Slice.Types.Predicate);
+/**
+ * Optional per-column display metadata the developer supplies once. Keyed by
+ * column name. Lets the derived prose read "worse" instead of "lower" and show
+ * friendly labels / units.
+ */
+export const ColumnMetaType = DictType(StringType, StructType({
+    label: OptionType(StringType),
+    unit: OptionType(StringType),
+    higherIsBetter: OptionType(BooleanType),
+}));
+/**
+ * A committed experiment in the journal — the framed config + the verdict +
+ * headline effect + who committed it when. The renderer derives the verdict
+ * words and colour from `verdict` / `adjusted`.
+ */
+export const JournalRowType = StructType({
+    config: ExperimentConfigType,
+    verdict: ExperimentVerdictType,
+    naive: FloatType,
+    adjusted: OptionType(FloatType),
+    committed_at: DateTimeType,
+    committed_by: StringType,
+});
+/** The journal dataset — committed experiments, newest first. */
+export const JournalType = ArrayType(JournalRowType);
+//# sourceMappingURL=types.js.map

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

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

package/dist/src/index.d.ts

@@ -33,6 +33,8 @@ export { Diff } from './runtime/diff.js';
 export { DiffPayloadType, DiffStyleType, type DiffOptions, } from './diff.js';
 export { Ontology } from './runtime/ontology.js';
 export { OntologyPayloadType, OntologyStyleType, type OntologyOptions, NodeKindType, LinkKindType, NodeType, LinkType, OntologyMetadataType, OntologyType, type OntologyStructType, OntologyViewType, type OntologyViewLiteral, } from './ontology.js';
+export { Experiment } from './runtime/experiment.js';
+export { ExperimentPayloadType, type ExperimentOptions, type ExperimentTabLiteral, } from './experiment/index.js';
 export { Decision } from './decision/index.js';
 export { DecisionType, DecisionOptionType, UrgencyType, type UrgencyLiteral, StakesLevelType, type StakesLevelLiteral, EvidenceType, AnswerType, type AnswerLiteral, VerdictType, ReferenceType, JudgementInputType, DecisionConstraintType, PromptType, LeverType, judgementInputType, type PromptInput, type LeverInput, type DecisionInput, type DecisionOptionInput, type EvidenceInput, type DecisionReferenceInput, type DecisionJudgementInput, } from './decision/types.js';
 export { decisionBind, decisionBindPlatformFn, DecisionHandleType, DecisionHandleRefType, CommitStateType, JudgementsType, type DecisionHandle, type DecisionBindOptions, } from './decision/bind.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EACH,IAAI,EACJ,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,eAAe,EACf,KAAK,UAAU,EACf,kBAAkB,EAClB,KAAK,eAAe,EACpB,cAAc,GACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EACH,IAAI,EACJ,cAAc,EACd,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,KAAK,SAAS,EACd,kBAAkB,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAG7B,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EACH,eAAe,EACf,aAAa,EACb,KAAK,WAAW,GACnB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EACH,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,eAAe,EACpB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,oBAAoB,EACpB,YAAY,EACZ,KAAK,kBAAkB,EACvB,gBAAgB,EAChB,KAAK,mBAAmB,GAC3B,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EACH,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,KAAK,cAAc,EACnB,eAAe,EACf,KAAK,kBAAkB,EACvB,YAAY,EACZ,UAAU,EACV,KAAK,aAAa,EAClB,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,YAAY,EACZ,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,mBAAmB,GAC3B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EACH,IAAI,EACJ,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,eAAe,EACf,KAAK,UAAU,EACf,kBAAkB,EAClB,KAAK,eAAe,EACpB,cAAc,GACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EACH,IAAI,EACJ,cAAc,EACd,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,KAAK,SAAS,EACd,kBAAkB,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAG7B,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EACH,eAAe,EACf,aAAa,EACb,KAAK,WAAW,GACnB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EACH,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,eAAe,EACpB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,oBAAoB,EACpB,YAAY,EACZ,KAAK,kBAAkB,EACvB,gBAAgB,EAChB,KAAK,mBAAmB,GAC3B,MAAM,eAAe,CAAC;AAOvB,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EACH,qBAAqB,EACrB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,GAC5B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EACH,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,KAAK,cAAc,EACnB,eAAe,EACf,KAAK,kBAAkB,EACvB,YAAY,EACZ,UAAU,EACV,KAAK,aAAa,EAClB,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,YAAY,EACZ,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,mBAAmB,GAC3B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/src/index.js

@@ -35,6 +35,13 @@ export { DiffPayloadType, DiffStyleType, } from './diff.js';
 // e3 `<Ontology>` tag + its types
 export { Ontology } from './runtime/ontology.js';
 export { OntologyPayloadType, OntologyStyleType, NodeKindType, LinkKindType, NodeType, LinkType, OntologyMetadataType, OntologyType, OntologyViewType, } from './ontology.js';
+// e3 `<Experiment>` tag + its payload/options. The render-contract value types
+// (Config / Result / DoseResponse / Journal …) are intentionally NOT public
+// named exports — reach them via `Experiment.Types.Config`, `.Result`, … (like
+// `Table.Types.*`), since users only touch them to type the bound `experiment`
+// function / seed result datasets.
+export { Experiment } from './runtime/experiment.js';
+export { ExperimentPayloadType, } from './experiment/index.js';
 // Decision platform types + factory
 export { Decision } from './decision/index.js';
 export { DecisionType, DecisionOptionType, UrgencyType, StakesLevelType, EvidenceType, AnswerType, VerdictType, ReferenceType, JudgementInputType, DecisionConstraintType, PromptType, LeverType, judgementInputType, } from './decision/types.js';

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EACH,IAAI,EACJ,gBAAgB,EAEhB,eAAe,EAEf,kBAAkB,EAElB,cAAc,GACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EACH,IAAI,EACJ,cAAc,EACd,aAAa,EACb,eAAe,EACf,kBAAkB,EAElB,kBAAkB,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAqB,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAE7B,8BAA8B;AAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EACH,eAAe,EACf,aAAa,GAEhB,MAAM,WAAW,CAAC;AAEnB,kCAAkC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EACH,mBAAmB,EACnB,iBAAiB,EAEjB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,oBAAoB,EACpB,YAAY,EAEZ,gBAAgB,GAEnB,MAAM,eAAe,CAAC;AAEvB,oCAAoC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EACH,YAAY,EACZ,kBAAkB,EAClB,WAAW,EAEX,eAAe,EAEf,YAAY,EACZ,UAAU,EAEV,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,UAAU,EACV,SAAS,EACT,kBAAkB,GAQrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,YAAY,EACZ,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,cAAc,GAGjB,MAAM,oBAAoB,CAAC;AAC5B,0DAA0D;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAA6B,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAA+B,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EACH,IAAI,EACJ,gBAAgB,EAEhB,eAAe,EAEf,kBAAkB,EAElB,cAAc,GACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EACH,IAAI,EACJ,cAAc,EACd,aAAa,EACb,eAAe,EACf,kBAAkB,EAElB,kBAAkB,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAqB,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAE7B,8BAA8B;AAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EACH,eAAe,EACf,aAAa,GAEhB,MAAM,WAAW,CAAC;AAEnB,kCAAkC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EACH,mBAAmB,EACnB,iBAAiB,EAEjB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,oBAAoB,EACpB,YAAY,EAEZ,gBAAgB,GAEnB,MAAM,eAAe,CAAC;AAEvB,+EAA+E;AAC/E,4EAA4E;AAC5E,+EAA+E;AAC/E,+EAA+E;AAC/E,mCAAmC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EACH,qBAAqB,GAGxB,MAAM,uBAAuB,CAAC;AAE/B,oCAAoC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EACH,YAAY,EACZ,kBAAkB,EAClB,WAAW,EAEX,eAAe,EAEf,YAAY,EACZ,UAAU,EAEV,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,UAAU,EACV,SAAS,EACT,kBAAkB,GAQrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,YAAY,EACZ,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,cAAc,GAGjB,MAAM,oBAAoB,CAAC;AAC5B,0DAA0D;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAA6B,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAA+B,MAAM,uBAAuB,CAAC"}

package/dist/src/internal.d.ts

@@ -21,6 +21,7 @@ export { DataManifestType, type DataManifest, encodeManifest, decodeManifest } f
 export { deriveManifest } from './derive.js';
 export { Diff, DiffComponent, DiffPayloadType, DiffStyleType, type DiffOptions, } from './diff.js';
 export { Ontology, OntologyComponent, OntologyPayloadType, OntologyStyleType, type OntologyOptions, NodeKindType, LinkKindType, NodeType, LinkType, OntologyMetadataType, OntologyType, type OntologyStructType, OntologyViewType, type OntologyViewLiteral, } from './ontology.js';
+export { Experiment, ExperimentComponent } from './experiment/index.js';
 export { Decision } from './decision/index.js';
 export { DecisionType, DecisionOptionType, UrgencyType, type UrgencyLiteral, StakesLevelType, type StakesLevelLiteral, EvidenceType, AnswerType, type AnswerLiteral, VerdictType, ReferenceType, JudgementInputType, DecisionConstraintType, PromptType, LeverType, judgementInputType, type PromptInput, type LeverInput, type DecisionInput, type DecisionOptionInput, type EvidenceInput, type DecisionReferenceInput, type DecisionJudgementInput, } from './decision/types.js';
 export { decisionBind, decisionBindPlatformFn, DecisionHandleType, DecisionHandleRefType, CommitStateType, JudgementsType, type DecisionHandle, type DecisionBindOptions, } from './decision/bind.js';

package/dist/src/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/internal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EACH,IAAI,EACJ,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,eAAe,EACf,KAAK,UAAU,EACf,kBAAkB,EAClB,KAAK,eAAe,EACpB,cAAc,GACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EACH,IAAI,EACJ,cAAc,EACd,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,KAAK,SAAS,EACd,kBAAkB,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACH,IAAI,EACJ,aAAa,EACb,eAAe,EACf,aAAa,EACb,KAAK,WAAW,GACnB,MAAM,WAAW,CAAC;AACnB,OAAO,EACH,QAAQ,EACR,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,eAAe,EACpB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,oBAAoB,EACpB,YAAY,EACZ,KAAK,kBAAkB,EACvB,gBAAgB,EAChB,KAAK,mBAAmB,GAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EACH,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,KAAK,cAAc,EACnB,eAAe,EACf,KAAK,kBAAkB,EACvB,YAAY,EACZ,UAAU,EACV,KAAK,aAAa,EAClB,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,YAAY,EACZ,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,mBAAmB,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,aAAa,EACb,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,KAAK,oBAAoB,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,eAAe,EACf,wBAAwB,EACxB,0BAA0B,EAC1B,KAAK,sBAAsB,GAC9B,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/internal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EACH,IAAI,EACJ,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,eAAe,EACf,KAAK,UAAU,EACf,kBAAkB,EAClB,KAAK,eAAe,EACpB,cAAc,GACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EACH,IAAI,EACJ,cAAc,EACd,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,KAAK,SAAS,EACd,kBAAkB,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACH,IAAI,EACJ,aAAa,EACb,eAAe,EACf,aAAa,EACb,KAAK,WAAW,GACnB,MAAM,WAAW,CAAC;AACnB,OAAO,EACH,QAAQ,EACR,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,eAAe,EACpB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,oBAAoB,EACpB,YAAY,EACZ,KAAK,kBAAkB,EACvB,gBAAgB,EAChB,KAAK,mBAAmB,GAC3B,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EACH,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,KAAK,cAAc,EACnB,eAAe,EACf,KAAK,kBAAkB,EACvB,YAAY,EACZ,UAAU,EACV,KAAK,aAAa,EAClB,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,YAAY,EACZ,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,mBAAmB,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,aAAa,EACb,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,KAAK,oBAAoB,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,eAAe,EACf,wBAAwB,EACxB,0BAA0B,EAC1B,KAAK,sBAAsB,GAC9B,MAAM,uBAAuB,CAAC"}

package/dist/src/internal.js

@@ -21,6 +21,9 @@ export { DataManifestType, encodeManifest, decodeManifest } from './manifest.js'
 export { deriveManifest } from './derive.js';
 export { Diff, DiffComponent, DiffPayloadType, DiffStyleType, } from './diff.js';
 export { Ontology, OntologyComponent, OntologyPayloadType, OntologyStyleType, NodeKindType, LinkKindType, NodeType, LinkType, OntologyMetadataType, OntologyType, OntologyViewType, } from './ontology.js';
+// Experiment factory + component carrier for renderers/tests. The value types
+// ride on `Experiment.Types`, so they are not re-exported individually here.
+export { Experiment, ExperimentComponent } from './experiment/index.js';
 export { Decision } from './decision/index.js';
 export { DecisionType, DecisionOptionType, UrgencyType, StakesLevelType, EvidenceType, AnswerType, VerdictType, ReferenceType, JudgementInputType, DecisionConstraintType, PromptType, LeverType, judgementInputType, } from './decision/types.js';
 export { decisionBind, decisionBindPlatformFn, DecisionHandleType, DecisionHandleRefType, CommitStateType, JudgementsType, } from './decision/bind.js';

package/dist/src/internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../src/internal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EACH,IAAI,EACJ,gBAAgB,EAEhB,eAAe,EAEf,kBAAkB,EAElB,cAAc,GACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EACH,IAAI,EACJ,cAAc,EACd,aAAa,EACb,eAAe,EACf,kBAAkB,EAElB,kBAAkB,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAqB,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACH,IAAI,EACJ,aAAa,EACb,eAAe,EACf,aAAa,GAEhB,MAAM,WAAW,CAAC;AACnB,OAAO,EACH,QAAQ,EACR,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EAEjB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,oBAAoB,EACpB,YAAY,EAEZ,gBAAgB,GAEnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EACH,YAAY,EACZ,kBAAkB,EAClB,WAAW,EAEX,eAAe,EAEf,YAAY,EACZ,UAAU,EAEV,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,UAAU,EACV,SAAS,EACT,kBAAkB,GAQrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,YAAY,EACZ,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,cAAc,GAGjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,aAAa,EACb,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,GAErB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,eAAe,EACf,wBAAwB,EACxB,0BAA0B,GAE7B,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../src/internal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EACH,IAAI,EACJ,gBAAgB,EAEhB,eAAe,EAEf,kBAAkB,EAElB,cAAc,GACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EACH,IAAI,EACJ,cAAc,EACd,aAAa,EACb,eAAe,EACf,kBAAkB,EAElB,kBAAkB,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAqB,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACH,IAAI,EACJ,aAAa,EACb,eAAe,EACf,aAAa,GAEhB,MAAM,WAAW,CAAC;AACnB,OAAO,EACH,QAAQ,EACR,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EAEjB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,oBAAoB,EACpB,YAAY,EAEZ,gBAAgB,GAEnB,MAAM,eAAe,CAAC;AACvB,8EAA8E;AAC9E,6EAA6E;AAC7E,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EACH,YAAY,EACZ,kBAAkB,EAClB,WAAW,EAEX,eAAe,EAEf,YAAY,EACZ,UAAU,EAEV,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,UAAU,EACV,SAAS,EACT,kBAAkB,GAQrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,YAAY,EACZ,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,cAAc,GAGjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,aAAa,EACb,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,GAErB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,eAAe,EACf,wBAAwB,EACxB,0BAA0B,GAE7B,MAAM,uBAAuB,CAAC"}

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

@@ -0,0 +1,48 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<Experiment>` tag — see the export's JSDoc. */
+import { type StructType } from "@elaraai/east";
+import { type UIElement } from "@elaraai/east-ui";
+import { Experiment as ExperimentFactory, type ExperimentOptions } from "../experiment/index.js";
+/**
+ * Interactive causal-experiment surface — binds an input dataset + a staged spec
+ * + estimator functions and renders a picture-and-colour answer to *"did
+ * {treatment} change {outcome}?"*.
+ *
+ * Generic over the bound dataset's row struct (like `<Table>`): `Row` is
+ * inferred from `data`, which types the `estimate` / `refute` / `dose` function
+ * signatures. The result side is derived, not authored — status words, the
+ * sign-flip banner and the bars are computed from the bound numbers; only the
+ * column names the user picked appear as text.
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/e3-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { Reactive, UIComponentType } from "@elaraai/east-ui";
+ * import { Data, Experiment, Func } from "@elaraai/e3-ui";
+ *
+ * const surface = East.function([], UIComponentType, _$ => (
+ *     <Reactive>{$ => {
+ *         const data     = $.let(Data.bind(batchesInput));
+ *         const spec     = $.let(Data.bind(specInput, { mode: "staged" }));
+ *         const estimate = $.let(Func.bind(estimateFn));
+ *         return <Experiment data={data} spec={spec} estimate={estimate} />;
+ *     }}</Reactive>
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `Experiment.Types` (the spec / result / refute / dose / journal value
+ * types). Desugars to `Experiment.Root(options)`. The renderer registers against
+ * `Experiment.Component` (from `@elaraai/e3-ui/internal`).
+ */
+/** The generic `<Experiment>` tag: `Row` is inferred from the `data` prop. */
+export type ExperimentTag = {
+    <Row extends StructType>(props: ExperimentOptions<Row>): UIElement;
+    Types: typeof ExperimentFactory.Types;
+};
+export declare const Experiment: ExperimentTag;
+//# sourceMappingURL=experiment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"experiment.d.ts","sourceRoot":"","sources":["../../../src/runtime/experiment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mDAAmD;AAEnD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,UAAU,IAAI,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEjG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,8EAA8E;AAC9E,MAAM,MAAM,aAAa,GAAG;IACxB,CAAC,GAAG,SAAS,UAAU,EAAE,KAAK,EAAE,iBAAiB,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IACnE,KAAK,EAAE,OAAO,iBAAiB,CAAC,KAAK,CAAC;CACzC,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,aAGI,CAAC"}

package/dist/src/runtime/experiment.js

@@ -0,0 +1,10 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<Experiment>` tag — see the export's JSDoc. */
+import {} from "@elaraai/east";
+import { optionsTag } from "@elaraai/east-ui";
+import { Experiment as ExperimentFactory } from "../experiment/index.js";
+export const Experiment = Object.assign(optionsTag(ExperimentFactory.Root), { Types: ExperimentFactory.Types });
+//# sourceMappingURL=experiment.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"experiment.js","sourceRoot":"","sources":["../../../src/runtime/experiment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mDAAmD;AAEnD,OAAO,EAAmB,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,UAAU,IAAI,iBAAiB,EAA0B,MAAM,wBAAwB,CAAC;AAyCjG,MAAM,CAAC,MAAM,UAAU,GAAkB,MAAM,CAAC,MAAM,CAClD,UAAU,CAAC,iBAAiB,CAAC,IAA6D,CAAC,EAC3F,EAAE,KAAK,EAAE,iBAAiB,CAAC,KAAK,EAAE,CACT,CAAC"}

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

@@ -11,5 +11,6 @@
  */
 export { Diff } from "./diff.js";
 export { Ontology } from "./ontology.js";
+export { Experiment } from "./experiment.js";
 export { DecisionQueue } from "./decision/queue.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/runtime/index.js

@@ -11,5 +11,6 @@
  */
 export { Diff } from "./diff.js";
 export { Ontology } from "./ontology.js";
+export { Experiment } from "./experiment.js";
 export { DecisionQueue } from "./decision/queue.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}