@mathscan/geometry-engine 0.1.0

package/dist/renderer/GeometryGrid.d.ts

@@ -0,0 +1,8 @@
+import { CanvasSize } from '../coordinates/transform.js';
+import { MathViewport } from '../schemas/viewport.schema.js';
+export declare function GeometryGrid({ viewport, canvas, visible, }: {
+    viewport: MathViewport;
+    canvas: CanvasSize;
+    visible: boolean;
+}): import("react").JSX.Element;
+//# sourceMappingURL=GeometryGrid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GeometryGrid.d.ts","sourceRoot":"","sources":["../../src/renderer/GeometryGrid.tsx"],"names":[],"mappings":"AACA,OAAO,EAAkC,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAE1F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,MAAM,EACN,OAAO,GACR,EAAE;IACD,QAAQ,EAAE,YAAY,CAAA;IACtB,MAAM,EAAE,UAAU,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;CACjB,+BAuDA"}

package/dist/renderer/GeometryInstruments.d.cts

@@ -0,0 +1,7 @@
+import { ToolName } from '../schemas/exercise.schema.cjs';
+import { CanvasSize } from '../coordinates/transform.cjs';
+export interface GeometryInstrumentsProps {
+    tools: ToolName[];
+    canvas: CanvasSize;
+}
+export declare function GeometryInstruments({ tools, canvas }: GeometryInstrumentsProps): import("react").JSX.Element;

package/dist/renderer/GeometryInstruments.d.ts

@@ -0,0 +1,8 @@
+import { ToolName } from '../schemas/exercise.schema.js';
+import { CanvasSize } from '../coordinates/transform.js';
+export interface GeometryInstrumentsProps {
+    tools: ToolName[];
+    canvas: CanvasSize;
+}
+export declare function GeometryInstruments({ tools, canvas }: GeometryInstrumentsProps): import("react").JSX.Element;
+//# sourceMappingURL=GeometryInstruments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GeometryInstruments.d.ts","sourceRoot":"","sources":["../../src/renderer/GeometryInstruments.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAS1D,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,MAAM,EAAE,UAAU,CAAA;CACnB;AAqJD,wBAAgB,mBAAmB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,wBAAwB,+BA0L9E"}

package/dist/renderer/StudentGeometryCanvas.d.cts

@@ -0,0 +1,11 @@
+import { CanvasSize } from '../coordinates/transform.cjs';
+import { Store } from '../store/createStore.cjs';
+import { GeometryValidationFeedback } from '../validation/types.cjs';
+import { StudentState } from '../store/studentStore.cjs';
+export interface StudentGeometryCanvasProps {
+    store: Store<StudentState>;
+    size: CanvasSize;
+    validationFeedback?: GeometryValidationFeedback | null;
+    focusedGoalId?: string | null;
+}
+export declare function StudentGeometryCanvas({ store, size, validationFeedback, focusedGoalId, }: StudentGeometryCanvasProps): import("react").JSX.Element;

package/dist/renderer/StudentGeometryCanvas.d.ts

@@ -0,0 +1,12 @@
+import { CanvasSize } from '../coordinates/transform.js';
+import { Store } from '../store/createStore.js';
+import { GeometryValidationFeedback } from '../validation/types.js';
+import { StudentState } from '../store/studentStore.js';
+export interface StudentGeometryCanvasProps {
+    store: Store<StudentState>;
+    size: CanvasSize;
+    validationFeedback?: GeometryValidationFeedback | null;
+    focusedGoalId?: string | null;
+}
+export declare function StudentGeometryCanvas({ store, size, validationFeedback, focusedGoalId, }: StudentGeometryCanvasProps): import("react").JSX.Element;
+//# sourceMappingURL=StudentGeometryCanvas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StudentGeometryCanvas.d.ts","sourceRoot":"","sources":["../../src/renderer/StudentGeometryCanvas.tsx"],"names":[],"mappings":"AAGA,OAAO,EAA8B,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACtF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAEjD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAA;AACrE,OAAO,EAYL,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAA;AAiB9B,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,CAAA;IAC1B,IAAI,EAAE,UAAU,CAAA;IAChB,kBAAkB,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAA;IACtD,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAiBD,wBAAgB,qBAAqB,CAAC,EACpC,KAAK,EACL,IAAI,EACJ,kBAAyB,EACzB,aAAoB,GACrB,EAAE,0BAA0B,+BAyM5B"}

