@pie-element/graphing-solution-set 7.0.4-next.20261011174919 → 7.0.4

package/dist/schemas/session.schema.json

@@ -0,0 +1,126 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cdn.jsdelivr.net/npm/@pie-element/graphing-solution-set@7.0.4/dist/schemas/session.schema.json",
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "description": "Identifier of the session"
+    },
+    "element": {
+      "type": "string",
+      "description": "The element the session belongs to"
+    },
+    "answer": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/Mark"
+      },
+      "description": "The lines the student drew and the section picked as the solution set"
+    }
+  },
+  "description": "A student response",
+  "definitions": {
+    "Mark": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "$ref": "#/definitions/MarkType",
+          "description": "Indicates type of mark"
+        },
+        "building": {
+          "type": "boolean",
+          "description": "Indicates if mark is in build process"
+        },
+        "from": {
+          "$ref": "#/definitions/MarkPoint",
+          "description": "Indicates where the line starts if type is line"
+        },
+        "to": {
+          "$ref": "#/definitions/MarkPoint",
+          "description": "Indicates where the line ends if type is line"
+        },
+        "fill": {
+          "$ref": "#/definitions/LineType",
+          "description": "Line type of a line mark, copied from the line's `gssLineData` setting"
+        },
+        "points": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/MarkPoint"
+          },
+          "description": "Indicates all mark's points if type is polygon"
+        },
+        "closed": {
+          "type": "boolean",
+          "description": "Indicates if mark is closed if type is polygon"
+        },
+        "isSolution": {
+          "type": "boolean",
+          "description": "Indicates if a polygon mark is the selected solution set"
+        },
+        "middle": {
+          "$ref": "#/definitions/MarkPoint",
+          "description": "Labelled midpoint of a line or polygon mark"
+        },
+        "x": {
+          "type": "number",
+          "description": "Not read by this element or `@pie-lib/graphing-solution-set`."
+        },
+        "y": {
+          "type": "number",
+          "description": "Not read by this element or `@pie-lib/graphing-solution-set`."
+        },
+        "label": {
+          "type": "string",
+          "description": "Not read by this element or `@pie-lib/graphing-solution-set`."
+        },
+        "showLabel": {
+          "type": "boolean",
+          "description": "Not read by this element or `@pie-lib/graphing-solution-set`."
+        }
+      },
+      "required": [
+        "type"
+      ]
+    },
+    "MarkType": {
+      "type": "string",
+      "enum": [
+        "line",
+        "polygon"
+      ],
+      "description": "Kind of mark: one of the item's lines, or a section of the graph picked as the solution set."
+    },
+    "MarkPoint": {
+      "type": "object",
+      "properties": {
+        "x": {
+          "type": "number",
+          "description": "Indicates x coordinate"
+        },
+        "y": {
+          "type": "number",
+          "description": "Indicates y coordinate"
+        },
+        "label": {
+          "type": "string",
+          "description": "Label shown next to the point"
+        }
+      },
+      "required": [
+        "x",
+        "y"
+      ],
+      "description": "A point of a mark, optionally labelled."
+    },
+    "LineType": {
+      "type": "string",
+      "enum": [
+        "Solid",
+        "Dashed"
+      ],
+      "description": "How a line is drawn: solid for an inclusive inequality, dashed for a strict one."
+    }
+  }
+}

package/dist/types.d.ts

