@tscircuit/ti 1.0.1

package/README.md

@@ -0,0 +1,54 @@
+# @tscircuit/ti
+
+Texas Instruments chip components and reusable reference subcircuits for
+[tscircuit](https://github.com/tscircuit/ti).
+
+## Install in a circuit project
+
+```sh
+npm install @tscircuit/ti tscircuit react
+```
+
+```tsx
+import { BQ24074, PowerMonitor_INA237 } from "@tscircuit/ti";
+
+export default () => (
+  <board width="30mm" height="20mm">
+    <BQ24074 name="U1" />
+    <PowerMonitor_INA237 name="Monitor" />
+  </board>
+);
+```
+
+The package includes ESM, CommonJS, and TypeScript declarations. Node.js 22.14
+or newer is required. React, tscircuit, and `@tscircuit/props` are peer dependencies so the library
+uses the same runtime as your circuit project.
+
+## Global installation
+
+```sh
+npm install -g @tscircuit/ti
+ti search "buck converter"
+ti search --json "buck converter"
+ti import TPS62160DSGR
+```
+
+The `ti search` command searches the same Texas Instruments catalog as
+`tsci search --ti`, returning up to 10 components. Queries can be quoted or
+passed as separate words. Use `--json` for `{ query, results }` output, including
+TI metadata and `source: "ti"` on every result, or `ti --help` for usage.
+
+`ti import TPS62160DSGR` finds the exact manufacturer part in LCSC/JLCPCB,
+converts its EasyEDA symbol and footprint, and writes `imports/TPS62160DSGR.tsx`.
+You can also use an LCSC ID directly: `ti import C324077`.
+Use the result with `import { TPS62160DSGR } from "./imports/TPS62160DSGR"`.
+Existing files are never overwritten. Imports require an internet connection
+and an available EasyEDA part. They contain individual chips, not complete
+reference subcircuits; available 3D models remain remote links.
+
+Global installation does not make imports resolve in local projects; install
+the package in each project where you use its components.
+
+See the [library documentation](https://github.com/tscircuit/ti#readme) for the
+available chips, reference subcircuits, and connection examples. Examples using
+`@tsci/tscircuit.ti` have the same exports; use `@tscircuit/ti` for npm imports.

package/cli/import.mjs

@@ -0,0 +1,104 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { parseArgs } from "node:util";
+import {
+  convertRawEasyEdaToTs,
+  EasyEdaJsonSchema,
+  fetchEasyEDAComponent,
+  normalizeManufacturerPartNumber,
+} from "easyeda";
+
+const help = `Usage: ti import <part-number>
+
+Import an EasyEDA chip as editable TSX into ./imports/.
+Use an exact manufacturer part number or an LCSC ID (C-number).
+Existing files are not overwritten.
+
+Examples:
+  ti import TPS62160DSGR
+  ti import C324077`;
+
+export async function runImport(args, { fetch, stdout, stderr, cwd }) {
+  try {
+    const { values, positionals } = parseArgs({
+      args,
+      allowPositionals: true,
+      options: { help: { type: "boolean", short: "h" } },
+    });
+    if (values.help) {
+      stdout(help);
+      return 0;
+    }
+    if (positionals.length !== 1 || !positionals[0].trim()) {
+      throw new Error(
+        "An exact part number is required. Usage: ti import <part-number>",
+      );
+    }
+
+    const query = positionals[0].trim();
+    const directLcsc = /^C[1-9]\d*$/i.test(query);
+    let lcscPartNumber = query.toUpperCase();
+    if (!directLcsc) {
+      const response = await fetch(
+        "https://jlcsearch.tscircuit.com/api/search?limit=10&q=" +
+          encodeURIComponent(query),
+      );
+      if (!response.ok)
+        throw new Error(`LCSC search failed (HTTP ${response.status})`);
+      const data = await response.json();
+      if (!Array.isArray(data?.components))
+        throw new Error("LCSC search returned an invalid response");
+      const match = data.components.find(
+        (part) =>
+          part?.mfr?.trim().toUpperCase() === query.toUpperCase() &&
+          Number.isSafeInteger(part.lcsc) &&
+          part.lcsc > 0,
+      );
+      if (!match) {
+        throw new Error(
+          `No exact LCSC match for "${query}". Use the full manufacturer part number or an LCSC ID (C-number).`,
+        );
+      }
+      lcscPartNumber = `C${match.lcsc}`;
+    }
+
+    const rawEasy = await fetchEasyEDAComponent(lcscPartNumber, { fetch });
+    const component = EasyEdaJsonSchema.parse(rawEasy);
+    const manufacturerPart = component.dataStr.head.c_para["Manufacturer Part"];
+    if (
+      !manufacturerPart?.trim() ||
+      component.lcsc.number.toUpperCase() !== lcscPartNumber ||
+      (!directLcsc &&
+        manufacturerPart.trim().toUpperCase() !== query.toUpperCase())
+    ) {
+      throw new Error(
+        `EasyEDA returned a different or missing part identity for "${query}"`,
+      );
+    }
+
+    const componentName = normalizeManufacturerPartNumber(manufacturerPart);
+    const tsx = await convertRawEasyEdaToTs({ rawEasy });
+    const directory = join(cwd, "imports");
+    const filename = `${componentName}.tsx`;
+    await mkdir(directory, { recursive: true });
+    try {
+      await writeFile(join(directory, filename), `${tsx}\n`, { flag: "wx" });
+    } catch (error) {
+      if (error?.code === "EEXIST")
+        throw new Error(
+          `imports/${filename} already exists; no files were overwritten.`,
+        );
+      throw error;
+    }
+    stdout(`Imported imports/${filename} from EasyEDA (${lcscPartNumber}).`);
+    stdout(
+      `Use: import { ${componentName} } from "./imports/${componentName}"`,
+    );
+    return 0;
+  } catch (error) {
+    stderr(
+      `Failed to import: ${error instanceof Error ? error.message : String(error)}`,
+    );
+    return 1;
+  }
+}

package/cli/main.mjs

@@ -0,0 +1,111 @@
+import { parseArgs } from "node:util";
+
+const help = `Usage: ti search [options] <query...>
+       ti import <part-number>
+
+Search Texas Instruments components or import a chip from EasyEDA.
+
+Options:
+  --json      Output search results as JSON
+  -h, --help  Show help
+
+Examples:
+  ti search "buck converter"
+  ti search --json TPS62160
+  ti import TPS62160DSGR
+  ti import C324077`;
+
+export async function runCli(
+  argv,
+  {
+    fetch = globalThis.fetch,
+    stdout = console.log,
+    stderr = console.error,
+    cwd = process.cwd(),
+  } = {},
+) {
+  const [command, ...args] = argv;
+  if (!command || command === "--help" || command === "-h") {
+    stdout(help);
+    return 0;
+  }
+  if (command === "import") {
+    const { runImport } = await import("./import.mjs");
+    return runImport(args, { fetch, stdout, stderr, cwd });
+  }
+  if (command !== "search") {
+    stderr(`Unknown command "${command}". Run ti --help for usage.`);
+    return 1;
+  }
+
+  let parsed;
+  try {
+    parsed = parseArgs({
+      args,
+      allowPositionals: true,
+      options: {
+        json: { type: "boolean" },
+        help: { type: "boolean", short: "h" },
+      },
+    });
+  } catch (error) {
+    stderr(error instanceof Error ? error.message : String(error));
+    return 1;
+  }
+  if (parsed.values.help) {
+    stdout(help);
+    return 0;
+  }
+
+  const query = parsed.positionals.join(" ").trim();
+  if (!query) {
+    stderr("A search query is required. Usage: ti search [options] <query...>");
+    return 1;
+  }
+
+  try {
+    const response = await fetch(
+      "https://tisearch.tscircuit.com/api/search?limit=10&q=" +
+        encodeURIComponent(query),
+    );
+    if (!response.ok)
+      throw new Error(`TI search failed (HTTP ${response.status})`);
+    const data = await response.json();
+    if (!Array.isArray(data?.components))
+      throw new Error("TI search returned an invalid response");
+
+    if (parsed.values.json) {
+      stdout(
+        JSON.stringify(
+          {
+            query,
+            results: data.components.map((component) => ({
+              ...component,
+              source: "ti",
+            })),
+          },
+          null,
+          2,
+        ),
+      );
+    } else if (!data.components.length) {
+      stdout(`No results found for "${query}" in Texas Instruments.`);
+    } else {
+      stdout(
+        [
+          `Found ${data.components.length} component(s) in TI search:`,
+          ...data.components.map(
+            (component, index) =>
+              `${index + 1}. ${component.mfr} - ${component.description} (stock: ${component.stock.toLocaleString("en-US")})`,
+          ),
+        ].join("\n"),
+      );
+    }
+    return 0;
+  } catch (error) {
+    stderr(
+      `Failed to search: ${error instanceof Error ? error.message : String(error)}`,
+    );
+    return 1;
+  }
+}

package/cli/ti.mjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runCli } from "./main.mjs";
+
+process.exitCode = await runCli(process.argv.slice(2));