package/dist/renderer/StudentGeometryExercise.d.cts

@@ -0,0 +1,36 @@
+import { GeometryState } from '../schemas/geometryState.schema.cjs';
+import { ConstructionNotice, StudentGeometryChangeMeta } from '../store/studentStore.cjs';
+import { CheckGeometryAnswerResult } from '../validation/checkGeometryAnswer.cjs';
+import { StudentGeometryExerciseIssue } from './studentExerciseSession.cjs';
+export type { StudentGeometryExerciseIssue } from './studentExerciseSession.cjs';
+/** Which built-in controls are shown. Each defaults to `true`; hiding one changes no permission. */
+export interface StudentGeometryControls {
+    toolbar?: boolean;
+    history?: boolean;
+    delete?: boolean;
+    reset?: boolean;
+}
+export interface StudentGeometryExerciseProps {
+    exercise: unknown;
+    value?: unknown;
+    onChange(attempt: GeometryState, meta: StudentGeometryChangeMeta): void;
+    readOnly?: boolean;
+    validationFeedback?: CheckGeometryAnswerResult | null;
+    focusedGoalId?: string | null;
+    controls?: StudentGeometryControls;
+    className?: string;
+    onNotice?(notice: ConstructionNotice): void;
+    onError?(issues: StudentGeometryExerciseIssue[]): void;
+}
+/**
+ * A complete, mobile-first student exercise for a host application (RFC 0005,
+ * ADR 0014): tools, history, delete, reset, the construction notice, a canvas
+ * that measures its own container and the semantic companion. The host keeps
+ * Check, Reveal, persistence and result wording.
+ *
+ * Controlled: `exercise` and `value` are untrusted and parsed on the way in,
+ * every completed student action reaches `onChange` once, and a different
+ * value or exercise replaces the attempt or the whole session on the same
+ * store without echoing. Every mount owns its store.
+ */
+export declare function StudentGeometryExercise(props: StudentGeometryExerciseProps): import("react").JSX.Element | null;

package/dist/renderer/StudentGeometryExercise.d.ts

@@ -0,0 +1,37 @@
+import { GeometryState } from '../schemas/geometryState.schema.js';
+import { ConstructionNotice, StudentGeometryChangeMeta } from '../store/studentStore.js';
+import { CheckGeometryAnswerResult } from '../validation/checkGeometryAnswer.js';
+import { StudentGeometryExerciseIssue } from './studentExerciseSession.js';
+export type { StudentGeometryExerciseIssue } from './studentExerciseSession.js';
+/** Which built-in controls are shown. Each defaults to `true`; hiding one changes no permission. */
+export interface StudentGeometryControls {
+    toolbar?: boolean;
+    history?: boolean;
+    delete?: boolean;
+    reset?: boolean;
+}
+export interface StudentGeometryExerciseProps {
+    exercise: unknown;
+    value?: unknown;
+    onChange(attempt: GeometryState, meta: StudentGeometryChangeMeta): void;
+    readOnly?: boolean;
+    validationFeedback?: CheckGeometryAnswerResult | null;
+    focusedGoalId?: string | null;
+    controls?: StudentGeometryControls;
+    className?: string;
+    onNotice?(notice: ConstructionNotice): void;
+    onError?(issues: StudentGeometryExerciseIssue[]): void;
+}
+/**
+ * A complete, mobile-first student exercise for a host application (RFC 0005,
+ * ADR 0014): tools, history, delete, reset, the construction notice, a canvas
+ * that measures its own container and the semantic companion. The host keeps
+ * Check, Reveal, persistence and result wording.
+ *
+ * Controlled: `exercise` and `value` are untrusted and parsed on the way in,
+ * every completed student action reaches `onChange` once, and a different
+ * value or exercise replaces the attempt or the whole session on the same
+ * store without echoing. Every mount owns its store.
+ */
+export declare function StudentGeometryExercise(props: StudentGeometryExerciseProps): import("react").JSX.Element | null;
+//# sourceMappingURL=StudentGeometryExercise.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StudentGeometryExercise.d.ts","sourceRoot":"","sources":["../../src/renderer/StudentGeometryExercise.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AAEpE,OAAO,EAOL,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAE/B,MAAM,uBAAuB,CAAA;AAE9B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAA;AAIlF,OAAO,EAOL,KAAK,4BAA4B,EAClC,MAAM,0BAA0B,CAAA;AAGjC,YAAY,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAA;AAE5E,oGAAoG;AACpG,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,QAAQ,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,yBAAyB,GAAG,IAAI,CAAA;IACvE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,kBAAkB,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAA;IACrD,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,QAAQ,CAAC,EAAE,uBAAuB,CAAA;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAA;IAC3C,OAAO,CAAC,CAAC,MAAM,EAAE,4BAA4B,EAAE,GAAG,IAAI,CAAA;CACvD;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,sCAiE1E"}

