npm - kicadts - Versions diffs - 0.0.2 → 0.0.4 - Mend

kicadts 0.0.2 → 0.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (195) hide show

package/dist/index.d.ts +4466 -0
package/dist/index.js +14253 -0
package/package.json +5 -2
package/.cursor/rules/use-bun-instead-of-node-vite-npm-pnpm.mdc +0 -111
package/.github/workflows/bun-formatcheck.yml +0 -26
package/.github/workflows/bun-pver-release.yml +0 -70
package/.github/workflows/bun-test.yml +0 -32
package/.github/workflows/bun-typecheck.yml +0 -26
package/.vscode/settings.json +0 -16
package/AGENTS.md +0 -31
package/TODO.md +0 -46
package/biome.json +0 -93
package/bunfig.toml +0 -5
package/lib/index.ts +0 -1
package/lib/sexpr/base-classes/SxClass.ts +0 -164
package/lib/sexpr/base-classes/SxPrimitiveBoolean.ts +0 -35
package/lib/sexpr/base-classes/SxPrimitiveNumber.ts +0 -26
package/lib/sexpr/base-classes/SxPrimitiveString.ts +0 -26
package/lib/sexpr/classes/At.ts +0 -53
package/lib/sexpr/classes/Bus.ts +0 -103
package/lib/sexpr/classes/BusEntry.ts +0 -169
package/lib/sexpr/classes/Color.ts +0 -29
package/lib/sexpr/classes/Dnp.ts +0 -8
package/lib/sexpr/classes/EmbeddedFonts.ts +0 -68
package/lib/sexpr/classes/ExcludeFromSim.ts +0 -8
package/lib/sexpr/classes/FieldsAutoplaced.ts +0 -8
package/lib/sexpr/classes/Footprint.ts +0 -849
package/lib/sexpr/classes/FootprintAttr.ts +0 -104
package/lib/sexpr/classes/FootprintAutoplaceCost180.ts +0 -9
package/lib/sexpr/classes/FootprintAutoplaceCost90.ts +0 -9
package/lib/sexpr/classes/FootprintClearance.ts +0 -9
package/lib/sexpr/classes/FootprintDescr.ts +0 -44
package/lib/sexpr/classes/FootprintLocked.ts +0 -32
package/lib/sexpr/classes/FootprintModel.ts +0 -142
package/lib/sexpr/classes/FootprintNetTiePadGroups.ts +0 -52
package/lib/sexpr/classes/FootprintPad.ts +0 -857
package/lib/sexpr/classes/FootprintPath.ts +0 -44
package/lib/sexpr/classes/FootprintPlaced.ts +0 -32
package/lib/sexpr/classes/FootprintPrivateLayers.ts +0 -56
package/lib/sexpr/classes/FootprintSheetfile.ts +0 -44
package/lib/sexpr/classes/FootprintSheetname.ts +0 -44
package/lib/sexpr/classes/FootprintSolderMaskMargin.ts +0 -9
package/lib/sexpr/classes/FootprintSolderPasteMargin.ts +0 -9
package/lib/sexpr/classes/FootprintSolderPasteRatio.ts +0 -9
package/lib/sexpr/classes/FootprintTags.ts +0 -44
package/lib/sexpr/classes/FootprintTedit.ts +0 -21
package/lib/sexpr/classes/FootprintThermalGap.ts +0 -9
package/lib/sexpr/classes/FootprintThermalWidth.ts +0 -9
package/lib/sexpr/classes/FootprintZoneConnect.ts +0 -9
package/lib/sexpr/classes/FpArc.ts +0 -312
package/lib/sexpr/classes/FpCircle.ts +0 -314
package/lib/sexpr/classes/FpLine.ts +0 -316
package/lib/sexpr/classes/FpPoly.ts +0 -286
package/lib/sexpr/classes/FpPolyFill.ts +0 -48
package/lib/sexpr/classes/FpPolyLocked.ts +0 -40
package/lib/sexpr/classes/FpRect.ts +0 -314
package/lib/sexpr/classes/FpText.ts +0 -375
package/lib/sexpr/classes/FpTextBox.ts +0 -450
package/lib/sexpr/classes/GrLine.ts +0 -264
package/lib/sexpr/classes/GrLineAngle.ts +0 -32
package/lib/sexpr/classes/GrLineEnd.ts +0 -61
package/lib/sexpr/classes/GrLineLocked.ts +0 -40
package/lib/sexpr/classes/GrLineStart.ts +0 -61
package/lib/sexpr/classes/GrText.ts +0 -228
package/lib/sexpr/classes/Image.ts +0 -283
package/lib/sexpr/classes/InBom.ts +0 -8
package/lib/sexpr/classes/Junction.ts +0 -166
package/lib/sexpr/classes/KicadPcb.ts +0 -361
package/lib/sexpr/classes/KicadSch.ts +0 -397
package/lib/sexpr/classes/KicadSchGenerator.ts +0 -32
package/lib/sexpr/classes/KicadSchGeneratorVersion.ts +0 -30
package/lib/sexpr/classes/KicadSchVersion.ts +0 -22
package/lib/sexpr/classes/Label.ts +0 -176
package/lib/sexpr/classes/Layer.ts +0 -51
package/lib/sexpr/classes/Layers.ts +0 -47
package/lib/sexpr/classes/LibSymbols.ts +0 -61
package/lib/sexpr/classes/NoConnect.ts +0 -90
package/lib/sexpr/classes/OnBoard.ts +0 -8
package/lib/sexpr/classes/PadChamfer.ts +0 -50
package/lib/sexpr/classes/PadChamferRatio.ts +0 -9
package/lib/sexpr/classes/PadClearance.ts +0 -9
package/lib/sexpr/classes/PadDieLength.ts +0 -9
package/lib/sexpr/classes/PadDrill.ts +0 -145
package/lib/sexpr/classes/PadDrillOffset.ts +0 -54
package/lib/sexpr/classes/PadLayers.ts +0 -71
package/lib/sexpr/classes/PadNet.ts +0 -56
package/lib/sexpr/classes/PadOptions.ts +0 -181
package/lib/sexpr/classes/PadPinFunction.ts +0 -9
package/lib/sexpr/classes/PadPinType.ts +0 -9
package/lib/sexpr/classes/PadPrimitiveGrArc.ts +0 -272
package/lib/sexpr/classes/PadPrimitiveGrCircle.ts +0 -298
package/lib/sexpr/classes/PadPrimitiveGrLine.ts +0 -126
package/lib/sexpr/classes/PadPrimitives.ts +0 -291
package/lib/sexpr/classes/PadRectDelta.ts +0 -57
package/lib/sexpr/classes/PadRoundrectRratio.ts +0 -9
package/lib/sexpr/classes/PadSize.ts +0 -69
package/lib/sexpr/classes/PadSolderMaskMargin.ts +0 -9
package/lib/sexpr/classes/PadSolderPasteMargin.ts +0 -9
package/lib/sexpr/classes/PadSolderPasteMarginRatio.ts +0 -9
package/lib/sexpr/classes/PadTeardrops.ts +0 -210
package/lib/sexpr/classes/PadThermalBridgeAngle.ts +0 -9
package/lib/sexpr/classes/PadThermalGap.ts +0 -9
package/lib/sexpr/classes/PadThermalWidth.ts +0 -9
package/lib/sexpr/classes/PadZoneConnect.ts +0 -9
package/lib/sexpr/classes/Paper.ts +0 -119
package/lib/sexpr/classes/PcbGeneral.ts +0 -82
package/lib/sexpr/classes/PcbGeneralLegacyTeardrops.ts +0 -44
package/lib/sexpr/classes/PcbGeneralThickness.ts +0 -9
package/lib/sexpr/classes/PcbGenerator.ts +0 -16
package/lib/sexpr/classes/PcbGeneratorVersion.ts +0 -16
package/lib/sexpr/classes/PcbLayerDefinition.ts +0 -106
package/lib/sexpr/classes/PcbLayers.ts +0 -34
package/lib/sexpr/classes/PcbNet.ts +0 -56
package/lib/sexpr/classes/PcbVersion.ts +0 -9
package/lib/sexpr/classes/Property.ts +0 -301
package/lib/sexpr/classes/PropertyHide.ts +0 -9
package/lib/sexpr/classes/PropertyUnlocked.ts +0 -9
package/lib/sexpr/classes/Pts.ts +0 -67
package/lib/sexpr/classes/RenderCache.ts +0 -221
package/lib/sexpr/classes/SchematicText.ts +0 -171
package/lib/sexpr/classes/Segment.ts +0 -243
package/lib/sexpr/classes/SegmentEnd.ts +0 -59
package/lib/sexpr/classes/SegmentLocked.ts +0 -33
package/lib/sexpr/classes/SegmentNet.ts +0 -64
package/lib/sexpr/classes/SegmentStart.ts +0 -59
package/lib/sexpr/classes/Setup/PcbPlotParams.ts +0 -689
package/lib/sexpr/classes/Setup/PcbPlotParamsBase.ts +0 -9
package/lib/sexpr/classes/Setup/PcbPlotParamsNumericProperties.ts +0 -105
package/lib/sexpr/classes/Setup/PcbPlotParamsStringPropertiesA.ts +0 -104
package/lib/sexpr/classes/Setup/PcbPlotParamsStringPropertiesB.ts +0 -105
package/lib/sexpr/classes/Setup/Setup.ts +0 -574
package/lib/sexpr/classes/Setup/SetupPropertyTypes.ts +0 -119
package/lib/sexpr/classes/Setup/Stackup.ts +0 -135
package/lib/sexpr/classes/Setup/StackupLayer.ts +0 -233
package/lib/sexpr/classes/Setup/StackupLayerProperties.ts +0 -80
package/lib/sexpr/classes/Setup/StackupProperties.ts +0 -40
package/lib/sexpr/classes/Setup/base.ts +0 -165
package/lib/sexpr/classes/Setup/index.ts +0 -14
package/lib/sexpr/classes/Setup/setupMultiValueProperties.ts +0 -53
package/lib/sexpr/classes/Setup/setupNumericProperties.ts +0 -151
package/lib/sexpr/classes/Setup/setupPropertyHandlers.ts +0 -90
package/lib/sexpr/classes/Setup/setupStringProperties.ts +0 -75
package/lib/sexpr/classes/Sheet.ts +0 -287
package/lib/sexpr/classes/SheetFill.ts +0 -44
package/lib/sexpr/classes/SheetInstances.ts +0 -168
package/lib/sexpr/classes/SheetInstancesRoot.ts +0 -165
package/lib/sexpr/classes/SheetPin.ts +0 -125
package/lib/sexpr/classes/SheetProperty.ts +0 -115
package/lib/sexpr/classes/SheetSize.ts +0 -44
package/lib/sexpr/classes/Stroke.ts +0 -58
package/lib/sexpr/classes/StrokeType.ts +0 -34
package/lib/sexpr/classes/Symbol.ts +0 -1666
package/lib/sexpr/classes/TextEffects.ts +0 -461
package/lib/sexpr/classes/TitleBlock.ts +0 -369
package/lib/sexpr/classes/Unit.ts +0 -28
package/lib/sexpr/classes/Uuid.ts +0 -8
package/lib/sexpr/classes/Via.ts +0 -363
package/lib/sexpr/classes/ViaNet.ts +0 -60
package/lib/sexpr/classes/Width.ts +0 -8
package/lib/sexpr/classes/Wire.ts +0 -111
package/lib/sexpr/classes/Xy.ts +0 -33
package/lib/sexpr/classes/Zone.ts +0 -39
package/lib/sexpr/index.ts +0 -130
package/lib/sexpr/parseKicadSexpr.ts +0 -5
package/lib/sexpr/parseToPrimitiveSExpr.ts +0 -245
package/lib/sexpr/utils/indentLines.ts +0 -3
package/lib/sexpr/utils/parseYesNo.ts +0 -12
package/lib/sexpr/utils/quoteSExprString.ts +0 -8
package/lib/sexpr/utils/strokeFromArgs.ts +0 -18
package/lib/sexpr/utils/toNumberValue.ts +0 -13
package/lib/sexpr/utils/toStringValue.ts +0 -11
package/scripts/download-references.ts +0 -68
package/tests/fixtures/expectEqualPrimitiveSExpr.ts +0 -199
package/tests/fixtures/png-matcher.ts +0 -109
package/tests/fixtures/preload.ts +0 -1
package/tests/sexpr/KicadPcbDemos.test.ts +0 -48
package/tests/sexpr/KicadSchDemos.test.ts +0 -49
package/tests/sexpr/classes/Footprint.test.ts +0 -277
package/tests/sexpr/classes/FootprintPad.test.ts +0 -78
package/tests/sexpr/classes/FpArc.test.ts +0 -45
package/tests/sexpr/classes/FpCircle.test.ts +0 -39
package/tests/sexpr/classes/FpPoly.test.ts +0 -43
package/tests/sexpr/classes/FpRect.test.ts +0 -40
package/tests/sexpr/classes/FpTextBox.test.ts +0 -84
package/tests/sexpr/classes/Image.test.ts +0 -58
package/tests/sexpr/classes/KicadSch.test.ts +0 -95
package/tests/sexpr/classes/Paper.test.ts +0 -30
package/tests/sexpr/classes/Property.test.ts +0 -48
package/tests/sexpr/classes/Setup.test.ts +0 -188
package/tests/sexpr/classes/Sheet.test.ts +0 -107
package/tests/sexpr/classes/Stroke.test.ts +0 -15
package/tests/sexpr/classes/Symbol.test.ts +0 -96
package/tests/sexpr/classes/TextEffects.test.ts +0 -56
package/tests/sexpr/classes/TitleBlock.test.ts +0 -40
package/tsconfig.json +0 -35

