circuitscript 0.5.5 → 0.5.7

package/README.md

@@ -1,3 +1,106 @@
-# circuitscript
+# Circuitscript
 
-CLI tool for the [circuitscript language](https://circuitscript.net)
+A code-based language for creating electronic schematics. Instead of clicking through GUI tools, you write Circuitscript to describe circuits — and get SVG/PDF schematics and KiCAD-compatible netlists as output.
+
+**Homepage:** https://circuitscript.net
+
+---
+
+## Features
+
+- **Code-first design** — capture schematics using a simple scripting language
+- **Version control friendly** — plain text files work naturally with git
+- **SVG and PDF output** — high-quality schematic diagrams
+- **KiCAD netlist export** — use generated netlists directly in KiCAD layout
+- **Bill of Materials** — export BOM as CSV
+- **Programmatic constructs** — loops, functions, conditionals, and modules for reusable circuit blocks
+- **Standard library of components** — resistors, capacitors, inductors, LEDs, etc.
+- **Custom components** — define components with arbitrary pin layouts and graphics
+- **ERC** — basic electrical rules check (more to be added)
+
+---
+
+## Installation
+
+Requires Node.js 16 or later.
+
+```bash
+npm install -g circuitscript
+```
+
+Or install locally as a library:
+
+```bash
+npm install circuitscript
+```
+
+---
+
+## Quick Start
+
+Create a file `circuit.cst`:
+
+```
+from "std" import *
+
+v5 = supply("5V")
+gnd = dgnd()
+
+at v5
+wire down 100
+add res(100k)
+wire down 100
+to gnd
+
+at v5
+wire down 100
+add cap(100n)
+wire down 100
+to gnd
+```
+
+Generate a schematic:
+
+```bash
+circuitscript circuit.cst output.svg
+```
+
+---
+
+## CLI Usage
+
+```
+circuitscript [input path] [output path] [options]
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `-w, --watch` | Watch for file changes and regenerate |
+| `-u, --update-source` | Update source file with reference designator annotation |
+| `-j, --annotated-path [file]` | Save annotated source file at given path |
+| `-n, --dump-nets` | Print net information |
+| `-d, --dump-data` | Dump data during parsing |
+| `-s, --stats` | Show stats during generation |
+| `-x, --skip-output` | Skip output generation |
+| `-e, --erc` | Enable ERC output |
+| `-b, --bom [output-path]` | Generate Bill of Materials as CSV |
+| `-i, --input text <text>` | Provide input text directly instead of a file |
+| `--version` | Show version |
+
+### Examples
+
+```bash
+# Generate SVG
+circuitscript schematic.cst schematic.svg
+
+# Generate PDF
+circuitscript schematic.cst schematic.pdf
+
+# Generate BOM
+circuitscript schematic.cst schematic.svg --bom bom.csv
+
+# Print to stdout
+circuitscript schematic.cst
+```

package/dist/cjs/execute.js

@@ -374,6 +374,7 @@ class ExecutionContext {
         this.applyComponentAngleFromWire(component, pinId);
         this.scope.setCurrent(component, pinId);
         this.scope.clearActive();
+        this.log('clear active wire/frame (to component)');
         if (addSequence) {
             if (this.scope.sequence.length > 0) {
                 const [entryType, , segments] = this.scope.sequence[this.scope.sequence.length - 1];
@@ -410,6 +411,7 @@ class ExecutionContext {
             this.scope.setNet(component, usePinId, tmpNet);
         }
         this.scope.clearActive();
+        this.log('clear active wire/frame (at component)');
         if (addSequence) {
             this.scope.sequence.push([ExecutionScope_js_1.SequenceAction.At,
                 component, usePinId]);
@@ -448,8 +450,12 @@ class ExecutionContext {
             || blockType === BlockTypes_js_1.BlockTypes.Parallel
             || blockType === BlockTypes_js_1.BlockTypes.Branch) {
             const key = (0, utils_js_1.getBlockTypeString)(blockType);
+            const wireIdBefore = this.scope.currentWireId;
             this.addPoint(`${globals_js_1.Delimiter1}${key}.${this.name}.${this.tmpPointId}`, false);
             this.tmpPointId += 1;
+            if (wireIdBefore !== -1) {
+                this.scope.currentWireId = wireIdBefore;
+            }
         }
         this.scope.blockStack.set(this.scope.scopeLevel, {
             start_point: [

package/dist/cjs/index.js

@@ -31,6 +31,7 @@ __exportStar(require("./parser.js"), exports);
 __exportStar(require("./utils.js"), exports);
 __exportStar(require("./visitor.js"), exports);
 __exportStar(require("./sizing.js"), exports);
+__exportStar(require("./errors.js"), exports);
 __exportStar(require("./objects/types.js"), exports);
 __exportStar(require("./builtinMethods.js"), exports);
 __exportStar(require("./validate/SymbolTable.js"), exports);

package/dist/cjs/regenerate-tests.js

@@ -9,13 +9,15 @@ const environment_js_1 = require("./environment/environment.js");
 const mainDir = './__tests__/testData/renderData/';
 const env = new environment_js_1.NodeScriptEnvironment();
 environment_js_1.NodeScriptEnvironment.setInstance(env);
-async function regenerateTests(extra = "") {
+async function regenerateTests(extra = "", fileList = []) {
     await env.prepareSVGEnvironment();
     const cstFiles = [];
     const files = fs_1.default.readdirSync(mainDir);
     files.forEach(file => {
         if (file.endsWith('.cst') && file.startsWith('script')) {
-            cstFiles.push(file);
+            if (fileList.length === 0 || fileList.includes(file)) {
+                cstFiles.push(file);
+            }
         }
     });
     for (let i = 0; i < cstFiles.length; i++) {
@@ -38,8 +40,15 @@ async function regenerateTests(extra = "") {
 (async () => {
     const generateDiff = (process.argv.indexOf('-diff') !== -1);
     console.log('diff flag: ', generateDiff);
+    const listIndex = process.argv.indexOf('--list');
+    const fileList = listIndex !== -1 && process.argv[listIndex + 1]
+        ? process.argv[listIndex + 1].split(',').map(f => f.trim())
+        : [];
+    if (fileList.length > 0) {
+        console.log('filtering to files: ', fileList);
+    }
     const nextExtra = generateDiff ? '.next' : '';
-    const cstFiles = await regenerateTests(nextExtra);
+    const cstFiles = await regenerateTests(nextExtra, fileList);
     const allFiles = [];
     if (generateDiff) {
         cstFiles.forEach(file => {

package/dist/esm/execute.js

@@ -379,6 +379,7 @@ export class ExecutionContext {
         this.applyComponentAngleFromWire(component, pinId);
         this.scope.setCurrent(component, pinId);
         this.scope.clearActive();
+        this.log('clear active wire/frame (to component)');
         if (addSequence) {
             if (this.scope.sequence.length > 0) {
                 const [entryType, , segments] = this.scope.sequence[this.scope.sequence.length - 1];
@@ -415,6 +416,7 @@ export class ExecutionContext {
             this.scope.setNet(component, usePinId, tmpNet);
         }
         this.scope.clearActive();
+        this.log('clear active wire/frame (at component)');
         if (addSequence) {
             this.scope.sequence.push([SequenceAction.At,
                 component, usePinId]);
@@ -453,8 +455,12 @@ export class ExecutionContext {
             || blockType === BlockTypes.Parallel
             || blockType === BlockTypes.Branch) {
             const key = getBlockTypeString(blockType);
+            const wireIdBefore = this.scope.currentWireId;
             this.addPoint(`${Delimiter1}${key}.${this.name}.${this.tmpPointId}`, false);
             this.tmpPointId += 1;
+            if (wireIdBefore !== -1) {
+                this.scope.currentWireId = wireIdBefore;
+            }
         }
         this.scope.blockStack.set(this.scope.scopeLevel, {
             start_point: [

package/dist/esm/index.js

@@ -15,6 +15,7 @@ export * from './parser.js';
 export * from './utils.js';
 export * from './visitor.js';
 export * from './sizing.js';
+export * from './errors.js';
 export * from './objects/types.js';
 export * from './builtinMethods.js';
 export * from './validate/SymbolTable.js';

package/dist/esm/regenerate-tests.js

@@ -4,13 +4,15 @@ import { NodeScriptEnvironment } from "./environment/environment.js";
 const mainDir = './__tests__/testData/renderData/';
 const env = new NodeScriptEnvironment();
 NodeScriptEnvironment.setInstance(env);
-async function regenerateTests(extra = "") {
+async function regenerateTests(extra = "", fileList = []) {
     await env.prepareSVGEnvironment();
     const cstFiles = [];
     const files = fs.readdirSync(mainDir);
     files.forEach(file => {
         if (file.endsWith('.cst') && file.startsWith('script')) {
-            cstFiles.push(file);
+            if (fileList.length === 0 || fileList.includes(file)) {
+                cstFiles.push(file);
+            }
         }
     });
     for (let i = 0; i < cstFiles.length; i++) {
@@ -33,8 +35,15 @@ async function regenerateTests(extra = "") {
 (async () => {
     const generateDiff = (process.argv.indexOf('-diff') !== -1);
     console.log('diff flag: ', generateDiff);
+    const listIndex = process.argv.indexOf('--list');
+    const fileList = listIndex !== -1 && process.argv[listIndex + 1]
+        ? process.argv[listIndex + 1].split(',').map(f => f.trim())
+        : [];
+    if (fileList.length > 0) {
+        console.log('filtering to files: ', fileList);
+    }
     const nextExtra = generateDiff ? '.next' : '';
-    const cstFiles = await regenerateTests(nextExtra);
+    const cstFiles = await regenerateTests(nextExtra, fileList);
     const allFiles = [];
     if (generateDiff) {
         cstFiles.forEach(file => {

package/dist/types/index.d.ts

@@ -15,6 +15,7 @@ export * from './parser.js';
 export * from './utils.js';
 export * from './visitor.js';
 export * from './sizing.js';
+export * from './errors.js';
 export * from './objects/types.js';
 export * from './builtinMethods.js';
 export * from './validate/SymbolTable.js';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "circuitscript",
-    "version": "0.5.5",
+    "version": "0.5.7",
     "description": "Interpreter for the circuitscript language",
     "homepage": "https://circuitscript.net",
     "engines": {
@@ -24,12 +24,14 @@
         "libs"
     ],
     "devDependencies": {
+        "@resvg/resvg-js": "^2.6.2",
         "@types/big.js": "^6.2.2",
         "@types/crypto-js": "^4.2.2",
         "@types/figlet": "^1.5.8",
         "@types/jest": "~29.5",
         "@types/node": "~18",
         "@types/pdfkit": "^0.13.6",
+        "@types/pngjs": "^6.0.5",
         "@types/svg-to-pdfkit": "^0.1.3",
         "@types/svgdom": "^0.1.2",
         "@typescript-eslint/eslint-plugin": "~5.59",
@@ -39,6 +41,9 @@
         "eslint-config-prettier": "~8.8",
         "eslint-plugin-jest": "~27.2",
         "jest": "~29.5",
+        "license-check-and-add": "^4.0.5",
+        "pixelmatch": "^7.1.0",
+        "pngjs": "^7.0.0",
         "prettier": "~2.8",
         "rimraf": "~5.0",
         "source-map-support": "^0.5.21",
@@ -76,7 +81,9 @@
         "changelog": "auto-changelog --handlebars-setup ../changelog/helper.js -p",
         "preversion": "npm run test",
         "version": "npm run changelog && git add CHANGELOG.md",
-        "copy-assets": "mkdir -p dist/fonts && mkdir -p dist/libs && cp -r fonts dist/ && cp -r libs dist/"
+        "copy-assets": "mkdir -p dist/fonts && mkdir -p dist/libs && cp -r fonts dist/ && cp -r libs dist/",
+        "license:check": "license-check-and-add check -f licensecheck.json",
+        "license:add": "license-check-and-add add -f licensecheck.json"
     },
     "boilerplate_author": "Jakub Synowiec <jsynowiec@users.noreply.github.com>",
     "license": "MIT",