@pie-element/graphing 10.1.0-next.2 → 10.1.1-next.0

package/dist/author/utils.js

@@ -0,0 +1,260 @@
+import e from "../node_modules/.bun/lodash-es@4.18.1/node_modules/lodash-es/isEqual.js";
+//#region src/author/utils.ts
+var t = [
+	.01,
+	.02,
+	.04,
+	.05,
+	.0625,
+	.1,
+	.125,
+	.2,
+	.25,
+	.5,
+	1,
+	2,
+	3,
+	4,
+	5,
+	8,
+	10,
+	12,
+	15,
+	20,
+	40,
+	50,
+	64,
+	100,
+	500,
+	1e3
+], n = [
+	.01,
+	.02,
+	.05,
+	.1,
+	.2,
+	.25,
+	.5,
+	1,
+	2,
+	5,
+	10,
+	20,
+	50,
+	100,
+	500,
+	1e3
+], r = {
+	.01: [
+		0,
+		.01,
+		.02,
+		.04,
+		.05,
+		.1
+	],
+	.02: [
+		0,
+		.02,
+		.04,
+		.1
+	],
+	.04: [
+		0,
+		.04,
+		.08,
+		.16,
+		.2
+	],
+	.05: [
+		0,
+		.05,
+		.1,
+		.2,
+		.25
+	],
+	.0625: [
+		0,
+		.0625,
+		.125,
+		.25,
+		.5
+	],
+	.1: [
+		0,
+		.1,
+		.2,
+		.4,
+		.5,
+		1
+	],
+	.125: [
+		0,
+		.125,
+		.25,
+		.5,
+		1
+	],
+	.2: [
+		0,
+		.2,
+		.5,
+		.1
+	],
+	.25: [
+		0,
+		.25,
+		.5,
+		1,
+		2
+	],
+	.5: [
+		0,
+		.5,
+		1,
+		2
+	],
+	1: [
+		0,
+		1,
+		2,
+		4,
+		5,
+		10
+	],
+	2: [
+		0,
+		2,
+		4,
+		8,
+		10
+	],
+	3: [
+		0,
+		3,
+		6,
+		12,
+		15
+	],
+	4: [
+		0,
+		4,
+		8,
+		16,
+		20
+	],
+	5: [
+		0,
+		5,
+		10,
+		20,
+		25
+	],
+	8: [
+		0,
+		8,
+		16,
+		32,
+		40,
+		64
+	],
+	10: [
+		0,
+		10,
+		20,
+		40,
+		50,
+		100
+	],
+	12: [
+		0,
+		12,
+		24
+	],
+	15: [
+		0,
+		15,
+		30,
+		60
+	],
+	20: [
+		0,
+		20,
+		40,
+		80,
+		100
+	],
+	40: [
+		0,
+		40,
+		80,
+		160,
+		200
+	],
+	50: [
+		0,
+		50,
+		100,
+		200,
+		250
+	],
+	64: [
+		0,
+		64,
+		128
+	],
+	100: [
+		0,
+		100,
+		200,
+		400,
+		500
+	],
+	500: [
+		0,
+		500,
+		1e3,
+		2500
+	],
+	1e3: [
+		0,
+		1e3,
+		2e3,
+		4e3,
+		5e3
+	]
+}, i = (e, r, i = !1) => {
+	let a = 10 * (e.max - e.min) / r, o = a * 10, s = i && !n.includes(e.step) && t.includes(e.step);
+	return (!i || s ? t : n).filter((e) => e >= a && e <= o);
+}, a = (e) => r[e] || [], o = (t, n, r, o) => {
+	let s = i(t, n), c = a(t.step);
+	if (!e(r, s) && !s.includes(t.step)) {
+		let e = i(t, n, !0)[0] || 1;
+		return t.step = e, c = a(e), c.includes(t.labelStep) || (t.labelStep = e), {
+			gridValues: s,
+			labelValues: c
+		};
+	}
+	return !e(o, c) && !c.includes(t.labelStep) && (t.labelStep = t.step), {
+		gridValues: s,
+		labelValues: c
+	};
+}, s = (e) => {
+	let t = [], n = 0;
+	for (; n >= e.min && t.indexOf(n) < 0;) t.push(n), n = Math.round((n - e.step) * 1e4) / 1e4;
+	for (n = Math.round(e.step * 1e4) / 1e4; n <= e.max && t.indexOf(n) < 0;) t.push(n), n = Math.round((n + e.step) * 1e4) / 1e4;
+	return t ? t.filter((t) => t >= e.min && t <= e.max) : [];
+}, c = (e, t, n) => {
+	let r = s(e), i = s(t), a = (e, t) => r.includes(e) && i.includes(t);
+	return Object.entries(n || {}).reduce((e, [t, n]) => (e[t] = {
+		...n,
+		marks: (n.marks || []).filter((e) => {
+			if (e.type === "point") return a(e.x, e.y);
+			if (e.type === "polygon") return !e.points.find((e) => !a(e.x, e.y));
+			let t = e.from || e.root, n = e.to || e.edge;
+			return e.building ? a(t.x, t.y) : a(t.x, t.y) && a(n.x, n.y);
+		})
+	}, e), {});
+};
+//#endregion
+export { o as applyConstraints, c as filterPlotableMarks, i as getGridValues, a as getLabelValues };

