@pie-element/venn-classification 0.1.1-next.1 → 0.1.1-next.10

package/dist/controller/index.d.ts

@@ -1,4 +1,4 @@
-import type { Region, VennModel, VennSession, VennTile, VennViewModel } from '../types.js';
+import type { Region, ScoringPolicy, VennModel, VennSession, VennTile, VennViewModel } from '../types.js';
 export { composeRegionLabel, enumerateRegions, getRegionLabel, normalizeRegion, regionKey, regionsEqual, } from './region.js';
 export type { Region, ScoringPolicy, VennCircle, VennModel, VennSession, VennTile, VennViewModel, } from '../types.js';
 /**
@@ -25,13 +25,27 @@ export type Correctness = 'correct' | 'incorrect' | 'unanswered';
 export declare function getTileCorrectness(tile: VennTile, placement: Region | null | undefined): Correctness;
 /** Map tile id -> correctness, for convenience in delivery `evaluate` mode. */
 export declare function getCorrectnessMap(model: VennModel, session: VennSession | null | undefined): Record<string, Correctness>;
-export declare function outcome(question: VennModel | null | undefined, session: VennSession | null | undefined, env?: {
+export interface VennOutcome {
+    score: number;
+    empty: boolean;
+    traceLog: string[];
+}
+export interface OutcomeEnv {
     mode?: string;
-}): Promise<{
-    score?: number;
-    empty?: boolean;
-    completed?: boolean;
-}>;
+    /** A player's `false` forces all-or-nothing whatever `scoringPolicy` says. */
+    partialScoring?: boolean;
+}
+/**
+ * The scoring policy in force: the model's `scoringPolicy`, overridden to
+ * all-or-nothing by `env.partialScoring === false` - the rule the React
+ * elements apply through `partialScoring.enabled(model, env)`.
+ */
+export declare function effectiveScoringPolicy(model: Pick<VennModel, 'scoringPolicy'>, env?: OutcomeEnv | null): ScoringPolicy;
+/**
+ * Score a session. Scores in every mode, as multiple-choice does: a player
+ * calls this with the env it scores under, not only `evaluate`.
+ */
+export declare function outcome(question: VennModel | null | undefined, session: VennSession | null | undefined, env?: OutcomeEnv | null): Promise<VennOutcome>;
 /**
  * Build the view model consumed by the delivery Svelte component.
  * Strips `correctRegion` from `tiles` unless the host is in `evaluate` mode so