@mathscan/geometry-engine 0.1.0

package/dist/renderer/shapes/EntityLabel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityLabel.d.ts","sourceRoot":"","sources":["../../../src/renderer/shapes/EntityLabel.tsx"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAajE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,eAAe,CAAA;IAC3B,QAAQ,EAAE,YAAY,CAAA;IACtB,MAAM,EAAE,UAAU,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAqCD,wBAAgB,aAAa,CAAC,UAAU,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,GAAG,KAAK,GAAG,IAAI,CAS/F;AAED,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,MAAM,EACN,KAAiB,EACjB,OAAW,GACZ,EAAE,gBAAgB,sCAqBlB"}

package/dist/renderer/shapes/EntityShape.d.cts

@@ -0,0 +1,18 @@
+import { ReactElement } from 'react';
+import { CanvasSize } from '../../coordinates/transform.cjs';
+import { ShapeDescriptor } from '../../geometry/entityModel.cjs';
+import { MathViewport } from '../../schemas/viewport.schema.cjs';
+export interface EntityShapeProps {
+    id: string;
+    descriptor: ShapeDescriptor;
+    viewport: MathViewport;
+    canvas: CanvasSize;
+    color?: string;
+    strokeWidth?: number;
+    dashed?: boolean;
+    selected?: boolean;
+    opacity?: number;
+    listening?: boolean;
+    label?: string;
+}
+export declare function EntityShape({ descriptor, label, ...styling }: EntityShapeProps): ReactElement | null;

package/dist/renderer/shapes/EntityShape.d.ts

@@ -0,0 +1,19 @@
+import { ReactElement } from 'react';
+import { CanvasSize } from '../../coordinates/transform.js';
+import { ShapeDescriptor } from '../../geometry/entityModel.js';
+import { MathViewport } from '../../schemas/viewport.schema.js';
+export interface EntityShapeProps {
+    id: string;
+    descriptor: ShapeDescriptor;
+    viewport: MathViewport;
+    canvas: CanvasSize;
+    color?: string;
+    strokeWidth?: number;
+    dashed?: boolean;
+    selected?: boolean;
+    opacity?: number;
+    listening?: boolean;
+    label?: string;
+}
+export declare function EntityShape({ descriptor, label, ...styling }: EntityShapeProps): ReactElement | null;
+//# sourceMappingURL=EntityShape.d.ts.map

package/dist/renderer/shapes/EntityShape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityShape.d.ts","sourceRoot":"","sources":["../../../src/renderer/shapes/EntityShape.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAkBjE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,eAAe,CAAA;IAC3B,QAAQ,EAAE,YAAY,CAAA;IACtB,MAAM,EAAE,UAAU,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,OAAO,CAAA;IAKnB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AA6BD,wBAAgB,WAAW,CAAC,EAC1B,UAAU,EACV,KAAK,EACL,GAAG,OAAO,EACX,EAAE,gBAAgB,GAAG,YAAY,GAAG,IAAI,CA4BxC"}

package/dist/renderer/shapes/LineShape.d.cts

@@ -0,0 +1,16 @@
+import { CanvasSize } from '../../coordinates/transform.cjs';
+import { Point } from '../../geometry/point.cjs';
+import { MathViewport } from '../../schemas/viewport.schema.cjs';
+export interface LineShapeProps {
+    id: string;
+    through: [Point, Point];
+    viewport: MathViewport;
+    canvas: CanvasSize;
+    color?: string;
+    strokeWidth?: number;
+    dashed?: boolean;
+    selected?: boolean;
+    opacity?: number;
+    listening?: boolean;
+}
+export declare function LineShape({ id, through, viewport, canvas, color, strokeWidth, dashed, selected, opacity, listening, }: LineShapeProps): import("react").JSX.Element | null;

package/dist/renderer/shapes/LineShape.d.ts

@@ -0,0 +1,17 @@
+import { CanvasSize } from '../../coordinates/transform.js';
+import { Point } from '../../geometry/point.js';
+import { MathViewport } from '../../schemas/viewport.schema.js';
+export interface LineShapeProps {
+    id: string;
+    through: [Point, Point];
+    viewport: MathViewport;
+    canvas: CanvasSize;
+    color?: string;
+    strokeWidth?: number;
+    dashed?: boolean;
+    selected?: boolean;
+    opacity?: number;
+    listening?: boolean;
+}
+export declare function LineShape({ id, through, viewport, canvas, color, strokeWidth, dashed, selected, opacity, listening, }: LineShapeProps): import("react").JSX.Element | null;
+//# sourceMappingURL=LineShape.d.ts.map

