@ai-gui/plugin-physics 0.17.0 → 0.18.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @ai-gui/plugin-physics
 
+## 0.18.0
+
+### Patch Changes
+
+- Updated dependencies [a22ba20]
+  - @ai-gui/core@0.18.0
+
+## 0.17.1
+
+### Patch Changes
+
+- a06c692: **The view box now holds the angle marks, the labels and the hatching.**
+
+  It was measured from bodies, surfaces and vector tips only. Everything else a mechanics diagram draws
+  sits outside those: the `30°` at the foot of an incline is an arc 28 from its vertex with a label 14
+  further out and was measured by nothing at all, so on any diagram whose incline reaches the left edge it
+  was simply outside the picture — the one label a 斜面 diagram cannot do without. A vector's label is
+  written past its arrowhead and then runs the width of its own text, so "mg cos(30°)" hung off the frame
+  beside an arrow pointing at nothing. Hatching hangs below its surface by its own length.
+
+  Text is estimated rather than measured — this renders to a string, with no DOM to measure in — and errs
+  wide: CJK at a full em, Latin at half. A box slightly too big shows white space; one slightly too small
+  cuts a word in half. An explicit `view` is still left exactly as given.
+
+  - @ai-gui/core@0.17.1
+
 ## 0.17.0
 
 ### Patch Changes

package/dist/index.cjs

@@ -193,7 +193,25 @@ function viewBoxOf(diagram) {
 	for (const vector of diagram.vectors ?? []) {
 		const start = vector.from ?? diagram.bodies?.[0]?.at ?? [0, 0];
 		note(start);
-		note(tipOf(vector, start));
+		const tip = tipOf(vector, start);
+		note(tip);
+		if (vector.label) {
+			const lx = tip[0] + (tip[0] - start[0]) * .08 + 8;
+			const ly = tip[1] + (tip[1] - start[1]) * .08;
+			note([lx, ly]);
+			note([lx + textWidth(vector.label), ly + LABEL_HEIGHT]);
+			note([lx, ly - LABEL_HEIGHT]);
+		}
+	}
+	for (const angle of diagram.angles ?? []) {
+		const radius = angle.radius ?? 28;
+		const reach = radius + (angle.label ? ANGLE_LABEL_OFFSET + textWidth(angle.label) : 0);
+		note([angle.at[0] - reach, angle.at[1] - reach]);
+		note([angle.at[0] + reach, angle.at[1] + reach]);
+	}
+	for (const surface of diagram.surfaces ?? []) {
+		if (!surface.hatch) continue;
+		note([Math.min(surface.from[0], surface.to[0]) - HATCH_REACH, Math.min(surface.from[1], surface.to[1]) - HATCH_REACH]);
 	}
 	if (xs.length === 0) return [
 		0,
@@ -209,6 +227,24 @@ function viewBoxOf(diagram) {
 		Math.max(...ys) + pad
 	];
 }
+/** How far past the arc a label sits, as the renderer places it. */
+const ANGLE_LABEL_OFFSET = 14;
+/** How far the hatching hangs off a surface, as the renderer draws it. */
+const HATCH_REACH = 15;
+/** One line of label text, in the same units the diagram is drawn in. */
+const LABEL_HEIGHT = 14;
+/**
+* Roughly how wide a label will be.
+*
+* An estimate on purpose: measuring text needs a DOM, and this renders to a string on whatever runs it.
+* Wide-erring — CJK counted at a full em, Latin at half — because a box slightly too big shows white
+* space, and a box slightly too small cuts a word off.
+*/
+function textWidth(label) {
+	let width = 0;
+	for (const character of label) width += /[\u3000-\u9fff\uff00-\uffef]/.test(character) ? LABEL_HEIGHT : LABEL_HEIGHT * .55;
+	return width;
+}
 /** Where a vector ends, whether it was given as a point or as a magnitude and angle. */
 function tipOf(vector, start) {
 	if (vector.to) return vector.to;

package/dist/index.js

@@ -191,7 +191,25 @@ function viewBoxOf(diagram) {
 	for (const vector of diagram.vectors ?? []) {
 		const start = vector.from ?? diagram.bodies?.[0]?.at ?? [0, 0];
 		note(start);
-		note(tipOf(vector, start));
+		const tip = tipOf(vector, start);
+		note(tip);
+		if (vector.label) {
+			const lx = tip[0] + (tip[0] - start[0]) * .08 + 8;
+			const ly = tip[1] + (tip[1] - start[1]) * .08;
+			note([lx, ly]);
+			note([lx + textWidth(vector.label), ly + LABEL_HEIGHT]);
+			note([lx, ly - LABEL_HEIGHT]);
+		}
+	}
+	for (const angle of diagram.angles ?? []) {
+		const radius = angle.radius ?? 28;
+		const reach = radius + (angle.label ? ANGLE_LABEL_OFFSET + textWidth(angle.label) : 0);
+		note([angle.at[0] - reach, angle.at[1] - reach]);
+		note([angle.at[0] + reach, angle.at[1] + reach]);
+	}
+	for (const surface of diagram.surfaces ?? []) {
+		if (!surface.hatch) continue;
+		note([Math.min(surface.from[0], surface.to[0]) - HATCH_REACH, Math.min(surface.from[1], surface.to[1]) - HATCH_REACH]);
 	}
 	if (xs.length === 0) return [
 		0,
@@ -207,6 +225,24 @@ function viewBoxOf(diagram) {
 		Math.max(...ys) + pad
 	];
 }
+/** How far past the arc a label sits, as the renderer places it. */
+const ANGLE_LABEL_OFFSET = 14;
+/** How far the hatching hangs off a surface, as the renderer draws it. */
+const HATCH_REACH = 15;
+/** One line of label text, in the same units the diagram is drawn in. */
+const LABEL_HEIGHT = 14;
+/**
+* Roughly how wide a label will be.
+*
+* An estimate on purpose: measuring text needs a DOM, and this renders to a string on whatever runs it.
+* Wide-erring — CJK counted at a full em, Latin at half — because a box slightly too big shows white
+* space, and a box slightly too small cuts a word off.
+*/
+function textWidth(label) {
+	let width = 0;
+	for (const character of label) width += /[\u3000-\u9fff\uff00-\uffef]/.test(character) ? LABEL_HEIGHT : LABEL_HEIGHT * .55;
+	return width;
+}
 /** Where a vector ends, whether it was given as a point or as a magnitude and angle. */
 function tipOf(vector, start) {
 	if (vector.to) return vector.to;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-gui/plugin-physics",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Force and vector diagrams for teaching mechanics, rendered as SVG from a declarative block.",
   "keywords": [
     "llm",
@@ -54,7 +54,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@ai-gui/core": "0.17.0"
+    "@ai-gui/core": "0.18.0"
   },
   "scripts": {
     "build": "tsdown",