jspsych-tangram 0.0.1 → 0.0.3

package/src/core/io/json-to-tangram-spec.ts

@@ -1,110 +0,0 @@
-// Convert raw stims JSON to clean TangramSpec[] for plugin interface
-import type { TangramSpec } from "@/core/types/plugin-interfaces";
-
-/** Raw JSON shapes from dev/assets/stims_dev.json */
-type RawTan = {
-  name: string;
-  verticesAtOrigin: Array<[number, number] | { x: number; y: number }>;
-};
-
-type RawStim = {
-  solutionTans: RawTan[];
-  stimImgPath?: string;
-  stimSilhouetteImgPath?: string;
-  set?: string;
-  id?: string | number;
-};
-
-/** Canonical tangram names we accept as actual piece polys. */
-const CANON = new Set([
-  "square",
-  "small_triangle", 
-  "parallelogram",
-  "med_triangle",
-  "large_triangle",
-]);
-
-// ----------------------- guards & converters -----------------------
-function isPoint(a: unknown): a is [number, number] {
-  return Array.isArray(a) && a.length >= 2
-    && typeof a[0] === "number" && typeof a[1] === "number";
-}
-
-function isPointObj(a: unknown): a is { x: number; y: number } {
-  return !!a && typeof a === "object"
-    && "x" in (a as any) && "y" in (a as any)
-    && typeof (a as any).x === "number" && typeof (a as any).y === "number";
-}
-
-function toNumberPair(p: [number, number] | { x: number; y: number }): [number, number] {
-  // Keep in math coords (+y up) - conversion to SVG coords happens in plugin wrapper
-  if (isPoint(p)) return [p[0], p[1]];
-  const obj = p as any;
-  return [obj.x, obj.y];
-}
-
-function polygonToNumbers(vertices: Array<[number, number] | { x: number; y: number }>): number[][] {
-  const out: number[][] = [];
-  for (const v of vertices) {
-    if (isPoint(v) || isPointObj(v)) {
-      out.push(toNumberPair(v));
-    }
-  }
-  return out;
-}
-
-// ----------------------- main converter -----------------------
-/**
- * Convert raw stims JSON to TangramSpec[] for clean plugin interface.
- * This replaces the old normalizeStims() function with proper separation of concerns.
- */
-export function rawStimsToTangramSpecs(
-  src: unknown,
-  sectorIds: string[],
-  defaultRequired = 2
-): TangramSpec[] {
-  const rawList: RawStim[] = Array.isArray(src)
-    ? (src as RawStim[])
-    : (src && typeof src === "object" && Array.isArray((src as any).stims))
-    ? ((src as any).stims as RawStim[])
-    : [];
-
-  const tangrams: TangramSpec[] = [];
-
-  for (let i = 0; i < Math.min(sectorIds.length, rawList.length); i++) {
-    const raw = rawList[i];
-    if (!raw) continue;
-
-    // Extract only canonical piece shapes; ignore macros
-    const mask: number[][][] = [];
-    for (const tan of raw.solutionTans ?? []) {
-      if (!tan || !CANON.has(tan.name)) continue;
-      if (Array.isArray(tan.verticesAtOrigin) && tan.verticesAtOrigin.length >= 3) {
-        mask.push(polygonToNumbers(tan.verticesAtOrigin));
-      }
-    }
-
-    const id = sectorIds[i] ?? String(i);
-    tangrams.push({
-      id,
-      silhouette: {
-        mask,
-        requiredCount: defaultRequired,
-      },
-    });
-  }
-
-  return tangrams;
-}
-
-/** Fetch + convert helper for dev path (e.g., "/dev/assets/stims_dev.json"). */
-export async function loadTangramSpecsFromUrl(
-  url: string,
-  sectorIds: string[],
-  defaultRequired = 2
-): Promise<TangramSpec[]> {
-  const res = await fetch(url);
-  if (!res.ok) throw new Error(`Failed to load stims: ${res.status} ${res.statusText}`);
-  const json = await res.json();
-  return rawStimsToTangramSpecs(json, sectorIds, defaultRequired);
-}