package/dist/controller/defaults.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @synced-from pie-elements/packages/graphing/controller/src/defaults.js
+ * @auto-generated
+ *
+ * This file is automatically synced from pie-elements and converted to TypeScript.
+ * Manual edits will be overwritten on next sync.
+ * To make changes, edit the upstream JavaScript file and run sync again.
+ */
+declare const _default: {
+    answers: {
+        correctAnswer: {
+            name: string;
+            marks: never[];
+        };
+    };
+    arrows: {
+        left: boolean;
+        right: boolean;
+        up: boolean;
+        down: boolean;
+    };
+    backgroundMarks: never[];
+    coordinatesOnHover: boolean;
+    defaultGridConfiguration: number;
+    domain: {
+        min: number;
+        max: number;
+        step: number;
+        labelStep: number;
+        axisLabel: string;
+    };
+    graph: {
+        width: number;
+        height: number;
+    };
+    includeAxes: boolean;
+    labels: {};
+    labelsEnabled: boolean;
+    padding: boolean;
+    prompt: string;
+    promptEnabled: boolean;
+    range: {
+        min: number;
+        max: number;
+        step: number;
+        labelStep: number;
+        axisLabel: string;
+    };
+    rationale: string;
+    rationaleEnabled: boolean;
+    standardGrid: boolean;
+    studentInstructionsEnabled: boolean;
+    teacherInstructions: string;
+    teacherInstructionsEnabled: boolean;
+    title: string;
+    titleEnabled: boolean;
+    toolbarTools: string[];
+};
+export default _default;

package/dist/controller/defaults.js

@@ -0,0 +1,61 @@
+var e = {
+	answers: { correctAnswer: {
+		name: "Correct Answer",
+		marks: []
+	} },
+	arrows: {
+		left: !0,
+		right: !0,
+		up: !0,
+		down: !0
+	},
+	backgroundMarks: [],
+	coordinatesOnHover: !1,
+	defaultGridConfiguration: 0,
+	domain: {
+		min: -5,
+		max: 5,
+		step: 1,
+		labelStep: 1,
+		axisLabel: "x"
+	},
+	graph: {
+		width: 500,
+		height: 500
+	},
+	includeAxes: !0,
+	labels: {},
+	labelsEnabled: !0,
+	padding: !0,
+	prompt: "",
+	promptEnabled: !0,
+	range: {
+		min: -5,
+		max: 5,
+		step: 1,
+		labelStep: 1,
+		axisLabel: "y"
+	},
+	rationale: "",
+	rationaleEnabled: !0,
+	standardGrid: !1,
+	studentInstructionsEnabled: !0,
+	teacherInstructions: "",
+	teacherInstructionsEnabled: !0,
+	title: "",
+	titleEnabled: !0,
+	toolbarTools: [
+		"circle",
+		"line",
+		"label",
+		"parabola",
+		"point",
+		"polygon",
+		"ray",
+		"segment",
+		"sine",
+		"vector"
+	]
+};
+//#endregion
+export { e as default };