package/dist/renderer/Toolbar.d.cts

@@ -0,0 +1,7 @@
+import { ObjectTypeName } from '../schemas/objectTypeName.schema.cjs';
+export interface ToolbarProps {
+    selected: ObjectTypeName | null;
+    onSelect: (type: ObjectTypeName | null) => void;
+    available?: ObjectTypeName[];
+}
+export declare function Toolbar({ selected, onSelect, available }: ToolbarProps): import("react").JSX.Element;

package/dist/renderer/Toolbar.d.ts

@@ -0,0 +1,8 @@
+import { ObjectTypeName } from '../schemas/objectTypeName.schema.js';
+export interface ToolbarProps {
+    selected: ObjectTypeName | null;
+    onSelect: (type: ObjectTypeName | null) => void;
+    available?: ObjectTypeName[];
+}
+export declare function Toolbar({ selected, onSelect, available }: ToolbarProps): import("react").JSX.Element;
+//# sourceMappingURL=Toolbar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Toolbar.d.ts","sourceRoot":"","sources":["../../src/renderer/Toolbar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AAEtE,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAA;IAC/B,QAAQ,EAAE,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,KAAK,IAAI,CAAA;IAC/C,SAAS,CAAC,EAAE,cAAc,EAAE,CAAA;CAC7B;AAgBD,wBAAgB,OAAO,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAwB,EAAE,EAAE,YAAY,+BAgBrF"}

package/dist/renderer/deriveRenderableGeometry.d.cts

@@ -0,0 +1,15 @@
+import { EntityCapabilities, EntityId } from '../geometry/entityModel.cjs';
+import { SceneEntity } from '../geometry/hitTest.cjs';
+import { Point, PointId } from '../geometry/point.cjs';
+import { GeometryExercise } from '../schemas/exercise.schema.cjs';
+import { GeometryState } from '../schemas/geometryState.schema.cjs';
+import { TeacherEditorState } from '../store/teacherStore.cjs';
+export interface RenderableGeometry {
+    points: ReadonlyMap<PointId, Point>;
+    objects: SceneEntity[];
+    capabilitiesOf: (id: EntityId) => Readonly<EntityCapabilities>;
+    labelOf: (id: EntityId) => string | undefined;
+    isSnapTarget: (id: EntityId) => boolean;
+}
+export declare function deriveRenderableGeometry(state: TeacherEditorState): RenderableGeometry;
+export declare function deriveStudentRenderableGeometry(exercise: GeometryExercise, geometry: GeometryState): RenderableGeometry;

package/dist/renderer/deriveRenderableGeometry.d.ts

@@ -0,0 +1,16 @@
+import { EntityCapabilities, EntityId } from '../geometry/entityModel.js';
+import { SceneEntity } from '../geometry/hitTest.js';
+import { Point, PointId } from '../geometry/point.js';
+import { GeometryExercise } from '../schemas/exercise.schema.js';
+import { GeometryState } from '../schemas/geometryState.schema.js';
+import { TeacherEditorState } from '../store/teacherStore.js';
+export interface RenderableGeometry {
+    points: ReadonlyMap<PointId, Point>;
+    objects: SceneEntity[];
+    capabilitiesOf: (id: EntityId) => Readonly<EntityCapabilities>;
+    labelOf: (id: EntityId) => string | undefined;
+    isSnapTarget: (id: EntityId) => boolean;
+}
+export declare function deriveRenderableGeometry(state: TeacherEditorState): RenderableGeometry;
+export declare function deriveStudentRenderableGeometry(exercise: GeometryExercise, geometry: GeometryState): RenderableGeometry;
+//# sourceMappingURL=deriveRenderableGeometry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deriveRenderableGeometry.d.ts","sourceRoot":"","sources":["../../src/renderer/deriveRenderableGeometry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAmB,MAAM,yBAAyB,CAAA;AAC5F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AAGpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAqB/D,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IACnC,OAAO,EAAE,WAAW,EAAE,CAAA;IAGtB,cAAc,EAAE,CAAC,EAAE,EAAE,QAAQ,KAAK,QAAQ,CAAC,kBAAkB,CAAC,CAAA;IAQ9D,OAAO,EAAE,CAAC,EAAE,EAAE,QAAQ,KAAK,MAAM,GAAG,SAAS,CAAA;IAK7C,YAAY,EAAE,CAAC,EAAE,EAAE,QAAQ,KAAK,OAAO,CAAA;CACxC;AAID,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,kBAAkB,GAAG,kBAAkB,CAsBtF;AAUD,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,aAAa,GACtB,kBAAkB,CAKpB"}