package/dist/renderer/shapes/LineShape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LineShape.d.ts","sourceRoot":"","sources":["../../../src/renderer/shapes/LineShape.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE3E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAGjE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IACvB,QAAQ,EAAE,YAAY,CAAA;IACtB,MAAM,EAAE,UAAU,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAKD,wBAAgB,SAAS,CAAC,EACxB,EAAE,EACF,OAAO,EACP,QAAQ,EACR,MAAM,EACN,KAAiB,EACjB,WAAe,EACf,MAAc,EACd,QAAgB,EAChB,OAAW,EACX,SAAgB,GACjB,EAAE,cAAc,sCAoBhB"}

package/dist/renderer/shapes/PointShape.d.cts

@@ -0,0 +1,17 @@
+import { CanvasSize } from '../../coordinates/transform.cjs';
+import { Point, PointId } from '../../geometry/point.cjs';
+import { MathViewport } from '../../schemas/viewport.schema.cjs';
+export interface PointShapeProps {
+    id: PointId;
+    position: Point;
+    viewport: MathViewport;
+    canvas: CanvasSize;
+    selected?: boolean;
+    connectable?: boolean;
+    snapTarget?: boolean;
+    label?: string;
+    color?: string;
+    feedbackRingColor?: string;
+    feedbackRingDashed?: boolean;
+}
+export declare function PointShape({ id, position, viewport, canvas, selected, connectable, snapTarget, label, color, feedbackRingColor, feedbackRingDashed, }: PointShapeProps): import("react").JSX.Element;

package/dist/renderer/shapes/PointShape.d.ts

@@ -0,0 +1,18 @@
+import { CanvasSize } from '../../coordinates/transform.js';
+import { Point, PointId } from '../../geometry/point.js';
+import { MathViewport } from '../../schemas/viewport.schema.js';
+export interface PointShapeProps {
+    id: PointId;
+    position: Point;
+    viewport: MathViewport;
+    canvas: CanvasSize;
+    selected?: boolean;
+    connectable?: boolean;
+    snapTarget?: boolean;
+    label?: string;
+    color?: string;
+    feedbackRingColor?: string;
+    feedbackRingDashed?: boolean;
+}
+export declare function PointShape({ id, position, viewport, canvas, selected, connectable, snapTarget, label, color, feedbackRingColor, feedbackRingDashed, }: PointShapeProps): import("react").JSX.Element;
+//# sourceMappingURL=PointShape.d.ts.map

package/dist/renderer/shapes/PointShape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PointShape.d.ts","sourceRoot":"","sources":["../../../src/renderer/shapes/PointShape.tsx"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAC3E,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAGjE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAA;IACX,QAAQ,EAAE,KAAK,CAAA;IACf,QAAQ,EAAE,YAAY,CAAA;IACtB,MAAM,EAAE,UAAU,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B;AAeD,wBAAgB,UAAU,CAAC,EACzB,EAAE,EACF,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,QAAgB,EAChB,WAAmB,EACnB,UAAkB,EAClB,KAAK,EACL,KAAiB,EACjB,iBAAiB,EACjB,kBAA0B,GAC3B,EAAE,eAAe,+BAuDjB"}

package/dist/renderer/shapes/SegmentShape.d.cts

@@ -0,0 +1,17 @@
+import { CanvasSize } from '../../coordinates/transform.cjs';
+import { Point } from '../../geometry/point.cjs';
+import { MathViewport } from '../../schemas/viewport.schema.cjs';
+export interface SegmentShapeProps {
+    id: string;
+    from: Point;
+    to: Point;
+    viewport: MathViewport;
+    canvas: CanvasSize;
+    color?: string;
+    strokeWidth?: number;
+    dashed?: boolean;
+    selected?: boolean;
+    opacity?: number;
+    listening?: boolean;
+}
+export declare function SegmentShape({ id, from, to, viewport, canvas, color, strokeWidth, dashed, selected, opacity, listening, }: SegmentShapeProps): import("react").JSX.Element;

package/dist/renderer/shapes/SegmentShape.d.ts

