kicadts 0.0.2 → 0.0.4

package/lib/sexpr/index.ts

@@ -1,130 +0,0 @@
-export * from "./base-classes/SxClass"
-export * from "./classes/Stroke"
-export * from "./classes/Width"
-export * from "./classes/Unit"
-export * from "./classes/InBom"
-export * from "./classes/OnBoard"
-export * from "./classes/StrokeType"
-export * from "./classes/Color"
-export * from "./classes/Pts"
-export * from "./classes/At"
-export * from "./classes/Xy"
-export * from "./classes/TextEffects"
-export * from "./classes/TitleBlock"
-export * from "./classes/Paper"
-export * from "./classes/Image"
-export * from "./classes/RenderCache"
-export * from "./classes/Uuid"
-export * from "./classes/KicadSchGenerator"
-export * from "./classes/KicadSchVersion"
-export * from "./classes/KicadSchGeneratorVersion"
-export * from "./classes/LibSymbols"
-export * from "./classes/Wire"
-export * from "./classes/Bus"
-export * from "./classes/Junction"
-export * from "./classes/NoConnect"
-export * from "./classes/BusEntry"
-export * from "./classes/Label"
-export * from "./classes/SchematicText"
-export * from "./classes/KicadSch"
-export * from "./classes/Property"
-export * from "./classes/PropertyUnlocked"
-export * from "./classes/PropertyHide"
-export * from "./classes/Footprint"
-export * from "./classes/FootprintLocked"
-export * from "./classes/FootprintPlaced"
-export * from "./classes/FootprintTedit"
-export * from "./classes/FootprintDescr"
-export * from "./classes/FootprintTags"
-export * from "./classes/FootprintSheetname"
-export * from "./classes/FootprintSheetfile"
-export * from "./classes/FootprintPath"
-export * from "./classes/FootprintAutoplaceCost90"
-export * from "./classes/FootprintAutoplaceCost180"
-export * from "./classes/FootprintSolderMaskMargin"
-export * from "./classes/FootprintSolderPasteMargin"
-export * from "./classes/FootprintSolderPasteRatio"
-export * from "./classes/FootprintClearance"
-export * from "./classes/FootprintZoneConnect"
-export * from "./classes/FootprintThermalWidth"
-export * from "./classes/FootprintThermalGap"
-export * from "./classes/FootprintAttr"
-export * from "./classes/FootprintPrivateLayers"
-export * from "./classes/FootprintNetTiePadGroups"
-export * from "./classes/GrLine"
-export * from "./classes/GrLineStart"
-export * from "./classes/GrLineEnd"
-export * from "./classes/GrLineAngle"
-export * from "./classes/GrLineLocked"
-export * from "./classes/GrText"
-export * from "./classes/Segment"
-export * from "./classes/SegmentStart"
-export * from "./classes/SegmentEnd"
-export * from "./classes/SegmentNet"
-export * from "./classes/SegmentLocked"
-export * from "./classes/Zone"
-export * from "./classes/EmbeddedFonts"
-export * from "./classes/Layers"
-export * from "./classes/Layer"
-export * from "./classes/FpText"
-export * from "./classes/FpTextBox"
-export * from "./classes/FpLine"
-export * from "./classes/FpRect"
-export * from "./classes/FpCircle"
-export * from "./classes/FpArc"
-export * from "./classes/FpPoly"
-export * from "./classes/FpPolyFill"
-export * from "./classes/FpPolyLocked"
-export * from "./classes/FootprintPad"
-export * from "./classes/FootprintModel"
-export * from "./classes/PadSize"
-export * from "./classes/PadDrill"
-export * from "./classes/PadDrillOffset"
-export * from "./classes/PadLayers"
-export * from "./classes/PadRoundrectRratio"
-export * from "./classes/PadRectDelta"
-export * from "./classes/PadChamferRatio"
-export * from "./classes/PadChamfer"
-export * from "./classes/PadNet"
-export * from "./classes/PadPinFunction"
-export * from "./classes/PadPinType"
-export * from "./classes/PadDieLength"
-export * from "./classes/PadSolderMaskMargin"
-export * from "./classes/PadSolderPasteMargin"
-export * from "./classes/PadSolderPasteMarginRatio"
-export * from "./classes/PadClearance"
-export * from "./classes/PadZoneConnect"
-export * from "./classes/PadThermalWidth"
-export * from "./classes/PadThermalGap"
-export * from "./classes/PadThermalBridgeAngle"
-export * from "./classes/PadOptions"
-export * from "./classes/PadPrimitives"
-export * from "./classes/PadPrimitiveGrLine"
-export * from "./classes/PadPrimitiveGrArc"
-export * from "./classes/PadPrimitiveGrCircle"
-export * from "./classes/PadTeardrops"
-export * from "./classes/Symbol"
-export * from "./classes/Sheet"
-export * from "./classes/SheetPin"
-export * from "./classes/SheetProperty"
-export * from "./classes/SheetInstances"
-export * from "./classes/SheetInstancesRoot"
-export * from "./classes/SheetFill"
-export * from "./classes/SheetSize"
-export * from "./classes/FieldsAutoplaced"
-export * from "./classes/ExcludeFromSim"
-export * from "./classes/Dnp"
-export * from "./classes/Setup"
-export * from "./classes/PcbGeneral"
-export * from "./classes/PcbGeneralThickness"
-export * from "./classes/PcbGeneralLegacyTeardrops"
-export * from "./classes/PcbLayers"
-export * from "./classes/PcbLayerDefinition"
-export * from "./classes/PcbNet"
-export * from "./classes/PcbVersion"
-export * from "./classes/PcbGenerator"
-export * from "./classes/PcbGeneratorVersion"
-export * from "./classes/KicadPcb"
-export * from "./classes/Via"
-export * from "./classes/ViaNet"
-export * from "./parseKicadSexpr"

