jspsych-tangram 0.0.5 → 0.0.6

package/dist/index.d.ts

@@ -16,6 +16,12 @@ declare const info$1: {
             default: never[];
             description: string;
         };
+        /** Array of primitive names in the order they should be displayed */
+        primitive_order: {
+            type: ParameterType;
+            default: string[];
+            description: string;
+        };
         /** Whether to place pieces in workspace or directly on silhouette */
         target: {
             type: ParameterType;
@@ -118,6 +124,12 @@ declare class TangramConstructPlugin implements JsPsychPlugin<Info$1> {
                 default: never[];
                 description: string;
             };
+            /** Array of primitive names in the order they should be displayed */
+            primitive_order: {
+                type: ParameterType;
+                default: string[];
+                description: string;
+            };
             /** Whether to place pieces in workspace or directly on silhouette */
             target: {
                 type: ParameterType;
@@ -241,6 +253,12 @@ declare const info: {
             default: never[];
             description: string;
         };
+        /** Array of primitive names in the order they should be displayed */
+        primitive_order: {
+            type: ParameterType;
+            default: string[];
+            description: string;
+        };
         /** Callback fired after each interaction (optional analytics hook) */
         onInteraction: {
             type: ParameterType;
@@ -310,6 +328,12 @@ declare class TangramPrepPlugin implements JsPsychPlugin<Info> {
                 default: never[];
                 description: string;
             };
+            /** Array of primitive names in the order they should be displayed */
+            primitive_order: {
+                type: ParameterType;
+                default: string[];
+                description: string;
+            };
             /** Callback fired after each interaction (optional analytics hook) */
             onInteraction: {
                 type: ParameterType;

package/dist/index.js

@@ -3547,6 +3547,7 @@ function startConstructionTrial(display_element, params, _jsPsych) {
     "medtriangle",
     "largetriangle"
   ]);
+  const PRIMITIVE_BLUEPRINTS_ORDERED = [...PRIMITIVE_BLUEPRINTS].sort((a, b) => params.primitiveOrder.indexOf(a.kind) - params.primitiveOrder.indexOf(b.kind));
   const sectors = params.tangrams.map((tangramSpec, index) => {
     const filteredTans = tangramSpec.solutionTans.filter((tan) => {
       const tanName = tan.name ?? tan.kind;
@@ -3573,7 +3574,7 @@ function startConstructionTrial(display_element, params, _jsPsych) {
     const firstMacro = params.quickstash_macros[0];
     if (firstMacro && "parts" in firstMacro && firstMacro.parts && firstMacro.parts[0] && "anchorOffset" in firstMacro.parts[0]) {
       const primsByKind = /* @__PURE__ */ new Map();
-      PRIMITIVE_BLUEPRINTS.forEach((p) => primsByKind.set(p.kind, p));
+      PRIMITIVE_BLUEPRINTS_ORDERED.forEach((p) => primsByKind.set(p.kind, p));
       quickstash = params.quickstash_macros.map(
         (anchorComposite) => convertAnchorCompositeToPixels(anchorComposite, primsByKind, CONFIG.layout.grid.stepPx)
         // Use current CONFIG grid step
@@ -3585,7 +3586,7 @@ function startConstructionTrial(display_element, params, _jsPsych) {
   const gameBoardProps = {
     sectors,
     quickstash,
-    primitives: PRIMITIVE_BLUEPRINTS,
+    primitives: PRIMITIVE_BLUEPRINTS_ORDERED,
     layout: params.layout,
     target: params.target,
     input: params.input,
@@ -3616,6 +3617,12 @@ const info$1 = {
       default: [],
       description: "Array of MacroSpec objects created in prep trial"
     },
+    /** Array of primitive names in the order they should be displayed */
+    primitive_order: {
+      type: ParameterType.OBJECT,
+      default: ["square", "smalltriangle", "parallelogram", "medtriangle", "largetriangle"],
+      description: "Array of primitive names in the order they should be displayed"
+    },
     /** Whether to place pieces in workspace or directly on silhouette */
     target: {
       type: ParameterType.SELECT,
@@ -3717,6 +3724,7 @@ class TangramConstructPlugin {
     const params = {
       tangrams: trial.tangrams,
       quickstash_macros: trial.quickstash_macros,
+      primitiveOrder: trial.primitive_order,
       target: trial.target,
       input: trial.input,
       layout: trial.layout,
@@ -3738,9 +3746,11 @@ function startPrepTrial(display_element, params, jsPsych) {
     layoutMode,
     requireAllSlots,
     quickstashMacros,
+    primitiveOrder,
     onInteraction,
     onTrialEnd
   } = params;
+  const PRIMITIVE_BLUEPRINTS_ORDERED = [...PRIMITIVE_BLUEPRINTS].sort((a, b) => primitiveOrder.indexOf(a.kind) - primitiveOrder.indexOf(b.kind));
   const prepSectors = Array.from({ length: numQuickstashSlots }, (_, i) => ({
     id: `prep-sector-${i}`,
     tangramId: `prep-sector-${i}`,
@@ -3754,7 +3764,7 @@ function startPrepTrial(display_element, params, jsPsych) {
   const handleControllerReady = (controller, layout, force) => {
     if (quickstashMacros && quickstashMacros.length > 0 && layout) {
       const primsByKind = /* @__PURE__ */ new Map();
-      PRIMITIVE_BLUEPRINTS.forEach((p) => primsByKind.set(p.kind, p));
+      PRIMITIVE_BLUEPRINTS_ORDERED.forEach((p) => primsByKind.set(p.kind, p));
       quickstashMacros.forEach((anchorComposite, macroIndex) => {
         const sectorId = `prep-sector-${macroIndex}`;
         const compositeBlueprint = convertAnchorCompositeToPixels(
@@ -3811,7 +3821,7 @@ function startPrepTrial(display_element, params, jsPsych) {
     sectors: prepSectors,
     quickstash: [],
     // No pre-made macros
-    primitives: PRIMITIVE_BLUEPRINTS,
+    primitives: PRIMITIVE_BLUEPRINTS_ORDERED,
     layout: layoutMode,
     target: "workspace",
     // Pieces go in sectors
@@ -3872,6 +3882,12 @@ const info = {
       default: [],
       description: "Array of AnchorComposite objects to edit as primitive pieces"
     },
+    /** Array of primitive names in the order they should be displayed */
+    primitive_order: {
+      type: ParameterType.OBJECT,
+      default: ["square", "smalltriangle", "parallelogram", "medtriangle", "largetriangle"],
+      description: "Array of primitive names in the order they should be displayed"
+    },
     /** Callback fired after each interaction (optional analytics hook) */
     onInteraction: {
       type: ParameterType.FUNCTION,
@@ -3922,6 +3938,7 @@ class TangramPrepPlugin {
       layoutMode: trial.layout,
       requireAllSlots: trial.require_all_slots,
       quickstashMacros: trial.quickstash_macros,
+      primitiveOrder: trial.primitive_order,
       onInteraction: trial.onInteraction,
       onTrialEnd: wrappedOnTrialEnd
     };