@@ -0,0 +1,18 @@
+import { CanvasSize } from '../../coordinates/transform.js';
+import { Point } from '../../geometry/point.js';
+import { MathViewport } from '../../schemas/viewport.schema.js';
+export interface SegmentShapeProps {
+    id: string;
+    from: Point;
+    to: Point;
+    viewport: MathViewport;
+    canvas: CanvasSize;
+    color?: string;
+    strokeWidth?: number;
+    dashed?: boolean;
+    selected?: boolean;
+    opacity?: number;
+    listening?: boolean;
+}
+export declare function SegmentShape({ id, from, to, viewport, canvas, color, strokeWidth, dashed, selected, opacity, listening, }: SegmentShapeProps): import("react").JSX.Element;
+//# sourceMappingURL=SegmentShape.d.ts.map

package/dist/renderer/shapes/SegmentShape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SegmentShape.d.ts","sourceRoot":"","sources":["../../../src/renderer/shapes/SegmentShape.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAC3E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAGjE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,KAAK,CAAA;IACX,EAAE,EAAE,KAAK,CAAA;IACT,QAAQ,EAAE,YAAY,CAAA;IACtB,MAAM,EAAE,UAAU,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,wBAAgB,YAAY,CAAC,EAC3B,EAAE,EACF,IAAI,EACJ,EAAE,EACF,QAAQ,EACR,MAAM,EACN,KAAiB,EACjB,WAAe,EACf,MAAc,EACd,QAAgB,EAChB,OAAW,EACX,SAAgB,GACjB,EAAE,iBAAiB,+BAiBnB"}

package/dist/renderer/shapes/SnapMarker.d.cts

@@ -0,0 +1,8 @@
+import { CanvasSize } from '../../coordinates/transform.cjs';
+import { MathViewport } from '../../schemas/viewport.schema.cjs';
+import { SnapResult } from '../../snapping/computeSnap.cjs';
+export declare function SnapMarker({ snap, viewport, canvas, }: {
+    snap: SnapResult;
+    viewport: MathViewport;
+    canvas: CanvasSize;
+}): import("react").JSX.Element;

package/dist/renderer/shapes/SnapMarker.d.ts

@@ -0,0 +1,9 @@
+import { CanvasSize } from '../../coordinates/transform.js';
+import { MathViewport } from '../../schemas/viewport.schema.js';
+import { SnapResult } from '../../snapping/computeSnap.js';
+export declare function SnapMarker({ snap, viewport, canvas, }: {
+    snap: SnapResult;
+    viewport: MathViewport;
+    canvas: CanvasSize;
+}): import("react").JSX.Element;
+//# sourceMappingURL=SnapMarker.d.ts.map

package/dist/renderer/shapes/SnapMarker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapMarker.d.ts","sourceRoot":"","sources":["../../../src/renderer/shapes/SnapMarker.tsx"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAgB5D,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,QAAQ,EACR,MAAM,GACP,EAAE;IACD,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE,YAAY,CAAA;IACtB,MAAM,EAAE,UAAU,CAAA;CACnB,+BAyBA"}

package/dist/renderer/shapes/StrokedLine.d.cts

@@ -0,0 +1,18 @@
+export interface StrokedLineProps {
+    id: string;
+    a: {
+        x: number;
+        y: number;
+    };
+    b: {
+        x: number;
+        y: number;
+    };
+    color: string;
+    strokeWidth: number;
+    dashed: boolean;
+    selected: boolean;
+    opacity: number;
+    listening: boolean;
+}
+export declare function StrokedLine({ id, a, b, color, strokeWidth, dashed, selected, opacity, listening, }: StrokedLineProps): import("react").JSX.Element;

package/dist/renderer/shapes/StrokedLine.d.ts

@@ -0,0 +1,19 @@
+export interface StrokedLineProps {
+    id: string;
+    a: {
+        x: number;
+        y: number;
+    };
+    b: {
+        x: number;
+        y: number;
+    };
+    color: string;
+    strokeWidth: number;
+    dashed: boolean;
+    selected: boolean;
+    opacity: number;
+    listening: boolean;
+}
+export declare function StrokedLine({ id, a, b, color, strokeWidth, dashed, selected, opacity, listening, }: StrokedLineProps): import("react").JSX.Element;
+//# sourceMappingURL=StrokedLine.d.ts.map

package/dist/renderer/shapes/StrokedLine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StrokedLine.d.ts","sourceRoot":"","sources":["../../../src/renderer/shapes/StrokedLine.tsx"],"names":[],"mappings":"AAmBA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3B,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,wBAAgB,WAAW,CAAC,EAC1B,EAAE,EACF,CAAC,EACD,CAAC,EACD,KAAK,EACL,WAAW,EACX,MAAM,EACN,QAAQ,EACR,OAAO,EACP,SAAS,GACV,EAAE,gBAAgB,+BAclB"}