package/dist/renderer/deriveSemanticScene.d.cts

@@ -0,0 +1,58 @@
+import { EntityId, EntityKind } from '../geometry/entityModel.cjs';
+import { StudentState } from '../store/studentStore.cjs';
+import { TeacherEditorState } from '../store/teacherStore.cjs';
+import { GeometryValidationFeedback, GoalStatus } from '../validation/types.cjs';
+import { EntityOwner } from './entityDisplayName.cjs';
+export interface SemanticEntity {
+    readonly id: EntityId;
+    readonly kind: EntityKind;
+    readonly owner: EntityOwner;
+    readonly name: string;
+    readonly description: string;
+    readonly placed: boolean;
+    readonly selected: boolean;
+    readonly selectable: boolean;
+    readonly status: GoalStatus | null;
+    readonly text: string;
+}
+export interface SemanticScene {
+    readonly toolLine: string;
+    readonly pendingLine: string;
+    readonly answerLine: string | null;
+    readonly entities: readonly SemanticEntity[];
+    readonly selectedId: EntityId | null;
+}
+/**
+ * The student's figure: the exercise's givens and their own work, with the
+ * last check's verdict where it applies.
+ *
+ * `validationFeedback` and `focusedGoalId` are the canvas's own two props, and
+ * the per-entity verdict is derived through the same
+ * `deriveGeometryCanvasFeedback()` the canvas colours with — one goal's
+ * feedback, so the companion and the canvas can never disagree about which
+ * entities a check touched.
+ */
+export declare function deriveStudentSemanticScene(state: StudentState, validationFeedback?: GeometryValidationFeedback | null, focusedGoalId?: string | null): SemanticScene;
+/**
+ * The exercise being authored. Every entity belongs to the exercise, so every
+ * drawn one is selectable and none carries a verdict.
+ *
+ * Walked in declaration order rather than in resolution order, for the reason
+ * `deriveRenderableGeometry()` walks it that way: an author reordering the
+ * entity record expects both the figure and its description to follow.
+ */
+export declare function deriveTeacherSemanticScene(state: TeacherEditorState): SemanticScene;
+/**
+ * What changed between two scenes, as one sentence to put in a live region —
+ * `null` when nothing worth interrupting a construction for did.
+ *
+ * A pure function of the two scenes rather than a subscription, so what gets
+ * announced is assertable without a browser, and so a component can compute it
+ * from the scene it already holds.
+ *
+ * Deliberately silent about selection: the selected row carries
+ * `aria-pressed`, and it has focus, so announcing it would say the same thing
+ * twice. Also silent about drags — one message per pointer event is noise, and
+ * a drag ends in a construction that is announced.
+ */
+export declare function announceSceneChange(previous: SemanticScene | null, next: SemanticScene): string | null;

package/dist/renderer/deriveSemanticScene.d.ts