package/dist/controller/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @synced-from pie-elements/packages/graphing/controller/src/index.js
+ * @auto-generated
+ *
+ * This file is automatically synced from pie-elements and converted to TypeScript.
+ * Manual edits will be overwritten on next sync.
+ * To make changes, edit the upstream JavaScript file and run sync again.
+ */
+export declare const compareMarks: (mark1: any, mark2: any) => boolean;
+export declare const comparLabelMarks: (mark1: any, mark2: any) => "correct" | "incorrect";
+export declare const getAnswerCorrected: ({ sessionAnswers, marks: correctAnswers, withPointLabel }: {
+    sessionAnswers: any;
+    marks: any;
+    withPointLabel?: boolean | undefined;
+}) => any[];
+export declare const getBestAnswer: (question: any, session: any, env?: {}) => {
+    bestScore: number;
+    bestScoreAnswerKey: null;
+    answersCorrected: any;
+    foundOneSolution: boolean;
+};
+export declare const normalize: (question: any) => any;
+export declare function model(question: any, session: any, env: any): Promise<unknown>;
+/**
+* Generates detailed trace log for scoring evaluation
+* @param {Object} model - the question model
+* @param {Object} session - the student session
+* @param {Object} env - the environment
+* @returns {Array} traceLog - array of trace messages
+*/
+export declare const getLogTrace: (question: any, session: any, env: any) => string[];
+export declare function outcome(question: any, session: any, env?: {}): Promise<unknown>;
+export declare const createCorrectResponseSession: (question: any, env: any) => Promise<unknown>;
+export declare const validate: (model?: {}, config?: {}) => {};

package/dist/controller/index.js