package/dist/renderer/studentExerciseSession.d.cts

@@ -0,0 +1,71 @@
+import { GeometryExercise } from '../schemas/exercise.schema.cjs';
+import { GeometryState } from '../schemas/geometryState.schema.cjs';
+import { Store } from '../store/createStore.cjs';
+import { ConstructionNotice, StudentGeometryChangeMeta, StudentState } from '../store/studentStore.cjs';
+import { CheckGeometryAnswerResult } from '../validation/checkGeometryAnswer.cjs';
+import { GeometryValidationFeedback } from '../validation/types.cjs';
+/** Why the component cannot mount: `source` names the prop at fault. */
+export interface StudentGeometryExerciseIssue {
+    source: 'exercise' | 'value';
+    path: Array<string | number>;
+    message: string;
+}
+export type StudentExerciseInputs = {
+    success: true;
+    exercise: GeometryExercise;
+    attempt: GeometryState;
+    exerciseFingerprint: string;
+    attemptFingerprint: string;
+} | {
+    success: false;
+    issues: StudentGeometryExerciseIssue[];
+};
+/**
+ * Both props, loaded the way Check loads them: the exercise through the
+ * solution-free grading load, so a malformed authored solution never stops a
+ * student working (ADR 0015), and the value normalized against that exercise.
+ * An absent value — `undefined` or `null` — is a fresh attempt.
+ */
+export declare function loadStudentExerciseInputs(exerciseInput: unknown, valueInput: unknown): StudentExerciseInputs;
+/**
+ * One mounted component's store, and the fingerprints of the inputs it last
+ * applied. The value fingerprint is what makes a value "arrive": only a value
+ * that differs from the last one applied is compared with the store at all, so
+ * a host that never passes one does not wipe the student's work on re-render.
+ */
+export interface StudentExerciseSession {
+    store: Store<StudentState>;
+    exercise: string;
+    value: string;
+}
+export declare function createStudentExerciseSession(inputs: Extract<StudentExerciseInputs, {
+    success: true;
+}>): StudentExerciseSession;
+/**
+ * Applies newly loaded props to the session's store. A different exercise
+ * replaces exercise and attempt together; a different value replaces the
+ * attempt, unless it is the store's own attempt handed back — an echo, which
+ * keeps history. Neither replacement records a receipt, so neither reaches
+ * `onChange`.
+ */
+export declare function syncStudentExerciseSession(session: StudentExerciseSession, inputs: Extract<StudentExerciseInputs, {
+    success: true;
+}>): void;
+export interface StudentExerciseListeners {
+    onChange(attempt: GeometryState, meta: StudentGeometryChangeMeta): void;
+    onNotice?(notice: ConstructionNotice): void;
+}
+/**
+ * One `onChange` per completed-action receipt and one `onNotice` per refused
+ * construction, read off the store's transitions rather than off renders. The
+ * store writes a new notice object for every refusal, so a repeated one is
+ * reported again. `listeners` is read on each event, so a host's callbacks may
+ * change identity freely.
+ */
+export declare function subscribeStudentExerciseEvents(store: Store<StudentState>, listeners: () => StudentExerciseListeners): () => void;
+/**
+ * The feedback a check result carries, while it still describes what is on the
+ * canvas: both fingerprints must equal the current ones. Anything else — a
+ * failed check, an edit, a reset, a replacement — shows no feedback.
+ */
+export declare function currentFeedback(result: CheckGeometryAnswerResult | null | undefined, exercise: GeometryExercise, geometry: GeometryState): GeometryValidationFeedback | null;

package/dist/renderer/studentExerciseSession.d.ts