@@ -0,0 +1,349 @@
+import type { ConfigureLanguageOptions, ConfigureMathMLProp, ConfigureMaxImageDimensionsProp, ConfigureProp, ConfigurePropWithEnabled, ContentDimensions, ExtraCSSRules, PieModel } from '@pie-element/shared-types';
+/** Kind of mark: one of the item's lines, or a section of the graph picked as the solution set. */
+export type MarkType = 'line' | 'polygon';
+/** How a line is drawn: solid for an inclusive inequality, dashed for a strict one. */
+export type LineType = 'Solid' | 'Dashed';
+export interface Point {
+    /** Indicates x coordinate */
+    x: number;
+    /** Indicates y coordinate */
+    y: number;
+}
+/** A point of a mark, optionally labelled. */
+export interface MarkPoint extends Point {
+    /** Label shown next to the point */
+    label?: string;
+}
+export interface Mark {
+    /** Indicates type of mark */
+    type: MarkType;
+    /** Indicates if mark is in build process */
+    building?: boolean;
+    /** Indicates where the line starts if type is line */
+    from?: MarkPoint;
+    /** Indicates where the line ends if type is line */
+    to?: MarkPoint;
+    /** Line type of a line mark, copied from the line's `gssLineData` setting */
+    fill?: LineType;
+    /** Indicates all mark's points if type is polygon */
+    points?: MarkPoint[];
+    /** Indicates if mark is closed if type is polygon */
+    closed?: boolean;
+    /** Indicates if a polygon mark is the selected solution set */
+    isSolution?: boolean;
+    /** Labelled midpoint of a line or polygon mark */
+    middle?: MarkPoint;
+    /** Not read by this element or `@pie-lib/graphing-solution-set`. */
+    x?: number;
+    /** Not read by this element or `@pie-lib/graphing-solution-set`. */
+    y?: number;
+    /** Not read by this element or `@pie-lib/graphing-solution-set`. */
+    label?: string;
+    /** Not read by this element or `@pie-lib/graphing-solution-set`. */
+    showLabel?: boolean;
+}
+export interface Answer {
+    /** Indicates name of answer */
+    name: string;
+    /** Indicates marks for the answer */
+    marks: Mark[];
+}
+/** The correct answer, plus alternates keyed `alternate<N>`, e.g. `alternate1`; scoring reads alternates too. */
+export interface GraphingSolutionSetAnswers {
+    /** The correct answer */
+    correctAnswer: Answer;
+    [alternate: string]: Answer;
+}
+export interface Arrows {
+    /** Indicates if left arrow is enabled */
+    left: boolean;
+    /** Indicates if right arrow is enabled */
+    right: boolean;
+    /** Indicates if up arrow is enabled */
+    up: boolean;
+    /** Indicates if down arrow is enabled */
+    down: boolean;
+}
+export interface GraphSettings {
+    /** Min value */
+    min: number;
+    /** Max value */
+    max: number;
+    /** Padding value */
+    padding?: number;
+    /** Step value */
+    step: number;
+    /** Label step value */
+    labelStep: number;
+    /** Axis Label */
+    axisLabel: string;
+}
+export interface Graph {
+    /** Width for graph representation */
+    width: number;
+    /** Height for graph representation */
+    height: number;
+}
+export interface Labels {
+    /** Label for top side of the graph */
+    top?: string;
+    /** Label for bottom side of the graph */
+    bottom?: string;
+    /** Label for left side of the graph */
+    left?: string;
+    /** Label for right side of the graph */
+    right?: string;
+}
+export interface LineTypeSetting {
+    /** Indicates line type */
+    lineType: LineType;
+}
+/** The item's lines and the sections they divide the graph into. */
+export interface GssLineData {
+    /** Indicates number of lines for GSS item: 1 or 2 */
+    numberOfLines: number;
+    /** Indicates selected tool default is lineA */
+    selectedTool: 'lineA' | 'lineB' | 'solutionSet';
+    /** Indicates array of polygons, each a list of points, formed by intersection of lines drawn */
+    sections?: Point[][];
+    /** Settings for the first line */
+    lineA: LineTypeSetting;
+    /** Settings for the second line; present when there are 2 lines */
+    lineB?: LineTypeSetting;
+}
+/** Model for the Graphing Solution Set Interaction */
+export interface GraphingSolutionSetModel extends PieModel {
+    /** Indicates marks that are set as answers */
+    answers: GraphingSolutionSetAnswers;
+    /** Indicates if arrows are enabled; a boolean sets all four arrows (older models) */
+    arrows?: Arrows | boolean;
+    /**
+     * Indicates if coordinates of a point are displayed on hover
+     * @default false
+     */
+    coordinatesOnHover?: boolean;
+    /**
+     * Indicates the default grid configuration: an index into the configuration's `gridConfigurations`
+     * @default 0
+     * @minimum 0
+     */
+    defaultGridConfiguration?: number;
+    /** Indicates if the graph dimensions are displayed */
+    dimensionsEnabled?: boolean;
+    /** Indicates domain settings for the graph */
+    domain?: GraphSettings;
+    /** Host-supplied CSS scoped to the element */
+    extraCSSRules?: ExtraCSSRules;
+    /** Indicates the graph line model */
+    graph?: Graph;
+    /** Indicates the item's lines and the sections they form */
+    gssLineData?: GssLineData;
+    /**
+     * Indicates if the graph axes and labels are enabled
+     * @default true
+     */
+    includeAxes?: boolean;
+    /** Not read: the author copies it from the selected grid configuration. */
+    label?: string;
+    /** Indicates labels */
+    labels?: Labels;
+    /**
+     * Indicates if the graph labels are displayed
+     * @default true
+     */
+    labelsEnabled?: boolean;
+    /**
+     * Indicates the language of the component
+     * Supported options: en, es, en_US, en-US, es_ES, es-ES, es_MX, es-MX
+     */
+    language?: string;
+    /** Not read by this element; the defaults carry it. */
+    marks?: Mark[];
+    /** Not read by this element; the author's padding toggle writes it. */
+    padding?: boolean;
+    /** Indicates prompt value */
+    prompt?: string;
+    /**
+     * Indicates if the prompt is enabled
+     * @default true
+     */
+    promptEnabled?: boolean;
+    /** Indicates range settings for the graph */
+    range?: GraphSettings;
+    /** Indicates rationale for the answer */
+    rationale?: string;
+    /**
+     * Indicates if Rationale are enabled
+     * @default true
+     */
+    rationaleEnabled?: boolean;
+    /** Indicates if Rubric is enabled */
+    rubricEnabled?: boolean;
+    /** Indicates scoring type */
+    scoringType?: 'dichotomous' | 'partial scoring';
+    /** Indicates if spellcheck is enabled for the author. Default value is true */
+    spellCheckEnabled?: boolean;
+    /**
+     * Indicates if some domain values will be synched to the range values
+     * @default false
+     */
+    standardGrid?: boolean;
+    /** Not read by this element. */
+    studentInstructions?: string;
+    /**
+     * Indicates if Student Instructions are enabled
+     * @default true
+     */
+    studentInstructionsEnabled?: boolean;
+    /** Indicates teacher instructions */
+    teacherInstructions?: string;
+    /**
+     * Indicates if Teacher Instructions are enabled
+     * @default true
+     */
+    teacherInstructionsEnabled?: boolean;
+    /** Indicates graph title */
+    title?: string;
+    /** Indicates if the graph title is displayed */
+    titleEnabled?: boolean;
+}
+/** A student response */
+export interface GraphingSolutionSetSession {
+    /** Identifier of the session */
+    id?: string;
+    /** The element the session belongs to */
+    element?: string;
+    /** The lines the student drew and the section picked as the solution set */
+    answer?: Mark[];
+}
+export interface ArrowsConfigProp extends ConfigureProp {
+    /** Configuration for the left arrow checkbox */
+    left?: ConfigureProp;
+    /** Configuration for the right arrow checkbox */
+    right?: ConfigureProp;
+    /** Configuration for the up arrow checkbox */
+    up?: ConfigureProp;
+    /** Configuration for the down arrow checkbox */
+    down?: ConfigureProp;
+}
+export interface DimensionsConfigProp extends ConfigurePropWithEnabled {
+    /** Minimum graph dimension, in pixels */
+    min?: number;
+    /** Maximum graph dimension, in pixels */
+    max?: number;
+    /** Step between graph dimensions, in pixels */
+    step?: number;
+}
+export interface GridPanelConfigProp {
+    /** Label for the field in the Grid Setup Panel */
+    label?: string;
+    /** Indicates if the field is displayed in the Grid Setup Panel */
+    enabled?: boolean;
+}
+export interface AuthoringConfigProp extends ConfigurePropWithEnabled {
+    /** Indicates if the "Include axes and labels?" toggle is displayed in the Grid Setup Panel */
+    includeAxesEnabled?: boolean;
+    /** Indicates if the "Constrain to standard coordinate grid?" toggle is displayed in the Grid Setup Panel */
+    standardGridEnabled?: boolean;
+    /** Min value configuration */
+    min?: GridPanelConfigProp;
+    /** Max value configuration */
+    max?: GridPanelConfigProp;
+    /** Axis label configuration */
+    axisLabel?: GridPanelConfigProp;
+    /** Step value configuration */
+    step?: GridPanelConfigProp;
+    /** Label step value configuration */
+    labelStep?: GridPanelConfigProp;
+}
+/** A preset grid an author picks from; selecting it copies these values into the model. */
+export interface GridConfiguration {
+    /** Name shown in the grid configuration picker */
+    label?: string;
+    /** Arrows for the grid */
+    arrows?: Arrows;
+    /** Domain settings for the grid */
+    domain?: GraphSettings;
+    /** Graph dimensions for the grid */
+    graph?: Graph;
+    /** Indicates if the graph axes and labels are enabled */
+    includeAxes?: boolean;
+    /** Labels for the grid */
+    labels?: Labels;
+    /** Indicates if padding is enabled */
+    padding?: boolean;
+    /** Range settings for the grid */
+    range?: GraphSettings;
+    /** Indicates if domain values are synched to the range values */
+    standardGrid?: boolean;
+    /** Graph title */
+    title?: string;
+}
+export interface LabelsConfigProp extends ConfigurePropWithEnabled {
+    /** Placeholder for the top label */
+    top?: string;
+    /** Placeholder for the right label */
+    right?: string;
+    /** Placeholder for the bottom label */
+    bottom?: string;
+    /** Placeholder for the left label */
+    left?: string;
+}
+export interface TitleConfigProp extends ConfigurePropWithEnabled {
+    /** Placeholder for the graph title */
+    placeholder?: string;
+}
+export interface GraphingSolutionSetConfiguration {
+    /** Grid Setup Panel configuration */
+    authoring?: AuthoringConfigProp;
+    /** Arrows configuration */
+    arrows?: ArrowsConfigProp;
+    /** Coordinates configuration */
+    coordinatesOnHover?: ConfigureProp;
+    /** Minimum and maximum dimensions of the authoring view */
+    contentDimensions?: ContentDimensions;
+    /** Graph dimensions configuration */
+    graphDimensions?: DimensionsConfigProp;
+    /** Grid default configurations */
+    gridConfigurations?: GridConfiguration[];
+    /** Instructions shown at the top of the authoring view */
+    instruction?: ConfigureProp;
+    /** Padding configuration */
+    padding?: ConfigureProp;
+    /** Labels configuration */
+    labels?: LabelsConfigProp;
+    /** Language configuration */
+    language?: ConfigurePropWithEnabled;
+    /** Language choices configuration Only available if language is enabled */
+    languageChoices?: ConfigureLanguageOptions;
+    /** Configuration for the prompt */
+    prompt?: ConfigureProp;
+    /** Configuration for the rationale */
+    rationale?: ConfigureProp;
+    /** Indicates if the settings panel is not available */
+    settingsPanelDisabled?: boolean;
+    /** Configuration for the author's spellcheck */
+    spellCheck?: ConfigurePropWithEnabled;
+    /** Scoring Type configuration */
+    scoringType?: ConfigureProp;
+    /** Student Instructions configuration */
+    studentInstructions?: ConfigureProp;
+    /** Teacher Instructions configuration */
+    teacherInstructions?: ConfigureProp;
+    /** Graph title configuration */
+    title?: TitleConfigProp;
+    /** Maximum image width for input fields */
+    maxImageWidth?: ConfigureMaxImageDimensionsProp;
+    /** Maximum image height for input fields */
+    maxImageHeight?: ConfigureMaxImageDimensionsProp;
+    /** Rubric configuration - only relevant in environments that use pie-player-components */
+    withRubric?: ConfigureProp;
+    /** Configuration for editable-html */
+    mathMlOptions?: ConfigureMathMLProp;
+    /** Not read by this element. */
+    showPrompt?: boolean;
+    /** Not read by this element. */
+    promptLabel?: string;
+    /** Not read by this element. */
+    settingsPartialScoring?: boolean;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pie-element/graphing-solution-set",
-  "version": "7.0.4-next.20261011174919",
+  "version": "7.0.4",
   "description": "",
   "repository": {
     "type": "git",
@@ -11,21 +11,22 @@
     "@emotion/react": "^11.14.0",
     "@mui/icons-material": "^7.3.4",
     "@mui/material": "^7.3.4",
-    "@pie-lib/config-ui": "14.0.4-next.20261011174919",
-    "@pie-lib/correct-answer-toggle": "5.0.4-next.20261011174919",
-    "@pie-lib/graphing-solution-set": "5.0.4-next.20261011174919",
-    "@pie-lib/render-ui": "8.0.4-next.20261009061152",
-    "@pie-lib/translator": "5.0.2-next.20261006160832",
+    "@pie-lib/config-ui": "14.0.4",
+    "@pie-lib/correct-answer-toggle": "5.0.4",
+    "@pie-lib/graphing-solution-set": "5.0.4",
+    "@pie-lib/render-ui": "8.0.4",
+    "@pie-lib/translator": "5.0.1",
     "debug": "^4.1.1",
     "prop-types": "^15.8.1",
-    "@pie-lib/editable-html-tip-tap": "3.0.4-next.20261009061152",
-    "@pie-element/shared-lodash": "0.1.3-next.20261006160832",
-    "@pie-element/shared-configure-events": "0.1.2-next.20261002215153",
-    "@pie-element/shared-math-rendering-mathjax": "0.1.5-next.20261009061152",
-    "@pie-element/shared-player-events": "0.1.2-next.20261002215153",
+    "@pie-lib/editable-html-tip-tap": "3.0.4",
+    "@pie-element/shared-lodash": "0.1.2",
+    "@pie-element/shared-configure-events": "0.1.1",
+    "@pie-element/shared-math-rendering-mathjax": "0.1.5",
+    "@pie-element/shared-player-events": "0.1.1",
     "clsx": "^2.1.1",
     "react": "^18.2.0",
-    "react-dom": "^18.2.0"
+    "react-dom": "^18.2.0",
+    "@pie-element/shared-types": "0.2.1"
   },
   "exports": {
     ".": {
@@ -68,6 +69,9 @@
       "types": "./dist/runtime-support.d.ts",
       "default": "./dist/runtime-support.js"
     },
+    "./schemas/model.schema.json": "./dist/schemas/model.schema.json",
+    "./schemas/configuration.schema.json": "./dist/schemas/configuration.schema.json",
+    "./schemas/session.schema.json": "./dist/schemas/session.schema.json",
     "./package.json": "./package.json"
   },
   "type": "module",
@@ -81,7 +85,7 @@
   ],
   "sideEffects": false,
   "scripts": {
-    "build": "bun x vite build && bun x vite build --config ../../../tools/vite/element-browser.config.ts && bun x vite build --config ../../../tools/vite/element-browser-editor-runtime.config.ts && bun x vite build --config vite.config.iife.ts && bun x tsc --emitDeclarationOnly",
+    "build": "bun x vite build && bun x vite build --config ../../../tools/vite/element-browser.config.ts && bun x vite build --config ../../../tools/vite/element-browser-editor-runtime.config.ts && bun x vite build --config vite.config.iife.ts && bun x tsc --emitDeclarationOnly && bun ../../../tools/schemas/build.ts",
     "dev": "bun x vite",
     "demo": "bun x vite --mode demo",
     "test": "bun x vitest run"
@@ -95,7 +99,7 @@
     },
     "browserEditorRuntime": {
       "name": "@pie-element/shared-editor-runtime",
-      "version": "0.1.3-next.20261006160832",
+      "version": "0.1.2",
       "views": {
         "delivery": "editor-runtime/delivery",
         "author": "editor-runtime/author",