@snaptrude/plugin-core 0.9.16-networks-20261012.1 → 0.9.17

package/src/api/presentation/viewPresets.ts

@@ -1,241 +0,0 @@
-import * as z from "zod"
-import type { PluginApiReturn } from "../../types"
-
-/** Presets are document-local. Their ids are stable across reload; built-ins are immutable. */
-export const PluginViewPreset = z.object({
-  id: z.string(),
-  name: z.string(),
-  builtIn: z.boolean(),
-  revision: z.number().int().nonnegative(),
-})
-export type PluginViewPreset = z.infer<typeof PluginViewPreset>
-export const PluginViewPresetIdArgs = z
-  .object({ presetId: z.string().min(1) })
-  .strict()
-export type PluginViewPresetIdArgs = z.infer<typeof PluginViewPresetIdArgs>
-export const PluginViewPresetCreateArgs = z
-  .object({ name: z.string().trim().min(1), fromDrawingId: z.string().min(1) })
-  .strict()
-export type PluginViewPresetCreateArgs = z.infer<
-  typeof PluginViewPresetCreateArgs
->
-export const PluginViewPresetRenameArgs = PluginViewPresetIdArgs.extend({
-  name: z.string().trim().min(1),
-})
-export type PluginViewPresetRenameArgs = z.infer<
-  typeof PluginViewPresetRenameArgs
->
-export const PluginViewPresetUpdateArgs = PluginViewPresetIdArgs.extend({
-  fromDrawingId: z.string().min(1),
-})
-export type PluginViewPresetUpdateArgs = z.infer<
-  typeof PluginViewPresetUpdateArgs
->
-export const PluginViewPresetDeleteArgs = PluginViewPresetIdArgs.extend({
-  replacementId: z.string().min(1),
-})
-export type PluginViewPresetDeleteArgs = z.infer<
-  typeof PluginViewPresetDeleteArgs
->
-
-/**
- * Reusable styles for kernel-plan drawings, stored in the Present document.
- *
- * A preset holds every style category of a native kernel plan. A drawing is
- * bound to one with {@linkcode PluginPresentationDrawingsApi.applyPreset}; its
- * own style changes are overrides on top, dropped by
- * {@linkcode PluginPresentationDrawingsApi.resetOverrides}. Presets apply only
- * to drawings whose `drawings.getCapabilities(drawingId).presets` is `true`.
- * Local title text is excluded from preset values.
- *
- * Presets are document-local; their ids survive reload. Built-in presets are
- * immutable. Catalog writes (`create`, `copy`, `rename`, `update`, `delete`)
- * are native document metadata and are **not undoable**; binding a drawing or
- * changing its overrides uses Present undo. Every method requires **Present
- * mode to be open** and throws `PRECONDITION_FAILED` ("Present mode is not
- * open") when it is closed; no method switches tabs.
- *
- * Accessed via `snaptrude.presentation.viewPresets`.
- */
-export abstract class PluginPresentationViewPresetsApi {
-  /**
-   * List the preset catalog: built-ins first, then custom presets by name.
-   *
-   * @returns Every {@linkcode PluginViewPreset}.
-   * @throws `PRECONDITION_FAILED` if Present mode is not open.
-   *
-   * @examplePrompt List the available drawing style presets
-   * @examplePrompt Which custom presets does this presentation have?
-   * @examplePrompt Is there a Planning Issue preset?
-   *
-   * # Example
-   * ```ts
-   * const presets = await snaptrude.presentation.viewPresets.list()
-   * const custom = presets.filter((preset) => !preset.builtIn)
-   * ```
-   */
-  public abstract list(): PluginApiReturn<PluginViewPreset[]>
-
-  /**
-   * Read one preset by id.
-   *
-   * @param presetId - The preset to read.
-   * @returns The {@linkcode PluginViewPreset}, or `null` if no preset has that id.
-   * @throws `PRECONDITION_FAILED` if Present mode is not open.
-   *
-   * @examplePrompt Which preset is this drawing using?
-   * @examplePrompt Is this preset a built-in one?
-   * @examplePrompt Read the preset bound to the ground floor plan
-   *
-   * # Example
-   * ```ts
-   * const drawing = await snaptrude.presentation.drawings.get(drawingId)
-   * const preset = drawing?.presetId
-   *   ? await snaptrude.presentation.viewPresets.get(drawing.presetId)
-   *   : null
-   * ```
-   */
-  public abstract get(
-    presetId: string,
-  ): PluginApiReturn<PluginViewPreset | null>
-
-  /**
-   * Save a kernel-plan drawing's effective styles as a new custom preset and
-   * bind that drawing to it. Not undoable (catalog write).
-   *
-   * @param name - A unique preset name (non-empty after trimming).
-   * @param options - `fromDrawingId`: the kernel-plan drawing to take styles from.
-   * @returns The new {@linkcode PluginViewPreset}.
-   * @throws `VALIDATION` for an empty or duplicate name (with a hint);
-   *   `PRECONDITION_FAILED` if Present mode is not open, the document is
-   *   read-only, or the drawing is not a kernel vector plan (each with a
-   *   hint); `HANDLE_INVALID` if `fromDrawingId` is not a drawing.
-   *
-   * @examplePrompt Save this drawing's styles as a new preset
-   * @examplePrompt Make a preset called Planning Issue from this plan
-   * @examplePrompt Turn my restyled drawing into a reusable style
-   *
-   * # Example
-   * ```ts
-   * const capabilities = await snaptrude.presentation.drawings.getCapabilities(drawing.id)
-   * if (capabilities.presets) {
-   *   const preset = await snaptrude.presentation.viewPresets.create("Planning Issue", {
-   *     fromDrawingId: drawing.id,
-   *   })
-   * }
-   * ```
-   */
-  public abstract create(
-    name: string,
-    options: { fromDrawingId: string },
-  ): PluginApiReturn<PluginViewPreset>
-
-  /**
-   * Duplicate a preset under a native-generated unique name. Drawing bindings
-   * do not change. Not undoable (catalog write). Built-ins can be copied.
-   *
-   * @param presetId - The preset to copy.
-   * @returns The new custom {@linkcode PluginViewPreset}.
-   * @throws `PRECONDITION_FAILED` if Present mode is not open or the document
-   *   is read-only (each with a hint); `HANDLE_INVALID` if `presetId` does not
-   *   exist.
-   *
-   * @examplePrompt Duplicate this preset
-   * @examplePrompt Make an editable copy of the built-in preset
-   * @examplePrompt Copy the Planning Issue preset so I can change it
-   *
-   * # Example
-   * ```ts
-   * const copy = await snaptrude.presentation.viewPresets.copy(preset.id)
-   * await snaptrude.presentation.viewPresets.rename(copy.id, "Planning Issue B")
-   * ```
-   */
-  public abstract copy(presetId: string): PluginApiReturn<PluginViewPreset>
-
-  /**
-   * Rename a custom preset. Names must stay unique; built-ins cannot be
-   * renamed. Not undoable (catalog write).
-   *
-   * @param presetId - The custom preset to rename.
-   * @param name - The new unique name (non-empty after trimming).
-   * @returns The renamed {@linkcode PluginViewPreset}.
-   * @throws `VALIDATION` when the catalog refuses: an empty or duplicate name,
-   *   a built-in preset, or an unknown `presetId` (with a hint);
-   *   `PRECONDITION_FAILED` if Present mode is not open or the document is
-   *   read-only (each with a hint).
-   *
-   * @examplePrompt Rename this preset to Client Review
-   * @examplePrompt Call the copied preset Planning Issue B
-   * @examplePrompt Change the name of my custom drawing style
-   *
-   * # Example
-   * ```ts
-   * await snaptrude.presentation.viewPresets.rename(preset.id, "Client Review")
-   * ```
-   */
-  public abstract rename(
-    presetId: string,
-    name: string,
-  ): PluginApiReturn<PluginViewPreset>
-
-  /**
-   * Replace a custom preset's values with the effective styles of a drawing
-   * already bound to it, then refresh every bound drawing. Built-ins cannot
-   * be updated. Not undoable (catalog write).
-   *
-   * @param presetId - The custom preset to update.
-   * @param options - `fromDrawingId`: a kernel-plan drawing bound to this preset.
-   * @returns The updated {@linkcode PluginViewPreset} (its `revision` grows).
-   * @throws `VALIDATION` when the catalog refuses: a built-in preset (with a
-   *   hint); `PRECONDITION_FAILED` if Present mode is not open, the document
-   *   is read-only, or the drawing is not a kernel vector plan bound to this
-   *   preset (each with a hint); `HANDLE_INVALID` if `fromDrawingId` is not a
-   *   drawing.
-   *
-   * @examplePrompt Update this preset from the current drawing styles
-   * @examplePrompt Push my style changes to every drawing using this preset
-   * @examplePrompt Save these overrides into the Planning Issue preset
-   *
-   * # Example
-   * ```ts
-   * await snaptrude.presentation.viewPresets.update(drawing.presetId!, {
-   *   fromDrawingId: drawing.id,
-   * })
-   * ```
-   */
-  public abstract update(
-    presetId: string,
-    options: { fromDrawingId: string },
-  ): PluginApiReturn<PluginViewPreset>
-
-  /**
-   * Delete a custom preset and rebind its drawings to another existing
-   * preset. Built-ins cannot be deleted. Not undoable (catalog write).
-   *
-   * @param presetId - The custom preset to delete.
-   * @param options - `replacementId`: the existing preset its drawings move to
-   *   (not the deleted one).
-   * @returns Nothing.
-   * @throws `VALIDATION` when the catalog refuses: a built-in or unknown
-   *   `presetId`, or an unknown `replacementId` (with a hint);
-   *   `PRECONDITION_FAILED` if Present mode is not open or the document is
-   *   read-only (each with a hint).
-   *
-   * @examplePrompt Delete this preset
-   * @examplePrompt Remove the old style preset and switch its drawings to the default
-   * @examplePrompt Get rid of the Planning Issue B preset
-   *
-   * # Example
-   * ```ts
-   * const presets = await snaptrude.presentation.viewPresets.list()
-   * const replacement = presets.find((each) => each.builtIn)!
-   * await snaptrude.presentation.viewPresets.delete(customPreset.id, {
-   *   replacementId: replacement.id,
-   * })
-   * ```
-   */
-  public abstract delete(
-    presetId: string,
-    options: { replacementId: string },
-  ): PluginApiReturn<void>
-}