@@ -0,0 +1,72 @@
+import { GeometryExercise } from '../schemas/exercise.schema.js';
+import { GeometryState } from '../schemas/geometryState.schema.js';
+import { Store } from '../store/createStore.js';
+import { ConstructionNotice, StudentGeometryChangeMeta, StudentState } from '../store/studentStore.js';
+import { CheckGeometryAnswerResult } from '../validation/checkGeometryAnswer.js';
+import { GeometryValidationFeedback } from '../validation/types.js';
+/** Why the component cannot mount: `source` names the prop at fault. */
+export interface StudentGeometryExerciseIssue {
+    source: 'exercise' | 'value';
+    path: Array<string | number>;
+    message: string;
+}
+export type StudentExerciseInputs = {
+    success: true;
+    exercise: GeometryExercise;
+    attempt: GeometryState;
+    exerciseFingerprint: string;
+    attemptFingerprint: string;
+} | {
+    success: false;
+    issues: StudentGeometryExerciseIssue[];
+};
+/**
+ * Both props, loaded the way Check loads them: the exercise through the
+ * solution-free grading load, so a malformed authored solution never stops a
+ * student working (ADR 0015), and the value normalized against that exercise.
+ * An absent value — `undefined` or `null` — is a fresh attempt.
+ */
+export declare function loadStudentExerciseInputs(exerciseInput: unknown, valueInput: unknown): StudentExerciseInputs;
+/**
+ * One mounted component's store, and the fingerprints of the inputs it last
+ * applied. The value fingerprint is what makes a value "arrive": only a value
+ * that differs from the last one applied is compared with the store at all, so
+ * a host that never passes one does not wipe the student's work on re-render.
+ */
+export interface StudentExerciseSession {
+    store: Store<StudentState>;
+    exercise: string;
+    value: string;
+}
+export declare function createStudentExerciseSession(inputs: Extract<StudentExerciseInputs, {
+    success: true;
+}>): StudentExerciseSession;
+/**
+ * Applies newly loaded props to the session's store. A different exercise
+ * replaces exercise and attempt together; a different value replaces the
+ * attempt, unless it is the store's own attempt handed back — an echo, which
+ * keeps history. Neither replacement records a receipt, so neither reaches
+ * `onChange`.
+ */
+export declare function syncStudentExerciseSession(session: StudentExerciseSession, inputs: Extract<StudentExerciseInputs, {
+    success: true;
+}>): void;
+export interface StudentExerciseListeners {
+    onChange(attempt: GeometryState, meta: StudentGeometryChangeMeta): void;
+    onNotice?(notice: ConstructionNotice): void;
+}
+/**
+ * One `onChange` per completed-action receipt and one `onNotice` per refused
+ * construction, read off the store's transitions rather than off renders. The
+ * store writes a new notice object for every refusal, so a repeated one is
+ * reported again. `listeners` is read on each event, so a host's callbacks may
+ * change identity freely.
+ */
+export declare function subscribeStudentExerciseEvents(store: Store<StudentState>, listeners: () => StudentExerciseListeners): () => void;
+/**
+ * The feedback a check result carries, while it still describes what is on the
+ * canvas: both fingerprints must equal the current ones. Anything else — a
+ * failed check, an edit, a reset, a replacement — shows no feedback.
+ */
+export declare function currentFeedback(result: CheckGeometryAnswerResult | null | undefined, exercise: GeometryExercise, geometry: GeometryState): GeometryValidationFeedback | null;
+//# sourceMappingURL=studentExerciseSession.d.ts.map

package/dist/renderer/studentExerciseSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studentExerciseSession.d.ts","sourceRoot":"","sources":["../../src/renderer/studentExerciseSession.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AACpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAA;AAOlF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAA;AAGrE,wEAAwE;AACxE,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,UAAU,GAAG,OAAO,CAAA;IAC5B,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAA;IAC5B,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,MAAM,qBAAqB,GAC7B;IACE,OAAO,EAAE,IAAI,CAAA;IACb,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,OAAO,EAAE,aAAa,CAAA;IACtB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,kBAAkB,EAAE,MAAM,CAAA;CAC3B,GACD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,4BAA4B,EAAE,CAAA;CAAE,CAAA;AAE9D;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,OAAO,EACtB,UAAU,EAAE,OAAO,GAClB,qBAAqB,CAyBvB;AASD;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,CAAA;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,OAAO,CAAC,qBAAqB,EAAE;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,CAAC,GACxD,sBAAsB,CAMxB;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,sBAAsB,EAC/B,MAAM,EAAE,OAAO,CAAC,qBAAqB,EAAE;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,CAAC,GACxD,IAAI,CAaN;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,yBAAyB,GAAG,IAAI,CAAA;IACvE,QAAQ,CAAC,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAA;CAC5C;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,EAC1B,SAAS,EAAE,MAAM,wBAAwB,GACxC,MAAM,IAAI,CAaZ;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,yBAAyB,GAAG,IAAI,GAAG,SAAS,EACpD,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,aAAa,GACtB,0BAA0B,GAAG,IAAI,CAInC"}