@@ -0,0 +1,59 @@
+import { EntityId, EntityKind } from '../geometry/entityModel.js';
+import { StudentState } from '../store/studentStore.js';
+import { TeacherEditorState } from '../store/teacherStore.js';
+import { GeometryValidationFeedback, GoalStatus } from '../validation/types.js';
+import { EntityOwner } from './entityDisplayName.js';
+export interface SemanticEntity {
+    readonly id: EntityId;
+    readonly kind: EntityKind;
+    readonly owner: EntityOwner;
+    readonly name: string;
+    readonly description: string;
+    readonly placed: boolean;
+    readonly selected: boolean;
+    readonly selectable: boolean;
+    readonly status: GoalStatus | null;
+    readonly text: string;
+}
+export interface SemanticScene {
+    readonly toolLine: string;
+    readonly pendingLine: string;
+    readonly answerLine: string | null;
+    readonly entities: readonly SemanticEntity[];
+    readonly selectedId: EntityId | null;
+}
+/**
+ * The student's figure: the exercise's givens and their own work, with the
+ * last check's verdict where it applies.
+ *
+ * `validationFeedback` and `focusedGoalId` are the canvas's own two props, and
+ * the per-entity verdict is derived through the same
+ * `deriveGeometryCanvasFeedback()` the canvas colours with — one goal's
+ * feedback, so the companion and the canvas can never disagree about which
+ * entities a check touched.
+ */
+export declare function deriveStudentSemanticScene(state: StudentState, validationFeedback?: GeometryValidationFeedback | null, focusedGoalId?: string | null): SemanticScene;
+/**
+ * The exercise being authored. Every entity belongs to the exercise, so every
+ * drawn one is selectable and none carries a verdict.
+ *
+ * Walked in declaration order rather than in resolution order, for the reason
+ * `deriveRenderableGeometry()` walks it that way: an author reordering the
+ * entity record expects both the figure and its description to follow.
+ */
+export declare function deriveTeacherSemanticScene(state: TeacherEditorState): SemanticScene;
+/**
+ * What changed between two scenes, as one sentence to put in a live region —
+ * `null` when nothing worth interrupting a construction for did.
+ *
+ * A pure function of the two scenes rather than a subscription, so what gets
+ * announced is assertable without a browser, and so a component can compute it
+ * from the scene it already holds.
+ *
+ * Deliberately silent about selection: the selected row carries
+ * `aria-pressed`, and it has focus, so announcing it would say the same thing
+ * twice. Also silent about drags — one message per pointer event is noise, and
+ * a drag ends in a construction that is announced.
+ */
+export declare function announceSceneChange(previous: SemanticScene | null, next: SemanticScene): string | null;
+//# sourceMappingURL=deriveSemanticScene.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deriveSemanticScene.d.ts","sourceRoot":"","sources":["../../src/renderer/deriveSemanticScene.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAKnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAE/D,OAAO,KAAK,EAAE,0BAA0B,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACjF,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEzE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAG3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAK5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAG1B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAG5B,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAA;IAGlC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAI5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAG5B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAA;IAC5C,QAAQ,CAAC,UAAU,EAAE,QAAQ,GAAG,IAAI,CAAA;CACrC;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,YAAY,EACnB,kBAAkB,GAAE,0BAA0B,GAAG,IAAW,EAC5D,aAAa,GAAE,MAAM,GAAG,IAAW,GAClC,aAAa,CAwBf;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAkBnF;AAoGD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,aAAa,GAAG,IAAI,EAC9B,IAAI,EAAE,aAAa,GAClB,MAAM,GAAG,IAAI,CAwBf"}

package/dist/renderer/entityDisplayName.d.cts

@@ -0,0 +1,12 @@
+import { EntityId } from '../geometry/entityModel.cjs';
+/** Which document declared an entity — the half of naming an id cannot answer. */
+export type EntityOwner = 'given' | 'student';
+/**
+ * The name both surfaces use for `id`.
+ *
+ * `owner` decides whether the id is prettified, because only the student store
+ * promises the `student-<kind>-<n>` shape. An exercise may author an entity
+ * whose id happens to look like one, and rewriting a teacher's chosen id would
+ * be the canvas relabelling the exercise.
+ */
+export declare function entityDisplayName(id: EntityId, label: string | undefined, owner: EntityOwner): string;

package/dist/renderer/entityDisplayName.d.ts

@@ -0,0 +1,13 @@
+import { EntityId } from '../geometry/entityModel.js';
+/** Which document declared an entity — the half of naming an id cannot answer. */
+export type EntityOwner = 'given' | 'student';
+/**
+ * The name both surfaces use for `id`.
+ *
+ * `owner` decides whether the id is prettified, because only the student store
+ * promises the `student-<kind>-<n>` shape. An exercise may author an entity
+ * whose id happens to look like one, and rewriting a teacher's chosen id would
+ * be the canvas relabelling the exercise.
+ */
+export declare function entityDisplayName(id: EntityId, label: string | undefined, owner: EntityOwner): string;
+//# sourceMappingURL=entityDisplayName.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entityDisplayName.d.ts","sourceRoot":"","sources":["../../src/renderer/entityDisplayName.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAEvD,kFAAkF;AAClF,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,CAAA;AAI7C;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,WAAW,UAS5F"}