@@ -0,0 +1,181 @@
+import e from "../node_modules/.bun/lodash-es@4.18.1/node_modules/lodash-es/cloneDeep.js";
+import t from "../node_modules/.bun/lodash-es@4.18.1/node_modules/lodash-es/isEmpty.js";
+import n from "../node_modules/.bun/lodash-es@4.18.1/node_modules/lodash-es/uniqWith.js";
+import r from "./defaults.js";
+import { equalMarks as i, equalPointWithLabel as a, sortedAnswers as o } from "./utils.js";
+import s from "debug";
+import { partialScoring as c } from "@pie-element/shared-controller-utils";
+//#region src/controller/index.ts
+var l = s("@pie-element:graphing:controller"), u = () => ({
+	point: [],
+	segment: [],
+	line: [],
+	ray: [],
+	vector: [],
+	polygon: [],
+	circle: [],
+	sine: [],
+	parabola: [],
+	absolute: [],
+	exponential: []
+}), d = {
+	incorrect: 0,
+	correct: 1,
+	missing: 2
+}, f = (e, t) => !!(e && t && e.type === t.type && i[e.type] && i[e.type](e, t)), p = (e, t) => e.label === t.label ? "correct" : "incorrect", m = ({ sessionAnswers: t, marks: n, withPointLabel: r = !1 }) => {
+	t ||= [], n ||= [];
+	let i = e(t).reduce((e, t) => {
+		let i = n.find((e) => f(t, e));
+		return t.correctness = (i && t.type === "point" && r ? a(t, i) : i) ? "correct" : "incorrect", i && (t.correctnesslabel = p(t, i), t.correctlabel = i.label ? i.label : "", t.label = t.label ? t.label : ""), [...e, t];
+	}, []), o = e(n).reduce((e, n) => t.find((e) => f(n, e)) ? e : [...e, {
+		...n,
+		correctness: "missing"
+	}], []);
+	return [...i, ...o];
+}, h = ({ scoringType: e, env: t }) => {
+	let n = e;
+	return e && (n = e === "partial scoring"), c.enabled({ partialScoring: n }, t);
+}, g = (r, i, a = {}) => {
+	let { answers: s = {}, scoringType: c } = r || {}, { answer: l } = i || {};
+	Object.entries(s || {}).forEach(([e, t]) => s[e] = {
+		...t,
+		marks: t?.marks.filter((e) => !e.building)
+	}), l ||= [], l = l.filter((e) => !e.building), s = t(s) ? { correctAnswer: u() } : {
+		correctAnswer: s.correctAnswer,
+		...o(s)
+	};
+	let d = h({
+		scoringType: c,
+		env: a
+	}), p = n(l, f);
+	return Object.entries(s).reduce((e, t) => {
+		let n = t[0], { marks: r } = t[1] || {};
+		if (!r || !r.length) return e;
+		let i = m({
+			sessionAnswers: p,
+			marks: r
+		}), a = m({
+			sessionAnswers: p,
+			marks: r,
+			withPointLabel: !0
+		}), o = a.filter((e) => e.correctness === "correct"), s = a.filter((e) => e.correctness !== "missing"), c = r.length, l = o.length;
+		return s.length > c && (l -= s.length - c), l < 0 && (l = 0), (l / c > e.bestScore || !e.foundOneSolution) && (d ? e.bestScore = parseFloat((l / c).toFixed(2)) : e.bestScore = Math.floor(l / c), e.bestScoreAnswerKey = n, e.answersCorrected = i, e.foundOneSolution = !0), e;
+	}, {
+		bestScore: 0,
+		bestScoreAnswerKey: null,
+		answersCorrected: e(p).map((e) => ({
+			...e,
+			correctness: "incorrect"
+		})),
+		foundOneSolution: !1
+	});
+}, _ = (e) => ({
+	...r,
+	...e
+});
+function v(e, n, r) {
+	return new Promise((i) => {
+		let a = _(e);
+		n ??= {};
+		let { defaultTool: o, extraCSSRules: s, prompt: c, promptEnabled: u, graph: f, answers: p, toolbarTools: m, ...h } = a || {}, { arrows: v } = a, { mode: y, role: b } = r || {};
+		typeof v == "boolean" && (v = v ? {
+			left: !0,
+			right: !0,
+			up: !0,
+			down: !0
+		} : {
+			left: !1,
+			right: !1,
+			up: !1,
+			down: !1
+		});
+		let x = (m || []).filter((e) => e !== "label"), S = o || x.length && x[0] || "", C = {
+			...h,
+			answers: p,
+			arrows: v,
+			defaultTool: S,
+			disabled: r.mode !== "gather",
+			prompt: u ? c : null,
+			rationale: null,
+			size: f,
+			showKeyLegend: r.mode === "evaluate",
+			showToggle: r.mode === "evaluate" && !t(p) && p.correctAnswer && p.correctAnswer.marks && !t(p.correctAnswer.marks),
+			teacherInstructions: null,
+			toolbarTools: m,
+			extraCSSRules: s
+		};
+		if (b === "instructor" && (y === "view" || y === "evaluate")) {
+			let { rationale: e, rationaleEnabled: t, teacherInstructions: n, teacherInstructionsEnabled: r } = a || {};
+			C.rationale = t ? e : null, C.teacherInstructions = r ? n : null;
+		}
+		if (y === "evaluate") if (!t(p) && p.correctAnswer && p.correctAnswer.marks && !t(p.correctAnswer.marks)) {
+			let { answersCorrected: e, bestScoreAnswerKey: t, bestScore: i } = g(a, n, r);
+			C.answersCorrected = e.sort((e, t) => d[e.correctness] - d[t.correctness]), C.correctResponse = t ? (p[t] || {}).marks : [], C.showToggle = C.showToggle && i !== 1;
+		} else C.answersCorrected = n && n.answer || [], C.correctResponse = [];
+		l("base: ", C), i(C);
+	});
+}
+var y = (e, t, n) => {
+	let r = [], { answers: i = {}, scoringType: a } = e || {}, o = t && t.answer || [];
+	if (!o.length) return ["Student did not interact with the graph."];
+	r.push(`Student added ${o.length} object(s) to the graph.`);
+	let s = h({
+		scoringType: a,
+		env: n
+	}), { answersCorrected: c, bestScore: l, bestScoreAnswerKey: u } = g(e, t, n), d = u && i[u] && i[u].marks || [], f = 0, p = 0, m = 0;
+	for (let e = 0; e < c.length; e++) {
+		let t = c[e].correctness;
+		t === "correct" ? f++ : t === "incorrect" ? p++ : t === "missing" && m++;
+	}
+	if (f > 0 && r.push(`Correct objects: ${f}.`), p > 0 && r.push(`Incorrect objects: ${p}.`), m > 0 && r.push(`Missing required objects: ${m}.`), c.forEach((e, t) => {
+		let n = e.type || "graph object", i = e.label ? `'${e.label}'` : "", a = `with index ${t + 1}`;
+		e.correctness === "correct" && r.push(`${n.charAt(0).toUpperCase() + n.slice(1)} ${i || a} is correct.`), e.correctness === "incorrect" && r.push(`${n.charAt(0).toUpperCase() + n.slice(1)} ${i || a} does not match the expected ${n}.`), e.correctness === "missing" && r.push(`Expected ${n} ${i || a} was not plotted by the student.`);
+	}), o.length > d.length) {
+		let e = o.length - d.length;
+		r.push(`${e} extra object(s) were plotted and are penalized in scoring.`);
+	}
+	return s ? r.push("Score calculated using partial scoring.") : r.push("Score calculated using all-or-nothing scoring."), r.push(`Final score: ${l}.`), r;
+};
+function b(e, n, r = {}) {
+	return new Promise((i) => {
+		(!n || t(n)) && i({
+			score: 0,
+			empty: !0,
+			logTrace: ["Student did not interact with the graph."]
+		}), (r.mode !== "evaluate" || t(e.answers) || e.answers && e.answers.correctAnswer && t(e.answers.correctAnswer.marks)) && i({
+			score: 0,
+			empty: !0,
+			logTrace: ["Student did not interact with the graph."]
+		});
+		let { bestScore: a } = g(e, n, r);
+		i({
+			score: a,
+			empty: !1,
+			logTrace: y(e, n, r)
+		});
+	});
+}
+var x = (e, t) => new Promise((n) => {
+	if (t.mode !== "evaluate" && t.role === "instructor") {
+		let { answers: t } = e || {}, r = [];
+		t && Object.values(t) && (r = (t.correctAnswer || Object.values(t)[0] || {}).marks || []), n({
+			answer: r,
+			id: "1"
+		});
+	} else n(null);
+}), S = (e) => (e || "").replace(/(<(?!img|iframe|source)([^>]+)>)/gi, ""), C = (e = {}, n = {}) => {
+	let { answers: r, toolbarTools: i } = e, a = {}, o = {};
+	return (i || []).filter((e) => e !== "label").length || (a.toolbarToolsError = "There should be at least 1 tool defined."), [
+		"teacherInstructions",
+		"prompt",
+		"rationale"
+	].forEach((t) => {
+		n[t]?.required && !S(e[t]) && (a[t] = "This field is required.");
+	}), Object.entries(r || {}).forEach(([e, t]) => {
+		t.marks.length || (o[e] = "At least 1 graph object should be defined."), t.marks.length > 0 && t.marks.forEach((t) => {
+			t.building && (o[e] = "At least 1 graph object is not correctly defined.");
+		});
+	}), t(o) || (a.correctAnswerErrors = o), a;
+};
+//#endregion
+export { p as comparLabelMarks, f as compareMarks, x as createCorrectResponseSession, m as getAnswerCorrected, g as getBestAnswer, y as getLogTrace, v as model, _ as normalize, b as outcome, C as validate };