package/dist/renderer/useConnectionPreview.d.cts

@@ -0,0 +1,44 @@
+import { CanvasSize } from '../coordinates/transform.cjs';
+import { SceneEntity } from '../geometry/hitTest.cjs';
+import { Point, PointId } from '../geometry/point.cjs';
+import { ConstructionEndpoint } from '../store/constructionCommand.cjs';
+import { SnapResult } from '../snapping/computeSnap.cjs';
+import { MathViewport } from '../schemas/viewport.schema.cjs';
+import { ObjectTypeName } from '../schemas/objectTypeName.schema.cjs';
+import { ScreenPoint } from './gesturePolicy.cjs';
+interface UseConnectionPreviewArgs {
+    points: ReadonlyMap<PointId, Point>;
+    viewport: MathViewport;
+    canvas: CanvasSize;
+    pendingObjectType: ObjectTypeName | null;
+    pendingFirstPointId: PointId | null;
+    connect: (from: ConstructionEndpoint, to: ConstructionEndpoint) => void;
+    pick: (id: PointId) => void;
+    objects?: readonly SceneEntity[];
+    isSnapTarget?: (id: PointId) => boolean;
+    canCreatePoints?: boolean;
+    preserveCreatedPointOrigins?: boolean;
+}
+/**
+ * The shared "tap two points, or drag from one to another" gesture behind
+ * building a segment or a line, used identically by the teacher and student
+ * canvases so the two roles can never drift out of visual or interaction sync.
+ *
+ * It resolves endpoints and draws the preview; it does not listen to a single
+ * event. `usePointerGestures` owns the pointer lifecycle and calls in with
+ * `press`, `drag`, `release` and `cancel`, already classified against the drag
+ * threshold (RFC 0004 § Decision 4).
+ */
+export declare function useConnectionPreview({ points, viewport, canvas, pendingObjectType, pendingFirstPointId, connect, pick, objects, isSnapTarget, canCreatePoints, preserveCreatedPointOrigins, }: UseConnectionPreviewArgs): {
+    connecting: boolean;
+    previewPoints: number[] | null;
+    snapTargetId: string | null;
+    snapPreview: SnapResult | null;
+    press: (pointer: ScreenPoint, pressedPointId: PointId | null) => void;
+    drag: (pointer: ScreenPoint) => void;
+    hover: (pointer: ScreenPoint | null) => void;
+    release: (pointer: ScreenPoint, releasedOnPointId: PointId | null, dragging: boolean) => boolean;
+    cancel: () => void;
+};
+export type ConnectionPreview = ReturnType<typeof useConnectionPreview>;
+export {};

package/dist/renderer/useConnectionPreview.d.ts

@@ -0,0 +1,45 @@
+import { CanvasSize } from '../coordinates/transform.js';
+import { SceneEntity } from '../geometry/hitTest.js';
+import { Point, PointId } from '../geometry/point.js';
+import { ConstructionEndpoint } from '../store/constructionCommand.js';
+import { SnapResult } from '../snapping/computeSnap.js';
+import { MathViewport } from '../schemas/viewport.schema.js';
+import { ObjectTypeName } from '../schemas/objectTypeName.schema.js';
+import { ScreenPoint } from './gesturePolicy.js';
+interface UseConnectionPreviewArgs {
+    points: ReadonlyMap<PointId, Point>;
+    viewport: MathViewport;
+    canvas: CanvasSize;
+    pendingObjectType: ObjectTypeName | null;
+    pendingFirstPointId: PointId | null;
+    connect: (from: ConstructionEndpoint, to: ConstructionEndpoint) => void;
+    pick: (id: PointId) => void;
+    objects?: readonly SceneEntity[];
+    isSnapTarget?: (id: PointId) => boolean;
+    canCreatePoints?: boolean;
+    preserveCreatedPointOrigins?: boolean;
+}
+/**
+ * The shared "tap two points, or drag from one to another" gesture behind
+ * building a segment or a line, used identically by the teacher and student
+ * canvases so the two roles can never drift out of visual or interaction sync.
+ *
+ * It resolves endpoints and draws the preview; it does not listen to a single
+ * event. `usePointerGestures` owns the pointer lifecycle and calls in with
+ * `press`, `drag`, `release` and `cancel`, already classified against the drag
+ * threshold (RFC 0004 § Decision 4).
+ */
+export declare function useConnectionPreview({ points, viewport, canvas, pendingObjectType, pendingFirstPointId, connect, pick, objects, isSnapTarget, canCreatePoints, preserveCreatedPointOrigins, }: UseConnectionPreviewArgs): {
+    connecting: boolean;
+    previewPoints: number[] | null;
+    snapTargetId: string | null;
+    snapPreview: SnapResult | null;
+    press: (pointer: ScreenPoint, pressedPointId: PointId | null) => void;
+    drag: (pointer: ScreenPoint) => void;
+    hover: (pointer: ScreenPoint | null) => void;
+    release: (pointer: ScreenPoint, releasedOnPointId: PointId | null, dragging: boolean) => boolean;
+    cancel: () => void;
+};
+export type ConnectionPreview = ReturnType<typeof useConnectionPreview>;
+export {};
+//# sourceMappingURL=useConnectionPreview.d.ts.map

