@uniformdev/context 20.3.1-alpha.7 → 20.4.1-alpha.3

package/dist/api/api.d.mts

@@ -1,4 +1,4 @@
-import { aD as paths$7, N as ManifestV2 } from '../types-gu4PVkDD.mjs';
+import { aD as paths$7, N as ManifestV2 } from '../types-C9cSPjHd.mjs';
 import 'mitt';
 
 type LimitPolicy = <ReturnValue>(func: () => Promise<ReturnValue>) => Promise<ReturnValue>;

package/dist/api/api.d.ts

@@ -1,4 +1,4 @@
-import { aD as paths$7, N as ManifestV2 } from '../types-gu4PVkDD.js';
+import { aD as paths$7, N as ManifestV2 } from '../types-C9cSPjHd.js';
 import 'mitt';
 
 type LimitPolicy = <ReturnValue>(func: () => Promise<ReturnValue>) => Promise<ReturnValue>;

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { O as OutputSeverity, L as LogDrain, C as ContextPlugin, S as ScoreVector, A as AggregateDimension, T as TransitionDataStore, a as StorageCommands, V as VisitorData, Q as Quirks, b as TransitionDataStoreOptions, D as DecayFunction, c as CriteriaEvaluator, d as StringMatch, e as VariantMatchCriteria, f as LogMessage, g as DevToolsEvents } from './types-gu4PVkDD.mjs';
-export { $ as AggregateDimensionInput, a6 as BehaviorTag, h as CONTEXTUAL_EDITING_TEST_NAME, i as CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID, n as Context, l as ContextEvents, m as ContextInstance, j as ContextOptions, aA as ContextState, aB as ContextStateUpdate, J as CriteriaEvaluatorParameters, I as CriteriaEvaluatorResult, ap as DecayOptions, q as DevToolsActions, t as DevToolsDataEvent, r as DevToolsEvent, x as DevToolsForgetEvent, u as DevToolsHelloEvent, s as DevToolsLogEvent, w as DevToolsRawCommandsEvent, p as DevToolsState, o as DevToolsUiVersion, v as DevToolsUpdateEvent, a2 as DimensionMatch, Y as EnrichmentCategory, av as EnrichmentData, ay as EventData, aC as GoalStateUpdate, au as Goals, H as GroupCriteriaEvaluator, ai as IdentifyCommand, F as LogMessageGroup, E as LogMessageSingle, y as LogMessages, G as ManifestInstance, N as ManifestV2, M as MessageCategory, B as MessageFunc, ad as ModifyScoreCommand, ae as ModifySessionScoreCommand, Z as NumberMatch, P as PersonalizationEvent, R as PersonalizationManifest, aw as PersonalizeControlVariant, a4 as PersonalizeOptions, ax as PersonalizeVariants, a8 as PersonalizedResult, a7 as PersonalizedVariant, a3 as QuirkMatch, an as SERVER_STATE_ID, am as ServerToClientTransitionState, af as SetConsentCommand, aj as SetControlGroupCommand, ac as SetGoalCommand, ak as SetPersonalizeVariantControlCommand, ag as SetQuirkCommand, ah as SetTestCommand, z as Severity, U as Signal, X as SignalCriteria, W as SignalCriteriaGroup, K as SignalData, ab as StorageCommand, _ as TestDefinition, k as TestEvent, a0 as TestOptions, aa as TestResult, a9 as TestVariant, at as Tests, ao as TransitionDataStoreEvents, as as VisitorDataStore, ar as VisitorDataStoreEvents, aq as VisitorDataStoreOptions, al as areCommandsEqual, az as emptyVisitorData, a5 as personalizeVariations, a1 as testVariations } from './types-gu4PVkDD.mjs';
+import { O as OutputSeverity, L as LogDrain, C as ContextPlugin, S as ScoreVector, A as AggregateDimension, T as TransitionDataStore, a as StorageCommands, V as VisitorData, Q as Quirks, b as TransitionDataStoreOptions, D as DecayFunction, c as CriteriaEvaluator, d as StringMatch, e as VariantMatchCriteria, f as LogMessage, g as DevToolsEvents } from './types-C9cSPjHd.mjs';
+export { a0 as AggregateDimensionInput, a6 as BehaviorTag, h as CONTEXTUAL_EDITING_TEST_NAME, i as CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID, n as Context, l as ContextEvents, m as ContextInstance, j as ContextOptions, aA as ContextState, aB as ContextStateUpdate, J as CriteriaEvaluatorParameters, I as CriteriaEvaluatorResult, ap as DecayOptions, q as DevToolsActions, t as DevToolsDataEvent, r as DevToolsEvent, x as DevToolsForgetEvent, u as DevToolsHelloEvent, s as DevToolsLogEvent, w as DevToolsRawCommandsEvent, p as DevToolsState, o as DevToolsUiVersion, v as DevToolsUpdateEvent, a3 as DimensionMatch, Z as EnrichmentCategory, av as EnrichmentData, ay as EventData, aC as GoalStateUpdate, au as Goals, H as GroupCriteriaEvaluator, ai as IdentifyCommand, F as LogMessageGroup, E as LogMessageSingle, y as LogMessages, G as ManifestInstance, N as ManifestV2, M as MessageCategory, B as MessageFunc, ad as ModifyScoreCommand, ae as ModifySessionScoreCommand, _ as NumberMatch, P as PersonalizationEvent, U as PersonalizationManifest, aw as PersonalizeControlVariant, a4 as PersonalizeOptions, ax as PersonalizeVariants, a8 as PersonalizedResult, a7 as PersonalizedVariant, R as RankPersonalizationVariantOptions, an as SERVER_STATE_ID, am as ServerToClientTransitionState, af as SetConsentCommand, aj as SetControlGroupCommand, ac as SetGoalCommand, ak as SetPersonalizeVariantControlCommand, ag as SetQuirkCommand, ah as SetTestCommand, z as Severity, W as Signal, Y as SignalCriteria, X as SignalCriteriaGroup, K as SignalData, ab as StorageCommand, $ as TestDefinition, k as TestEvent, a1 as TestOptions, aa as TestResult, a9 as TestVariant, at as Tests, ao as TransitionDataStoreEvents, as as VisitorDataStore, ar as VisitorDataStoreEvents, aq as VisitorDataStoreOptions, al as areCommandsEqual, az as emptyVisitorData, a5 as personalizeVariations, a2 as testVariations } from './types-C9cSPjHd.mjs';
 import Cookies from 'js-cookie';
 import 'mitt';
 