package/dist/renderer/gesturePolicy.d.cts

@@ -0,0 +1,97 @@
+import { CanvasSize } from '../coordinates/transform.cjs';
+/**
+ * A position within the canvas, in the stage's own pixels from its top-left
+ * corner — the frame Konva draws and hit-tests in, and the one `screenToMath`
+ * converts from.
+ */
+export interface ScreenPoint {
+    x: number;
+    y: number;
+}
+/**
+ * A pointer's viewport position, in the stage's own pixels. The stage may be
+ * displayed at another size than it is laid out at — a CSS transform on a host
+ * element, `zoom` on the page — so the offset into its displayed box is divided
+ * by the ratio between the two, which is exactly the conversion Konva applies to
+ * its own events. Without it, a stage displayed at half size would take every
+ * press at twice its distance from the corner.
+ */
+export declare function toStagePoint(client: {
+    x: number;
+    y: number;
+}, displayed: {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}, laidOut: {
+    width: number;
+    height: number;
+}): ScreenPoint;
+export declare const MOUSE_DRAG_THRESHOLD_PX = 4;
+export declare const TOUCH_DRAG_THRESHOLD_PX = 8;
+/**
+ * The displacement at which a contact of this pointer type becomes a drag. An
+ * unknown or empty `pointerType` is treated as a mouse: the tighter threshold
+ * can only turn a sloppy tap into a harmless drag, never the other way round.
+ */
+export declare function dragThresholdPx(pointerType: string): number;
+/**
+ * One pointer's contact with the canvas, from press to release.
+ *
+ * Measured in the viewport's CSS pixels — where the hand actually moved — and
+ * not in the stage's: a stage displayed at half size must not make a finger
+ * drag after 4 px of travel. `maxDisplacement` is the furthest the pointer has
+ * been from where it went down, not where it is now: a finger that wanders out
+ * and back has still dragged, and releasing where it started must not turn it
+ * back into a tap.
+ */
+export interface PointerContact {
+    pointerId: number;
+    pointerType: string;
+    origin: ScreenPoint;
+    maxDisplacement: number;
+    dragging: boolean;
+}
+export declare function beginContact(pointerId: number, pointerType: string, origin: ScreenPoint): PointerContact;
+/** The contact after the pointer reached `at`. At the threshold it is a drag. */
+export declare function advanceContact(contact: PointerContact, at: ScreenPoint): PointerContact;
+/**
+ * Whether a press may open a contact at all. Only a primary pointer does — a
+ * second finger is a cancellation, never a gesture of its own — and a mouse
+ * only with its main button, so a right-click or a middle-click builds nothing.
+ */
+export declare function opensContact(press: {
+    isPrimary: boolean;
+    pointerType: string;
+    button: number;
+}): boolean;
+/**
+ * The stage container's style on both canvases. Every contact on the stage is
+ * the lifecycle's: a browser that pans, zooms or selects text under a finger
+ * that is drawing takes the pointer with `pointercancel`, and the gesture is
+ * lost to scrolling the page.
+ */
+export declare const GESTURE_SURFACE_STYLE: {
+    readonly touchAction: "none";
+    readonly userSelect: "none";
+    readonly WebkitUserSelect: "none";
+};
+/** Whether a release landed on the canvas. Anywhere else cancels the gesture. */
+export declare function isWithinCanvas(point: ScreenPoint, canvas: CanvasSize): boolean;
+/**
+ * Why a gesture ended without completing. Every one of them clears the
+ * preview, the snap, the pending endpoint and the contact; only `escape` also
+ * disarms the tool.
+ */
+export type GestureCancelReason = 'pointercancel' | 'second-pointer' | 'lost-capture' | 'outside-release' | 'blur' | 'hidden' | 'escape' | 'invalidated' | 'resize' | 'store-replaced' | 'unmount';
+export declare function pointNodeId(id: string): string;
+export declare function objectNodeId(id: string): string;
+/** What a hit node's id names: a point, an object, or nothing of the figure's. */
+export declare function nodeTarget(nodeId: string): {
+    kind: 'point';
+    id: string;
+} | {
+    kind: 'object';
+    id: string;
+} | null;

