@tscircuit/cli 0.1.1792 → 0.1.1793

package/README.md

@@ -80,6 +80,28 @@ The `build` command also accepts the following options:
 - `--ignore-placement-drc` - suppress placement DRC diagnostics
 - `--ignore-routing-drc` - suppress routing DRC diagnostics
 
+### KiCad PCM compatibility
+
+`tsci build --kicad-pcm` uses the package license from `package.json` and
+selects the oldest compatible PCM schema by default. Licenses accepted by PCM
+schema v1 produce a feed for KiCad 6–10. Other non-empty license strings use
+schema v2 and require KiCad 10 or newer.
+
+Projects can select a schema or declare a distribution-specific PCM license in
+`tscircuit.config.json`:
+
+```json
+{
+  "kicadPcm": {
+    "schemaVersion": "auto",
+    "license": "CC-BY-ND-4.0"
+  }
+}
+```
+
+Set `schemaVersion` to `1` or `2` to force a schema. Forcing v1 rejects licenses
+that are not in KiCad's v1 license list instead of substituting another license.
+
 ### Debug autorouting stages
 
 Use `--autorouter-debug` to log each autorouting stage and write visual

package/dist/cli/build/build.worker.js

@@ -11666,6 +11666,10 @@ var pcbSnapshotSettingsSchema = z.object({
   showPcbNotes: z.boolean().optional(),
   showFabricationNotes: z.boolean().optional()
 });