package/package.json CHANGED Viewed

@@ -1,16 +1,19 @@
 {
   "name": "kicadts",
   "module": "dist/index.js",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "type": "module",
   "repository": {
     "type": "git",
     "url": "https://github.com/tscircuit/kicadts"
   },
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsup-node lib/index.ts --format esm --dts",
     "download-references": "bun run scripts/download-references.ts",
-    "download-demos": "git clone --depth 1 --filter=blob:none --sparse git@gitlab.com:kicad/code/kicad.git kicad-demos && cd kicad-demos && git sparse-checkout set demos",
+    "download-demos": "git clone --depth 1 --filter=blob:none --sparse https://gitlab.com/kicad/code/kicad.git kicad-demos && cd kicad-demos && git sparse-checkout set demos",
     "typecheck": "bunx tsc --noEmit",
     "format": "biome format --write .",
     "format:check": "biome format ."

package/.cursor/rules/use-bun-instead-of-node-vite-npm-pnpm.mdc DELETED Viewed

@@ -1,111 +0,0 @@
----
-description: Use Bun instead of Node.js, npm, pnpm, or vite.
-globs: "*.ts, *.tsx, *.html, *.css, *.js, *.jsx, package.json"
-alwaysApply: false
----
-Default to using Bun instead of Node.js.
-- Use `bun <file>` instead of `node <file>` or `ts-node <file>`
-- Use `bun test` instead of `jest` or `vitest`
-- Use `bun build <file.html|file.ts|file.css>` instead of `webpack` or `esbuild`
-- Use `bun install` instead of `npm install` or `yarn install` or `pnpm install`
-- Use `bun run <script>` instead of `npm run <script>` or `yarn run <script>` or `pnpm run <script>`
-- Bun automatically loads .env, so don't use dotenv.
-## APIs
-- `Bun.serve()` supports WebSockets, HTTPS, and routes. Don't use `express`.
-- `bun:sqlite` for SQLite. Don't use `better-sqlite3`.
-- `Bun.redis` for Redis. Don't use `ioredis`.
-- `Bun.sql` for Postgres. Don't use `pg` or `postgres.js`.
-- `WebSocket` is built-in. Don't use `ws`.
-- Prefer `Bun.file` over `node:fs`'s readFile/writeFile
-- Bun.$`ls` instead of execa.
-## Testing
-Use `bun test` to run tests.
-```ts#index.test.ts
-import { test, expect } from "bun:test";
-test("hello world", () => {
-  expect(1).toBe(1);
-});
-```
-## Frontend
-Use HTML imports with `Bun.serve()`. Don't use `vite`. HTML imports fully support React, CSS, Tailwind.
-Server:
-```ts#index.ts
-import index from "./index.html"
-Bun.serve({
-  routes: {
-    "/": index,
-    "/api/users/:id": {
-      GET: (req) => {
-        return new Response(JSON.stringify({ id: req.params.id }));
-      },
-    },
-  },
-  // optional websocket support
-  websocket: {
-    open: (ws) => {
-      ws.send("Hello, world!");
-    },
-    message: (ws, message) => {
-      ws.send(message);
-    },
-    close: (ws) => {
-      // handle close
-    }
-  },
-  development: {
-    hmr: true,
-    console: true,
-  }
-})
-```
-HTML files can import .tsx, .jsx or .js files directly and Bun's bundler will transpile & bundle automatically. `<link>` tags can point to stylesheets and Bun's CSS bundler will bundle.
-```html#index.html
-<html>
-  <body>
-    <h1>Hello, world!</h1>
-    <script type="module" src="./frontend.tsx"></script>
-  </body>
-</html>
-```
-With the following `frontend.tsx`:
-```tsx#frontend.tsx
-import React from "react";
-// import .css files directly and it works
-import './index.css';
-import { createRoot } from "react-dom/client";
-const root = createRoot(document.body);
-export default function Frontend() {
-  return <h1>Hello, world!</h1>;
-}
-root.render(<Frontend />);
-```
-Then, run index.ts
-```sh
-bun --hot ./index.ts
-```
-For more information, read the Bun API docs in `node_modules/bun-types/docs/**.md`.

package/.github/workflows/bun-formatcheck.yml DELETED Viewed

@@ -1,26 +0,0 @@
-# Created using @tscircuit/plop (npm install -g @tscircuit/plop)
-name: Format Check
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-jobs:
-  format-check:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Setup bun
-        uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-      - name: Install dependencies
-        run: bun install
-      - name: Run format check
-        run: bun run format:check

package/.github/workflows/bun-pver-release.yml DELETED Viewed

@@ -1,70 +0,0 @@
-# Created using @tscircuit/plop (npm install -g @tscircuit/plop)
-name: Publish to npm
-on:
-  push:
-    branches:
-      - main
-  workflow_dispatch:
-env:
-  UPSTREAM_REPOS: "" # comma-separated list, e.g. "eval,tscircuit,docs"
-  UPSTREAM_PACKAGES_TO_UPDATE: "" # comma-separated list, e.g. "@tscircuit/core,@tscircuit/protos"
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          token: ${{ secrets.TSCIRCUIT_BOT_GITHUB_TOKEN }}
-      - name: Setup bun
-        uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-      - uses: actions/setup-node@v3
-        with:
-          node-version: 20
-          registry-url: https://registry.npmjs.org/
-      - run: npm install -g pver
-      - run: bun install --frozen-lockfile
-      - run: bun run build
-      - run: pver release
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-          GITHUB_TOKEN: ${{ secrets.TSCIRCUIT_BOT_GITHUB_TOKEN }}
-      # - name: Create Pull Request
-      #   id: create-pr
-      #   uses: peter-evans/create-pull-request@v5
-      #   with:
-      #     commit-message: "chore: bump version"
-      #     title: "chore: bump version"
-      #     body: "Automated package update"
-      #     branch: bump-version-${{ github.run_number }}
-      #     base: main
-      #     token: ${{ secrets.TSCIRCUIT_BOT_GITHUB_TOKEN }}
-      #     committer: tscircuitbot <githubbot@tscircuit.com>
-      #     author: tscircuitbot <githubbot@tscircuit.com>
-      # - name: Enable auto-merge
-      #   if: steps.create-pr.outputs.pull-request-number != ''
-      #   run: |
-      #     gh pr merge ${{ steps.create-pr.outputs.pull-request-number }} --rebase --delete-branch
-      #   env:
-      #     GH_TOKEN: ${{ secrets.TSCIRCUIT_BOT_GITHUB_TOKEN }}
-      # - name: Trigger upstream repo updates
-      #   if: env.UPSTREAM_REPOS && env.UPSTREAM_PACKAGES_TO_UPDATE
-      #   run: |
-      #     IFS=',' read -ra REPOS <<< "${{ env.UPSTREAM_REPOS }}"
-      #     for repo in "${REPOS[@]}"; do
-      #       if [[ -n "$repo" ]]; then
-      #         echo "Triggering update for repo: $repo"
-      #         curl -X POST \
-      #           -H "Accept: application/vnd.github.v3+json" \
-      #           -H "Authorization: token ${{ secrets.TSCIRCUIT_BOT_GITHUB_TOKEN }}" \
-      #           -H "Content-Type: application/json" \
-      #           "https://api.github.com/repos/tscircuit/$repo/actions/workflows/update-package.yml/dispatches" \
-      #           -d "{\"ref\":\"main\",\"inputs\":{\"package_names\":\"${{ env.UPSTREAM_PACKAGES_TO_UPDATE }}\"}}"
-      #       fi
-      #     done

package/.github/workflows/bun-test.yml DELETED Viewed

@@ -1,32 +0,0 @@
-# Created using @tscircuit/plop (npm install -g @tscircuit/plop)
-name: Bun Test
-on:
-  pull_request:
-  push:
-    branches:
-      - main
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    timeout-minutes: 5
-    # Skip test for PRs that not chore: bump version
-    if: "${{ github.event_name != 'pull_request' || github.event.pull_request.title != 'chore: bump version' }}"
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-      - name: Setup bun
-        uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-      - name: Install dependencies
-        run: bun install
-      - run: bun run download-demos
-      - name: Run tests
-        run: bun test

package/.github/workflows/bun-typecheck.yml DELETED Viewed

@@ -1,26 +0,0 @@
-# Created using @tscircuit/plop (npm install -g @tscircuit/plop)
-name: Type Check
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-jobs:
-  type-check:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Setup bun
-        uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-      - name: Install dependencies
-        run: bun i
-      - name: Run type check
-        run: bunx tsc --noEmit

package/.vscode/settings.json DELETED Viewed

@@ -1,16 +0,0 @@
-{
-  "workbench.colorCustomizations": {
-    "commandCenter.border": "#15202b99",
-    "sash.hoverBorder": "#18f7e8",
-    "statusBar.background": "#07d5c7",
-    "statusBar.foreground": "#15202b",
-    "statusBarItem.hoverBackground": "#05a499",
-    "statusBarItem.remoteBackground": "#07d5c7",
-    "statusBarItem.remoteForeground": "#15202b",
-    "titleBar.activeBackground": "#07d5c7",
-    "titleBar.activeForeground": "#15202b",
-    "titleBar.inactiveBackground": "#07d5c799",
-    "titleBar.inactiveForeground": "#15202b99"
-  },
-  "peacock.color": "#07d5c7"
-}

package/AGENTS.md DELETED Viewed

@@ -1,31 +0,0 @@
-This is the `kicadts` typescript library. It's still in early developement and
-we're trying to make sure we parse the entire KiCad S-expression specification.
-You can find the difference specifications in the `references` directory, the
-most extensive one is `references/SEXPR_MAIN.adoc` (use `bun run scripts/download-references.ts` to download if it's not already there)
-- `references/SCHEMATIC_SEXPR.adoc`
-- `references/PCB_SEXPR.adoc`
-- `references/FOOTPRINT_SEXPR.adoc`
-- `references/SCH_SYM_SEXPR.adoc`
-- `references/SEXPR_MAIN.adoc`
-### Tips
-- Every S-expression token must have a corresponding `SxClass` subclass and be registered via `SxClass.register`; missing registrations cause parse failures.
-- Tokens reused under different parents (for example `type` under `stroke`) require `static parentToken` overrides so the correct class resolves during parsing.
-- When a class accepts unordered child tokens, set `_propertyMap` using `loadProperties` to make getters convenient and keep `getString()` deterministic.
-- Snapshot tests with `bun test` provide quick verification that `getString()` matches the KiCad formatting expectations.
-### Major Refactor Notice
-- The code in this repo is only partially migrated to the new pattern
-- NEW PATTERN: Constructors never take `PrimitiveSExpr` arguments
-- NEW PATTERN: All classes have a `fromSexprPrimitives` static method that takes a `PrimitiveSExpr` array and returns an instance of the class
-- NEW PATTERN: Classes have ergonomic getters and setters for properties
-- NEW PATTERN: Never has "extras" property, everything becomes an `SxClass`
-- NEW PATTERN: Never have "switch cases" that switch on the token. Always use the `SxClass.parsePrimitiveSexpr` or `SxClass.parsePrimitivesToClassProperties` methods to parse arrays of `PrimitiveSExpr` into instances of the correct class
-- NEW PATTERN: Never track the order of children unless absolutely necessary, use the `_sx*` properties and `getChildren` to return the children in a predefined order
-- NEW PATTERN: Never track unknown children, throw an error/allow an error to be thrown if you encounter a child PrimitiveSExpr that can't be parsed. You can introduce new `_sx*` properties and a new class to prevent the error
-- NEW PATTERN: One class per file
-- NEW PATTERN: Ergonomic constructors for classes

package/TODO.md DELETED Viewed

@@ -1,46 +0,0 @@
-# TODO: Ergonomic Constructors
-The following classes need ergonomic constructors created (similar to the pattern in `KicadSch.ts`):
-## Main Container Classes
-- [x] **KicadSch** - `lib/sexpr/classes/KicadSch.ts`
-- [ ] **Bus** - `lib/sexpr/classes/Bus.ts`
-- [ ] **BusEntry** - `lib/sexpr/classes/BusEntry.ts`
-- [ ] **Footprint** - `lib/sexpr/classes/Footprint.ts`
-- [ ] **FootprintPad** - `lib/sexpr/classes/FootprintPad.ts`
-- [ ] **FpArc** - `lib/sexpr/classes/FpArc.ts`
-- [ ] **FpCircle** - `lib/sexpr/classes/FpCircle.ts`
-- [ ] **FpLine** - `lib/sexpr/classes/FpLine.ts`
-- [ ] **FpPoly** - `lib/sexpr/classes/FpPoly.ts`
-- [ ] **FpRect** - `lib/sexpr/classes/FpRect.ts`
-- [ ] **FpText** - `lib/sexpr/classes/FpText.ts`
-- [ ] **FpTextBox** - `lib/sexpr/classes/FpTextBox.ts`
-- [ ] **GrLine** - `lib/sexpr/classes/GrLine.ts`
-- [ ] **GrText** - `lib/sexpr/classes/GrText.ts`
-- [ ] **Image** - `lib/sexpr/classes/Image.ts`
-- [ ] **Junction** - `lib/sexpr/classes/Junction.ts`
-- [ ] **KicadPcb** - `lib/sexpr/classes/KicadPcb.ts`
-- [ ] **Label** - `lib/sexpr/classes/Label.ts`
-- [ ] **NoConnect** - `lib/sexpr/classes/NoConnect.ts`
-- [ ] **PadPrimitiveGrArc** - `lib/sexpr/classes/PadPrimitiveGrArc.ts`
-- [ ] **PadPrimitiveGrCircle** - `lib/sexpr/classes/PadPrimitiveGrCircle.ts`
-- [ ] **Property** - `lib/sexpr/classes/Property.ts`
-- [ ] **SchematicText** - `lib/sexpr/classes/SchematicText.ts`
-- [ ] **Segment** - `lib/sexpr/classes/Segment.ts`
-- [ ] **Sheet** - `lib/sexpr/classes/Sheet.ts`
-- [ ] **Symbol** (SchematicSymbol) - `lib/sexpr/classes/Symbol.ts`
-- [ ] **TextEffects** - `lib/sexpr/classes/TextEffects.ts`
-- [ ] **TitleBlock** - `lib/sexpr/classes/TitleBlock.ts`
-- [ ] **Via** - `lib/sexpr/classes/Via.ts`
-- [ ] **Wire** - `lib/sexpr/classes/Wire.ts`
-## Pattern Requirements
-Each class needs:
-1. A TypeScript interface `{ClassName}ConstructorParams` with optional properties
-2. Properties should accept either primitive values (strings, numbers) OR SxClass wrapper objects
-3. Constructor that accepts the params interface and handles both cases
-4. Getter/setter pairs working with primitive values while storing SxClass objects internally
-See `lib/sexpr/classes/KicadSch.ts` for reference implementation.

package/biome.json DELETED Viewed

@@ -1,93 +0,0 @@
-{
-  "$schema": "https://biomejs.dev/schemas/2.0.0/schema.json",
-  "assist": { "actions": { "source": { "organizeImports": "on" } } },
-  "formatter": {
-    "enabled": true,
-    "indentStyle": "space"
-  },
-  "files": {
-    "includes": ["**", "!**/cosmos-export", "!**/dist", "!**/package.json"]
-  },
-  "javascript": {
-    "formatter": {
-      "jsxQuoteStyle": "double",
-      "quoteProperties": "asNeeded",
-      "trailingCommas": "all",
-      "semicolons": "asNeeded",
-      "arrowParentheses": "always",
-      "bracketSpacing": true,
-      "bracketSameLine": false
-    }
-  },
-  "linter": {
-    "enabled": true,
-    "rules": {
-      "recommended": true,
-      "suspicious": {
-        "noExplicitAny": "off"
-      },
-      "complexity": {
-        "noForEach": "error",
-        "useLiteralKeys": "off"
-      },
-      "a11y": {
-        "noAccessKey": "off",
-        "noAriaHiddenOnFocusable": "off",
-        "noAriaUnsupportedElements": "off",
-        "noAutofocus": "off",
-        "noDistractingElements": "off",
-        "noHeaderScope": "off",
-        "noInteractiveElementToNoninteractiveRole": "off",
-        "noLabelWithoutControl": "off",
-        "noNoninteractiveElementToInteractiveRole": "off",
-        "noNoninteractiveTabindex": "off",
-        "noPositiveTabindex": "off",
-        "noRedundantAlt": "off",
-        "noRedundantRoles": "off",
-        "noStaticElementInteractions": "off",
-        "noSvgWithoutTitle": "off",
-        "useAltText": "off",
-        "useAnchorContent": "off",
-        "useAriaActivedescendantWithTabindex": "off",
-        "useAriaPropsForRole": "off",
-        "useAriaPropsSupportedByRole": "off",
-        "useButtonType": "off",
-        "useFocusableInteractive": "off",
-        "useHeadingContent": "off",
-        "useHtmlLang": "off",
-        "useIframeTitle": "off",
-        "useKeyWithClickEvents": "off",
-        "useKeyWithMouseEvents": "off",
-        "useMediaCaption": "off",
-        "useSemanticElements": "off",
-        "useValidAnchor": "off",
-        "useValidAriaProps": "off",
-        "useValidAriaRole": "off",
-        "useValidAriaValues": "off",
-        "useValidAutocomplete": "off",
-        "useValidLang": "off"
-      },
-      "style": {
-        "useSingleVarDeclarator": "error",
-        "noParameterAssign": "off",
-        "noUselessElse": "off",
-        "noNonNullAssertion": "off",
-        "useNumberNamespace": "off",
-        "noUnusedTemplateLiteral": "off",
-        "useFilenamingConvention": {
-          "level": "error",
-          "options": {
-            "strictCase": true,
-            "requireAscii": true,
-            "filenameCases": ["kebab-case", "export"]
-          }
-        },
-        "useAsConstAssertion": "error",
-        "useDefaultParameterLast": "error",
-        "useEnumInitializers": "error",
-        "useSelfClosingElements": "error",
-        "noInferrableTypes": "error"
-      }
-    }
-  }
-}

package/bunfig.toml DELETED Viewed

@@ -1,5 +0,0 @@
-[test]
-preload = ["./tests/fixtures/preload.ts"]
-[install.lockfile]
-save = false

package/lib/index.ts DELETED Viewed

	@@ -1 +0,0 @@
1	- export * from "./sexpr"

package/lib/sexpr/base-classes/SxClass.ts DELETED Viewed

@@ -1,164 +0,0 @@
-import {
-  parseToPrimitiveSExpr,
-  type PrimitiveSExpr,
-} from "../parseToPrimitiveSExpr"
-const DEFAULT_PARENT_TOKEN = "__default__"
-export abstract class SxClass {
-  abstract token: string
-  static token: string
-  /**
-   * Token strings are sometimes re-used (e.g. a "type" token) but the class
-   * varies based on the parent token
-   */
-  static parentToken?: string
-  isSxClass = true
-  getChildren(): SxClass[] {
-    // By default, return any properties found in this instance that have the _sx* prefix
-    return Object.keys(this)
-      .filter((k) => k.startsWith("_sx"))
-      .map((k) => (this as any)[k])
-      .filter((v) => v && typeof v === "object" && v.isSxClass)
-  }
-  getStringIndented(): string {
-    return this.getString()
-      .split("\n")
-      .map((line) => `  ${line}`)
-      .join("\n")
-  }
-  getString(): string {
-    const children = this.getChildren()
-    if (children.length === 0) {
-      return `(${this.token})`
-    }
-    const lines = [`(${this.token}`]
-    for (const p of children) {
-      lines.push(p.getStringIndented())
-    }
-    lines.push(")")
-    return lines.join("\n")
-  }
-  get [Symbol.toStringTag](): string {
-    return this.getString()
-  }
-  [Symbol.for("nodejs.util.inspect.custom")]() {
-    return this.getString()
-  }
-  // =========================== STATIC METHODS ===========================
-  static classes: Record<string, Record<string, any>> = {}
-  /**
-   * Should be called after class definition to register the class for parsing
-   */
-  static register(newClass: any) {
-    if (!newClass.token) {
-      throw new Error("Class must have a static override token")
-    }
-    const parentKey = newClass.parentToken ?? DEFAULT_PARENT_TOKEN
-    const existing = SxClass.classes[newClass.token] ?? {}
-    existing[parentKey] = newClass
-    SxClass.classes[newClass.token] = existing
-  }
-  /**
-   * Parse an S-expression string into registered SxClass instances
-   */
-  static parse(sexpr: string): SxClass[] {
-    const primitiveSexpr = parseToPrimitiveSExpr(sexpr)
-    return SxClass.parsePrimitiveSexpr(primitiveSexpr) as any
-  }
-  static fromSexprPrimitives(primitiveSexprs: PrimitiveSExpr[]): SxClass {
-    throw new Error(
-      `"${this.name}" class has not implemented fromSexprPrimitives`,
-    )
-  }
-  static parsePrimitiveSexpr(
-    primitiveSexpr: PrimitiveSExpr,
-    options: { parentToken?: string } = {},
-  ): SxClass | SxClass[] | number | string | boolean | null {
-    const parentToken = options.parentToken
-    if (
-      Array.isArray(primitiveSexpr) &&
-      primitiveSexpr.length >= 1 &&
-      typeof primitiveSexpr[0] === "string"
-    ) {
-      const classToken = primitiveSexpr[0] as string
-      const classGroup = SxClass.classes[classToken]
-      if (!classGroup) {
-        throw new Error(
-          `Class "${classToken}" not registered via SxClass.register`,
-        )
-      }
-      const parentKey = parentToken ?? DEFAULT_PARENT_TOKEN
-      const ClassDef: any =
-        classGroup[parentKey] ?? classGroup[DEFAULT_PARENT_TOKEN]
-      if (!ClassDef) {
-        throw new Error(
-          `Class "${classToken}" not registered for parent "${parentToken ?? "<root>"}"`,
-        )
-      }
-      const args = primitiveSexpr.slice(1) as PrimitiveSExpr[]
-      if (!("fromSexprPrimitives" in ClassDef)) {
-        throw new Error(
-          `Class "${classToken}" does not have a fromSexprPrimitives method`,
-        )
-      }
-      const classInstance = ClassDef.fromSexprPrimitives(args)
-      return classInstance
-    }
-    if (Array.isArray(primitiveSexpr)) {
-      return primitiveSexpr.map((item) =>
-        SxClass.parsePrimitiveSexpr(item, options),
-      ) as any[]
-    }
-    if (
-      typeof primitiveSexpr === "number" ||
-      typeof primitiveSexpr === "string" ||
-      typeof primitiveSexpr === "boolean" ||
-      primitiveSexpr === null
-    ) {
-      return primitiveSexpr as number | string | boolean | null
-    }
-    throw new Error(
-      `Couldn't parse primitive S-expression: ${JSON.stringify(primitiveSexpr)}`,
-    )
-  }
-  // =========================== STATIC UTILITIES  ===========================
-  static parsePrimitivesToClassProperties(
-    primitiveSexprs: PrimitiveSExpr[],
-    parentToken?: string,
-  ): {
-    propertyMap: Record<string, SxClass>
-    arrayPropertyMap: Record<string, SxClass[]>
-  } {
-    const propertyMap = {} as Record<string, SxClass>
-    const arrayPropertyMap = {} as Record<string, SxClass[]>
-    for (const primitiveSexpr of primitiveSexprs) {
-      const sxClass = SxClass.parsePrimitiveSexpr(primitiveSexpr, {
-        parentToken,
-      }) as SxClass
-      if (!sxClass.isSxClass) continue
-      propertyMap[sxClass.token] = sxClass
-      arrayPropertyMap[sxClass.token] ??= []
-      arrayPropertyMap[sxClass.token]!.push(sxClass)
-    }
-    return { propertyMap, arrayPropertyMap }
-  }
-}