package/lib/sexpr/parseKicadSexpr.ts

@@ -1,5 +0,0 @@
-import { SxClass } from "./base-classes/SxClass"
-
-export const parseKicadSexpr = (sexpr: string) => {
-  return SxClass.parse(sexpr)
-}

package/lib/sexpr/parseToPrimitiveSExpr.ts

@@ -1,245 +0,0 @@
-// s_expr_parser.ts
-export type PrimitiveSExpr =
-  | string // symbols and string literals (distinct via `type` guard if you want)
-  | number
-  | boolean
-  | null
-  | PrimitiveSExpr[] // lists
-
-type Token =
-  | { type: "lparen" }
-  | { type: "rparen" }
-  | { type: "number"; value: number }
-  | { type: "string"; value: string }
-  | { type: "boolean"; value: boolean }
-  | { type: "nil" }
-  | { type: "symbol"; value: string }
-
-export function tokenize(input: string): Token[] {
-  const tokens: Token[] = []
-  let i = 0
-
-  const isWhitespace = (ch: string) => /\s/.test(ch)
-  const isSymbolInitial = (ch: string) => /[^\s()"]/u.test(ch) // anything except ws, parens, quote
-  const peek = () => (i < input.length ? input[i]! : undefined)
-  const advance = () => {
-    if (i >= input.length) {
-      throw new SyntaxError("Unexpected end of input")
-    }
-    return input[i++]!
-  }
-
-  while (i < input.length) {
-    const ch = peek()
-    if (ch === undefined) {
-      break
-    }
-    const current: string = ch
-
-    // Skip whitespace
-    if (isWhitespace(current)) {
-      i++
-      continue
-    }
-
-    // Comments ;...<EOL>
-    if (current === ";") {
-      while (i < input.length && input[i] !== "\n") i++
-      continue
-    }
-
-    if (current === "(") {
-      tokens.push({ type: "lparen" })
-      i++
-      continue
-    }
-    if (current === ")") {
-      tokens.push({ type: "rparen" })
-      i++
-      continue
-    }
-
-    // String literal
-    if (current === '"') {
-      i++ // skip opening quote
-      let out = ""
-      while (i < input.length) {
-        const c = advance()
-        if (c === '"') break
-        if (c === "\\") {
-          if (i >= input.length)
-            throw new SyntaxError("Unterminated escape in string")
-          const e = advance()
-          switch (e) {
-            case "n":
-              out += "\n"
-              break
-            case "r":
-              out += "\r"
-              break
-            case "t":
-              out += "\t"
-              break
-            case '"':
-              out += '"'
-              break
-            case "\\":
-              out += "\\"
-              break
-            default:
-              out += e
-              break // unknown escapes: keep raw
-          }
-        } else {
-          out += c
-        }
-      }
-      if (input[i - 1] !== '"')
-        throw new SyntaxError("Unterminated string literal")
-      tokens.push({ type: "string", value: out })
-      continue
-    }
-
-    // Number or symbol
-    if (
-      isSymbolInitial(current) ||
-      current === "-" ||
-      current === "+" ||
-      current === "."
-    ) {
-      // read a maximal token until delimiter
-      let start = i
-      while (i < input.length) {
-        const nextChar = input[i]!
-        if (
-          isWhitespace(nextChar) ||
-          nextChar === "(" ||
-          nextChar === ")" ||
-          nextChar === '"'
-        ) {
-          break
-        }
-        i++
-      }
-      const raw = input.slice(start, i)
-
-      // Booleans
-      if (raw === "#t") {
-        tokens.push({ type: "boolean", value: true })
-        continue
-      }
-      if (raw === "#f") {
-        tokens.push({ type: "boolean", value: false })
-        continue
-      }
-
-      // nil
-      if (raw === "nil") {
-        tokens.push({ type: "nil" })
-        continue
-      }
-
-      // Numbers (int/float), allow leading +/-, decimals, exponent
-      if (/^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][+-]?\d+)?$/u.test(raw)) {
-        tokens.push({ type: "number", value: Number(raw) })
-      } else {
-        tokens.push({ type: "symbol", value: raw })
-      }
-      continue
-    }
-
-    throw new SyntaxError(`Unexpected character: ${JSON.stringify(ch)} at ${i}`)
-  }
-
-  return tokens
-}
-
-export function parseToPrimitiveSExpr(input: string): PrimitiveSExpr[] {
-  const toks = tokenize(input)
-  let idx = 0
-
-  const peekToken = () => (idx < toks.length ? toks[idx]! : undefined)
-  const advanceToken = () => {
-    if (idx >= toks.length) {
-      throw new SyntaxError("Unexpected end of input")
-    }
-    return toks[idx++]!
-  }
-
-  function readForm(): PrimitiveSExpr {
-    const t = advanceToken()
-
-    switch (t.type) {
-      case "lparen": {
-        const list: PrimitiveSExpr[] = []
-        while (true) {
-          const next = peekToken()
-          if (!next) {
-            throw new SyntaxError("Unmatched '('")
-          }
-          if (next.type === "rparen") break
-          list.push(readForm())
-        }
-        advanceToken() // consume rparen
-        return list
-      }
-      case "rparen":
-        throw new SyntaxError("Unmatched ')'")
-      case "number":
-        return t.value
-      case "string":
-        return t.value
-      case "boolean":
-        return t.value
-      case "nil":
-        return null
-      case "symbol":
-        return t.value // represent symbols as strings
-    }
-  }
-
-  const forms: PrimitiveSExpr[] = []
-  while (peekToken()) forms.push(readForm())
-  return forms
-}
-
-/* -------------------------
-   Tiny helper utilities
---------------------------*/
-
-export function printSExpr(x: PrimitiveSExpr): string {
-  if (x === null) return "nil"
-  if (typeof x === "boolean") return x ? "#t" : "#f"
-  if (typeof x === "number") return Number.isFinite(x) ? String(x) : "nan"
-  if (typeof x === "string") {
-    // naive: treat as symbol if it looks like a symbol; otherwise quote
-    if (/^[^\s()"]+$/u.test(x) && x !== "nil" && x !== "#t" && x !== "#f")
-      return x
-    return `"${x.replace(/["\\\n\r\t]/g, (m) =>
-      m === '"'
-        ? '\\"'
-        : m === "\\"
-          ? "\\\\"
-          : m === "\n"
-            ? "\\n"
-            : m === "\r"
-              ? "\\r"
-              : "\\t",
-    )}"`
-  }
-  if (Array.isArray(x)) {
-    return `(${x.map(printSExpr).join(" ")})`
-  }
-
-  throw new Error(`Unsupported S-expression value: ${JSON.stringify(x)}`)
-}
-
-// Quick example:
-// const program = `
-//   ; define square
-//   (define (square x) (* x x))
-//   (list 1 2.5 "hi" #t nil foo-bar)
-// `;
-// const ast = parseSExpr(program);
-// console.log(JSON.stringify(ast, null, 2));
-// console.log(ast.map(printSExpr).join("\n"));

package/lib/sexpr/utils/indentLines.ts

@@ -1,3 +0,0 @@
-export const indentLines = (value: string, indent = "  "): string[] => {
-  return value.split("\n").map((line) => `${indent}${line}`)
-}

package/lib/sexpr/utils/parseYesNo.ts

@@ -1,12 +0,0 @@
-import type { PrimitiveSExpr } from "../parseToPrimitiveSExpr"
-import { toStringValue } from "./toStringValue"
-
-export const parseYesNo = (
-  value: PrimitiveSExpr | undefined,
-): boolean | undefined => {
-  const str = toStringValue(value)
-  if (!str) return undefined
-  if (str === "yes" || str === "true") return true
-  if (str === "no" || str === "false") return false
-  return undefined
-}

package/lib/sexpr/utils/quoteSExprString.ts

@@ -1,8 +0,0 @@
-export const quoteSExprString = (value: string): string => {
-  return `"${value
-    .replace(/\\/g, "\\\\")
-    .replace(/"/g, '\\"')
-    .replace(/\n/g, "\\n")
-    .replace(/\r/g, "\\r")
-    .replace(/\t/g, "\\t")}"`
-}

package/lib/sexpr/utils/strokeFromArgs.ts

@@ -1,18 +0,0 @@
-import { SxClass } from "../base-classes/SxClass"
-import type { PrimitiveSExpr } from "../parseToPrimitiveSExpr"
-import { Stroke } from "../classes/Stroke"
-
-export const strokeFromArgs = (args: PrimitiveSExpr[]): Stroke | undefined => {
-  try {
-    const parsed = SxClass.parsePrimitiveSexpr([
-      "stroke",
-      ...args,
-    ] as PrimitiveSExpr)
-    if (parsed instanceof Stroke) {
-      return parsed
-    }
-  } catch {
-    // Ignore parse errors and defer to caller
-  }
-  return undefined
-}

package/lib/sexpr/utils/toNumberValue.ts

@@ -1,13 +0,0 @@
-import type { PrimitiveSExpr } from "../parseToPrimitiveSExpr"
-
-export const toNumberValue = (
-  value: PrimitiveSExpr | undefined,
-): number | undefined => {
-  if (value === undefined) return undefined
-  if (typeof value === "number") return value
-  if (typeof value === "string") {
-    const parsed = Number(value)
-    return Number.isNaN(parsed) ? undefined : parsed
-  }
-  return undefined
-}

package/lib/sexpr/utils/toStringValue.ts

@@ -1,11 +0,0 @@
-import type { PrimitiveSExpr } from "../parseToPrimitiveSExpr"
-
-export const toStringValue = (
-  value: PrimitiveSExpr | undefined,
-): string | undefined => {
-  if (value === undefined) return undefined
-  if (typeof value === "string") return value
-  if (typeof value === "number" || typeof value === "boolean")
-    return String(value)
-  return undefined
-}

package/scripts/download-references.ts

@@ -1,68 +0,0 @@
-import { mkdir, writeFile } from "node:fs/promises"
-import { resolve, dirname } from "node:path"
-import { fileURLToPath } from "node:url"
-
-type ReferenceSpec = {
-  readonly url: string
-  readonly filename: string
-}
-
-const references: ReferenceSpec[] = [
-  {
-    url: "https://gitlab.com/kicad/services/kicad-dev-docs/-/raw/master/content/file-formats/sexpr-intro/_index.en.adoc",
-    filename: "SEXPR_MAIN.adoc",
-  },
-  {
-    url: "https://gitlab.com/kicad/services/kicad-dev-docs/-/raw/master/content/file-formats/sexpr-schematic/_index.en.adoc",
-    filename: "SCHEMATIC_SEXPR.adoc",
-  },
-  {
-    url: "https://gitlab.com/kicad/services/kicad-dev-docs/-/raw/master/content/file-formats/sexpr-pcb/_index.en.adoc",
-    filename: "PCB_SEXPR.adoc",
-  },
-  {
-    url: "https://gitlab.com/kicad/services/kicad-dev-docs/-/raw/master/content/file-formats/sexpr-footprint/_index.en.adoc",
-    filename: "FOOTPRINT_SEXPR.adoc",
-  },
-  {
-    url: "https://gitlab.com/kicad/services/kicad-dev-docs/-/raw/master/content/file-formats/sexpr-symbol-lib/_index.en.adoc",
-    filename: "SCH_SYM_SEXPR.adoc",
-  },
-]
-
-const __dirname = dirname(fileURLToPath(import.meta.url))
-const repoRoot = resolve(__dirname, "..")
-const referencesDir = resolve(repoRoot, "references")
-
-async function fetchReference(reference: ReferenceSpec): Promise<void> {
-  const response = await fetch(reference.url)
-
-  if (!response.ok) {
-    throw new Error(
-      `${reference.url} (${response.status} ${response.statusText})`,
-    )
-  }
-
-  const content = await response.text()
-  const targetPath = resolve(referencesDir, reference.filename)
-
-  await writeFile(targetPath, content, "utf8")
-  console.log(`Saved ${reference.filename}`)
-}
-
-async function main(): Promise<void> {
-  await mkdir(referencesDir, { recursive: true })
-
-  await Promise.all(
-    references.map(async (reference) => {
-      try {
-        await fetchReference(reference)
-      } catch (error) {
-        console.error(`Failed to download ${reference.filename}:`, error)
-        process.exitCode = 1
-      }
-    }),
-  )
-}
-
-await main()