package/dist/controller/utils.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @synced-from pie-elements/packages/graphing/controller/src/utils.js
+ * @auto-generated
+ *
+ * This file is automatically synced from pie-elements and converted to TypeScript.
+ * Manual edits will be overwritten on next sync.
+ * To make changes, edit the upstream JavaScript file and run sync again.
+ */
+export declare const equalPoint: (A: any, B: any) => any;
+export declare const equalPointWithLabel: (A: any, B: any) => any;
+export declare const equalSegment: (segment1: any, segment2: any) => any;
+export declare const equalVector: (vector1: any, vector2: any) => any;
+export declare const sortedAnswers: (answers: any) => {};
+export declare const equalLine: (line1: any, line2: any) => boolean;
+export declare const equalRay: (ray1: any, ray2: any) => boolean;
+export declare const constructSegmentsFromPoints: (points: any) => any;
+export declare const removeDuplicateSegments: (segments: any) => any;
+export declare const removeInvalidSegments: (segments: any) => any;
+export declare const equalPolygon: (poly1: any, poly2: any) => boolean;
+export declare const equalCircle: (c1: any, c2: any) => any;
+export declare const equalSine: (sine1: any, sine2: any) => boolean;
+export declare const equalParabola: (p1: any, p2: any) => boolean;
+export declare const equalAbsolute: (p1: any, p2: any) => any;
+export declare const equalExponential: (p1: any, p2: any) => any;
+export declare const equalMarks: {
+    circle: (sessAnswer: any, mark: any) => any;
+    line: (sessAnswer: any, mark: any) => boolean;
+    parabola: (sessAnswer: any, mark: any) => boolean;
+    absolute: (sessAnswer: any, mark: any) => any;
+    exponential: (sessAnswer: any, mark: any) => any;
+    point: (sessAnswer: any, mark: any) => any;
+    polygon: (sessAnswer: any, poly: any) => boolean;
+    ray: (sessAnswer: any, mark: any) => boolean;
+    segment: (sessAnswer: any, mark: any) => any;
+    sine: (sessAnswer: any, mark: any) => boolean;
+    vector: (sessAnswer: any, mark: any) => any;
+};