@@ -158,7 +158,7 @@ declare function createDebugConsoleLogDrain(level: OutputSeverity, options?: Con
  */
 declare function enableDebugConsoleLogDrain(level: OutputSeverity, options?: ConsoleDebugLogDrainOptions): ContextPlugin;
 
-declare function evaluateVariantMatch(variantId: string, match: VariantMatchCriteria | undefined | null, vec: ScoreVector, onLogMessage?: (message: LogMessage) => void, quirks?: Quirks): boolean;
+declare function evaluateVariantMatch(variantId: string, match: VariantMatchCriteria | undefined | null, vec: ScoreVector, onLogMessage?: (message: LogMessage) => void): boolean;
 
 type ContextDevToolOptions = {
     onAfterMessageReceived?: (message: DevToolsEvents) => void;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { O as OutputSeverity, L as LogDrain, C as ContextPlugin, S as ScoreVector, A as AggregateDimension, T as TransitionDataStore, a as StorageCommands, V as VisitorData, Q as Quirks, b as TransitionDataStoreOptions, D as DecayFunction, c as CriteriaEvaluator, d as StringMatch, e as VariantMatchCriteria, f as LogMessage, g as DevToolsEvents } from './types-gu4PVkDD.js';
-export { $ as AggregateDimensionInput, a6 as BehaviorTag, h as CONTEXTUAL_EDITING_TEST_NAME, i as CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID, n as Context, l as ContextEvents, m as ContextInstance, j as ContextOptions, aA as ContextState, aB as ContextStateUpdate, J as CriteriaEvaluatorParameters, I as CriteriaEvaluatorResult, ap as DecayOptions, q as DevToolsActions, t as DevToolsDataEvent, r as DevToolsEvent, x as DevToolsForgetEvent, u as DevToolsHelloEvent, s as DevToolsLogEvent, w as DevToolsRawCommandsEvent, p as DevToolsState, o as DevToolsUiVersion, v as DevToolsUpdateEvent, a2 as DimensionMatch, Y as EnrichmentCategory, av as EnrichmentData, ay as EventData, aC as GoalStateUpdate, au as Goals, H as GroupCriteriaEvaluator, ai as IdentifyCommand, F as LogMessageGroup, E as LogMessageSingle, y as LogMessages, G as ManifestInstance, N as ManifestV2, M as MessageCategory, B as MessageFunc, ad as ModifyScoreCommand, ae as ModifySessionScoreCommand, Z as NumberMatch, P as PersonalizationEvent, R as PersonalizationManifest, aw as PersonalizeControlVariant, a4 as PersonalizeOptions, ax as PersonalizeVariants, a8 as PersonalizedResult, a7 as PersonalizedVariant, a3 as QuirkMatch, an as SERVER_STATE_ID, am as ServerToClientTransitionState, af as SetConsentCommand, aj as SetControlGroupCommand, ac as SetGoalCommand, ak as SetPersonalizeVariantControlCommand, ag as SetQuirkCommand, ah as SetTestCommand, z as Severity, U as Signal, X as SignalCriteria, W as SignalCriteriaGroup, K as SignalData, ab as StorageCommand, _ as TestDefinition, k as TestEvent, a0 as TestOptions, aa as TestResult, a9 as TestVariant, at as Tests, ao as TransitionDataStoreEvents, as as VisitorDataStore, ar as VisitorDataStoreEvents, aq as VisitorDataStoreOptions, al as areCommandsEqual, az as emptyVisitorData, a5 as personalizeVariations, a1 as testVariations } from './types-gu4PVkDD.js';
+import { O as OutputSeverity, L as LogDrain, C as ContextPlugin, S as ScoreVector, A as AggregateDimension, T as TransitionDataStore, a as StorageCommands, V as VisitorData, Q as Quirks, b as TransitionDataStoreOptions, D as DecayFunction, c as CriteriaEvaluator, d as StringMatch, e as VariantMatchCriteria, f as LogMessage, g as DevToolsEvents } from './types-C9cSPjHd.js';
+export { a0 as AggregateDimensionInput, a6 as BehaviorTag, h as CONTEXTUAL_EDITING_TEST_NAME, i as CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID, n as Context, l as ContextEvents, m as ContextInstance, j as ContextOptions, aA as ContextState, aB as ContextStateUpdate, J as CriteriaEvaluatorParameters, I as CriteriaEvaluatorResult, ap as DecayOptions, q as DevToolsActions, t as DevToolsDataEvent, r as DevToolsEvent, x as DevToolsForgetEvent, u as DevToolsHelloEvent, s as DevToolsLogEvent, w as DevToolsRawCommandsEvent, p as DevToolsState, o as DevToolsUiVersion, v as DevToolsUpdateEvent, a3 as DimensionMatch, Z as EnrichmentCategory, av as EnrichmentData, ay as EventData, aC as GoalStateUpdate, au as Goals, H as GroupCriteriaEvaluator, ai as IdentifyCommand, F as LogMessageGroup, E as LogMessageSingle, y as LogMessages, G as ManifestInstance, N as ManifestV2, M as MessageCategory, B as MessageFunc, ad as ModifyScoreCommand, ae as ModifySessionScoreCommand, _ as NumberMatch, P as PersonalizationEvent, U as PersonalizationManifest, aw as PersonalizeControlVariant, a4 as PersonalizeOptions, ax as PersonalizeVariants, a8 as PersonalizedResult, a7 as PersonalizedVariant, R as RankPersonalizationVariantOptions, an as SERVER_STATE_ID, am as ServerToClientTransitionState, af as SetConsentCommand, aj as SetControlGroupCommand, ac as SetGoalCommand, ak as SetPersonalizeVariantControlCommand, ag as SetQuirkCommand, ah as SetTestCommand, z as Severity, W as Signal, Y as SignalCriteria, X as SignalCriteriaGroup, K as SignalData, ab as StorageCommand, $ as TestDefinition, k as TestEvent, a1 as TestOptions, aa as TestResult, a9 as TestVariant, at as Tests, ao as TransitionDataStoreEvents, as as VisitorDataStore, ar as VisitorDataStoreEvents, aq as VisitorDataStoreOptions, al as areCommandsEqual, az as emptyVisitorData, a5 as personalizeVariations, a2 as testVariations } from './types-C9cSPjHd.js';
 import Cookies from 'js-cookie';
 import 'mitt';
 
@@ -158,7 +158,7 @@ declare function createDebugConsoleLogDrain(level: OutputSeverity, options?: Con
  */
 declare function enableDebugConsoleLogDrain(level: OutputSeverity, options?: ConsoleDebugLogDrainOptions): ContextPlugin;
 
-declare function evaluateVariantMatch(variantId: string, match: VariantMatchCriteria | undefined | null, vec: ScoreVector, onLogMessage?: (message: LogMessage) => void, quirks?: Quirks): boolean;
+declare function evaluateVariantMatch(variantId: string, match: VariantMatchCriteria | undefined | null, vec: ScoreVector, onLogMessage?: (message: LogMessage) => void): boolean;
 
 type ContextDevToolOptions = {
     onAfterMessageReceived?: (message: DevToolsEvents) => void;

package/dist/index.esm.js

@@ -516,7 +516,7 @@ var GroupCriteriaEvaluator = class {
 _evaluators = new WeakMap();
 
 // src/placement/criteria/evaluateVariantMatch.ts
-function evaluateVariantMatch(variantId, match, vec, onLogMessage, quirks) {
+function evaluateVariantMatch(variantId, match, vec, onLogMessage) {
   onLogMessage == null ? void 0 : onLogMessage(["info", 301, "GROUP", { id: variantId, op: match == null ? void 0 : match.op }]);
   let result;
   try {
@@ -524,9 +524,9 @@ function evaluateVariantMatch(variantId, match, vec, onLogMessage, quirks) {
       onLogMessage == null ? void 0 : onLogMessage(["info", 302, { matched: true, description: "default variation" }]);
       result = true;
     } else if (!match.op || match.op === "&") {
-      result = match.crit.every((c) => evaluateMatch(c, vec, quirks != null ? quirks : {}, onLogMessage));
+      result = match.crit.every((c) => evaluateDimensionMatch(c, vec, onLogMessage));
     } else {
-      result = match.crit.some((c) => evaluateMatch(c, vec, quirks != null ? quirks : {}, onLogMessage));
+      result = match.crit.some((c) => evaluateDimensionMatch(c, vec, onLogMessage));
     }
     onLogMessage == null ? void 0 : onLogMessage(["info", 303, result]);
   } finally {
@@ -534,16 +534,9 @@ function evaluateVariantMatch(variantId, match, vec, onLogMessage, quirks) {
   }
   return result;
 }
-function evaluateMatch(crit, vec, quirks, onLogMessage) {
-  if ("t" in crit && crit.t === "q") {
-    return evaluateQuirkMatch(crit, quirks, onLogMessage);
-  } else {
-    return evaluateDimensionMatch(crit, vec, onLogMessage);
-  }
-}
 function evaluateDimensionMatch(crit, vec, onLogMessage) {
   var _a, _b;
-  const { l: lhs, op } = crit;
+  const { op, l: lhs } = crit;
   const lhsScore = (_a = vec[lhs]) != null ? _a : 0;
   if (op === "^") {
     const [cat] = lhs.split(ENR_SEPARATOR);
@@ -610,49 +603,33 @@ function evaluateDimensionMatch(crit, vec, onLogMessage) {
   }
   if (op === ">") {
     const result = lhsScore > rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else if (op === ">=") {
     const result = lhsScore >= rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else if (op === "<") {
     const result = lhsScore < rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else if (op === "<=") {
     const result = lhsScore <= rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else if (op === "=") {
     const result = lhsScore === rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else if (op === "!=") {
     const result = lhsScore !== rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else {
     throw new Error(`Unknown op: ${op}`);
   }
 }
-function evaluateQuirkMatch(crit, quirks, onLogMessage) {
-  var _a;
-  const { l: targetQuirk, op, r: targetValue } = crit;
-  const targetQuirkValue = (_a = quirks[targetQuirk]) != null ? _a : "";
-  if (op === "=") {
-    const result = targetQuirkValue === targetValue;
-    explainQuirk(onLogMessage, result, crit, targetQuirkValue);
-    return result;
-  } else if (op === "!=") {
-    const result = targetQuirkValue !== targetValue;
-    explainQuirk(onLogMessage, result, crit, targetQuirkValue);
-    return result;
-  } else {
-    throw new Error(`Unknown quirk op: ${op}`);
-  }
-}
-function explainScore(onLogMessage, result, crit, lhsScore, rhsScore) {
+function explain(onLogMessage, result, crit, lhsScore, rhsScore) {
   onLogMessage == null ? void 0 : onLogMessage([
     "info",
     302,
@@ -662,24 +639,36 @@ function explainScore(onLogMessage, result, crit, lhsScore, rhsScore) {
     }
   ]);
 }
-function explainQuirk(onLogMessage, result, crit, lhs) {
-  onLogMessage == null ? void 0 : onLogMessage([
-    "info",
-    302,
-    {
-      matched: result,
-      description: `Quirk ${crit.l}[${lhs}] ${crit.op} ${crit.r}`
-    }
-  ]);
-}
 
-// src/placement/personalizeVariations.ts
+// src/placement/personalize.ts
+var sortVariations = ({
+  variations,
+  rankVariant
+}) => {
+  const variationsWithScores = Array.from(variations).map((variant) => {
+    const score = rankVariant == null ? void 0 : rankVariant(variant);
+    return {
+      variant,
+      score
+    };
+  });
+  const variantsWithDefinedScores = variationsWithScores.filter((v) => v.score !== void 0);
+  const variantsWithUndefinedScores = variationsWithScores.filter((v) => v.score === void 0);
+  return [
+    ...variantsWithDefinedScores.sort((a, b) => {
+      var _a, _b;
+      return ((_a = b.score) != null ? _a : 0) - ((_b = a.score) != null ? _b : 0);
+    }).map((v) => v.variant),
+    ...variantsWithUndefinedScores.map((v) => v.variant)
+  ];
+};
 function personalizeVariations({
   name,
   context,
-  variations,
+  variations: providedVariations,
   take = 1,
-  onLogMessage
+  onLogMessage,
+  rankVariant
 }) {
   var _a, _b, _c;
   onLogMessage == null ? void 0 : onLogMessage(["info", 300, "GROUP", { name, take }]);
@@ -688,9 +677,10 @@ function personalizeVariations({
     const defaultVariants = [];
     const needsConsent = context.requireConsentForPersonalization;
     const canEvaluate = !needsConsent || context.storage.data.consent;
+    const variations = rankVariant ? sortVariations({ variations: providedVariations, rankVariant }) : providedVariations;
     for (const variant of variations) {
       if ((_a = variant.pz) == null ? void 0 : _a.crit.length) {
-        if (canEvaluate && variantMatches.length !== take && evaluateVariantMatch(variant.id, variant.pz, context.scores, onLogMessage, context.quirks)) {
+        if (canEvaluate && variantMatches.length !== take && evaluateVariantMatch(variant.id, variant.pz, context.scores, onLogMessage)) {
           variantMatches.push(variant);
         }
       } else {
@@ -749,7 +739,7 @@ function personalizeVariations({
   }
 }
 
-// src/placement/normalizeVariationDistributions.ts
+// src/placement/test.ts
 var normalizeVariationDistributions = (variations) => {
   const { values, total, missingDistribution } = variations.reduce(
     (previous, current) => {
@@ -780,8 +770,6 @@ var normalizeVariationDistributions = (variations) => {
   }
   return values;
 };
-
-// src/placement/testVariations.ts
 var testVariations = ({
   name,
   context,
@@ -1548,7 +1536,7 @@ import { dequal as dequal5 } from "dequal/lite";
 import mitt3 from "mitt";
 var CONTEXTUAL_EDITING_TEST_NAME = "contextual_editing_test";
 var CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID = "contextual_editing_test_selected_variant";
-var _serverTransitionState, _scores, _state, _pzCache, _plugins, _commands, _requireConsentForPersonalization, _mitt3, _Context_instances, emitTest_fn, updateGoals_fn, updateComputedScores_fn, calculateScores_fn;
+var _serverTransitionState, _scores, _state, _pzCache, _plugins, _commands, _requireConsentForPersonalization, _rankPersonalizationVariant, _mitt3, _Context_instances, emitTest_fn, updateGoals_fn, updateComputedScores_fn, calculateScores_fn;
 var Context = class {
   constructor(options) {
     __privateAdd(this, _Context_instances);
@@ -1560,6 +1548,7 @@ var Context = class {
     __privateAdd(this, _plugins);
     __privateAdd(this, _commands);
     __privateAdd(this, _requireConsentForPersonalization);
+    __privateAdd(this, _rankPersonalizationVariant);
     __privateAdd(this, _mitt3, mitt3());
     /**
      * Subscribe to events
@@ -1574,6 +1563,7 @@ var Context = class {
     __privateSet(this, _state, {});
     __privateSet(this, _plugins, options.plugins);
     __privateSet(this, _requireConsentForPersonalization, options.requireConsentForPersonalization);
+    __privateSet(this, _rankPersonalizationVariant, options.rankPersonalizationVariant);
     if (typeof options.transitionStore !== "undefined") {
       __privateSet(this, _commands, []);
     }
@@ -1881,7 +1871,13 @@ var Context = class {
     const value = personalizeVariations({
       ...options,
       context: this,
-      onLogMessage: (message) => __privateGet(this, _mitt3).emit("log", message)
+      onLogMessage: (message) => __privateGet(this, _mitt3).emit("log", message),
+      rankVariant: __privateGet(this, _rankPersonalizationVariant) ? (variant) => __privateGet(this, _rankPersonalizationVariant).call(this, {
+        placementName: options.name,
+        variant,
+        scores: __privateGet(this, _scores),
+        quirks: this.storage.data.quirks
+      }) : void 0
     });
     const previousPlacement = __privateGet(this, _pzCache)[options.name];
     const eventData = {
@@ -1959,6 +1955,7 @@ _pzCache = new WeakMap();
 _plugins = new WeakMap();
 _commands = new WeakMap();
 _requireConsentForPersonalization = new WeakMap();
+_rankPersonalizationVariant = new WeakMap();
 _mitt3 = new WeakMap();
 _Context_instances = new WeakSet();
 emitTest_fn = function(event) {

package/dist/index.js

@@ -605,7 +605,7 @@ var GroupCriteriaEvaluator = class {
 _evaluators = new WeakMap();
 
 // src/placement/criteria/evaluateVariantMatch.ts
-function evaluateVariantMatch(variantId, match, vec, onLogMessage, quirks) {
+function evaluateVariantMatch(variantId, match, vec, onLogMessage) {
   onLogMessage == null ? void 0 : onLogMessage(["info", 301, "GROUP", { id: variantId, op: match == null ? void 0 : match.op }]);
   let result;
   try {
@@ -613,9 +613,9 @@ function evaluateVariantMatch(variantId, match, vec, onLogMessage, quirks) {
       onLogMessage == null ? void 0 : onLogMessage(["info", 302, { matched: true, description: "default variation" }]);
       result = true;
     } else if (!match.op || match.op === "&") {
-      result = match.crit.every((c) => evaluateMatch(c, vec, quirks != null ? quirks : {}, onLogMessage));
+      result = match.crit.every((c) => evaluateDimensionMatch(c, vec, onLogMessage));
     } else {
-      result = match.crit.some((c) => evaluateMatch(c, vec, quirks != null ? quirks : {}, onLogMessage));
+      result = match.crit.some((c) => evaluateDimensionMatch(c, vec, onLogMessage));
     }
     onLogMessage == null ? void 0 : onLogMessage(["info", 303, result]);
   } finally {
@@ -623,16 +623,9 @@ function evaluateVariantMatch(variantId, match, vec, onLogMessage, quirks) {
   }
   return result;
 }
-function evaluateMatch(crit, vec, quirks, onLogMessage) {
-  if ("t" in crit && crit.t === "q") {
-    return evaluateQuirkMatch(crit, quirks, onLogMessage);
-  } else {
-    return evaluateDimensionMatch(crit, vec, onLogMessage);
-  }
-}
 function evaluateDimensionMatch(crit, vec, onLogMessage) {
   var _a, _b;
-  const { l: lhs, op } = crit;
+  const { op, l: lhs } = crit;
   const lhsScore = (_a = vec[lhs]) != null ? _a : 0;
   if (op === "^") {
     const [cat] = lhs.split(ENR_SEPARATOR);
@@ -699,49 +692,33 @@ function evaluateDimensionMatch(crit, vec, onLogMessage) {
   }
   if (op === ">") {
     const result = lhsScore > rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else if (op === ">=") {
     const result = lhsScore >= rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else if (op === "<") {
     const result = lhsScore < rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else if (op === "<=") {
     const result = lhsScore <= rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else if (op === "=") {
     const result = lhsScore === rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else if (op === "!=") {
     const result = lhsScore !== rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else {
     throw new Error(`Unknown op: ${op}`);
   }
 }
-function evaluateQuirkMatch(crit, quirks, onLogMessage) {
-  var _a;
-  const { l: targetQuirk, op, r: targetValue } = crit;
-  const targetQuirkValue = (_a = quirks[targetQuirk]) != null ? _a : "";
-  if (op === "=") {
-    const result = targetQuirkValue === targetValue;
-    explainQuirk(onLogMessage, result, crit, targetQuirkValue);
-    return result;
-  } else if (op === "!=") {
-    const result = targetQuirkValue !== targetValue;
-    explainQuirk(onLogMessage, result, crit, targetQuirkValue);
-    return result;
-  } else {
-    throw new Error(`Unknown quirk op: ${op}`);
-  }
-}
-function explainScore(onLogMessage, result, crit, lhsScore, rhsScore) {
+function explain(onLogMessage, result, crit, lhsScore, rhsScore) {
   onLogMessage == null ? void 0 : onLogMessage([
     "info",
     302,
@@ -751,24 +728,36 @@ function explainScore(onLogMessage, result, crit, lhsScore, rhsScore) {
     }
   ]);
 }
-function explainQuirk(onLogMessage, result, crit, lhs) {
-  onLogMessage == null ? void 0 : onLogMessage([
-    "info",
-    302,
-    {
-      matched: result,
-      description: `Quirk ${crit.l}[${lhs}] ${crit.op} ${crit.r}`
-    }
-  ]);
-}
 
-// src/placement/personalizeVariations.ts
+// src/placement/personalize.ts
+var sortVariations = ({
+  variations,
+  rankVariant
+}) => {
+  const variationsWithScores = Array.from(variations).map((variant) => {
+    const score = rankVariant == null ? void 0 : rankVariant(variant);
+    return {
+      variant,
+      score
+    };
+  });
+  const variantsWithDefinedScores = variationsWithScores.filter((v) => v.score !== void 0);
+  const variantsWithUndefinedScores = variationsWithScores.filter((v) => v.score === void 0);
+  return [
+    ...variantsWithDefinedScores.sort((a, b) => {
+      var _a, _b;
+      return ((_a = b.score) != null ? _a : 0) - ((_b = a.score) != null ? _b : 0);
+    }).map((v) => v.variant),
+    ...variantsWithUndefinedScores.map((v) => v.variant)
+  ];
+};
 function personalizeVariations({
   name,
   context,
-  variations,
+  variations: providedVariations,
   take = 1,
-  onLogMessage
+  onLogMessage,
+  rankVariant
 }) {
   var _a, _b, _c;
   onLogMessage == null ? void 0 : onLogMessage(["info", 300, "GROUP", { name, take }]);
@@ -777,9 +766,10 @@ function personalizeVariations({
     const defaultVariants = [];
     const needsConsent = context.requireConsentForPersonalization;
     const canEvaluate = !needsConsent || context.storage.data.consent;
+    const variations = rankVariant ? sortVariations({ variations: providedVariations, rankVariant }) : providedVariations;
     for (const variant of variations) {
       if ((_a = variant.pz) == null ? void 0 : _a.crit.length) {
-        if (canEvaluate && variantMatches.length !== take && evaluateVariantMatch(variant.id, variant.pz, context.scores, onLogMessage, context.quirks)) {
+        if (canEvaluate && variantMatches.length !== take && evaluateVariantMatch(variant.id, variant.pz, context.scores, onLogMessage)) {
           variantMatches.push(variant);
         }
       } else {
@@ -838,7 +828,7 @@ function personalizeVariations({
   }
 }
 
-// src/placement/normalizeVariationDistributions.ts
+// src/placement/test.ts
 var normalizeVariationDistributions = (variations) => {
   const { values, total, missingDistribution } = variations.reduce(
     (previous, current) => {
@@ -869,8 +859,6 @@ var normalizeVariationDistributions = (variations) => {
   }
   return values;
 };
-
-// src/placement/testVariations.ts
 var testVariations = ({
   name,
   context,
@@ -1637,7 +1625,7 @@ var import_lite5 = require("dequal/lite");
 var import_mitt3 = __toESM(require("mitt"));
 var CONTEXTUAL_EDITING_TEST_NAME = "contextual_editing_test";
 var CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID = "contextual_editing_test_selected_variant";
-var _serverTransitionState, _scores, _state, _pzCache, _plugins, _commands, _requireConsentForPersonalization, _mitt3, _Context_instances, emitTest_fn, updateGoals_fn, updateComputedScores_fn, calculateScores_fn;
+var _serverTransitionState, _scores, _state, _pzCache, _plugins, _commands, _requireConsentForPersonalization, _rankPersonalizationVariant, _mitt3, _Context_instances, emitTest_fn, updateGoals_fn, updateComputedScores_fn, calculateScores_fn;
 var Context = class {
   constructor(options) {
     __privateAdd(this, _Context_instances);
@@ -1649,6 +1637,7 @@ var Context = class {
     __privateAdd(this, _plugins);
     __privateAdd(this, _commands);
     __privateAdd(this, _requireConsentForPersonalization);
+    __privateAdd(this, _rankPersonalizationVariant);
     __privateAdd(this, _mitt3, (0, import_mitt3.default)());
     /**
      * Subscribe to events
@@ -1663,6 +1652,7 @@ var Context = class {
     __privateSet(this, _state, {});
     __privateSet(this, _plugins, options.plugins);
     __privateSet(this, _requireConsentForPersonalization, options.requireConsentForPersonalization);
+    __privateSet(this, _rankPersonalizationVariant, options.rankPersonalizationVariant);
     if (typeof options.transitionStore !== "undefined") {
       __privateSet(this, _commands, []);
     }
@@ -1970,7 +1960,13 @@ var Context = class {
     const value = personalizeVariations({
       ...options,
       context: this,
-      onLogMessage: (message) => __privateGet(this, _mitt3).emit("log", message)
+      onLogMessage: (message) => __privateGet(this, _mitt3).emit("log", message),
+      rankVariant: __privateGet(this, _rankPersonalizationVariant) ? (variant) => __privateGet(this, _rankPersonalizationVariant).call(this, {
+        placementName: options.name,
+        variant,
+        scores: __privateGet(this, _scores),
+        quirks: this.storage.data.quirks
+      }) : void 0
     });
     const previousPlacement = __privateGet(this, _pzCache)[options.name];
     const eventData = {
@@ -2048,6 +2044,7 @@ _pzCache = new WeakMap();
 _plugins = new WeakMap();
 _commands = new WeakMap();
 _requireConsentForPersonalization = new WeakMap();
+_rankPersonalizationVariant = new WeakMap();
 _mitt3 = new WeakMap();
 _Context_instances = new WeakSet();
 emitTest_fn = function(event) {

package/dist/index.mjs

@@ -516,7 +516,7 @@ var GroupCriteriaEvaluator = class {
 _evaluators = new WeakMap();
 
 // src/placement/criteria/evaluateVariantMatch.ts
-function evaluateVariantMatch(variantId, match, vec, onLogMessage, quirks) {
+function evaluateVariantMatch(variantId, match, vec, onLogMessage) {
   onLogMessage == null ? void 0 : onLogMessage(["info", 301, "GROUP", { id: variantId, op: match == null ? void 0 : match.op }]);
   let result;
   try {
@@ -524,9 +524,9 @@ function evaluateVariantMatch(variantId, match, vec, onLogMessage, quirks) {
       onLogMessage == null ? void 0 : onLogMessage(["info", 302, { matched: true, description: "default variation" }]);
       result = true;
     } else if (!match.op || match.op === "&") {
-      result = match.crit.every((c) => evaluateMatch(c, vec, quirks != null ? quirks : {}, onLogMessage));
+      result = match.crit.every((c) => evaluateDimensionMatch(c, vec, onLogMessage));
     } else {
-      result = match.crit.some((c) => evaluateMatch(c, vec, quirks != null ? quirks : {}, onLogMessage));
+      result = match.crit.some((c) => evaluateDimensionMatch(c, vec, onLogMessage));
     }
     onLogMessage == null ? void 0 : onLogMessage(["info", 303, result]);
   } finally {
@@ -534,16 +534,9 @@ function evaluateVariantMatch(variantId, match, vec, onLogMessage, quirks) {
   }
   return result;
 }
-function evaluateMatch(crit, vec, quirks, onLogMessage) {
-  if ("t" in crit && crit.t === "q") {
-    return evaluateQuirkMatch(crit, quirks, onLogMessage);
-  } else {
-    return evaluateDimensionMatch(crit, vec, onLogMessage);
-  }
-}
 function evaluateDimensionMatch(crit, vec, onLogMessage) {
   var _a, _b;
-  const { l: lhs, op } = crit;
+  const { op, l: lhs } = crit;
   const lhsScore = (_a = vec[lhs]) != null ? _a : 0;
   if (op === "^") {
     const [cat] = lhs.split(ENR_SEPARATOR);
@@ -610,49 +603,33 @@ function evaluateDimensionMatch(crit, vec, onLogMessage) {
   }
   if (op === ">") {
     const result = lhsScore > rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else if (op === ">=") {
     const result = lhsScore >= rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else if (op === "<") {
     const result = lhsScore < rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else if (op === "<=") {
     const result = lhsScore <= rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else if (op === "=") {
     const result = lhsScore === rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else if (op === "!=") {
     const result = lhsScore !== rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else {
     throw new Error(`Unknown op: ${op}`);
   }
 }
-function evaluateQuirkMatch(crit, quirks, onLogMessage) {
-  var _a;
-  const { l: targetQuirk, op, r: targetValue } = crit;
-  const targetQuirkValue = (_a = quirks[targetQuirk]) != null ? _a : "";
-  if (op === "=") {
-    const result = targetQuirkValue === targetValue;
-    explainQuirk(onLogMessage, result, crit, targetQuirkValue);
-    return result;
-  } else if (op === "!=") {
-    const result = targetQuirkValue !== targetValue;
-    explainQuirk(onLogMessage, result, crit, targetQuirkValue);
-    return result;
-  } else {
-    throw new Error(`Unknown quirk op: ${op}`);
-  }
-}
-function explainScore(onLogMessage, result, crit, lhsScore, rhsScore) {
+function explain(onLogMessage, result, crit, lhsScore, rhsScore) {
   onLogMessage == null ? void 0 : onLogMessage([
     "info",
     302,
@@ -662,24 +639,36 @@ function explainScore(onLogMessage, result, crit, lhsScore, rhsScore) {
     }
   ]);
 }
-function explainQuirk(onLogMessage, result, crit, lhs) {
-  onLogMessage == null ? void 0 : onLogMessage([
-    "info",
-    302,
-    {
-      matched: result,
-      description: `Quirk ${crit.l}[${lhs}] ${crit.op} ${crit.r}`
-    }
-  ]);
-}
 
-// src/placement/personalizeVariations.ts
+// src/placement/personalize.ts
+var sortVariations = ({
+  variations,
+  rankVariant
+}) => {
+  const variationsWithScores = Array.from(variations).map((variant) => {
+    const score = rankVariant == null ? void 0 : rankVariant(variant);
+    return {
+      variant,
+      score
+    };
+  });
+  const variantsWithDefinedScores = variationsWithScores.filter((v) => v.score !== void 0);
+  const variantsWithUndefinedScores = variationsWithScores.filter((v) => v.score === void 0);
+  return [
+    ...variantsWithDefinedScores.sort((a, b) => {
+      var _a, _b;
+      return ((_a = b.score) != null ? _a : 0) - ((_b = a.score) != null ? _b : 0);
+    }).map((v) => v.variant),
+    ...variantsWithUndefinedScores.map((v) => v.variant)
+  ];
+};
 function personalizeVariations({
   name,
   context,
-  variations,
+  variations: providedVariations,
   take = 1,
-  onLogMessage
+  onLogMessage,
+  rankVariant
 }) {
   var _a, _b, _c;
   onLogMessage == null ? void 0 : onLogMessage(["info", 300, "GROUP", { name, take }]);
@@ -688,9 +677,10 @@ function personalizeVariations({
     const defaultVariants = [];
     const needsConsent = context.requireConsentForPersonalization;
     const canEvaluate = !needsConsent || context.storage.data.consent;
+    const variations = rankVariant ? sortVariations({ variations: providedVariations, rankVariant }) : providedVariations;
     for (const variant of variations) {
       if ((_a = variant.pz) == null ? void 0 : _a.crit.length) {
-        if (canEvaluate && variantMatches.length !== take && evaluateVariantMatch(variant.id, variant.pz, context.scores, onLogMessage, context.quirks)) {
+        if (canEvaluate && variantMatches.length !== take && evaluateVariantMatch(variant.id, variant.pz, context.scores, onLogMessage)) {
           variantMatches.push(variant);
         }
       } else {
@@ -749,7 +739,7 @@ function personalizeVariations({
   }
 }
 
-// src/placement/normalizeVariationDistributions.ts
+// src/placement/test.ts
 var normalizeVariationDistributions = (variations) => {
   const { values, total, missingDistribution } = variations.reduce(
     (previous, current) => {
@@ -780,8 +770,6 @@ var normalizeVariationDistributions = (variations) => {
   }
   return values;
 };
-
-// src/placement/testVariations.ts
 var testVariations = ({
   name,
   context,
@@ -1548,7 +1536,7 @@ import { dequal as dequal5 } from "dequal/lite";
 import mitt3 from "mitt";
 var CONTEXTUAL_EDITING_TEST_NAME = "contextual_editing_test";
 var CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID = "contextual_editing_test_selected_variant";
-var _serverTransitionState, _scores, _state, _pzCache, _plugins, _commands, _requireConsentForPersonalization, _mitt3, _Context_instances, emitTest_fn, updateGoals_fn, updateComputedScores_fn, calculateScores_fn;
+var _serverTransitionState, _scores, _state, _pzCache, _plugins, _commands, _requireConsentForPersonalization, _rankPersonalizationVariant, _mitt3, _Context_instances, emitTest_fn, updateGoals_fn, updateComputedScores_fn, calculateScores_fn;
 var Context = class {
   constructor(options) {
     __privateAdd(this, _Context_instances);
@@ -1560,6 +1548,7 @@ var Context = class {
     __privateAdd(this, _plugins);
     __privateAdd(this, _commands);
     __privateAdd(this, _requireConsentForPersonalization);
+    __privateAdd(this, _rankPersonalizationVariant);
     __privateAdd(this, _mitt3, mitt3());
     /**
      * Subscribe to events
@@ -1574,6 +1563,7 @@ var Context = class {
     __privateSet(this, _state, {});
     __privateSet(this, _plugins, options.plugins);
     __privateSet(this, _requireConsentForPersonalization, options.requireConsentForPersonalization);
+    __privateSet(this, _rankPersonalizationVariant, options.rankPersonalizationVariant);
     if (typeof options.transitionStore !== "undefined") {
       __privateSet(this, _commands, []);
     }
@@ -1881,7 +1871,13 @@ var Context = class {
     const value = personalizeVariations({
       ...options,
       context: this,
-      onLogMessage: (message) => __privateGet(this, _mitt3).emit("log", message)
+      onLogMessage: (message) => __privateGet(this, _mitt3).emit("log", message),
+      rankVariant: __privateGet(this, _rankPersonalizationVariant) ? (variant) => __privateGet(this, _rankPersonalizationVariant).call(this, {
+        placementName: options.name,
+        variant,
+        scores: __privateGet(this, _scores),
+        quirks: this.storage.data.quirks
+      }) : void 0
     });
     const previousPlacement = __privateGet(this, _pzCache)[options.name];
     const eventData = {
@@ -1959,6 +1955,7 @@ _pzCache = new WeakMap();
 _plugins = new WeakMap();
 _commands = new WeakMap();
 _requireConsentForPersonalization = new WeakMap();
+_rankPersonalizationVariant = new WeakMap();
 _mitt3 = new WeakMap();
 _Context_instances = new WeakSet();
 emitTest_fn = function(event) {

package/dist/{types-gu4PVkDD.d.mts → types-C9cSPjHd.d.mts}

@@ -905,7 +905,7 @@ type VariantMatchCriteria = {
      * @defaultValue `&`
      */
     op?: '&' | '|';
-    crit: Array<DimensionMatch | QuirkMatch>;
+    crit: DimensionMatch[];
     /**
      * Name of the variant for analytics tracking.
      */
@@ -953,37 +953,6 @@ type DimensionMatch = {
      */
     rDim?: string;
 };
-type QuirkMatch = {
-    /**
-     * Type of match expression; 'q' discriminates quirk matches from dimension matches
-     */
-    t: 'q';
-    /**
-     * Left hand side of the match expression (name of quirk)
-     * NOTE: if the quirk is not present
-     */
-    l: string;
-    /**
-     * Operator of the match expression
-     * Comparison operators:
-     * =: `l` is equal to the right hand side expression
-     * !=: `l` is not equal to the right hand side expression
-     */
-    op: '=' | '!=';
-    /**
-     * Right hand side of the match expression
-     * This value is treated as a constant value, if it is present. If it's a string, it is parsed to an integer.
-     * To reference another score dimension as the RHS, use the `rDim` property instead.
-     * `r` and `rDim` are mutually exclusive; if both are specified, then `rDim` wins.
-     */
-    r: string;
-    /**
-     * Only here to maintain object compatibility with DimensionMatch.
-     * Completely ignored.
-     * @deprecated this is not used with QuirkMatch.
-     */
-    rDim?: string;
-};
 
 /** Content that is tagged for adding enrichment score when triggered by behavior (i.e. being shown that content) */
 type BehaviorTag = {
@@ -1035,8 +1004,9 @@ type PersonalizeOptions<TVariant> = {
     /** Maximum number of variants to place (default: 1) */
     take?: number;
     onLogMessage?: (message: LogMessage) => void;
+    rankVariant?: (variant: TVariant) => number | undefined;
 };
-declare function personalizeVariations<TVariant extends PersonalizedVariant>({ name, context, variations, take, onLogMessage, }: PersonalizeOptions<TVariant> & {
+declare function personalizeVariations<TVariant extends PersonalizedVariant>({ name, context, variations: providedVariations, take, onLogMessage, rankVariant, }: PersonalizeOptions<TVariant> & {
     context: Context;
 }): PersonalizedResult<TVariant>;
 
@@ -1081,7 +1051,32 @@ type ContextOptions = {
      * `true`: personalization is not run at all unless storage consent is given
      */
     requireConsentForPersonalization?: boolean;
+    /**
+     * Specify a rank for a personalized variant, controlling the order in which variants are considered.
+     * @param placementName The name of the personalized placement
+     * @param variant The variant to rank
+     * @returns A number representing the rank of the variant, where higher numbers are considered first
+     */
+    rankPersonalizationVariant?: (options: RankPersonalizationVariantOptions) => number | undefined;
 } & Omit<VisitorDataStoreOptions, 'manifest' | 'onServerTransitionScoresReceived'>;
+type RankPersonalizationVariantOptions = {
+    /**
+     * The name of the personalized placement
+     */
+    placementName: string;
+    /**
+     * The variant to rank
+     */
+    variant: PersonalizedVariant;
+    /**
+     * The current scores of the visitor
+     */
+    scores: Readonly<ScoreVector>;
+    /**
+     * The current quirks of the visitor
+     */
+    quirks: Readonly<Quirks>;
+};
 /** Emitted when a personalization runs */
 type PersonalizationEvent = {
     /** Name of the personalized placement */
@@ -1296,4 +1291,4 @@ declare global {
     }
 }
 
-export { type AggregateDimensionInput as $, type AggregateDimension as A, type MessageFunc as B, type ContextPlugin as C, type DecayFunction as D, type LogMessageSingle as E, type LogMessageGroup as F, ManifestInstance as G, GroupCriteriaEvaluator as H, type CriteriaEvaluatorResult as I, type CriteriaEvaluatorParameters as J, type SignalData as K, type LogDrain as L, type MessageCategory as M, type ManifestV2 as N, type OutputSeverity as O, type PersonalizationEvent as P, type Quirks as Q, type PersonalizationManifest as R, type ScoreVector as S, TransitionDataStore as T, type Signal as U, type VisitorData as V, type SignalCriteriaGroup as W, type SignalCriteria as X, type EnrichmentCategory as Y, type NumberMatch as Z, type TestDefinition as _, type StorageCommands as a, type TestOptions as a0, testVariations as a1, type DimensionMatch as a2, type QuirkMatch as a3, type PersonalizeOptions as a4, personalizeVariations as a5, type BehaviorTag as a6, type PersonalizedVariant as a7, type PersonalizedResult as a8, type TestVariant as a9, type ContextState as aA, type ContextStateUpdate as aB, type GoalStateUpdate as aC, type paths as aD, type TestResult as aa, type StorageCommand as ab, type SetGoalCommand as ac, type ModifyScoreCommand as ad, type ModifySessionScoreCommand as ae, type SetConsentCommand as af, type SetQuirkCommand as ag, type SetTestCommand as ah, type IdentifyCommand as ai, type SetControlGroupCommand as aj, type SetPersonalizeVariantControlCommand as ak, areCommandsEqual as al, type ServerToClientTransitionState as am, SERVER_STATE_ID as an, type TransitionDataStoreEvents as ao, type DecayOptions as ap, type VisitorDataStoreOptions as aq, type VisitorDataStoreEvents as ar, VisitorDataStore as as, type Tests as at, type Goals as au, type EnrichmentData as av, type PersonalizeControlVariant as aw, type PersonalizeVariants as ax, type EventData as ay, emptyVisitorData as az, type TransitionDataStoreOptions as b, type CriteriaEvaluator as c, type StringMatch as d, type VariantMatchCriteria as e, type LogMessage as f, type DevToolsEvents as g, CONTEXTUAL_EDITING_TEST_NAME as h, CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID as i, type ContextOptions as j, type TestEvent as k, type ContextEvents as l, type ContextInstance as m, Context as n, type DevToolsUiVersion as o, type DevToolsState as p, type DevToolsActions as q, type DevToolsEvent as r, type DevToolsLogEvent as s, type DevToolsDataEvent as t, type DevToolsHelloEvent as u, type DevToolsUpdateEvent as v, type DevToolsRawCommandsEvent as w, type DevToolsForgetEvent as x, type LogMessages as y, type Severity as z };
+export { type TestDefinition as $, type AggregateDimension as A, type MessageFunc as B, type ContextPlugin as C, type DecayFunction as D, type LogMessageSingle as E, type LogMessageGroup as F, ManifestInstance as G, GroupCriteriaEvaluator as H, type CriteriaEvaluatorResult as I, type CriteriaEvaluatorParameters as J, type SignalData as K, type LogDrain as L, type MessageCategory as M, type ManifestV2 as N, type OutputSeverity as O, type PersonalizationEvent as P, type Quirks as Q, type RankPersonalizationVariantOptions as R, type ScoreVector as S, TransitionDataStore as T, type PersonalizationManifest as U, type VisitorData as V, type Signal as W, type SignalCriteriaGroup as X, type SignalCriteria as Y, type EnrichmentCategory as Z, type NumberMatch as _, type StorageCommands as a, type AggregateDimensionInput as a0, type TestOptions as a1, testVariations as a2, type DimensionMatch as a3, type PersonalizeOptions as a4, personalizeVariations as a5, type BehaviorTag as a6, type PersonalizedVariant as a7, type PersonalizedResult as a8, type TestVariant as a9, type ContextState as aA, type ContextStateUpdate as aB, type GoalStateUpdate as aC, type paths as aD, type TestResult as aa, type StorageCommand as ab, type SetGoalCommand as ac, type ModifyScoreCommand as ad, type ModifySessionScoreCommand as ae, type SetConsentCommand as af, type SetQuirkCommand as ag, type SetTestCommand as ah, type IdentifyCommand as ai, type SetControlGroupCommand as aj, type SetPersonalizeVariantControlCommand as ak, areCommandsEqual as al, type ServerToClientTransitionState as am, SERVER_STATE_ID as an, type TransitionDataStoreEvents as ao, type DecayOptions as ap, type VisitorDataStoreOptions as aq, type VisitorDataStoreEvents as ar, VisitorDataStore as as, type Tests as at, type Goals as au, type EnrichmentData as av, type PersonalizeControlVariant as aw, type PersonalizeVariants as ax, type EventData as ay, emptyVisitorData as az, type TransitionDataStoreOptions as b, type CriteriaEvaluator as c, type StringMatch as d, type VariantMatchCriteria as e, type LogMessage as f, type DevToolsEvents as g, CONTEXTUAL_EDITING_TEST_NAME as h, CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID as i, type ContextOptions as j, type TestEvent as k, type ContextEvents as l, type ContextInstance as m, Context as n, type DevToolsUiVersion as o, type DevToolsState as p, type DevToolsActions as q, type DevToolsEvent as r, type DevToolsLogEvent as s, type DevToolsDataEvent as t, type DevToolsHelloEvent as u, type DevToolsUpdateEvent as v, type DevToolsRawCommandsEvent as w, type DevToolsForgetEvent as x, type LogMessages as y, type Severity as z };

package/dist/{types-gu4PVkDD.d.ts → types-C9cSPjHd.d.ts}

@@ -905,7 +905,7 @@ type VariantMatchCriteria = {
      * @defaultValue `&`
      */
     op?: '&' | '|';
-    crit: Array<DimensionMatch | QuirkMatch>;
+    crit: DimensionMatch[];
     /**
      * Name of the variant for analytics tracking.
      */
@@ -953,37 +953,6 @@ type DimensionMatch = {
      */
     rDim?: string;
 };
-type QuirkMatch = {
-    /**
-     * Type of match expression; 'q' discriminates quirk matches from dimension matches
-     */
-    t: 'q';
-    /**
-     * Left hand side of the match expression (name of quirk)
-     * NOTE: if the quirk is not present
-     */
-    l: string;
-    /**
-     * Operator of the match expression
-     * Comparison operators:
-     * =: `l` is equal to the right hand side expression
-     * !=: `l` is not equal to the right hand side expression
-     */
-    op: '=' | '!=';
-    /**
-     * Right hand side of the match expression
-     * This value is treated as a constant value, if it is present. If it's a string, it is parsed to an integer.
-     * To reference another score dimension as the RHS, use the `rDim` property instead.
-     * `r` and `rDim` are mutually exclusive; if both are specified, then `rDim` wins.
-     */
-    r: string;
-    /**
-     * Only here to maintain object compatibility with DimensionMatch.
-     * Completely ignored.
-     * @deprecated this is not used with QuirkMatch.
-     */
-    rDim?: string;
-};
 
 /** Content that is tagged for adding enrichment score when triggered by behavior (i.e. being shown that content) */
 type BehaviorTag = {
@@ -1035,8 +1004,9 @@ type PersonalizeOptions<TVariant> = {
     /** Maximum number of variants to place (default: 1) */
     take?: number;
     onLogMessage?: (message: LogMessage) => void;
+    rankVariant?: (variant: TVariant) => number | undefined;
 };
-declare function personalizeVariations<TVariant extends PersonalizedVariant>({ name, context, variations, take, onLogMessage, }: PersonalizeOptions<TVariant> & {
+declare function personalizeVariations<TVariant extends PersonalizedVariant>({ name, context, variations: providedVariations, take, onLogMessage, rankVariant, }: PersonalizeOptions<TVariant> & {
     context: Context;
 }): PersonalizedResult<TVariant>;
 
@@ -1081,7 +1051,32 @@ type ContextOptions = {
      * `true`: personalization is not run at all unless storage consent is given
      */
     requireConsentForPersonalization?: boolean;
+    /**
+     * Specify a rank for a personalized variant, controlling the order in which variants are considered.
+     * @param placementName The name of the personalized placement
+     * @param variant The variant to rank
+     * @returns A number representing the rank of the variant, where higher numbers are considered first
+     */
+    rankPersonalizationVariant?: (options: RankPersonalizationVariantOptions) => number | undefined;
 } & Omit<VisitorDataStoreOptions, 'manifest' | 'onServerTransitionScoresReceived'>;
+type RankPersonalizationVariantOptions = {
+    /**
+     * The name of the personalized placement
+     */
+    placementName: string;
+    /**
+     * The variant to rank
+     */
+    variant: PersonalizedVariant;
+    /**
+     * The current scores of the visitor
+     */
+    scores: Readonly<ScoreVector>;
+    /**
+     * The current quirks of the visitor
+     */
+    quirks: Readonly<Quirks>;
+};
 /** Emitted when a personalization runs */
 type PersonalizationEvent = {
     /** Name of the personalized placement */
@@ -1296,4 +1291,4 @@ declare global {
     }
 }
 
-export { type AggregateDimensionInput as $, type AggregateDimension as A, type MessageFunc as B, type ContextPlugin as C, type DecayFunction as D, type LogMessageSingle as E, type LogMessageGroup as F, ManifestInstance as G, GroupCriteriaEvaluator as H, type CriteriaEvaluatorResult as I, type CriteriaEvaluatorParameters as J, type SignalData as K, type LogDrain as L, type MessageCategory as M, type ManifestV2 as N, type OutputSeverity as O, type PersonalizationEvent as P, type Quirks as Q, type PersonalizationManifest as R, type ScoreVector as S, TransitionDataStore as T, type Signal as U, type VisitorData as V, type SignalCriteriaGroup as W, type SignalCriteria as X, type EnrichmentCategory as Y, type NumberMatch as Z, type TestDefinition as _, type StorageCommands as a, type TestOptions as a0, testVariations as a1, type DimensionMatch as a2, type QuirkMatch as a3, type PersonalizeOptions as a4, personalizeVariations as a5, type BehaviorTag as a6, type PersonalizedVariant as a7, type PersonalizedResult as a8, type TestVariant as a9, type ContextState as aA, type ContextStateUpdate as aB, type GoalStateUpdate as aC, type paths as aD, type TestResult as aa, type StorageCommand as ab, type SetGoalCommand as ac, type ModifyScoreCommand as ad, type ModifySessionScoreCommand as ae, type SetConsentCommand as af, type SetQuirkCommand as ag, type SetTestCommand as ah, type IdentifyCommand as ai, type SetControlGroupCommand as aj, type SetPersonalizeVariantControlCommand as ak, areCommandsEqual as al, type ServerToClientTransitionState as am, SERVER_STATE_ID as an, type TransitionDataStoreEvents as ao, type DecayOptions as ap, type VisitorDataStoreOptions as aq, type VisitorDataStoreEvents as ar, VisitorDataStore as as, type Tests as at, type Goals as au, type EnrichmentData as av, type PersonalizeControlVariant as aw, type PersonalizeVariants as ax, type EventData as ay, emptyVisitorData as az, type TransitionDataStoreOptions as b, type CriteriaEvaluator as c, type StringMatch as d, type VariantMatchCriteria as e, type LogMessage as f, type DevToolsEvents as g, CONTEXTUAL_EDITING_TEST_NAME as h, CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID as i, type ContextOptions as j, type TestEvent as k, type ContextEvents as l, type ContextInstance as m, Context as n, type DevToolsUiVersion as o, type DevToolsState as p, type DevToolsActions as q, type DevToolsEvent as r, type DevToolsLogEvent as s, type DevToolsDataEvent as t, type DevToolsHelloEvent as u, type DevToolsUpdateEvent as v, type DevToolsRawCommandsEvent as w, type DevToolsForgetEvent as x, type LogMessages as y, type Severity as z };
+export { type TestDefinition as $, type AggregateDimension as A, type MessageFunc as B, type ContextPlugin as C, type DecayFunction as D, type LogMessageSingle as E, type LogMessageGroup as F, ManifestInstance as G, GroupCriteriaEvaluator as H, type CriteriaEvaluatorResult as I, type CriteriaEvaluatorParameters as J, type SignalData as K, type LogDrain as L, type MessageCategory as M, type ManifestV2 as N, type OutputSeverity as O, type PersonalizationEvent as P, type Quirks as Q, type RankPersonalizationVariantOptions as R, type ScoreVector as S, TransitionDataStore as T, type PersonalizationManifest as U, type VisitorData as V, type Signal as W, type SignalCriteriaGroup as X, type SignalCriteria as Y, type EnrichmentCategory as Z, type NumberMatch as _, type StorageCommands as a, type AggregateDimensionInput as a0, type TestOptions as a1, testVariations as a2, type DimensionMatch as a3, type PersonalizeOptions as a4, personalizeVariations as a5, type BehaviorTag as a6, type PersonalizedVariant as a7, type PersonalizedResult as a8, type TestVariant as a9, type ContextState as aA, type ContextStateUpdate as aB, type GoalStateUpdate as aC, type paths as aD, type TestResult as aa, type StorageCommand as ab, type SetGoalCommand as ac, type ModifyScoreCommand as ad, type ModifySessionScoreCommand as ae, type SetConsentCommand as af, type SetQuirkCommand as ag, type SetTestCommand as ah, type IdentifyCommand as ai, type SetControlGroupCommand as aj, type SetPersonalizeVariantControlCommand as ak, areCommandsEqual as al, type ServerToClientTransitionState as am, SERVER_STATE_ID as an, type TransitionDataStoreEvents as ao, type DecayOptions as ap, type VisitorDataStoreOptions as aq, type VisitorDataStoreEvents as ar, VisitorDataStore as as, type Tests as at, type Goals as au, type EnrichmentData as av, type PersonalizeControlVariant as aw, type PersonalizeVariants as ax, type EventData as ay, emptyVisitorData as az, type TransitionDataStoreOptions as b, type CriteriaEvaluator as c, type StringMatch as d, type VariantMatchCriteria as e, type LogMessage as f, type DevToolsEvents as g, CONTEXTUAL_EDITING_TEST_NAME as h, CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID as i, type ContextOptions as j, type TestEvent as k, type ContextEvents as l, type ContextInstance as m, Context as n, type DevToolsUiVersion as o, type DevToolsState as p, type DevToolsActions as q, type DevToolsEvent as r, type DevToolsLogEvent as s, type DevToolsDataEvent as t, type DevToolsHelloEvent as u, type DevToolsUpdateEvent as v, type DevToolsRawCommandsEvent as w, type DevToolsForgetEvent as x, type LogMessages as y, type Severity as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniformdev/context",
-  "version": "20.3.1-alpha.7+bede5bf489",
+  "version": "20.4.1-alpha.3+bc2e6fc5f7",
   "description": "Uniform Context core package",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "./dist/index.js",
@@ -68,5 +68,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "bede5bf4893bf814af6aba78a558e28efd9f5682"
+  "gitHead": "bc2e6fc5f7d2920e46605385db043782f023bbbb"
 }