jspsych-tangram 0.0.3 → 0.0.5

package/src/core/io/stims.ts

@@ -1,107 +0,0 @@
-// core/io/stims.ts
-import type { Poly, Sector, Vec } from "@/core/domain/types";
-
-/** 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 toVec(p: [number, number] | { x: number; y: number }): Vec {
-  // JSON vertices are authored in math coords (+y up). Convert to SVG (+y down).
-  if (isPoint(p)) return { x: p[0], y: -p[1] };
-  const obj = p as any;
-  return { x: obj.x, y: -obj.y };
-}
-
-// NOTE: We flip Y above so silhouettes render right-side-up in SVG.
-function polyFromVertices(vertices: Array<[number, number] | { x: number; y: number }>): Poly {
-  // defensively map every element that looks like a point
-  const out: Vec[] = [];
-  for (const v of vertices) {
-    if (isPoint(v) || isPointObj(v)) out.push(toVec(v));
-  }
-  return out;
-}
-
-// ----------------------- normalization -----------------------
-/**
- * Accepts either an array of raw stims or an object with { stims: [...] }.
- * Returns Sectors with silhouette.mask = array of polys (one per tan).
- */
-export function normalizeStims(
-  src: unknown,
-  fallbackSectorIds: string[]
-): Sector[] {
-  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 sectors: Sector[] = [];
-
-  for (let i = 0; i < Math.min(fallbackSectorIds.length, rawList.length); i++) {
-    const raw = rawList[i];
-    if (!raw) continue;
-
-    // take only canonical piece shapes; ignore macros
-    const polys: Poly[] = [];
-    for (const tan of raw.solutionTans ?? []) {
-      if (!tan || !CANON.has(tan.name)) continue;
-      if (Array.isArray(tan.verticesAtOrigin) && tan.verticesAtOrigin.length >= 3) {
-        polys.push(polyFromVertices(tan.verticesAtOrigin));
-      }
-    }
-
-    const id = fallbackSectorIds[i] ?? String(i);
-    sectors.push({
-      id,
-      silhouette: {
-        id,
-        mask: polys,
-      },
-    });
-  }
-
-  return sectors;
-}
-
-/** Fetch + normalize helper for dev path (e.g., "/dev/assets/stims_dev.json"). */
-export async function loadStimSectorsFromUrl(
-  url: string,
-  sectorIds: string[]
-): Promise<Sector[]> {
-  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 normalizeStims(json, sectorIds);
-}