package/dist/renderer/gesturePolicy.d.ts

@@ -0,0 +1,98 @@
+import { CanvasSize } from '../coordinates/transform.js';
+/**
+ * A position within the canvas, in the stage's own pixels from its top-left
+ * corner — the frame Konva draws and hit-tests in, and the one `screenToMath`
+ * converts from.
+ */
+export interface ScreenPoint {
+    x: number;
+    y: number;
+}
+/**
+ * A pointer's viewport position, in the stage's own pixels. The stage may be
+ * displayed at another size than it is laid out at — a CSS transform on a host
+ * element, `zoom` on the page — so the offset into its displayed box is divided
+ * by the ratio between the two, which is exactly the conversion Konva applies to
+ * its own events. Without it, a stage displayed at half size would take every
+ * press at twice its distance from the corner.
+ */
+export declare function toStagePoint(client: {
+    x: number;
+    y: number;
+}, displayed: {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}, laidOut: {
+    width: number;
+    height: number;
+}): ScreenPoint;
+export declare const MOUSE_DRAG_THRESHOLD_PX = 4;
+export declare const TOUCH_DRAG_THRESHOLD_PX = 8;
+/**
+ * The displacement at which a contact of this pointer type becomes a drag. An
+ * unknown or empty `pointerType` is treated as a mouse: the tighter threshold
+ * can only turn a sloppy tap into a harmless drag, never the other way round.
+ */
+export declare function dragThresholdPx(pointerType: string): number;
+/**
+ * One pointer's contact with the canvas, from press to release.
+ *
+ * Measured in the viewport's CSS pixels — where the hand actually moved — and
+ * not in the stage's: a stage displayed at half size must not make a finger
+ * drag after 4 px of travel. `maxDisplacement` is the furthest the pointer has
+ * been from where it went down, not where it is now: a finger that wanders out
+ * and back has still dragged, and releasing where it started must not turn it
+ * back into a tap.
+ */
+export interface PointerContact {
+    pointerId: number;
+    pointerType: string;
+    origin: ScreenPoint;
+    maxDisplacement: number;
+    dragging: boolean;
+}
+export declare function beginContact(pointerId: number, pointerType: string, origin: ScreenPoint): PointerContact;
+/** The contact after the pointer reached `at`. At the threshold it is a drag. */
+export declare function advanceContact(contact: PointerContact, at: ScreenPoint): PointerContact;
+/**
+ * Whether a press may open a contact at all. Only a primary pointer does — a
+ * second finger is a cancellation, never a gesture of its own — and a mouse
+ * only with its main button, so a right-click or a middle-click builds nothing.
+ */
+export declare function opensContact(press: {
+    isPrimary: boolean;
+    pointerType: string;
+    button: number;
+}): boolean;
+/**
+ * The stage container's style on both canvases. Every contact on the stage is
+ * the lifecycle's: a browser that pans, zooms or selects text under a finger
+ * that is drawing takes the pointer with `pointercancel`, and the gesture is
+ * lost to scrolling the page.
+ */
+export declare const GESTURE_SURFACE_STYLE: {
+    readonly touchAction: "none";
+    readonly userSelect: "none";
+    readonly WebkitUserSelect: "none";
+};
+/** Whether a release landed on the canvas. Anywhere else cancels the gesture. */
+export declare function isWithinCanvas(point: ScreenPoint, canvas: CanvasSize): boolean;
+/**
+ * Why a gesture ended without completing. Every one of them clears the
+ * preview, the snap, the pending endpoint and the contact; only `escape` also
+ * disarms the tool.
+ */
+export type GestureCancelReason = 'pointercancel' | 'second-pointer' | 'lost-capture' | 'outside-release' | 'blur' | 'hidden' | 'escape' | 'invalidated' | 'resize' | 'store-replaced' | 'unmount';
+export declare function pointNodeId(id: string): string;
+export declare function objectNodeId(id: string): string;
+/** What a hit node's id names: a point, an object, or nothing of the figure's. */
+export declare function nodeTarget(nodeId: string): {
+    kind: 'point';
+    id: string;
+} | {
+    kind: 'object';
+    id: string;
+} | null;
+//# sourceMappingURL=gesturePolicy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gesturePolicy.d.ts","sourceRoot":"","sources":["../../src/renderer/gesturePolicy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAW1D;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAChC,SAAS,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACvE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzC,WAAW,CAIb;AAKD,eAAO,MAAM,uBAAuB,IAAI,CAAA;AACxC,eAAO,MAAM,uBAAuB,IAAI,CAAA;AAExC;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,WAAW,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAClB,cAAc,CAEhB;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,WAAW,GAAG,cAAc,CAQvF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,SAAS,EAAE,OAAO,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;CACf,GAAG,OAAO,CAGV;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;;;CAIxB,CAAA;AAEV,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAE9E;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B,eAAe,GACf,gBAAgB,GAChB,cAAc,GACd,iBAAiB,GACjB,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,aAAa,GACb,QAAQ,GACR,gBAAgB,GAChB,SAAS,CAAA;AASb,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,kFAAkF;AAClF,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,GACb;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQvE"}