package/dist/renderer/useConnectionPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConnectionPreview.d.ts","sourceRoot":"","sources":["../../src/renderer/useConnectionPreview.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAExE,OAAO,EAA8B,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAElD,UAAU,wBAAwB;IAChC,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IACnC,QAAQ,EAAE,YAAY,CAAA;IACtB,MAAM,EAAE,UAAU,CAAA;IAClB,iBAAiB,EAAE,cAAc,GAAG,IAAI,CAAA;IACxC,mBAAmB,EAAE,OAAO,GAAG,IAAI,CAAA;IAKnC,OAAO,EAAE,CAAC,IAAI,EAAE,oBAAoB,EAAE,EAAE,EAAE,oBAAoB,KAAK,IAAI,CAAA;IAIvE,IAAI,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,CAAA;IAG3B,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;IAMhC,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,OAAO,CAAA;IAIvC,eAAe,CAAC,EAAE,OAAO,CAAA;IAKzB,2BAA2B,CAAC,EAAE,OAAO,CAAA;CACtC;AAgCD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,MAAM,EACN,QAAQ,EACR,MAAM,EACN,iBAAiB,EACjB,mBAAmB,EACnB,OAAO,EACP,IAAI,EACJ,OAAY,EACZ,YAAY,EACZ,eAAuB,EACvB,2BAAkC,GACnC,EAAE,wBAAwB;;;;;qBAyED,WAAW,kBAAkB,OAAO,GAAG,IAAI,KAAG,IAAI;oBAuDnD,WAAW,KAAG,IAAI;qBASjB,WAAW,GAAG,IAAI,KAAG,IAAI;uBAsDtC,WAAW,qBACD,OAAO,GAAG,IAAI,YACvB,OAAO,KAChB,OAAO;kBAyCS,IAAI;EAqBxB;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA"}

package/dist/renderer/usePlacementSnap.d.cts

@@ -0,0 +1,28 @@
+import { KonvaEventObject } from 'konva/lib/Node';
+import { CanvasSize } from '../coordinates/transform.cjs';
+import { SceneEntity } from '../geometry/hitTest.cjs';
+import { EntityId } from '../geometry/entityModel.cjs';
+import { Point, PointId } from '../geometry/point.cjs';
+import { MathViewport } from '../schemas/viewport.schema.cjs';
+import { SnapResult } from '../snapping/computeSnap.cjs';
+export interface SnapPlacement {
+    position: Point;
+    snap: SnapResult | null;
+}
+interface UsePlacementSnapArgs {
+    points: ReadonlyMap<PointId, Point>;
+    objects: readonly SceneEntity[];
+    viewport: MathViewport;
+    canvas: CanvasSize;
+    showGrid?: boolean;
+    isSnapTarget?: (id: EntityId) => boolean;
+    active: boolean;
+}
+export declare function usePlacementSnap({ points, objects, viewport, canvas, showGrid, isSnapTarget, active, }: UsePlacementSnapArgs): {
+    snap: SnapResult | null;
+    trackAt: (pointer: Point) => void;
+    trackPointer: (event: KonvaEventObject<MouseEvent | TouchEvent | PointerEvent>) => void;
+    clearPointer: () => void;
+    resolvePlacement: (pointer: Point) => SnapPlacement;
+};
+export {};

package/dist/renderer/usePlacementSnap.d.ts

