tsdraft 0.0.0-stage → 0.2.0

package/dist/rules.js

@@ -0,0 +1,56 @@
+const NAME_EMPTY = "Layer names cannot be empty";
+const NAME_CHARS = 'Layer names cannot contain < > / \\ " : ; ? * | = ` ^ , or line breaks';
+const NAME_EDGE = "Layer names cannot start or end with a space";
+const NAME_LENGTH = "Layer names cannot be longer than 255 characters";
+const NAME_R12_CHARS = 'R12 layer names can only use letters, digits, $, - and _. Use DXF version "R2018" for other characters';
+const NAME_R12_LENGTH = 'R12 layer names cannot be longer than 31 characters. Use DXF version "R2018" for longer names';
+const COLOR = "A layer color must be an AutoCAD Color Index integer from 1 to 255";
+const POSITIVE = "This value must be greater than 0";
+/** Returns what is wrong with a layer name for a DXF version, or undefined when it is valid. */
+export function layerNameProblem(name, version) {
+    if (name.length === 0)
+        return NAME_EMPTY;
+    if (/[<>/\\":;?*|=`^,]/.test(name) || hasControl(name) || hasAstral(name))
+        return NAME_CHARS;
+    if (name !== name.trim())
+        return NAME_EDGE;
+    if (name.length > 255)
+        return NAME_LENGTH;
+    if (version === "R12") {
+        if (!/^[A-Za-z0-9$_-]+$/.test(name))
+            return NAME_R12_CHARS;
+        if (name.length > 31)
+            return NAME_R12_LENGTH;
+    }
+    return undefined;
+}
+/** Returns what is wrong with a layer color, or undefined when it is valid. */
+export function layerColorProblem(color) {
+    return Number.isInteger(color) && color >= 1 && color <= 255 ? undefined : COLOR;
+}
+/** Returns what is wrong with a single-line text value, or undefined when it is valid. */
+export function textProblem(value) {
+    if (hasControl(value))
+        return "Text must be a single line with no control characters";
+    if (hasAstral(value)) {
+        return "Text cannot contain emoji or other characters above U+FFFF, because AutoCAD cannot read them from DXF";
+    }
+    return undefined;
+}
+function hasControl(value) {
+    for (let i = 0; i < value.length; i++) {
+        const code = value.charCodeAt(i);
+        if (code < 0x20 || code === 0x7f)
+            return true;
+    }
+    return false;
+}
+/** True when the string has a character above U+FFFF, which JavaScript stores as a surrogate pair. */
+function hasAstral(value) {
+    for (let i = 0; i < value.length; i++) {
+        const code = value.charCodeAt(i);
+        if (code >= 0xd800 && code <= 0xdfff)
+            return true;
+    }
+    return false;
+}

package/dist/svg.d.ts

@@ -0,0 +1,9 @@
+import { type Drawing } from "./drawing.ts";
+export interface SvgOptions {
+    /** Margin around the drawing's extents, in drawing units. Defaults to 2% of the larger side. */
+    readonly margin?: number;
+    /** Stroke width in screen pixels; it stays constant when the SVG scales. */
+    readonly strokeWidth?: number;
+}
+/** Renders a preview SVG. Model Y points up, so the drawing group flips Y. */
+export declare function toSVG(drawing: Drawing, options?: SvgOptions): string;

package/dist/svg.js

@@ -0,0 +1,70 @@
+import { sweep } from "./drawing.js";
+import { extents } from "./extents.js";
+import { fmt } from "./format.js";
+/** Screen colors for the standard ACI colors 1 to 7. Other indexes draw in currentColor. */
+const ACI = {
+    1: "#ff0000",
+    2: "#ffff00",
+    3: "#00ff00",
+    4: "#00ffff",
+    5: "#0000ff",
+    6: "#ff00ff",
+    7: "currentColor",
+};
+/** Renders a preview SVG. Model Y points up, so the drawing group flips Y. */
+export function toSVG(drawing, options = {}) {
+    const [minX, minY, maxX, maxY] = extents(drawing.entities);
+    const margin = options.margin ?? Math.max(maxX - minX, maxY - minY, 1) * 0.02;
+    const x = minX - margin;
+    const y = -(maxY + margin);
+    const w = maxX - minX + margin * 2;
+    const h = maxY - minY + margin * 2;
+    const colors = new Map(drawing.layers.map((l) => [l.name, ACI[l.color] ?? "currentColor"]));
+    const stroke = options.strokeWidth ?? 1;
+    const body = drawing.entities
+        .map((e) => entityToSvg(e, colors.get(e.layer) ?? "currentColor"))
+        .join("\n    ");
+    return [
+        `<svg xmlns="http://www.w3.org/2000/svg" viewBox="${fmt(x)} ${fmt(y)} ${fmt(w)} ${fmt(h)}">`,
+        `  <g transform="scale(1 -1)" fill="none" stroke-width="${fmt(stroke)}" vector-effect="non-scaling-stroke">`,
+        `    ${body}`,
+        `  </g>`,
+        `</svg>`,
+        ``,
+    ].join("\n");
+}
+function entityToSvg(e, color) {
+    const s = `stroke="${color}" vector-effect="non-scaling-stroke" data-layer="${esc(e.layer)}"`;
+    switch (e.kind) {
+        case "line":
+            return `<line x1="${fmt(e.from[0])}" y1="${fmt(e.from[1])}" x2="${fmt(e.to[0])}" y2="${fmt(e.to[1])}" ${s}/>`;
+        case "polyline": {
+            const tag = e.closed ? "polygon" : "polyline";
+            const points = e.points.map(([px, py]) => `${fmt(px)},${fmt(py)}`).join(" ");
+            return `<${tag} points="${points}" ${s}/>`;
+        }
+        case "circle":
+            return `<circle cx="${fmt(e.center[0])}" cy="${fmt(e.center[1])}" r="${fmt(e.radius)}" ${s}/>`;
+        case "arc": {
+            const [cx, cy] = e.center;
+            const a0 = rad(e.startAngle);
+            const a1 = rad(e.endAngle);
+            const large = sweep(e.startAngle, e.endAngle) > 180 ? 1 : 0;
+            const start = `${fmt(cx + e.radius * Math.cos(a0))} ${fmt(cy + e.radius * Math.sin(a0))}`;
+            const end = `${fmt(cx + e.radius * Math.cos(a1))} ${fmt(cy + e.radius * Math.sin(a1))}`;
+            // sweep-flag 1 is the positive-angle direction in local (Y-up) coordinates: counterclockwise.
+            return `<path d="M ${start} A ${fmt(e.radius)} ${fmt(e.radius)} 0 ${large} 1 ${end}" ${s}/>`;
+        }
+        case "text": {
+            // Undo the group's Y flip so the text reads upright, then apply CAD rotation.
+            const t = `translate(${fmt(e.at[0])} ${fmt(e.at[1])}) scale(1 -1)${e.rotation ? ` rotate(${fmt(-e.rotation)})` : ""}`;
+            return `<text transform="${t}" font-size="${fmt(e.height)}" font-family="monospace" fill="${color}" stroke="none" data-layer="${esc(e.layer)}">${esc(e.value)}</text>`;
+        }
+    }
+}
+function rad(degrees) {
+    return (degrees * Math.PI) / 180;
+}
+function esc(value) {
+    return value.replace(/[&<>"]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" })[c] ?? c);
+}

package/package.json

@@ -1,6 +1,63 @@
 {
   "name": "tsdraft",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "2D CAD drawings as TypeScript: write the drawing in code, export DXF and SVG.",
+  "keywords": [
+    "2d",
+    "autocad",
+    "bricscad",
+    "cad",
+    "drafting",
+    "drawing",
+    "dxf"
+  ],
+  "homepage": "https://github.com/Surfside-Software/tsdraft#readme",
+  "bugs": {
+    "url": "https://github.com/Surfside-Software/tsdraft/issues"
+  },
+  "license": "MIT",
+  "author": "Stephen Frederick",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Surfside-Software/tsdraft.git"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "pnpm clean && tsc -p tsconfig.build.json",
+    "prepack": "pnpm build",
+    "check": "tsc --noEmit",
+    "check:tsrs": "tsrs --noEmit",
+    "lint": "oxlint",
+    "fmt": "oxfmt",
+    "fmt:check": "oxfmt --check",
+    "test": "node --test test/*.test.ts",
+    "test:package": "node scripts/package-smoke.ts",
+    "test:cad": "node scripts/cad-check.ts",
+    "example": "node examples/site-plan.ts",
+    "verify": "pnpm fmt:check && pnpm lint && pnpm check && pnpm test && pnpm test:package"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "oxfmt": "0.77.0",
+    "oxlint": "1.92.0",
+    "tsrs": "0.23.0-ts7.1.0-beta",
+    "typescript": "7.0.2"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "packageManager": "pnpm@12.11.2"
+}