package/dist/renderer/shapes/CircleShape.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 CircleShapeProps {
+    id: string;
+    center: Point;
+    radius: number;
+    viewport: MathViewport;
+    canvas: CanvasSize;
+    color?: string;
+    strokeWidth?: number;
+    dashed?: boolean;
+    selected?: boolean;
+    opacity?: number;
+    listening?: boolean;
+}
+export declare function CircleShape({ id, center, radius, viewport, canvas, color, strokeWidth, dashed, selected, opacity, listening, }: CircleShapeProps): import("react").JSX.Element;

package/dist/renderer/shapes/CircleShape.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 CircleShapeProps {
+    id: string;
+    center: Point;
+    radius: number;
+    viewport: MathViewport;
+    canvas: CanvasSize;
+    color?: string;
+    strokeWidth?: number;
+    dashed?: boolean;
+    selected?: boolean;
+    opacity?: number;
+    listening?: boolean;
+}
+export declare function CircleShape({ id, center, radius, viewport, canvas, color, strokeWidth, dashed, selected, opacity, listening, }: CircleShapeProps): import("react").JSX.Element;
+//# sourceMappingURL=CircleShape.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CircleShape.d.ts","sourceRoot":"","sources":["../../../src/renderer/shapes/CircleShape.tsx"],"names":[],"mappings":"AACA,OAAO,EAAkC,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAC7F,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAOjE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,KAAK,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,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;AAYD,wBAAgB,WAAW,CAAC,EAC1B,EAAE,EACF,MAAM,EACN,MAAM,EACN,QAAQ,EACR,MAAM,EACN,KAAiB,EACjB,WAAe,EACf,MAAc,EACd,QAAgB,EAChB,OAAW,EACX,SAAgB,GACjB,EAAE,gBAAgB,+BAmBlB"}

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

@@ -0,0 +1,14 @@
+import { CanvasSize } from '../../coordinates/transform.cjs';
+import { ShapeDescriptor } from '../../geometry/entityModel.cjs';
+import { Point } from '../../geometry/point.cjs';
+import { MathViewport } from '../../schemas/viewport.schema.cjs';
+export interface EntityLabelProps {
+    text: string;
+    descriptor: ShapeDescriptor;
+    viewport: MathViewport;
+    canvas: CanvasSize;
+    color?: string;
+    opacity?: number;
+}
+export declare function labelAnchorOf(descriptor: ShapeDescriptor, viewport: MathViewport): Point | null;
+export declare function EntityLabel({ text, descriptor, viewport, canvas, color, opacity, }: EntityLabelProps): import("react").JSX.Element | null;

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

@@ -0,0 +1,15 @@
+import { CanvasSize } from '../../coordinates/transform.js';
+import { ShapeDescriptor } from '../../geometry/entityModel.js';
+import { Point } from '../../geometry/point.js';
+import { MathViewport } from '../../schemas/viewport.schema.js';
+export interface EntityLabelProps {
+    text: string;
+    descriptor: ShapeDescriptor;
+    viewport: MathViewport;
+    canvas: CanvasSize;
+    color?: string;
+    opacity?: number;
+}
+export declare function labelAnchorOf(descriptor: ShapeDescriptor, viewport: MathViewport): Point | null;
+export declare function EntityLabel({ text, descriptor, viewport, canvas, color, opacity, }: EntityLabelProps): import("react").JSX.Element | null;
+//# sourceMappingURL=EntityLabel.d.ts.map