@playcademy/sandbox 0.10.1-beta.3 → 0.10.1-beta.4

package/dist/cli.js

@@ -285,7 +285,7 @@ var init_platform = __esm(() => {
 var PLATFORM_TIMEZONE = "America/New_York";
 
 // ../constants/src/timeback.ts
-var TIMEBACK_GRADES, TIMEBACK_SUBJECTS, ASSESSMENT_PURPOSES, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_VERSION = 1, PLAYCADEMY_ASSESSMENT_CONTRACT_VERSION = 1, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_KEY = "playcademyAssessment", PLAYCADEMY_ASSESSMENT_ITEM_RESULT_METADATA_KEY = "playcademyAssessmentItem", TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS, TIMEBACK_ORG_SOURCED_ID = "PLAYCADEMY", TIMEBACK_ORG_NAME = "Playcademy Studios", TIMEBACK_ORG_TYPE = "department", TIMEBACK_COURSE_DEFAULTS, TIMEBACK_RESOURCE_DEFAULTS, TIMEBACK_COMPONENT_DEFAULTS, TIMEBACK_COMPONENT_RESOURCE_DEFAULTS, TIMEBACK_ASSESSMENT_RESPONSE_VALUE_MAX_LENGTH = 2048, TIMEBACK_GAME_METRIC_DECIMAL_PLACES, TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE;
+var TIMEBACK_GRADES, TIMEBACK_SUBJECTS, ASSESSMENT_PURPOSES, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_VERSION = 1, PLAYCADEMY_ASSESSMENT_CONTRACT_VERSION = 2, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_KEY = "playcademyAssessment", PLAYCADEMY_ASSESSMENT_ITEM_RESULT_METADATA_KEY = "playcademyAssessmentItem", TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS, TIMEBACK_ORG_SOURCED_ID = "PLAYCADEMY", TIMEBACK_ORG_NAME = "Playcademy Studios", TIMEBACK_ORG_TYPE = "department", TIMEBACK_COURSE_DEFAULTS, TIMEBACK_RESOURCE_DEFAULTS, TIMEBACK_COMPONENT_DEFAULTS, TIMEBACK_COMPONENT_RESOURCE_DEFAULTS, TIMEBACK_ASSESSMENT_RESPONSE_VALUE_MAX_LENGTH = 2048, TIMEBACK_GAME_METRIC_DECIMAL_PLACES, TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE;
 var init_timeback2 = __esm(() => {
   TIMEBACK_GRADES = [-1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13];
   TIMEBACK_SUBJECTS = [
@@ -1128,7 +1128,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.10.1-beta.3",
+    version: "0.10.1-beta.4",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -10834,30 +10834,60 @@ function comparePresentationText(left, right) {
   }
   return 0;
 }
+function presentationRandomIndex(seed) {
+  let state = presentationHash(seed);
+  const range = 2 ** 32;
+  return (bound) => {
+    const limit = range - range % bound;
+    let value;
+    do {
+      state = state + 1831565813 >>> 0;
+      let mixed = Math.imul(state ^ state >>> 15, state | 1);
+      mixed ^= mixed + Math.imul(mixed ^ mixed >>> 7, mixed | 61);
+      value = (mixed ^ mixed >>> 14) >>> 0;
+    } while (value >= limit);
+    return value % bound;
+  };
+}
 function presentationChoices(choices, attemptId, itemIdentifier, domain) {
-  const seed = `${attemptId}\x00${itemIdentifier}\x00${domain}\x00`;
-  return [...choices].toSorted((left, right) => {
-    const hashDifference = presentationHash(`${seed}${left.identifier}`) - presentationHash(`${seed}${right.identifier}`);
-    return hashDifference || comparePresentationText(left.identifier, right.identifier);
-  });
+  const randomIndex = presentationRandomIndex(JSON.stringify([attemptId, itemIdentifier, domain]));
+  const movable = choices.filter((choice) => !choice.fixed).toSorted((left, right) => comparePresentationText(left.identifier, right.identifier));
+  for (let index = movable.length - 1;index > 0; index--) {
+    const other = randomIndex(index + 1);
+    [movable[index], movable[other]] = [movable[other], movable[index]];
+  }
+  let next = 0;
+  return choices.map((choice) => choice.fixed ? choice : movable[next++]);
 }
 function assessmentPresentationForAttempt(assessment, attemptId) {
   const items = assessment.items.map((item) => {
     const interactions = item.interactions.map((interaction) => {
-      if (interaction.type === "order" && interaction.shuffle) {
-        return {
-          ...interaction,
-          choices: presentationChoices(interaction.choices, attemptId, item.identifier, `order\x00${interaction.responseIdentifier}`)
-        };
+      if (!("shuffle" in interaction) || !interaction.shuffle) {
+        return interaction;
       }
-      if (interaction.type === "match" && interaction.shuffle) {
-        return {
-          ...interaction,
-          sourceChoices: presentationChoices(interaction.sourceChoices, attemptId, item.identifier, `match-source\x00${interaction.responseIdentifier}`),
-          targetChoices: presentationChoices(interaction.targetChoices, attemptId, item.identifier, `match-target\x00${interaction.responseIdentifier}`)
-        };
+      function shuffled(choices, domain) {
+        return presentationChoices(choices, attemptId, item.identifier, `${domain}\x00${interaction.responseIdentifier}`);
+      }
+      switch (interaction.type) {
+        case "choice":
+        case "inline-choice":
+        case "order": {
+          return {
+            ...interaction,
+            choices: shuffled(interaction.choices, interaction.type)
+          };
+        }
+        case "gap-match": {
+          return { ...interaction, gapTexts: shuffled(interaction.gapTexts, "gap-match") };
+        }
+        case "match": {
+          return {
+            ...interaction,
+            sourceChoices: shuffled(interaction.sourceChoices, "match-source"),
+            targetChoices: shuffled(interaction.targetChoices, "match-target")
+          };
+        }
       }
-      return interaction;
     });
     return { ...item, interactions };
   });
@@ -11812,6 +11842,7 @@ var init_assessment_runtime2 = __esm(() => {
   init_src();
   init_timeback3();
   init_src();
+  init_src();
   init_uuid();
   init_esm();
   init_src();
@@ -39209,7 +39240,7 @@ function assertMatchingAssessmentArtifactPair(playable, scoring, expectedIdentit
     throw new ValidationError("Assessment artifact pair does not describe one revision");
   }
 }
-var ASSESSMENT_ARTIFACT_SCHEMA_VERSION = 1, ASSESSMENT_GRADER_PROTOCOL_VERSION = 1, ARTIFACT_KEY_PREFIX = "assessment-artifacts", SHA256_HEX, textEncoder;
+var ASSESSMENT_ARTIFACT_SCHEMA_VERSION = 2, ASSESSMENT_GRADER_PROTOCOL_VERSION = 1, ARTIFACT_KEY_PREFIX = "assessment-artifacts", SHA256_HEX, textEncoder;
 var init_assessment_artifact_envelope_util = __esm(() => {
   init_errors2();
   SHA256_HEX = /^[a-f0-9]{64}$/;
@@ -94303,6 +94334,30 @@ var init_timeback_game_metrics_comparison_util = __esm(() => {
 });
 
 // ../timeback/dist/engines/qti/index.js
+function qtiAttributeNumber(attributes, name3, fallback) {
+  const raw = attributes[name3]?.trim();
+  if (!raw) {
+    return fallback;
+  }
+  const value = Number(raw);
+  return Number.isFinite(value) ? value : fallback;
+}
+function qtiAttributeCapacity(attributes, name3, fallback) {
+  const raw = attributes[name3]?.trim();
+  if (!raw) {
+    return fallback;
+  }
+  const value = Number(raw);
+  return Number.isInteger(value) && value >= 0 ? value : null;
+}
+function qtiAttributeMaximum(attributes, name3, fallback, unlimited) {
+  const maximum = qtiAttributeNumber(attributes, name3, fallback);
+  return maximum === 0 ? unlimited : maximum;
+}
+function qtiAttributeBoolean(attributes, name3) {
+  const value = attributes[name3];
+  return value === "true" || value === "1";
+}
 function decodeCssEscapes(value) {
   return value.replace(/\\([0-9a-fA-F]{1,6})\s?/g, (_, hex3) => {
     const code = Number.parseInt(hex3, 16);
@@ -94890,7 +94945,8 @@ function parseGapTexts(interaction) {
     return {
       identifier: attributes2.identifier || "",
       content: plainTextFromNodes(gapText.children),
-      matchMax: finiteNumber(attributes2["match-max"]) ?? 1
+      matchMax: finiteNumber(attributes2["match-max"]) ?? 1,
+      ...qtiAttributeBoolean(attributes2, "fixed") ? { fixed: true } : {}
     };
   }).filter((gapText) => gapText.identifier);
 }
@@ -95990,30 +96046,6 @@ ${body2}
 ${processing}` : ""}
 </qti-assessment-item>`;
 }
-function qtiAttributeNumber(attributes2, name3, fallback) {
-  const raw = attributes2[name3]?.trim();
-  if (!raw) {
-    return fallback;
-  }
-  const value = Number(raw);
-  return Number.isFinite(value) ? value : fallback;
-}
-function qtiAttributeCapacity(attributes2, name3, fallback) {
-  const raw = attributes2[name3]?.trim();
-  if (!raw) {
-    return fallback;
-  }
-  const value = Number(raw);
-  return Number.isInteger(value) && value >= 0 ? value : null;
-}
-function qtiAttributeMaximum(attributes2, name3, fallback, unlimited) {
-  const maximum = qtiAttributeNumber(attributes2, name3, fallback);
-  return maximum === 0 ? unlimited : maximum;
-}
-function qtiAttributeBoolean(attributes2, name3) {
-  const value = attributes2[name3];
-  return value === "true" || value === "1";
-}
 function gapContentIdentifiers(nodes) {
   return nodes.flatMap((node) => {
     if (node.kind === "gap") {
@@ -96094,6 +96126,7 @@ function authorableQtiInteractionProjection(interaction) {
         type: interaction.type,
         choices: interaction.choices,
         minChoices: qtiAttributeNumber(attributes2, "min-choices", 1),
+        shuffle: qtiAttributeBoolean(attributes2, "shuffle"),
         maxChoices: qtiAttributeMaximum(attributes2, "max-choices", 1, interaction.choices.length)
       };
     }
@@ -96102,6 +96135,7 @@ function authorableQtiInteractionProjection(interaction) {
         ...base,
         type: interaction.type,
         choices: interaction.choices,
+        shuffle: qtiAttributeBoolean(attributes2, "shuffle"),
         blankIndex: interaction.blankIndex ?? 0
       } : null;
     }
@@ -99933,11 +99967,13 @@ var init_assessment_artifact_runtime_util = __esm(() => {
   playableContentNodesSchema = exports_external.array(exports_external.unknown());
   playableChoiceSchema = exports_external.object({
     identifier: trimmedNonEmptyString3,
+    fixed: exports_external.boolean().optional(),
     content: exports_external.string(),
     contentNodes: playableContentNodesSchema.optional()
   }).strict();
   playableMatchChoiceSchema = exports_external.object({
     identifier: trimmedNonEmptyString3,
+    fixed: exports_external.boolean().optional(),
     content: exports_external.string(),
     contentNodes: playableContentNodesSchema.optional(),
     matchMax: nonnegativeInteger
@@ -99957,6 +99993,7 @@ var init_assessment_artifact_runtime_util = __esm(() => {
   }).strict();
   playableGapTextSchema = exports_external.object({
     identifier: trimmedNonEmptyString3,
+    fixed: exports_external.boolean().optional(),
     content: exports_external.string(),
     matchMax: nonnegativeInteger
   }).strict();
@@ -99974,6 +100011,7 @@ var init_assessment_artifact_runtime_util = __esm(() => {
     exports_external.object({
       ...playableInteractionBase,
       type: exports_external.literal("choice"),
+      shuffle: exports_external.boolean(),
       choices: exports_external.array(playableChoiceSchema),
       minChoices: nonnegativeInteger,
       maxChoices: nonnegativeInteger
@@ -99981,6 +100019,7 @@ var init_assessment_artifact_runtime_util = __esm(() => {
     exports_external.object({
       ...playableInteractionBase,
       type: exports_external.literal("inline-choice"),
+      shuffle: exports_external.boolean(),
       choices: exports_external.array(playableChoiceSchema)
     }).strict(),
     exports_external.object({
@@ -100024,6 +100063,7 @@ var init_assessment_artifact_runtime_util = __esm(() => {
     exports_external.object({
       ...playableInteractionBase,
       type: exports_external.literal("gap-match"),
+      shuffle: exports_external.boolean(),
       content: exports_external.string(),
       contentNodes: playableContentNodesSchema,
       gapTexts: exports_external.array(playableGapTextSchema),
@@ -100536,6 +100576,7 @@ function playableChoice(choice) {
   return {
     identifier: choice.identifier,
     content: choice.content,
+    ...qtiAttributeBoolean(choice.attributes, "fixed") ? { fixed: true } : {},
     ...choice.contentNodes ? { contentNodes: choice.contentNodes } : {}
   };
 }
@@ -100598,6 +100639,7 @@ function parseInteraction2(questionIdentifier, interaction) {
       responseIdentifier,
       ...prompt,
       choices,
+      shuffle: qtiAttributeBoolean(interaction.attributes, "shuffle"),
       minChoices: qtiAttributeNumber(interaction.attributes, "min-choices", 1),
       maxChoices: qtiAttributeMaximum(interaction.attributes, "max-choices", 1, choices.length)
     };
@@ -100607,7 +100649,8 @@ function parseInteraction2(questionIdentifier, interaction) {
       type,
       responseIdentifier,
       ...prompt,
-      choices: requireChoices2(interaction.choices.map(playableChoice))
+      choices: requireChoices2(interaction.choices.map(playableChoice)),
+      shuffle: qtiAttributeBoolean(interaction.attributes, "shuffle")
     };
   }
   if (type === "text-entry") {
@@ -100668,11 +100711,13 @@ function parseInteraction2(questionIdentifier, interaction) {
       responseIdentifier,
       ...prompt,
       content: interaction.textWithGaps,
+      shuffle: qtiAttributeBoolean(interaction.attributes, "shuffle"),
       contentNodes: interaction.gapContent,
       gapTexts: interaction.gapTexts.map((gapText) => ({
         identifier: gapText.identifier,
         content: gapText.content,
-        matchMax: gapText.matchMax
+        matchMax: gapText.matchMax,
+        ...gapText.fixed ? { fixed: true } : {}
       })),
       gaps: [...interaction.gaps],
       maxAssociations: qtiAttributeNumber(interaction.attributes, "max-associations", 0)
@@ -101491,7 +101536,7 @@ function buildInlineChoiceQuestionXml(input, identifier, title) {
   if (!envelope) {
     return null;
   }
-  const { structure, responseIdentifier, prompt } = envelope;
+  const { interaction, structure, responseIdentifier, prompt } = envelope;
   const promptParts = prompt.split(INLINE_CHOICE_BLANK);
   if (promptParts.length !== 2) {
     throw new ValidationError("Inline-choice questions require exactly one blank");
@@ -101505,7 +101550,7 @@ function buildInlineChoiceQuestionXml(input, identifier, title) {
   const choicesXml = choices.map((choice) => `        <qti-inline-choice identifier="${escapeXml(choice.identifier)}">${escapeXml(choice.content)}</qti-inline-choice>`).join(`
 `);
   const [before = "", after = ""] = promptParts;
-  const itemBody = `    <p>${escapeXml(before)}<qti-inline-choice-interaction response-identifier="${escapeXml(responseIdentifier)}">
+  const itemBody = `    <p>${escapeXml(before)}<qti-inline-choice-interaction response-identifier="${escapeXml(responseIdentifier)}" shuffle="${interaction.shuffle === true}">
 ${choicesXml}
       </qti-inline-choice-interaction>${escapeXml(after)}</p>`;
   return buildExactMatchQuestionXml({
@@ -102120,7 +102165,7 @@ async function prepareReviewMappingUpdate(test, questions) {
   const contentRevision = await assessmentContentRevision(test, questions);
   const assessment = {
     identifier: test.identifier,
-    contractVersion: 1,
+    contractVersion: PLAYCADEMY_ASSESSMENT_CONTRACT_VERSION,
     contentRevision,
     title: test.title,
     items: questions.questions.map(({ question }) => ({
@@ -102159,6 +102204,7 @@ async function prepareReviewMappingUpdate(test, questions) {
 var PLAYCADEMY_REVIEW_BANK_TITLE = "Review Bank", PLAYCADEMY_REVIEW_BANK_SINK_METADATA_KEY = "playcademyReviewBankSink", PLAYCADEMY_REVIEW_BANK_SINK_VERSION = 1, StoredSinkWarningSchema, ReviewBankSinkMarkerSchema;
 var init_timeback_review_mapping_util = __esm(() => {
   init_esm();
+  init_src();
   init_assessment_runtime2();
   init_qti();
   init_timeback3();

package/dist/constants.js

@@ -100,7 +100,7 @@ var init_platform = __esm(() => {
 var PLATFORM_TIMEZONE = "America/New_York";
 
 // ../constants/src/timeback.ts
-var TIMEBACK_GRADES, TIMEBACK_SUBJECTS, ASSESSMENT_PURPOSES, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_VERSION = 1, PLAYCADEMY_ASSESSMENT_CONTRACT_VERSION = 1, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_KEY = "playcademyAssessment", PLAYCADEMY_ASSESSMENT_ITEM_RESULT_METADATA_KEY = "playcademyAssessmentItem", TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS, TIMEBACK_ORG_SOURCED_ID = "PLAYCADEMY", TIMEBACK_ORG_NAME = "Playcademy Studios", TIMEBACK_ORG_TYPE = "department", TIMEBACK_COURSE_DEFAULTS, TIMEBACK_RESOURCE_DEFAULTS, TIMEBACK_COMPONENT_DEFAULTS, TIMEBACK_COMPONENT_RESOURCE_DEFAULTS, TIMEBACK_ASSESSMENT_RESPONSE_VALUE_MAX_LENGTH = 2048, TIMEBACK_GAME_METRIC_DECIMAL_PLACES, TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE;
+var TIMEBACK_GRADES, TIMEBACK_SUBJECTS, ASSESSMENT_PURPOSES, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_VERSION = 1, PLAYCADEMY_ASSESSMENT_CONTRACT_VERSION = 2, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_KEY = "playcademyAssessment", PLAYCADEMY_ASSESSMENT_ITEM_RESULT_METADATA_KEY = "playcademyAssessmentItem", TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS, TIMEBACK_ORG_SOURCED_ID = "PLAYCADEMY", TIMEBACK_ORG_NAME = "Playcademy Studios", TIMEBACK_ORG_TYPE = "department", TIMEBACK_COURSE_DEFAULTS, TIMEBACK_RESOURCE_DEFAULTS, TIMEBACK_COMPONENT_DEFAULTS, TIMEBACK_COMPONENT_RESOURCE_DEFAULTS, TIMEBACK_ASSESSMENT_RESPONSE_VALUE_MAX_LENGTH = 2048, TIMEBACK_GAME_METRIC_DECIMAL_PLACES, TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE;
 var init_timeback = __esm(() => {
   TIMEBACK_GRADES = [-1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13];
   TIMEBACK_SUBJECTS = [

package/dist/server.js

@@ -284,7 +284,7 @@ var init_platform = __esm(() => {
 var PLATFORM_TIMEZONE = "America/New_York";
 
 // ../constants/src/timeback.ts
-var TIMEBACK_GRADES, TIMEBACK_SUBJECTS, ASSESSMENT_PURPOSES, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_VERSION = 1, PLAYCADEMY_ASSESSMENT_CONTRACT_VERSION = 1, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_KEY = "playcademyAssessment", PLAYCADEMY_ASSESSMENT_ITEM_RESULT_METADATA_KEY = "playcademyAssessmentItem", TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS, TIMEBACK_ORG_SOURCED_ID = "PLAYCADEMY", TIMEBACK_ORG_NAME = "Playcademy Studios", TIMEBACK_ORG_TYPE = "department", TIMEBACK_COURSE_DEFAULTS, TIMEBACK_RESOURCE_DEFAULTS, TIMEBACK_COMPONENT_DEFAULTS, TIMEBACK_COMPONENT_RESOURCE_DEFAULTS, TIMEBACK_ASSESSMENT_RESPONSE_VALUE_MAX_LENGTH = 2048, TIMEBACK_GAME_METRIC_DECIMAL_PLACES, TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE;
+var TIMEBACK_GRADES, TIMEBACK_SUBJECTS, ASSESSMENT_PURPOSES, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_VERSION = 1, PLAYCADEMY_ASSESSMENT_CONTRACT_VERSION = 2, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_KEY = "playcademyAssessment", PLAYCADEMY_ASSESSMENT_ITEM_RESULT_METADATA_KEY = "playcademyAssessmentItem", TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS, TIMEBACK_ORG_SOURCED_ID = "PLAYCADEMY", TIMEBACK_ORG_NAME = "Playcademy Studios", TIMEBACK_ORG_TYPE = "department", TIMEBACK_COURSE_DEFAULTS, TIMEBACK_RESOURCE_DEFAULTS, TIMEBACK_COMPONENT_DEFAULTS, TIMEBACK_COMPONENT_RESOURCE_DEFAULTS, TIMEBACK_ASSESSMENT_RESPONSE_VALUE_MAX_LENGTH = 2048, TIMEBACK_GAME_METRIC_DECIMAL_PLACES, TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE;
 var init_timeback2 = __esm(() => {
   TIMEBACK_GRADES = [-1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13];
   TIMEBACK_SUBJECTS = [
@@ -1127,7 +1127,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.10.1-beta.3",
+    version: "0.10.1-beta.4",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -10833,30 +10833,60 @@ function comparePresentationText(left, right) {
   }
   return 0;
 }
+function presentationRandomIndex(seed) {
+  let state = presentationHash(seed);
+  const range = 2 ** 32;
+  return (bound) => {
+    const limit = range - range % bound;
+    let value;
+    do {
+      state = state + 1831565813 >>> 0;
+      let mixed = Math.imul(state ^ state >>> 15, state | 1);
+      mixed ^= mixed + Math.imul(mixed ^ mixed >>> 7, mixed | 61);
+      value = (mixed ^ mixed >>> 14) >>> 0;
+    } while (value >= limit);
+    return value % bound;
+  };
+}
 function presentationChoices(choices, attemptId, itemIdentifier, domain) {
-  const seed = `${attemptId}\x00${itemIdentifier}\x00${domain}\x00`;
-  return [...choices].toSorted((left, right) => {
-    const hashDifference = presentationHash(`${seed}${left.identifier}`) - presentationHash(`${seed}${right.identifier}`);
-    return hashDifference || comparePresentationText(left.identifier, right.identifier);
-  });
+  const randomIndex = presentationRandomIndex(JSON.stringify([attemptId, itemIdentifier, domain]));
+  const movable = choices.filter((choice) => !choice.fixed).toSorted((left, right) => comparePresentationText(left.identifier, right.identifier));
+  for (let index = movable.length - 1;index > 0; index--) {
+    const other = randomIndex(index + 1);
+    [movable[index], movable[other]] = [movable[other], movable[index]];
+  }
+  let next = 0;
+  return choices.map((choice) => choice.fixed ? choice : movable[next++]);
 }
 function assessmentPresentationForAttempt(assessment, attemptId) {
   const items = assessment.items.map((item) => {
     const interactions = item.interactions.map((interaction) => {
-      if (interaction.type === "order" && interaction.shuffle) {
-        return {
-          ...interaction,
-          choices: presentationChoices(interaction.choices, attemptId, item.identifier, `order\x00${interaction.responseIdentifier}`)
-        };
+      if (!("shuffle" in interaction) || !interaction.shuffle) {
+        return interaction;
       }
-      if (interaction.type === "match" && interaction.shuffle) {
-        return {
-          ...interaction,
-          sourceChoices: presentationChoices(interaction.sourceChoices, attemptId, item.identifier, `match-source\x00${interaction.responseIdentifier}`),
-          targetChoices: presentationChoices(interaction.targetChoices, attemptId, item.identifier, `match-target\x00${interaction.responseIdentifier}`)
-        };
+      function shuffled(choices, domain) {
+        return presentationChoices(choices, attemptId, item.identifier, `${domain}\x00${interaction.responseIdentifier}`);
+      }
+      switch (interaction.type) {
+        case "choice":
+        case "inline-choice":
+        case "order": {
+          return {
+            ...interaction,
+            choices: shuffled(interaction.choices, interaction.type)
+          };
+        }
+        case "gap-match": {
+          return { ...interaction, gapTexts: shuffled(interaction.gapTexts, "gap-match") };
+        }
+        case "match": {
+          return {
+            ...interaction,
+            sourceChoices: shuffled(interaction.sourceChoices, "match-source"),
+            targetChoices: shuffled(interaction.targetChoices, "match-target")
+          };
+        }
       }
-      return interaction;
     });
     return { ...item, interactions };
   });
@@ -11811,6 +11841,7 @@ var init_assessment_runtime2 = __esm(() => {
   init_src();
   init_timeback3();
   init_src();
+  init_src();
   init_uuid();
   init_esm();
   init_src();
@@ -39208,7 +39239,7 @@ function assertMatchingAssessmentArtifactPair(playable, scoring, expectedIdentit
     throw new ValidationError("Assessment artifact pair does not describe one revision");
   }
 }
-var ASSESSMENT_ARTIFACT_SCHEMA_VERSION = 1, ASSESSMENT_GRADER_PROTOCOL_VERSION = 1, ARTIFACT_KEY_PREFIX = "assessment-artifacts", SHA256_HEX, textEncoder;
+var ASSESSMENT_ARTIFACT_SCHEMA_VERSION = 2, ASSESSMENT_GRADER_PROTOCOL_VERSION = 1, ARTIFACT_KEY_PREFIX = "assessment-artifacts", SHA256_HEX, textEncoder;
 var init_assessment_artifact_envelope_util = __esm(() => {
   init_errors2();
   SHA256_HEX = /^[a-f0-9]{64}$/;
@@ -94302,6 +94333,30 @@ var init_timeback_game_metrics_comparison_util = __esm(() => {
 });
 
 // ../timeback/dist/engines/qti/index.js
+function qtiAttributeNumber(attributes, name3, fallback) {
+  const raw = attributes[name3]?.trim();
+  if (!raw) {
+    return fallback;
+  }
+  const value = Number(raw);
+  return Number.isFinite(value) ? value : fallback;
+}
+function qtiAttributeCapacity(attributes, name3, fallback) {
+  const raw = attributes[name3]?.trim();
+  if (!raw) {
+    return fallback;
+  }
+  const value = Number(raw);
+  return Number.isInteger(value) && value >= 0 ? value : null;
+}
+function qtiAttributeMaximum(attributes, name3, fallback, unlimited) {
+  const maximum = qtiAttributeNumber(attributes, name3, fallback);
+  return maximum === 0 ? unlimited : maximum;
+}
+function qtiAttributeBoolean(attributes, name3) {
+  const value = attributes[name3];
+  return value === "true" || value === "1";
+}
 function decodeCssEscapes(value) {
   return value.replace(/\\([0-9a-fA-F]{1,6})\s?/g, (_, hex3) => {
     const code = Number.parseInt(hex3, 16);
@@ -94889,7 +94944,8 @@ function parseGapTexts(interaction) {
     return {
       identifier: attributes2.identifier || "",
       content: plainTextFromNodes(gapText.children),
-      matchMax: finiteNumber(attributes2["match-max"]) ?? 1
+      matchMax: finiteNumber(attributes2["match-max"]) ?? 1,
+      ...qtiAttributeBoolean(attributes2, "fixed") ? { fixed: true } : {}
     };
   }).filter((gapText) => gapText.identifier);
 }
@@ -95989,30 +96045,6 @@ ${body2}
 ${processing}` : ""}
 </qti-assessment-item>`;
 }
-function qtiAttributeNumber(attributes2, name3, fallback) {
-  const raw = attributes2[name3]?.trim();
-  if (!raw) {
-    return fallback;
-  }
-  const value = Number(raw);
-  return Number.isFinite(value) ? value : fallback;
-}
-function qtiAttributeCapacity(attributes2, name3, fallback) {
-  const raw = attributes2[name3]?.trim();
-  if (!raw) {
-    return fallback;
-  }
-  const value = Number(raw);
-  return Number.isInteger(value) && value >= 0 ? value : null;
-}
-function qtiAttributeMaximum(attributes2, name3, fallback, unlimited) {
-  const maximum = qtiAttributeNumber(attributes2, name3, fallback);
-  return maximum === 0 ? unlimited : maximum;
-}
-function qtiAttributeBoolean(attributes2, name3) {
-  const value = attributes2[name3];
-  return value === "true" || value === "1";
-}
 function gapContentIdentifiers(nodes) {
   return nodes.flatMap((node) => {
     if (node.kind === "gap") {
@@ -96093,6 +96125,7 @@ function authorableQtiInteractionProjection(interaction) {
         type: interaction.type,
         choices: interaction.choices,
         minChoices: qtiAttributeNumber(attributes2, "min-choices", 1),
+        shuffle: qtiAttributeBoolean(attributes2, "shuffle"),
         maxChoices: qtiAttributeMaximum(attributes2, "max-choices", 1, interaction.choices.length)
       };
     }
@@ -96101,6 +96134,7 @@ function authorableQtiInteractionProjection(interaction) {
         ...base,
         type: interaction.type,
         choices: interaction.choices,
+        shuffle: qtiAttributeBoolean(attributes2, "shuffle"),
         blankIndex: interaction.blankIndex ?? 0
       } : null;
     }
@@ -99932,11 +99966,13 @@ var init_assessment_artifact_runtime_util = __esm(() => {
   playableContentNodesSchema = exports_external.array(exports_external.unknown());
   playableChoiceSchema = exports_external.object({
     identifier: trimmedNonEmptyString3,
+    fixed: exports_external.boolean().optional(),
     content: exports_external.string(),
     contentNodes: playableContentNodesSchema.optional()
   }).strict();
   playableMatchChoiceSchema = exports_external.object({
     identifier: trimmedNonEmptyString3,
+    fixed: exports_external.boolean().optional(),
     content: exports_external.string(),
     contentNodes: playableContentNodesSchema.optional(),
     matchMax: nonnegativeInteger
@@ -99956,6 +99992,7 @@ var init_assessment_artifact_runtime_util = __esm(() => {
   }).strict();
   playableGapTextSchema = exports_external.object({
     identifier: trimmedNonEmptyString3,
+    fixed: exports_external.boolean().optional(),
     content: exports_external.string(),
     matchMax: nonnegativeInteger
   }).strict();
@@ -99973,6 +100010,7 @@ var init_assessment_artifact_runtime_util = __esm(() => {
     exports_external.object({
       ...playableInteractionBase,
       type: exports_external.literal("choice"),
+      shuffle: exports_external.boolean(),
       choices: exports_external.array(playableChoiceSchema),
       minChoices: nonnegativeInteger,
       maxChoices: nonnegativeInteger
@@ -99980,6 +100018,7 @@ var init_assessment_artifact_runtime_util = __esm(() => {
     exports_external.object({
       ...playableInteractionBase,
       type: exports_external.literal("inline-choice"),
+      shuffle: exports_external.boolean(),
       choices: exports_external.array(playableChoiceSchema)
     }).strict(),
     exports_external.object({
@@ -100023,6 +100062,7 @@ var init_assessment_artifact_runtime_util = __esm(() => {
     exports_external.object({
       ...playableInteractionBase,
       type: exports_external.literal("gap-match"),
+      shuffle: exports_external.boolean(),
       content: exports_external.string(),
       contentNodes: playableContentNodesSchema,
       gapTexts: exports_external.array(playableGapTextSchema),
@@ -100535,6 +100575,7 @@ function playableChoice(choice) {
   return {
     identifier: choice.identifier,
     content: choice.content,
+    ...qtiAttributeBoolean(choice.attributes, "fixed") ? { fixed: true } : {},
     ...choice.contentNodes ? { contentNodes: choice.contentNodes } : {}
   };
 }
@@ -100597,6 +100638,7 @@ function parseInteraction2(questionIdentifier, interaction) {
       responseIdentifier,
       ...prompt,
       choices,
+      shuffle: qtiAttributeBoolean(interaction.attributes, "shuffle"),
       minChoices: qtiAttributeNumber(interaction.attributes, "min-choices", 1),
       maxChoices: qtiAttributeMaximum(interaction.attributes, "max-choices", 1, choices.length)
     };
@@ -100606,7 +100648,8 @@ function parseInteraction2(questionIdentifier, interaction) {
       type,
       responseIdentifier,
       ...prompt,
-      choices: requireChoices2(interaction.choices.map(playableChoice))
+      choices: requireChoices2(interaction.choices.map(playableChoice)),
+      shuffle: qtiAttributeBoolean(interaction.attributes, "shuffle")
     };
   }
   if (type === "text-entry") {
@@ -100667,11 +100710,13 @@ function parseInteraction2(questionIdentifier, interaction) {
       responseIdentifier,
       ...prompt,
       content: interaction.textWithGaps,
+      shuffle: qtiAttributeBoolean(interaction.attributes, "shuffle"),
       contentNodes: interaction.gapContent,
       gapTexts: interaction.gapTexts.map((gapText) => ({
         identifier: gapText.identifier,
         content: gapText.content,
-        matchMax: gapText.matchMax
+        matchMax: gapText.matchMax,
+        ...gapText.fixed ? { fixed: true } : {}
       })),
       gaps: [...interaction.gaps],
       maxAssociations: qtiAttributeNumber(interaction.attributes, "max-associations", 0)
@@ -101490,7 +101535,7 @@ function buildInlineChoiceQuestionXml(input, identifier, title) {
   if (!envelope) {
     return null;
   }
-  const { structure, responseIdentifier, prompt } = envelope;
+  const { interaction, structure, responseIdentifier, prompt } = envelope;
   const promptParts = prompt.split(INLINE_CHOICE_BLANK);
   if (promptParts.length !== 2) {
     throw new ValidationError("Inline-choice questions require exactly one blank");
@@ -101504,7 +101549,7 @@ function buildInlineChoiceQuestionXml(input, identifier, title) {
   const choicesXml = choices.map((choice) => `        <qti-inline-choice identifier="${escapeXml(choice.identifier)}">${escapeXml(choice.content)}</qti-inline-choice>`).join(`
 `);
   const [before = "", after = ""] = promptParts;
-  const itemBody = `    <p>${escapeXml(before)}<qti-inline-choice-interaction response-identifier="${escapeXml(responseIdentifier)}">
+  const itemBody = `    <p>${escapeXml(before)}<qti-inline-choice-interaction response-identifier="${escapeXml(responseIdentifier)}" shuffle="${interaction.shuffle === true}">
 ${choicesXml}
       </qti-inline-choice-interaction>${escapeXml(after)}</p>`;
   return buildExactMatchQuestionXml({
@@ -102119,7 +102164,7 @@ async function prepareReviewMappingUpdate(test, questions) {
   const contentRevision = await assessmentContentRevision(test, questions);
   const assessment = {
     identifier: test.identifier,
-    contractVersion: 1,
+    contractVersion: PLAYCADEMY_ASSESSMENT_CONTRACT_VERSION,
     contentRevision,
     title: test.title,
     items: questions.questions.map(({ question }) => ({
@@ -102158,6 +102203,7 @@ async function prepareReviewMappingUpdate(test, questions) {
 var PLAYCADEMY_REVIEW_BANK_TITLE = "Review Bank", PLAYCADEMY_REVIEW_BANK_SINK_METADATA_KEY = "playcademyReviewBankSink", PLAYCADEMY_REVIEW_BANK_SINK_VERSION = 1, StoredSinkWarningSchema, ReviewBankSinkMarkerSchema;
 var init_timeback_review_mapping_util = __esm(() => {
   init_esm();
+  init_src();
   init_assessment_runtime2();
   init_qti();
   init_timeback3();

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sandbox",
-    "version": "0.10.1-beta.3",
+    "version": "0.10.1-beta.4",
     "description": "Local development server for Playcademy game development",
     "type": "module",
     "exports": {