@@ -0,0 +1,29 @@
+import { KonvaEventObject } from 'konva/lib/Node';
+import { CanvasSize } from '../coordinates/transform.js';
+import { SceneEntity } from '../geometry/hitTest.js';
+import { EntityId } from '../geometry/entityModel.js';
+import { Point, PointId } from '../geometry/point.js';
+import { MathViewport } from '../schemas/viewport.schema.js';
+import { SnapResult } from '../snapping/computeSnap.js';
+export interface SnapPlacement {
+    position: Point;
+    snap: SnapResult | null;
+}
+interface UsePlacementSnapArgs {
+    points: ReadonlyMap<PointId, Point>;
+    objects: readonly SceneEntity[];
+    viewport: MathViewport;
+    canvas: CanvasSize;
+    showGrid?: boolean;
+    isSnapTarget?: (id: EntityId) => boolean;
+    active: boolean;
+}
+export declare function usePlacementSnap({ points, objects, viewport, canvas, showGrid, isSnapTarget, active, }: UsePlacementSnapArgs): {
+    snap: SnapResult | null;
+    trackAt: (pointer: Point) => void;
+    trackPointer: (event: KonvaEventObject<MouseEvent | TouchEvent | PointerEvent>) => void;
+    clearPointer: () => void;
+    resolvePlacement: (pointer: Point) => SnapPlacement;
+};
+export {};
+//# sourceMappingURL=usePlacementSnap.d.ts.map

package/dist/renderer/usePlacementSnap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePlacementSnap.d.ts","sourceRoot":"","sources":["../../src/renderer/usePlacementSnap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAKtE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,KAAK,CAAA;IACf,IAAI,EAAE,UAAU,GAAG,IAAI,CAAA;CACxB;AAED,UAAU,oBAAoB;IAC5B,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IACnC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;IAC/B,QAAQ,EAAE,YAAY,CAAA;IACtB,MAAM,EAAE,UAAU,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAIlB,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,KAAK,OAAO,CAAA;IAGxC,MAAM,EAAE,OAAO,CAAA;CAChB;AAID,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,OAAO,EACP,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,MAAM,GACP,EAAE,oBAAoB;;uBASK,KAAK;0BASF,gBAAgB,CAAC,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC;;gCAalD,KAAK,KAAG,aAAa;EAQzD"}

package/dist/renderer/usePointerGestures.d.cts

@@ -0,0 +1,46 @@
+import { RefObject } from 'react';
+import { Stage } from 'konva/lib/Stage';
+import { CanvasSize } from '../coordinates/transform.cjs';
+import { PointId } from '../geometry/point.cjs';
+import { ObjectTypeName } from '../schemas/objectTypeName.schema.cjs';
+import { Store } from '../store/createStore.cjs';
+import { ScreenPoint } from './gesturePolicy.cjs';
+import { ConnectionPreview } from './useConnectionPreview.cjs';
+type EpochStore = Pick<Store<{
+    interactionEpoch?: number;
+}>, 'getState' | 'subscribe'>;
+export interface PointerGestureHandlers {
+    tool: ObjectTypeName | null;
+    connection: ConnectionPreview;
+    placement: {
+        trackAt(pointer: ScreenPoint): void;
+        clearPointer(): void;
+    };
+    pointOnScreen(id: PointId): ScreenPoint | null;
+    canDragPoint(id: PointId): boolean;
+    dragPoint(id: PointId, to: ScreenPoint): void;
+    endPointDrag(id: PointId): void;
+    tapPoint(id: PointId): void;
+    tapObject(id: string): void;
+    tapStage(pointer: ScreenPoint): void;
+    abandonConstruction(): void;
+    disarmTool(): void;
+}
+/**
+ * The one pointer lifecycle behind both canvases (RFC 0004 § Decision 4,
+ * ADR 0011).
+ *
+ * Native Pointer Events on the stage's container, one contact at a time,
+ * identified by `pointerId` and captured while it is down. A contact is a tap
+ * until it moves its pointer type's threshold and a drag from then on, and it
+ * becomes geometry only through a normal release on the canvas — no Konva
+ * click, tap or drag handler, and no compatibility mouse event, can build or
+ * select anything on its own, so one contact is at most one creation.
+ *
+ * Every other ending is a cancellation, and every cancellation clears the
+ * preview, the snap marker, the pending endpoint and the contact, and closes a
+ * point drag's undo step where it stands: a dragged point keeps the last
+ * position it was moved to, and one Undo takes it back.
+ */
+export declare function usePointerGestures(stageRef: RefObject<Stage | null>, canvas: CanvasSize, store: EpochStore, handlers: PointerGestureHandlers): void;
+export {};