@snaptrude/plugin-core 1.0.2-plainpoint-20261026.2 → 1.0.2-plainpoint-20261102.2

package/src/api/presentation/standards.ts

@@ -82,6 +82,7 @@ const StoredText = z
       })
       .strict()
       .optional(),
+    Text: z.object({ textMm: TextSize.optional() }).strict().optional(),
   })
   .strict()
 const StoredDimension = z
@@ -226,6 +227,10 @@ export const PluginGraphicStandardPatch = z
           })
           .strict()
           .optional(),
+        Text: z
+          .object({ textMm: TextSize.nullable().optional() })
+          .strict()
+          .optional(),
       })
       .strict()
       .optional(),
@@ -329,6 +334,7 @@ export const PluginResolvedGraphicStandard = z.object({
     gridBubbleRadiusMm: HeadRadius,
     sectionTextMm: TextSize,
     sectionHeadRadiusMm: HeadRadius,
+    annotationMm: TextSize,
   }),
   dimension: z.object({
     tickMm: TickLength,

package/src/api/presentation/views.ts

@@ -522,8 +522,13 @@ export type PluginPresentationViewsCreateArgs = z.infer<
   typeof PluginPresentationViewsCreateArgs
 >
 
-/** Result of {@linkcode PluginPresentationViewsApi.create} — the saved view. */
-export const PluginPresentationViewsCreateResult = PluginPresentationView
+/**
+ * Result of {@linkcode PluginPresentationViewsApi.create} — the saved view, plus `framed`:
+ * whether the view was framed on the given elements or bounds (always `false` without `frame`).
+ */
+export const PluginPresentationViewsCreateResult = PluginPresentationView.extend({
+  framed: z.boolean().optional(),
+})
 export type PluginPresentationViewsCreateResult = z.infer<
   typeof PluginPresentationViewsCreateResult
 >

package/test/designText.test.mjs

@@ -0,0 +1,72 @@
+// The design.text argument contract, checked before transport.
+// Run: node --test test/
+// Imports the BUILT package (dist) — run `pnpm build` first.
+import test from "node:test"
+import assert from "node:assert/strict"
+import {
+  PluginDesignTextCreateArgs,
+  PluginDesignTextUpdateArgs,
+  PluginTextPatch,
+} from "../dist/index.js"
+
+const position = "vec3_position"
+
+test("create takes one non-blank line of words", () => {
+  assert.equal(
+    PluginDesignTextCreateArgs.safeParse({ position, content: "LIVING" })
+      .success,
+    true,
+  )
+  for (const content of ["", "   ", "two\nlines", "two\r\nlines"])
+    assert.equal(
+      PluginDesignTextCreateArgs.safeParse({ position, content }).success,
+      false,
+      JSON.stringify(content),
+    )
+})
+
+test("create takes a #rrggbb colour and a vec3 handle for the arrowhead", () => {
+  const ok = {
+    position,
+    content: "Shear wall",
+    color: "#c62828",
+    arrowhead: "vec3_head",
+  }
+  assert.equal(PluginDesignTextCreateArgs.safeParse(ok).success, true)
+  for (const color of ["red", "#12345", "c62828"])
+    assert.equal(
+      PluginDesignTextCreateArgs.safeParse({ ...ok, color }).success,
+      false,
+      color,
+    )
+  for (const arrowhead of [{ x: 1, y: 0, z: 2 }, "component_1", "quat_1"])
+    assert.equal(
+      PluginDesignTextCreateArgs.safeParse({ ...ok, arrowhead }).success,
+      false,
+      JSON.stringify(arrowhead),
+    )
+})
+
+test("an update patch sets at least one known field", () => {
+  assert.deepEqual(PluginTextPatch.parse({ fontStyle: "Bold" }), {
+    fontStyle: "Bold",
+  })
+  for (const patch of [
+    {},
+    { size: 3 },
+    { content: "Fire exit", rotation: 90 },
+    { content: " " },
+  ])
+    assert.equal(
+      PluginTextPatch.safeParse(patch).success,
+      false,
+      JSON.stringify(patch),
+    )
+  assert.equal(
+    PluginDesignTextUpdateArgs.safeParse({
+      texts: [],
+      patch: { color: "#1565c0" },
+    }).success,
+    false,
+  )
+})

package/test/paperPensContract.test.mjs

@@ -2,7 +2,10 @@ import { test } from "node:test"
 import assert from "node:assert/strict"
 import {
   PluginGraphicStandardPatch,
+  PluginGraphicsAnnotationCategory,
+  PluginGraphicsOverrideCategory,
   PluginGraphicsOverrides,
+  PluginResolvedGraphicStandard,
   PluginGraphicsSetScaleArgs,
   PluginDesignCreateReferenceLinesArgs,
   PluginReferenceLineOptions,
@@ -36,6 +39,42 @@ test("Paper Pens rejects ambiguous, ineffective and stock-writing edits before t
   assert.deepEqual(PluginGraphicStandardPatch.parse(patch), patch)
 })
 
+test("Text is an annotation category with a projection pen and a size, but no view override", () => {
+  assert.equal(PluginGraphicsAnnotationCategory.safeParse("Text").success, true)
+  assert.equal(PluginGraphicsOverrideCategory.safeParse("Text").success, false)
+  assert.equal(
+    PluginGraphicsOverrides.safeParse({ Text: { hidden: true } }).success,
+    false,
+  )
+  for (const patch of [
+    { annotationText: { Text: { textMm: 3.5 } } },
+    { annotationText: { Text: { textMm: null } } },
+    { objectStyles: { Text: { projection: 2 } } },
+  ])
+    assert.deepEqual(PluginGraphicStandardPatch.parse(patch), patch)
+  for (const patch of [
+    { annotationText: { Text: { textMm: 0 } } },
+    { annotationText: { Text: { sizeMm: 3 } } },
+    { objectStyles: { Text: { cut: 2 } } },
+  ])
+    assert.equal(PluginGraphicStandardPatch.safeParse(patch).success, false)
+  const text = {
+    nameMm: 3,
+    areaMm: 2.5,
+    dimensionMm: 2.5,
+    gridTextMm: 3.5,
+    gridBubbleRadiusMm: 5,
+    sectionTextMm: 3,
+    sectionHeadRadiusMm: 6,
+  }
+  const resolvedText = PluginResolvedGraphicStandard.shape.text
+  assert.equal(resolvedText.safeParse(text).success, false)
+  assert.equal(
+    resolvedText.safeParse({ ...text, annotationMm: 2.5 }).success,
+    true,
+  )
+})
+
 test("explicit reference styles cannot conflict with legacy fields or mixed call forms", () => {
   assert.equal(
     PluginReferenceLineOptions.safeParse({ styleId: "wide", thickness: 3 })