+var kicadPcmSettingsSchema = z.object({
+  schemaVersion: z.union([z.literal("auto"), z.literal(1), z.literal(2)]).optional(),
+  license: z.string().trim().min(1).optional()
+});
 var projectConfigSchema = z.object({
   mainEntrypoint: z.string().optional(),
   libraryEntrypoint: z.string().optional(),
@@ -11680,6 +11684,7 @@ var projectConfigSchema = z.object({
   kicadProjectEntrypointPath: z.string().optional(),
   kicadLibraryEntrypointPath: z.string().optional(),
   kicadLibraryName: z.string().optional(),
+  kicadPcm: kicadPcmSettingsSchema.optional(),
   alwaysUseLatestTscircuitOnCloud: z.boolean().optional(),
   build: z.object({
     circuitJson: z.boolean().optional(),

package/dist/cli/main.js

@@ -118506,7 +118506,7 @@ var import_perfect_cli = __toESM2(require_dist2(), 1);
 // lib/getVersion.ts
 import { createRequire as createRequire2 } from "node:module";
 // package.json
-var version = "0.1.1791";
+var version = "0.1.1792";
 var package_default = {
   name: "@tscircuit/cli",
   version,
@@ -122606,6 +122606,10 @@ var pcbSnapshotSettingsSchema = z.object({
   showPcbNotes: z.boolean().optional(),
   showFabricationNotes: z.boolean().optional()
 });
+var kicadPcmSettingsSchema = z.object({
+  schemaVersion: z.union([z.literal("auto"), z.literal(1), z.literal(2)]).optional(),
+  license: z.string().trim().min(1).optional()
+});
 var projectConfigSchema = z.object({
   mainEntrypoint: z.string().optional(),
   libraryEntrypoint: z.string().optional(),
@@ -122620,6 +122624,7 @@ var projectConfigSchema = z.object({
   kicadProjectEntrypointPath: z.string().optional(),
   kicadLibraryEntrypointPath: z.string().optional(),
   kicadLibraryName: z.string().optional(),
+  kicadPcm: kicadPcmSettingsSchema.optional(),
   alwaysUseLatestTscircuitOnCloud: z.boolean().optional(),
   build: z.object({
     circuitJson: z.boolean().optional(),
@@ -130967,13 +130972,129 @@ import path31 from "node:path";
 import crypto3 from "node:crypto";
 
 // lib/shared/kicad-pcm-license.ts
-var KICAD_PCM_SCHEMA_VERSION = 2;
-var KICAD_PCM_SCHEMA_URL = "https://go.kicad.org/pcm/schemas/v2";
+var KICAD_PCM_SCHEMA_URLS = {
+  1: "https://go.kicad.org/pcm/schemas/v1",
+  2: "https://go.kicad.org/pcm/schemas/v2"
+};
+var KICAD_PCM_SCHEMA_URL = KICAD_PCM_SCHEMA_URLS[2];
+var KICAD_PCM_V1_LICENSES = [
+  "public-domain",
+  "Apache",
+  "Apache-1.0",
+  "Apache-2.0",
+  "Artistic",
+  "Artistic-1.0",
+  "Artistic-2.0",
+  "BSD",
+  "BSD-2-Clause",
+  "BSD-3-Clause",
+  "BSD-4-Clause",
+  "ISC",
+  "CC-BY",
+  "CC-BY-1.0",
+  "CC-BY-2.0",
+  "CC-BY-2.5",
+  "CC-BY-3.0",
+  "CC-BY-4.0",
+  "CC-BY-SA",
+  "CC-BY-SA-1.0",
+  "CC-BY-SA-2.0",
+  "CC-BY-SA-2.5",
+  "CC-BY-SA-3.0",
+  "CC-BY-SA-4.0",
+  "CC-BY-ND",
+  "CC-BY-ND-1.0",
+  "CC-BY-ND-2.0",
+  "CC-BY-ND-2.5",
+  "CC-BY-ND-3.0",
+  "CC-BY-ND-4.0",
+  "CC-BY-NC",
+  "CC-BY-NC-1.0",
+  "CC-BY-NC-2.0",
+  "CC-BY-NC-2.5",
+  "CC-BY-NC-3.0",
+  "CC-BY-NC-4.0",
+  "CC-BY-NC-SA",
+  "CC-BY-NC-SA-1.0",
+  "CC-BY-NC-SA-2.0",
+  "CC-BY-NC-SA-2.5",
+  "CC-BY-NC-SA-3.0",
+  "CC-BY-NC-SA-4.0",
+  "CC-BY-NC-ND",
+  "CC-BY-NC-ND-1.0",
+  "CC-BY-NC-ND-2.0",
+  "CC-BY-NC-ND-2.5",
+  "CC-BY-NC-ND-3.0",
+  "CC-BY-NC-ND-4.0",
+  "CC0-1.0",
+  "CDDL-1.0",
+  "CPL",
+  "EFL",
+  "EFL-1.0",
+  "EFL-2.0",
+  "MIT",
+  "GPL",
+  "GPL-1.0",
+  "GPL-2.0",
+  "GPL-3.0",
+  "LGPL",
+  "LGPL-2.1",
+  "LGPL-3.0",
+  "GNU-LGPL-2.0",
+  "GFDL",
+  "GFDL-1.0",
+  "GFDL-1.1",
+  "GFDL-1.2",
+  "GFDL-1.3",
+  "GFDL-NIV",
+  "LPPL",
+  "LPPL-1.0",
+  "LPPL-1.1",
+  "LPPL-1.2",
+  "LPPL-1.3",
+  "MPL-1.1",
+  "Perl",
+  "Python-2.0",
+  "QPL-1.0",
+  "W3C",
+  "Zlib",
+  "Zope",
+  "Zope-1.0",
+  "Zope-1.1",
+  "Zope-2.0",
+  "Zope-2.1",
+  "CERN-OHL",
+  "WTFPL",
+  "Unlicense",
+  "open-source",
+  "unrestricted"
+];
+var kicadPcmV1LicenseSet = new Set(KICAD_PCM_V1_LICENSES);
+var isValidKicadPcmV1License = (license) => typeof license === "string" && kicadPcmV1LicenseSet.has(license.trim());
+function assertValidKicadPcmV1License(license) {
+  if (!isValidKicadPcmV1License(license)) {
+    const value = typeof license === "string" ? license.trim() : "";
+    throw new Error(`Invalid KiCad PCM v1 license "${value || "(empty)"}". Choose a license allowed by ${KICAD_PCM_SCHEMA_URLS[1]} or use schema version 2 for KiCad 10+`);
+  }
+}
 var isValidKicadPcmV2License = (license) => typeof license === "string" && license.trim().length > 0;
 function assertValidKicadPcmV2License(license) {
   if (!isValidKicadPcmV2License(license)) {
-    throw new Error(`Invalid KiCad PCM v2 license "(empty)". License must be a non-empty string allowed by ${KICAD_PCM_SCHEMA_URL}`);
+    throw new Error(`Invalid KiCad PCM v2 license "(empty)". License must be a non-empty string allowed by ${KICAD_PCM_SCHEMA_URLS[2]}`);
+  }
+}
+function resolveKicadPcmSchemaVersion({
+  license,
+  preference = "auto"
+}) {
+  assertValidKicadPcmV2License(license);
+  if (preference === 1) {
+    assertValidKicadPcmV1License(license);
+    return 1;
   }
+  if (preference === 2)
+    return 2;
+  return isValidKicadPcmV1License(license) ? 1 : 2;
 }
 
 // lib/shared/generate-pcm-assets.ts
@@ -130985,18 +131106,23 @@ async function generatePcmAssets(options) {
     description = "",
     descriptionFull = `Visit https://tscircuit.com/${author}/${packageName} for more information.`,
     license,
+    schemaVersion: schemaVersionPreference = "auto",
     kicadLibraryPath,
     outputDir,
     baseUrl,
     displayName = `${author}/${packageName}`
   } = options;
-  assertValidKicadPcmV2License(license);
+  const schemaVersion = resolveKicadPcmSchemaVersion({
+    license,
+    preference: schemaVersionPreference
+  });
+  const schemaUrl = KICAD_PCM_SCHEMA_URLS[schemaVersion];
   const normalizedLicense = license.trim();
   const identifier = `com.tscircuit.${author}.${packageName}`.toLowerCase().replace(/[^a-z0-9.-]/g, "-").slice(0, 50);
   fs29.mkdirSync(outputDir, { recursive: true });
   console.log("Creating metadata.json...");
   const metadata = {
-    $schema: KICAD_PCM_SCHEMA_URL,
+    $schema: schemaUrl,
     name: displayName,
     description: description.slice(0, 500),
     description_full: descriptionFull.slice(0, 5000),
@@ -131065,8 +131191,8 @@ async function generatePcmAssets(options) {
   const packagesJsonSha256 = crypto3.createHash("sha256").update(packagesJsonBuffer).digest("hex");
   const packagesJsonUrl = baseUrl ? `${baseUrl}/pcm/packages.json` : "./packages.json";
   const repositoryJson = {
-    $schema: KICAD_PCM_SCHEMA_URL,
-    schema_version: KICAD_PCM_SCHEMA_VERSION,
+    $schema: schemaUrl,
+    ...schemaVersion === 2 ? { schema_version: 2 } : {},
     name: displayName,
     maintainer: {
       name: author,
@@ -131088,7 +131214,8 @@ async function generatePcmAssets(options) {
     packagesJsonPath,
     packageZipPath: zipFilePath,
     packageZipSha256: sha256,
-    packageZipSize: zipSize
+    packageZipSize: zipSize,
+    schemaVersion
   };
 }
 function addDirectoryToZip(opts) {
@@ -131163,8 +131290,12 @@ async function buildKicadPcm({
   const version2 = packageJson.version || "1.0.0";
   const author = getPackageAuthor(packageJson.name || "") || "tscircuit";
   const description = packageJson.description || "";
-  assertValidKicadPcmV2License(packageJson.license);
-  const license = packageJson.license.trim();
+  const license = projectConfig?.kicadPcm?.license ?? packageJson.license;
+  const schemaVersion = resolveKicadPcmSchemaVersion({
+    license,
+    preference: projectConfig?.kicadPcm?.schemaVersion
+  });
+  const normalizedLicense = license.trim();
   const libraryName = kicadLibraryNameOption ?? resolveKicadLibraryName({ projectDir });
   const kicadLibOutputDir = path32.join(distDir, "kicad-library-pcm");
   const kicadPcmPackageId = `com_tscircuit_${author}_${packageName}`.replace(/\./g, "_");
@@ -131186,7 +131317,8 @@ async function buildKicadPcm({
     version: version2,
     author,
     description,
-    license,
+    license: normalizedLicense,
+    schemaVersion,
     kicadLibraryPath: kicadLibOutputDir,
     outputDir: pcmOutputDir,
     baseUrl,

package/dist/cli/snapshot/snapshot.worker.js

@@ -4170,6 +4170,10 @@ var pcbSnapshotSettingsSchema = z.object({
   showPcbNotes: z.boolean().optional(),
   showFabricationNotes: z.boolean().optional()
 });
+var kicadPcmSettingsSchema = z.object({
+  schemaVersion: z.union([z.literal("auto"), z.literal(1), z.literal(2)]).optional(),
+  license: z.string().trim().min(1).optional()
+});
 var projectConfigSchema = z.object({
   mainEntrypoint: z.string().optional(),
   libraryEntrypoint: z.string().optional(),
@@ -4184,6 +4188,7 @@ var projectConfigSchema = z.object({
   kicadProjectEntrypointPath: z.string().optional(),
   kicadLibraryEntrypointPath: z.string().optional(),
   kicadLibraryName: z.string().optional(),
+  kicadPcm: kicadPcmSettingsSchema.optional(),
   alwaysUseLatestTscircuitOnCloud: z.boolean().optional(),
   build: z.object({
     circuitJson: z.boolean().optional(),

package/dist/lib/index.js

@@ -65757,7 +65757,7 @@ var getNodeHandler = (winterSpec, { port, middleware = [] }) => {
   }));
 };
 // package.json
-var version = "0.1.1791";
+var version = "0.1.1792";
 var package_default = {
   name: "@tscircuit/cli",
   version,
@@ -75018,14 +75018,130 @@ import path10 from "node:path";
 import crypto3 from "node:crypto";
 
 // lib/shared/kicad-pcm-license.ts
-var KICAD_PCM_SCHEMA_VERSION = 2;
-var KICAD_PCM_SCHEMA_URL = "https://go.kicad.org/pcm/schemas/v2";
+var KICAD_PCM_SCHEMA_URLS = {
+  1: "https://go.kicad.org/pcm/schemas/v1",
+  2: "https://go.kicad.org/pcm/schemas/v2"
+};
+var KICAD_PCM_SCHEMA_URL = KICAD_PCM_SCHEMA_URLS[2];
+var KICAD_PCM_V1_LICENSES = [
+  "public-domain",
+  "Apache",
+  "Apache-1.0",
+  "Apache-2.0",
+  "Artistic",
+  "Artistic-1.0",
+  "Artistic-2.0",
+  "BSD",
+  "BSD-2-Clause",
+  "BSD-3-Clause",
+  "BSD-4-Clause",
+  "ISC",
+  "CC-BY",
+  "CC-BY-1.0",
+  "CC-BY-2.0",
+  "CC-BY-2.5",
+  "CC-BY-3.0",
+  "CC-BY-4.0",
+  "CC-BY-SA",
+  "CC-BY-SA-1.0",
+  "CC-BY-SA-2.0",
+  "CC-BY-SA-2.5",
+  "CC-BY-SA-3.0",
+  "CC-BY-SA-4.0",
+  "CC-BY-ND",
+  "CC-BY-ND-1.0",
+  "CC-BY-ND-2.0",
+  "CC-BY-ND-2.5",
+  "CC-BY-ND-3.0",
+  "CC-BY-ND-4.0",
+  "CC-BY-NC",
+  "CC-BY-NC-1.0",
+  "CC-BY-NC-2.0",
+  "CC-BY-NC-2.5",
+  "CC-BY-NC-3.0",
+  "CC-BY-NC-4.0",
+  "CC-BY-NC-SA",
+  "CC-BY-NC-SA-1.0",
+  "CC-BY-NC-SA-2.0",
+  "CC-BY-NC-SA-2.5",
+  "CC-BY-NC-SA-3.0",
+  "CC-BY-NC-SA-4.0",
+  "CC-BY-NC-ND",
+  "CC-BY-NC-ND-1.0",
+  "CC-BY-NC-ND-2.0",
+  "CC-BY-NC-ND-2.5",
+  "CC-BY-NC-ND-3.0",
+  "CC-BY-NC-ND-4.0",
+  "CC0-1.0",
+  "CDDL-1.0",
+  "CPL",
+  "EFL",
+  "EFL-1.0",
+  "EFL-2.0",
+  "MIT",
+  "GPL",
+  "GPL-1.0",
+  "GPL-2.0",
+  "GPL-3.0",
+  "LGPL",
+  "LGPL-2.1",
+  "LGPL-3.0",
+  "GNU-LGPL-2.0",
+  "GFDL",
+  "GFDL-1.0",
+  "GFDL-1.1",
+  "GFDL-1.2",
+  "GFDL-1.3",
+  "GFDL-NIV",
+  "LPPL",
+  "LPPL-1.0",
+  "LPPL-1.1",
+  "LPPL-1.2",
+  "LPPL-1.3",
+  "MPL-1.1",
+  "Perl",
+  "Python-2.0",
+  "QPL-1.0",
+  "W3C",
+  "Zlib",
+  "Zope",
+  "Zope-1.0",
+  "Zope-1.1",
+  "Zope-2.0",
+  "Zope-2.1",
+  "CERN-OHL",
+  "WTFPL",
+  "Unlicense",
+  "open-source",
+  "unrestricted"
+];
+var kicadPcmV1LicenseSet = new Set(KICAD_PCM_V1_LICENSES);
+var isValidKicadPcmV1License = (license) => typeof license === "string" && kicadPcmV1LicenseSet.has(license.trim());
+function assertValidKicadPcmV1License(license) {
+  if (!isValidKicadPcmV1License(license)) {
+    const value = typeof license === "string" ? license.trim() : "";
+    throw new Error(`Invalid KiCad PCM v1 license "${value || "(empty)"}". Choose a license allowed by ${KICAD_PCM_SCHEMA_URLS[1]} or use schema version 2 for KiCad 10+`);
+  }
+}
 var isValidKicadPcmV2License = (license) => typeof license === "string" && license.trim().length > 0;
 function assertValidKicadPcmV2License(license) {
   if (!isValidKicadPcmV2License(license)) {
-    throw new Error(`Invalid KiCad PCM v2 license "(empty)". License must be a non-empty string allowed by ${KICAD_PCM_SCHEMA_URL}`);
+    throw new Error(`Invalid KiCad PCM v2 license "(empty)". License must be a non-empty string allowed by ${KICAD_PCM_SCHEMA_URLS[2]}`);
   }
 }
+function resolveKicadPcmSchemaVersion({
+  license,
+  preference = "auto"
+}) {
+  assertValidKicadPcmV2License(license);
+  if (preference === 1) {
+    assertValidKicadPcmV1License(license);
+    return 1;
+  }
+  if (preference === 2)
+    return 2;
+  return isValidKicadPcmV1License(license) ? 1 : 2;
+}
 
 // lib/shared/generate-pcm-assets.ts
 async function generatePcmAssets(options) {
@@ -75036,18 +75152,23 @@ async function generatePcmAssets(options) {
     description = "",
     descriptionFull = `Visit https://tscircuit.com/${author}/${packageName} for more information.`,
     license,
+    schemaVersion: schemaVersionPreference = "auto",
     kicadLibraryPath,
     outputDir,
     baseUrl,
     displayName = `${author}/${packageName}`
   } = options;
-  assertValidKicadPcmV2License(license);
+  const schemaVersion = resolveKicadPcmSchemaVersion({
+    license,
+    preference: schemaVersionPreference
+  });
+  const schemaUrl = KICAD_PCM_SCHEMA_URLS[schemaVersion];
   const normalizedLicense = license.trim();
   const identifier = `com.tscircuit.${author}.${packageName}`.toLowerCase().replace(/[^a-z0-9.-]/g, "-").slice(0, 50);
   fs8.mkdirSync(outputDir, { recursive: true });
   console.log("Creating metadata.json...");
   const metadata = {
-    $schema: KICAD_PCM_SCHEMA_URL,
+    $schema: schemaUrl,
     name: displayName,
     description: description.slice(0, 500),
     description_full: descriptionFull.slice(0, 5000),
@@ -75116,8 +75237,8 @@ async function generatePcmAssets(options) {
   const packagesJsonSha256 = crypto3.createHash("sha256").update(packagesJsonBuffer).digest("hex");
   const packagesJsonUrl = baseUrl ? `${baseUrl}/pcm/packages.json` : "./packages.json";
   const repositoryJson = {
-    $schema: KICAD_PCM_SCHEMA_URL,
-    schema_version: KICAD_PCM_SCHEMA_VERSION,
+    $schema: schemaUrl,
+    ...schemaVersion === 2 ? { schema_version: 2 } : {},
     name: displayName,
     maintainer: {
       name: author,
@@ -75139,7 +75260,8 @@ async function generatePcmAssets(options) {
     packagesJsonPath,
     packageZipPath: zipFilePath,
     packageZipSha256: sha256,
-    packageZipSize: zipSize
+    packageZipSize: zipSize,
+    schemaVersion
   };
 }
 function addDirectoryToZip(opts) {
@@ -75207,6 +75329,10 @@ var pcbSnapshotSettingsSchema = z21.object({
   showPcbNotes: z21.boolean().optional(),
   showFabricationNotes: z21.boolean().optional()
 });
+var kicadPcmSettingsSchema = z21.object({
+  schemaVersion: z21.union([z21.literal("auto"), z21.literal(1), z21.literal(2)]).optional(),
+  license: z21.string().trim().min(1).optional()
+});
 var projectConfigSchema = z21.object({
   mainEntrypoint: z21.string().optional(),
   libraryEntrypoint: z21.string().optional(),
@@ -75221,6 +75347,7 @@ var projectConfigSchema = z21.object({
   kicadProjectEntrypointPath: z21.string().optional(),
   kicadLibraryEntrypointPath: z21.string().optional(),
   kicadLibraryName: z21.string().optional(),
+  kicadPcm: kicadPcmSettingsSchema.optional(),
   alwaysUseLatestTscircuitOnCloud: z21.boolean().optional(),
   build: z21.object({
     circuitJson: z21.boolean().optional(),
@@ -75422,8 +75549,12 @@ async function buildKicadPcm({
   const version2 = packageJson.version || "1.0.0";
   const author = getPackageAuthor(packageJson.name || "") || "tscircuit";
   const description = packageJson.description || "";
-  assertValidKicadPcmV2License(packageJson.license);
-  const license = packageJson.license.trim();
+  const license = projectConfig?.kicadPcm?.license ?? packageJson.license;
+  const schemaVersion = resolveKicadPcmSchemaVersion({
+    license,
+    preference: projectConfig?.kicadPcm?.schemaVersion
+  });
+  const normalizedLicense = license.trim();
   const libraryName = kicadLibraryNameOption ?? resolveKicadLibraryName({ projectDir });
   const kicadLibOutputDir = path13.join(distDir, "kicad-library-pcm");
   const kicadPcmPackageId = `com_tscircuit_${author}_${packageName}`.replace(/\./g, "_");
@@ -75445,7 +75576,8 @@ async function buildKicadPcm({
     version: version2,
     author,
     description,
-    license,
+    license: normalizedLicense,
+    schemaVersion,
     kicadLibraryPath: kicadLibOutputDir,
     outputDir: pcmOutputDir,
     baseUrl,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tscircuit/cli",
-  "version": "0.1.1792",
+  "version": "0.1.1793",
   "main": "dist/cli/main.js",
   "exports": {
     ".": "./dist/cli/main.js",

package/types/tscircuit.config.schema.json

@@ -83,6 +83,22 @@
       "type": "string",
       "description": "Name for the generated KiCad library. Falls back to package.json name, then directory name."
     },
+    "kicadPcm": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "schemaVersion": {
+          "enum": ["auto", 1, 2],
+          "description": "KiCad PCM schema version. Auto uses v1 when compatible for KiCad 6-10 support, otherwise v2 for KiCad 10+."
+        },
+        "license": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Distribution-specific license for KiCad PCM output. Falls back to package.json license."
+        }
+      },
+      "description": "KiCad PCM output settings."
+    },
     "alwaysUseLatestTscircuitOnCloud": {
       "type": "boolean",
       "description": "Always use the latest TSCircuit version when building on the cloud."