package/test/drawingContract.test.mjs

@@ -1,288 +0,0 @@
-// The drawing tool contract the agent reads: export file names are base names
-// without an extension, and architectural scales are standard denominators only.
-// 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 { readFileSync } from "node:fs"
-import {
-  STANDARD_DRAWING_SCALES,
-  METRIC_DRAWING_SCALES,
-  IMPERIAL_DRAWING_SCALES,
-  IMPERIAL_DETAIL_DRAWING_SCALES,
-  IMPERIAL_SITE_DRAWING_SCALES,
-  PluginDrawingCreateOptions,
-  PluginDrawingCreateArgs,
-  PluginDrawingScaleArgs,
-  PluginDrawingExportOptions,
-  PluginDrawingExportArgs,
-  PluginPresentationExportArgs,
-  PluginPresentationSheetsPlaceArgs,
-  PluginPresentationSheetsPlaceDrawingArgs,
-  PluginPresentationSheetsPlaceDrawingResult,
-  PluginPresentationSheetsPlaceResult,
-  PluginPresentationPlacedViewsSetScaleArgs,
-} from "../dist/index.js"
-import { buildManifest } from "../scripts/generate-manifest.mjs"
-
-// The Scale dropdown's values in the frontend (ALL_SCALES_DICTIONARY in
-// src/app/common/utils/scaleMeasurements.ts): metric, imperial detail, imperial site.
-const METRIC = [10, 20, 50, 100, 150, 200, 250, 500, 1000]
-const IMPERIAL_DETAIL = [12, 16, 24, 32, 48, 64, 96, 128, 192, 384, 768, 1536]
-const IMPERIAL_SITE = [120, 240, 360, 480, 600, 1200, 2400, 3600, 4800]
-
-const messagesOf = (result) => result.error.issues.map((issue) => issue.message)
-
-// --- standard scales ---------------------------------------------------------
-
-test("STANDARD_DRAWING_SCALES is the frontend's metric and imperial list, ascending", () => {
-  const expected = [...METRIC, ...IMPERIAL_DETAIL, ...IMPERIAL_SITE].sort((a, b) => a - b)
-  assert.deepEqual([...STANDARD_DRAWING_SCALES], expected)
-  assert.deepEqual([...METRIC_DRAWING_SCALES], METRIC)
-  assert.deepEqual([...IMPERIAL_DRAWING_SCALES], [...IMPERIAL_DETAIL, ...IMPERIAL_SITE].sort((a, b) => a - b))
-  assert.deepEqual([...IMPERIAL_DETAIL_DRAWING_SCALES], IMPERIAL_DETAIL)
-  assert.deepEqual([...IMPERIAL_SITE_DRAWING_SCALES], IMPERIAL_SITE)
-})
-
-const scaleSchemas = [
-  ["drawings.create options", (scale) => PluginDrawingCreateOptions.safeParse({ scale })],
-  ["drawings.create args", (scale) => PluginDrawingCreateArgs.safeParse({ viewId: "v1", scale })],
-  ["drawings.setScale", (scale) => PluginDrawingScaleArgs.safeParse({ drawingId: "d1", scale })],
-  ["sheets.place", (scale) => PluginPresentationSheetsPlaceArgs.safeParse({ sheetId: "s1", viewId: "v1", scale })],
-  ["placedViews.setScale", (scale) => PluginPresentationPlacedViewsSetScaleArgs.safeParse({ shapeId: "p1", scale })],
-]
-
-for (const [name, parse] of scaleSchemas) {
-  test(`${name} accepts every standard scale`, () => {
-    for (const scale of STANDARD_DRAWING_SCALES) {
-      assert.equal(parse(scale).success, true, `${name} rejected ${scale}`)
-    }
-  })
-
-  test(`${name} rejects a non-standard scale and lists the allowed ones`, () => {
-    for (const scale of [137, 75, 1, 99.5]) {
-      const result = parse(scale)
-      assert.equal(result.success, false, `${name} accepted ${scale}`)
-      const message = messagesOf(result).join("\n")
-      assert.match(message, /standard/i)
-      assert.ok(message.includes(`Metric: ${METRIC.join(", ")}`), message)
-      assert.ok(message.includes(`imperial detail: ${IMPERIAL_DETAIL.join(", ")}`), message)
-      assert.ok(message.includes(`imperial site: ${IMPERIAL_SITE.join(", ")}`), message)
-      assert.match(message, /largest/i)
-    }
-  })
-}
-
-test("create options still allow omitting the scale", () => {
-  assert.equal(PluginDrawingCreateOptions.safeParse({}).success, true)
-  assert.equal(PluginPresentationSheetsPlaceArgs.safeParse({ sheetId: "s", viewId: "v" }).success, true)
-})
-
-// --- placing a drawing on a sheet -------------------------------------------
-
-test("sheets.placeDrawing takes an optional boolean fit", () => {
-  const base = { sheetId: "s", drawingId: "d" }
-  assert.equal(PluginPresentationSheetsPlaceDrawingArgs.safeParse(base).success, true)
-  assert.equal(PluginPresentationSheetsPlaceDrawingArgs.safeParse({ ...base, fit: true }).success, true)
-  assert.equal(PluginPresentationSheetsPlaceDrawingArgs.safeParse({ ...base, fit: false }).success, true)
-  assert.equal(PluginPresentationSheetsPlaceDrawingArgs.safeParse({ ...base, fit: "yes" }).success, false)
-})
-
-test("sheets.placeDrawing reports the scale it used and whether it rescaled", () => {
-  const ok = (value) => PluginPresentationSheetsPlaceDrawingResult.safeParse(value).success
-  assert.equal(ok({ shapeId: "shape:a", scale: 192, rescaled: true }), true)
-  assert.equal(ok({ shapeId: "shape:a", scale: null, rescaled: false }), true)
-  assert.equal(ok({ shapeId: "shape:a" }), false)
-  assert.equal(ok({ shapeId: "shape:a", scale: 100 }), false)
-  assert.equal(ok({ shapeId: "shape:a", scale: 100, rescaled: false, overlaps: true }), true)
-  assert.equal(ok({ shapeId: "shape:a", scale: 100, rescaled: false, overlaps: "yes" }), false)
-})
-
-test("sheets.place may report the scale, whether it rescaled and whether it overlaps", () => {
-  const ok = (value) => PluginPresentationSheetsPlaceResult.safeParse(value).success
-  assert.equal(ok({ shapeId: "shape:a" }), true)
-  assert.equal(ok({ shapeId: "shape:a", scale: 192, rescaled: true, overlaps: false }), true)
-  assert.equal(ok({ shapeId: "shape:a", scale: null, rescaled: false }), true)
-  assert.equal(ok({ shapeId: "shape:a", overlaps: "no" }), false)
-  assert.equal(ok({ shapeId: "shape:a", rescaled: 1 }), false)
-})
-
-test("sheets.place may report that a drawing at an explicit scale overflows the sheet; placeDrawing never does", () => {
-  const place = (value) => PluginPresentationSheetsPlaceResult.safeParse(value).success
-  assert.equal(place({ shapeId: "shape:a", scale: 100, rescaled: false, overflows: true }), true)
-  assert.equal(place({ shapeId: "shape:a", scale: 100, rescaled: false, overflows: "yes" }), false)
-  const placeDrawing = PluginPresentationSheetsPlaceDrawingResult.safeParse({
-    shapeId: "shape:a",
-    scale: 100,
-    rescaled: false,
-    overflows: true,
-  })
-  assert.equal(placeDrawing.success, true)
-  assert.equal("overflows" in placeDrawing.data, false)
-})
-
-// --- file names --------------------------------------------------------------
-
-const fileNameSchemas = [
-  ["drawings.export options", (fileName) => PluginDrawingExportOptions.safeParse({ fileName })],
-  ["drawings.export args", (fileName) => PluginDrawingExportArgs.safeParse({ drawingId: "d1", format: "pdf", fileName })],
-  ["presentation.export", (fileName) => PluginPresentationExportArgs.safeParse({ format: "pdf", fileName })],
-]
-
-for (const [name, parse] of fileNameSchemas) {
-  test(`${name} rejects a file name with an extension`, () => {
-    for (const fileName of ["Floor Pattern View.pdf", "plan.PDF", "a.svg", "a.png", "a.jpg", "a.JPEG"]) {
-      const result = parse(fileName)
-      assert.equal(result.success, false, `${name} accepted ${fileName}`)
-      assert.match(messagesOf(result).join("\n"), /without an extension/i)
-    }
-  })
-
-  test(`${name} rejects a file name ending in a dot or whitespace`, () => {
-    // The host appends the extension, so "a.pdf." would become "a.pdf..pdf".
-    for (const fileName of ["a.pdf.", "plan.", "plan..", "plan ", "plan\t", "a.pdf .", "a.pdf. "]) {
-      const result = parse(fileName)
-      assert.equal(result.success, false, `${name} accepted ${JSON.stringify(fileName)}`)
-      assert.match(messagesOf(result).join("\n"), /without an extension/i)
-    }
-  })
-
-  test(`${name} accepts a base name`, () => {
-    for (const fileName of ["Floor Pattern View", "Level 1.2 plan", "pdf plan", "notes.v2"]) {
-      assert.equal(parse(fileName).success, true, `${name} rejected ${fileName}`)
-    }
-  })
-}
-
-// --- the contract the agent reads (api-manifest summaries) -------------------
-
-// Overloaded methods produce one leaf per signature; the documented one comes first.
-const manifest = new Map()
-for (const leaf of buildManifest()) if (!manifest.has(leaf.path)) manifest.set(leaf.path, leaf)
-const summaryOf = (path) => {
-  const leaf = manifest.get(path)
-  assert.ok(leaf, `no manifest leaf ${path}`)
-  return leaf.summary
-}
-
-test("export summaries tell the agent to pass fileName without an extension", () => {
-  for (const path of ["presentation.drawings.export", "presentation.export"]) {
-    assert.match(summaryOf(path), /fileName[^.]*without (an|its) extension/i, path)
-  }
-})
-
-test("scale summaries list the standard scales and say how to choose one", () => {
-  for (const path of [
-    "presentation.drawings.create",
-    "presentation.drawings.setScale",
-    "presentation.sheets.place",
-    "presentation.placedViews.setScale",
-  ]) {
-    const summary = summaryOf(path)
-    assert.ok(summary.includes(`Metric: ${METRIC.join(", ")}.`), `${path}: ${summary}`)
-    assert.ok(summary.includes(`Imperial detail: ${IMPERIAL_DETAIL.join(", ")}`), `${path}: ${summary}`)
-    assert.ok(summary.includes(`Imperial site: ${IMPERIAL_SITE.join(", ")}`), `${path}: ${summary}`)
-    assert.match(summary, /Pick the LARGEST standard scale \(smallest denominator\)/, path)
-    assert.match(summary, /fits its frame or sheet/i, path)
-    assert.match(summary, /usually 1:50 to 1:200/, path)
-    assert.match(summary, /Never use a site-sized scale/, path)
-    assert.match(summary, /project's unit system/, path)
-  }
-})
-
-test("drawings.create tells the agent to omit position and follow the label layout's suggested scale", () => {
-  const summary = summaryOf("presentation.drawings.create")
-  assert.match(summary, /Omit `position` unless the user asked for a specific place/, summary)
-  assert.match(summary, /next to its source view/, summary)
-  assert.match(summary, /labels\.getLayout\(drawingId\)/, summary)
-  assert.match(summary, /suggestedScale/, summary)
-})
-
-test("drawing writes send the agent to presentation.camera instead of promising to frame the camera", () => {
-  for (const path of [
-    "presentation.drawings.create",
-    "presentation.drawings.setScale",
-    "presentation.drawings.setCrop",
-  ]) {
-    const summary = summaryOf(path)
-    assert.doesNotMatch(summary, /frames the camera/i, path)
-    assert.match(summary, /Changes the drawing, not the Present camera/, path)
-    assert.match(summary, /presentation\.camera\.zoomTo\(drawing\.id\)/, path)
-    assert.match(summary, /presentation\.camera\.capture\(\)/, path)
-  }
-  for (const path of ["presentation.drawings.setScale", "presentation.drawings.setCrop"]) {
-    assert.match(summaryOf(path), /moves\s+to the nearest free spot/, path)
-  }
-})
-
-test("drawings.create says it never puts a drawing on a sheet and names the sheet calls", () => {
-  const summary = summaryOf("presentation.drawings.create")
-  assert.match(summary, /beside its source view/, summary)
-  assert.match(summary, /never on a sheet/, summary)
-  assert.match(summary, /sheets\.place\(sheetId, viewId\)/, summary)
-  assert.match(summary, /sheets\.placeDrawing\(sheetId, drawingId\)/, summary)
-})
-
-test("sheets.placeDrawing documents fitting, fit: false and one sheet per drawing", () => {
-  const summary = summaryOf("presentation.sheets.placeDrawing")
-  assert.match(summary, /scaled down to fit/, summary)
-  assert.match(summary, /never scaled up/, summary)
-  assert.match(summary, /`fit: false`/, summary)
-  assert.match(summary, /naming the\s+drawing, the sheet and the scale/, summary)
-  assert.match(summary, /without\s+`fit: false`\s+to fit it, or\s+use a larger sheet/, summary)
-  assert.doesNotMatch(summary, /use\s+`?sheets\.place`?\s+to\s+fit/, summary)
-  assert.match(summary, /reports the architectural scale/, summary)
-})
-
-// Without a position the host puts the drawing at the sheet centre or the nearest free spot,
-// and only centres it over other drawings (reporting overlaps: true) when there is none.
-const NO_STACK = /lands\s+on\s+top/
-const FREE_SPOT = /nearest\s+free\s+spot/
-const CENTRED_WHEN_FULL = /no\s+free\s+spot[^.]*centred[^.]*`overlaps:\s*true`/
-const EXPLICIT_POSITION = /`position`[^.]*placed\s+as\s+given[^.]*`overlaps:\s*true`[^.]*not\s+moved/
-const DRAWINGS_ONLY = /only\s+other\s+drawings\s+count[^.]*text,\s+images\s+and\s+other\s+shapes/
-
-const assertPlacementLayout = (summary) => {
-  assert.doesNotMatch(summary, NO_STACK, summary)
-  assert.match(summary, FREE_SPOT, summary)
-  assert.match(summary, CENTRED_WHEN_FULL, summary)
-  assert.match(summary, EXPLICIT_POSITION, summary)
-  assert.match(summary, DRAWINGS_ONLY, summary)
-}
-
-test("sheets.placeDrawing says where a drawing goes without a position and when it overlaps", () => {
-  assertPlacementLayout(summaryOf("presentation.sheets.placeDrawing"))
-})
-
-test("sheets.place says it is the call that puts a view on a sheet and fits it to that sheet", () => {
-  const summary = summaryOf("presentation.sheets.place")
-  assert.match(summary, /This is the call that puts a view on a\s+sheet/, summary)
-  assert.match(summary, /largest\s+standard scale at which it fits inside the target sheet's margin/, summary)
-  assert.match(summary, /never at a larger scale than the normal view drop/, summary)
-  assert.match(summary, /3D view[^.]*shrunk\s+evenly/, summary)
-  assertPlacementLayout(summary)
-})
-
-// The full JSDoc of sheets.place, for the @returns and @throws tags the summary leaves out.
-const placeJsDoc = () => {
-  const source = readFileSync(new URL("../src/api/presentation/sheets.ts", import.meta.url), "utf8")
-  const end = source.indexOf("public abstract place(")
-  const start = source.lastIndexOf("/**", end)
-  return source
-    .slice(start, end)
-    .replace(/\{@linkcode (\w+)\}/g, "$1")
-    .replace(/\s*\*\s*/g, " ")
-}
-
-test("sheets.place documents the scale and rescaled it returns", () => {
-  const doc = placeJsDoc()
-  assert.match(doc, /@returns[^@]*`scale` used \(`null` for a 3D view\)/, doc)
-  assert.match(doc, /@returns[^@]*`rescaled`/, doc)
-  assert.doesNotMatch(doc, /a host that reports them/, doc)
-})
-
-test("sheets.place documents PRECONDITION_FAILED for a view that does not fit", () => {
-  const doc = placeJsDoc()
-  assert.match(doc, /@throws[^@]*`PRECONDITION_FAILED`[^@]*smallest standard scale/, doc)
-  assert.match(doc, /@throws[^@]*`PRECONDITION_FAILED`[^@]*title block alone/, doc)
-})