lineadraw 0.7.0 → 0.8.0

package/README.md

@@ -141,7 +141,8 @@ token; `--port`, `--token` and `LINEA_BRIDGE_TOKEN` override) — see
 docs/desktop-bridge.md in the linea repo.
 
 The manifest is deterministic (repo-relative paths, no git metadata), so
-`check` is a byte-for-byte diff — the included CI workflow runs it on every
+`check` compares the parsed JSON (formatting, a trailing newline or CRLF
+line endings never make it stale) — the included CI workflow runs it on every
 push and PR. `manifest`/`check` also **dry-run every block** through
 `lineadraw/sdk` and render thumbnails.
 
@@ -180,7 +181,7 @@ const walls = doc.addLayer({ name: "walls", color: "#e8e8e8", lineWidth: 0.5 });
 doc.add([
   { type: "polyline", layerId: walls, closed: true,
     points: [[0, 0], [6000, 0], [6000, 3000], [0, 3000]] },
-  { type: "dimension", points: [[0, 0], [6000, 0]], offset: [0, -500],
+  { type: "dimension", points: [[0, 0], [6000, 0]], offset: -500,
     scale: 50 },                                 // annotations × drawing scale
 ]);
 doc.addLayout("Plan 1:50", { sheet: "A3", viewport: { scale: "1:50" } });
@@ -221,7 +222,11 @@ await doc.exportPdf("plan.pdf");
 
 ### API surface
 
-`newDrawing(name?)` / `drawingFromJson(text)` / `openDrawing(path)` → `Drawing`:
+`newDrawing(name?, options?)` / `drawingFromJson(text)` / `openDrawing(path, options?)`
+→ `Drawing`; `options.marketplaces` lists the marketplaces to search and
+install from (`{ kind: "github", spec: "owner/repo[@branch]", token? }` or
+`{ kind: "folder", folder }`, priority order; the public collection is
+appended when missing):
 
 - **Name**: `drawing.name` is the file name (set on `openDrawing`, updated
   by `save(path)`); `newDrawing(name)` names it until it is saved. The
@@ -240,9 +245,22 @@ await doc.exportPdf("plan.pdf");
   `updateTextStyle(nameOrId, patch)`, `removeTextStyle(nameOrId)` (refused
   while objects use it) — the same four for `DimStyle`; `setTextStyle` /
   `setDimStyle` remain as deprecated aliases of update
+- **Line types / hatch patterns** (the document's own definitions, by
+  name, resolved ahead of the built-in catalogue): `listLineTypes()`,
+  `addLineTypes([{name, dashesMm}])`, `updateLineType(name, patch)`,
+  `removeLineType(name)`; `listHatchPatterns()`,
+  `addHatchPatterns([{name, lines}])`, `updateHatchPattern(name, patch)`,
+  `removeHatchPattern(name)`
 - **Modules**: `await addBlockDefinitions(sources)` / `removeBlockDefinition(id)`,
   `await addUserCommands(sources)` / `removeUserCommand(id)`,
   `await setBlockDefinitions(sources)`, `await setCommands(sources)`
+- **Marketplaces**: `listMarketplaces()`, `await addMarketplaces(list)`
+  (verifies each catalog), `removeMarketplaces(names)`,
+  `await searchMarketplaces({ query?, kind?, marketplace? })` (entries with
+  install status), `await installMarketplaceEntries(ids, marketplace?)`
+  (declared block dependencies first, one undo step) — then insert a block
+  with `add([{ type: "block", definitionId }])`. Marketplaces are process
+  configuration, never written to the file.
 - **Scripts**: `await runScript(source, inputs?, params?)` runs a
   `defineCommand` module (the same one the editor palette runs) headlessly
   as ONE undo step — its declared `inputs` (points) are supplied up front,
@@ -277,8 +295,12 @@ Full parameter docs are in the bundled `dist/index.d.ts` JSDoc.
 `hatch` (loops — outer + holes, even-odd; fill solid/pattern/lines) ·
 `text` (position, content; **default alignment center/center**; optional
 leaderLines with the arrowhead at index 0) · `dimension` (linear/angular/
-radial/diameter; `offset` is a vector from points[0] to the dimension line;
-linear with >2 points = chain) · `block` (instances of script definitions) ·
+radial/diameter; linear: `offset` is the signed distance of the dimension
+line from points[0] (left of the measuring direction positive) and
+`rotation` an optional locked measuring direction; angular: `offset` is the
+signed arc radius; `labels[i]` place and word each segment's text —
+`along`/`across` in mm, unset = automatic, `content` with `{value}` for the
+measurement; linear with >2 points = chain) · `block` (instances of script definitions) ·
 `viewport` (layouts only) · `image` (placement of an asset).
 
 ### Block scripts

package/bin/lineadraw.mjs

@@ -11,6 +11,7 @@
 //     and the agent token; `--port` / `--token` / LINEA_BRIDGE_TOKEN override.
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
+import { isDeepStrictEqual } from "node:util";
 import { dirname, join, resolve } from "node:path";
 import {
   buildManifest,
@@ -238,13 +239,27 @@ switch (command) {
   case "check": {
     const manifest = await validatedManifest();
     const committedPath = join(dir, MANIFEST_PATH);
-    const committed = existsSync(committedPath)
-      ? readFileSync(committedPath, "utf8")
-      : null;
-    if (committed !== manifestJson(manifest))
+    // Compared as parsed JSON, not bytes: a formatter, a web edit or a CRLF
+    // checkout must not fail a manifest whose content is current.
+    let committed = null;
+    if (existsSync(committedPath)) {
+      try {
+        committed = JSON.parse(readFileSync(committedPath, "utf8"));
+      } catch {
+        committed = "unreadable";
+      }
+    }
+    if (!isDeepStrictEqual(committed, JSON.parse(manifestJson(manifest)))) {
+      const why =
+        committed === null
+          ? "missing"
+          : committed === "unreadable"
+            ? "not valid JSON"
+            : "stale";
       fail(
-        `${MANIFEST_PATH} is ${committed === null ? "missing" : "stale"} — run \`npx lineadraw manifest\` and commit the result.`,
+        `${MANIFEST_PATH} is ${why} — run \`npx lineadraw manifest\` and commit the result.`,
       );
+    }
     const libWarning = tsconfigLibWarning(dir);
     if (libWarning !== null) console.warn(`warning: ${libWarning}`);
     console.log(`OK: ${manifest.entries.length} entries, manifest is current.`);