app
Adom Symbol
Public Made by Adomby adom
KiCad symbol creator with interactive viewer and delivery to KiCad/Fusion 360
← Commit history
1.2.2: --outline-name none / preferences.outlineName for outlines that already carry the MPN (side-etched STEPs); hint updated
4 files changed
+23−7
Cargo.toml+1−1@@ -1,6 +1,6 @@ [package] name = "adom-symbol"-version = "1.2.1"+version = "1.2.2" edition = "2021" description = "Create and preview KiCad/Fusion 360 schematic symbols with interactive viewer"
VERSION+1−1@@ -1 +1 @@-1.2.1+1.2.2
page.json+2−2@@ -40,7 +40,7 @@ "org": "adom", "updated_at": "2026-06-28T20:46:29.458Z", "source_visibility": "public",- "readme": "# adom-symbol\n\nStandalone Rust CLI + live app for **KiCad schematic symbols**. Generates\n`.kicad_sym` files natively in Rust, renders them as gorgeous dark-themed SVGs\nthrough the shared **service-kicad** container, and serves an AI-drivable live\nviewer with a full layout studio. No Node, no gallia, no local KiCad install.\n\n\n\n## What it does\n\n- **Generate** `.kicad_sym` natively in Rust — rectangle-body ICs with grouped,\n side-sorted pins (Category A) and discrete passives derived from a KiCad\n baseline symbol (Category B).\n- **Render** the symbol to a cropped, dark-themed SVG via service-kicad\n (`POST /kicad/sch/export/svg`) — the same render path the chip-fetcher\n dashboard uses, so the thumbnail and the app match exactly. The default render\n **inlines** the part's 3D-chip **vector outline** (with the part number lasered\n on) into the body centre as real `<polyline>`s — crisp in every renderer\n (browser, librsvg thumbnailer, anything), not a rasterisable `<image>`.\n- **Browse + lay out** a whole chip-fetcher library in the **live viewer**: a\n left chip-library rail (with project filters), a docked **Layout studio** for\n the source / pin arrangement / designator placement / 3D-chip style, drag-to-\n place labels, one-step **Undo**, and **Send to** KiCad / Fusion 360 / Altium /\n OrCAD.\n- **Emit an outline contract** — alongside `<mpn>-symbol.svg`, `render` writes\n `<mpn>-symbol-outline.mm.svg` + `<mpn>-symbol-outline.json` so **adom-lbr** can\n draw the exact same chip outline onto the EAGLE/Fusion 360 symbol with **zero\n guessing**. See [3D-chip outline contract](#3d-chip-outline-contract-for-adom-lbr).\n- **Serve** a live, AI-drivable app: the frontend stays connected to the Rust\n server (`GET /state` poller + `POST /eval` channel), so the AI can push a new\n symbol, hot-patch the UI, or read the console in real time.\n\n## The live viewer\n\n`adom-symbol serve` opens an interactive, AI-drivable viewer over the whole\nchip-fetcher library. The **Layout studio is always open** on the right — it's\nwhere you shape the symbol — and a collapsible chip-library rail sits on the\nleft.\n\n**Browse the library.** Every chip in the library root, with chip-fetcher's\nproject filters; ↑/↓ to step through, and each chip auto-saves the look you give\nit (per-symbol; your last-used choices fill in untouched chips).\n\n\n\n**Shape it in the Layout studio.** Pick the **source** (auto-grouped from ds2sf,\nor any manufacturer / Altium / Fusion / KiCad library variant), the pin\n**layout** (left-right or all-sides) and grouping, the **3D-chip** overlay style\n(off / shaded iso / thin / bold / blue / teal / dark) and size, where the chip\nname shows (lasered on the chip, in the symbol, both, or hidden), and then\n**Send to** a desktop EDA tool.\n\n\n\n**Place the labels — auto or by hand.** The Reference (`U?`/`Y?`) and chip-name\ndesignators don't have to overlap the body or pins. **Auto-place** centres both\nclear of everything; flip on **Manual** and each label gets a drag-outline you\ngrab and drop exactly where you want — it re-renders live and auto-saves to that\nchip. Any change (layout, 3D look, size, auto-place, a label drag) steps back\nwith **↶ Undo** or Ctrl/⌘+Z.\n\n\n\n## Install\n\n```\nadompkg install adom-symbol\n```\n\n## Quick start\n\n```bash\n# Create a symbol from structured pin JSON (stdin or --file)\nadom-symbol create --file rp2040.json --out RP2040\n\n# Preview an existing .kicad_sym as a themed viewer\nadom-symbol preview --file RP2040/RP2040.kicad_sym\n\n# Render a .kicad_sym to a themed thumbnail SVG (+ outline contract for adom-lbr)\nadom-symbol render --file RP2040/RP2040.kicad_sym --out RP2040-symbol.svg\n\n# Run the live app (AI-drivable: /state, /load, /eval, /console)\nadom-symbol serve --port 8781 --file RP2040/RP2040.kicad_sym\n```\n\nOpen the served app through the Adom proxy URL\n(`https://<slug>.adom.cloud/proxy/8781/`), never `localhost:8781` — the webview\nrenders outside the container.\n\n## CLI reference\n\n| Command | Description |\n|---|---|\n| `create --file <json> [--out <dir>]` | Generate `.kicad_sym` + SVG + viewer HTML from pin JSON |\n| `preview --file <kicad_sym> [--out <dir>]` | Render an existing symbol to a themed viewer |\n| `render --file <kicad_sym> --out <svg> [--iso <png>] [--chip-size large\\|medium\\|small]` | Render to a themed thumbnail SVG; auto-composites the 3D-chip outline + emits the outline contract |\n| `embed --file <kicad_sym> [--out <html>]` | Export a self-contained interactive HTML viewer (pan/zoom + pin info) |\n| `serve [--port 8781] [--file <kicad_sym>]` | Run the live AI-drivable viewer + layout studio |\n\n## 3D-chip outline contract (for adom-lbr)\n\nThe default `render` composites the part's **3D-chip vector outline** (white\n`heavy` style, with the part number lasered on the top face) into the symbol\nbody — sized to **0.62×** the body's smaller side, fitted from the source\n`320×320` outline canvas and centred on the body rectangle.\n\n\n\nBecause that exact placement was previously re-guessed downstream (adom-lbr fit\nthe outline to ~0.38× of a different reference frame, so it drifted ~30% small),\n`render` now **exposes the placement** so it can be transcribed 1:1. Next to\n`<mpn>-symbol.svg` it writes:\n\n| File | What it is |\n|---|---|\n| `<mpn>-symbol-outline.mm.svg` | The outline strokes **only**, as decimated (lite) `<polyline>`s, in the **same units / origin / viewBox** as `<mpn>-symbol.svg` (mm, Y-down). A drop-in overlay; each stroke keeps the source style's real colour/width/dash (and the neon glow `<defs>`, blur scaled to mm). |\n| `<mpn>-symbol-outline.json` | A self-describing sidecar: the canonical `default_variant`, the source viewBox, segment count, and the exact transform in **both** frames — EAGLE/KiCad **Y-up** (what adom-lbr maps to) and the symbol-svg **Y-down** overlay frame. |\n\n`adom-lbr generate --symbol-art <mpn>-symbol-outline.mm.svg` detects the contract\n(via the sibling `.json`), derives the svg→EAGLE offset/flip from the two frame\ncentres, and emits the outline as layer-94 `<wire>`s — no re-fitting, no\nre-decimation, so the art lands exactly where adom-symbol drew it.\n\n> The **canonical embedded variant is `heavy`** (white `#e6edf3`, single visible\n> layer) — clean as schematic wires. The multi-layer styles (`blueprint`/`xray`\n> add hidden dashed edges, `neon` is a 2-layer glow) are deliberately avoided for\n> embedding.\n\n### Outline placement (the math `render` exposes)\n\nFor a source outline point `(px, py)` in the `320×320` canvas:\n\n```\nscale = min(body_w, body_h) · 0.62 / 320 # mm per source unit\neagle_x = center_x + (px − 160) · scale # KiCad/EAGLE Y-up\neagle_y = center_y − (py − 160) · scale # (note the Y flip)\n```\n\n`center_x/center_y` (and the Y-down `symbol.svg`-frame equivalents) are written\nverbatim into the sidecar, so a consumer never has to reconstruct them.\n\n### The contract, proven\n\nThe emitted `.mm.svg` (recoloured magenta) placed over the live `-symbol.svg` —\ndead-centre in the body, framed by the real pins, tracing the chip body, side\npads and lasered name. Zero drift.\n\n\n\nReal EAGLE `.lbr` output: **left** transcribed 1:1 from the contract (exact 0.62\nfit, centred); **right** the legacy guess — too small *and* off-centre, because\nit fit the source's ink bbox instead of the canvas.\n\n\n\n\n\n## Architecture\n\nPure Rust. Symbol generation (`src/sym_gen.rs`, `src/discrete_gen.rs`) is a\nbyte-for-byte port of the original generator, **verified against golden files**\nin `tests/`. The only network dependency is **service-kicad** for SVG rendering\n— a lightweight proxy to the shared KiCad-10 container, so nothing installs\nKiCad locally. The live app server (`src/server.rs`) follows the Adom\napp-creator contract: `GET /state`, `POST /load`, `POST /eval` +\n`GET /eval/pending` + `POST /eval/:id/result`, `GET/POST /console`,\n`POST /shutdown`, `GET /favicon.svg`, and best-effort HD port registration.\nPer-symbol layout (including dragged label positions) persists to each chip's\n`info.json` and bakes into its `.kicad_sym` on save.\n\n## Build from source\n\nThe full source ships on the wiki app page — anyone in the community can build\nit locally:\n\n```bash\n# Fetch the source bundle from the wiki\nadompkg source adom-symbol # downloads + unpacks the repo\n\ncargo build --release # standalone — only needs Rust + cargo\ncargo test --release # runs the golden-file parity tests\ncp target/release/adom-symbol ~/.local/bin/\n```\n\nThe only runtime dependency is network access to a service-kicad endpoint\n(`KICAD_SERVICE_API`, defaults to the shared container).\n\n## Wiki\n\nhttps://wiki.adom.inc/adom/adom-symbol\n\n## Contributing & forking — open source under the Adom org\n\n**adom-symbol** is **open source** under the **adom** org on the [Adom Wiki](https://wiki.adom.inc/adom/adom-symbol). The full source lives in this page's repo (public) — open the **Files** tab, or `adompkg source adom-symbol`. Third-party developers are welcome to modify it and contribute back.\n\n**Modify it**\n- Get the source from the Files tab (or `adompkg source adom-symbol`), make your changes, run `cargo test --release` (keep the golden tests green), and rebuild.\n\n**Contribute back to Adom — two paths**\n1. **Pull request (preferred).** The wiki runs a PR-per-page flow: propose your change on this page and the maintainer reviews + merges it — no fork needed.\n2. **Fork + breadcrumb.** Prefer your own fork or add-on? Publish it as your own wiki page, then drop a **breadcrumb on _this_ page** pointing at your fork so it's discoverable:\n - Read existing trails: `GET https://wiki.adom.inc/api/v1/pages/adom-symbol/breadcrumbs`\n - Attach a breadcrumb from your fork's page targeting this anchor (a short label + your slug).\n\n The breadcrumb leaves a **linked path back here**, so **Adom's AI can auto-discover your fork** and surface it to users — the trail is followable both ways. Your fork stays yours; the original stays discoverable.\n\n## License\n\n**MIT** — © 2026 Adom Industries Inc. Open source; see [LICENSE](LICENSE). Modify, fork, and redistribute freely.\n",+ "readme": "# adom-symbol\n\nStandalone Rust CLI + live app for **KiCad schematic symbols**. Generates\n`.kicad_sym` files natively in Rust, renders them as gorgeous dark-themed SVGs\nthrough the shared **service-kicad** container, and serves an AI-drivable live\nviewer with a full layout studio. No Node, no gallia, no local KiCad install.\n\n\n\n## What it does\n\n- **Generate** `.kicad_sym` natively in Rust \u2014 rectangle-body ICs with grouped,\n side-sorted pins (Category A) and discrete passives derived from a KiCad\n baseline symbol (Category B).\n- **Render** the symbol to a cropped, dark-themed SVG via service-kicad\n (`POST /kicad/sch/export/svg`) \u2014 the same render path the chip-fetcher\n dashboard uses, so the thumbnail and the app match exactly. The default render\n **inlines** the part's 3D-chip **vector outline** (with the part number lasered\n on) into the body centre as real `<polyline>`s \u2014 crisp in every renderer\n (browser, librsvg thumbnailer, anything), not a rasterisable `<image>`.\n- **Browse + lay out** a whole chip-fetcher library in the **live viewer**: a\n left chip-library rail (with project filters), a docked **Layout studio** for\n the source / pin arrangement / designator placement / 3D-chip style, drag-to-\n place labels, one-step **Undo**, and **Send to** KiCad / Fusion 360 / Altium /\n OrCAD.\n- **Emit an outline contract** \u2014 alongside `<mpn>-symbol.svg`, `render` writes\n `<mpn>-symbol-outline.mm.svg` + `<mpn>-symbol-outline.json` so **adom-lbr** can\n draw the exact same chip outline onto the EAGLE/Fusion 360 symbol with **zero\n guessing**. See [3D-chip outline contract](#3d-chip-outline-contract-for-adom-lbr).\n- **Serve** a live, AI-drivable app: the frontend stays connected to the Rust\n server (`GET /state` poller + `POST /eval` channel), so the AI can push a new\n symbol, hot-patch the UI, or read the console in real time.\n\n## The live viewer\n\n`adom-symbol serve` opens an interactive, AI-drivable viewer over the whole\nchip-fetcher library. The **Layout studio is always open** on the right \u2014 it's\nwhere you shape the symbol \u2014 and a collapsible chip-library rail sits on the\nleft.\n\n**Browse the library.** Every chip in the library root, with chip-fetcher's\nproject filters; \u2191/\u2193 to step through, and each chip auto-saves the look you give\nit (per-symbol; your last-used choices fill in untouched chips).\n\n\n\n**Shape it in the Layout studio.** Pick the **source** (auto-grouped from ds2sf,\nor any manufacturer / Altium / Fusion / KiCad library variant), the pin\n**layout** (left-right or all-sides) and grouping, the **3D-chip** overlay style\n(off / shaded iso / thin / bold / blue / teal / dark) and size, where the chip\nname shows (lasered on the chip, in the symbol, both, or hidden), and then\n**Send to** a desktop EDA tool.\n\n\n\n**Place the labels \u2014 auto or by hand.** The Reference (`U?`/`Y?`) and chip-name\ndesignators don't have to overlap the body or pins. **Auto-place** centres both\nclear of everything; flip on **Manual** and each label gets a drag-outline you\ngrab and drop exactly where you want \u2014 it re-renders live and auto-saves to that\nchip. Any change (layout, 3D look, size, auto-place, a label drag) steps back\nwith **\u21b6 Undo** or Ctrl/\u2318+Z.\n\n\n\n## Install\n\n```\nadompkg install adom-symbol\n```\n\n## Quick start\n\n```bash\n# Create a symbol from structured pin JSON (stdin or --file)\nadom-symbol create --file rp2040.json --out RP2040\n\n# Preview an existing .kicad_sym as a themed viewer\nadom-symbol preview --file RP2040/RP2040.kicad_sym\n\n# Render a .kicad_sym to a themed thumbnail SVG (+ outline contract for adom-lbr)\nadom-symbol render --file RP2040/RP2040.kicad_sym --out RP2040-symbol.svg\n\n# Run the live app (AI-drivable: /state, /load, /eval, /console)\nadom-symbol serve --port 8781 --file RP2040/RP2040.kicad_sym\n```\n\nOpen the served app through the Adom proxy URL\n(`https://<slug>.adom.cloud/proxy/8781/`), never `localhost:8781` \u2014 the webview\nrenders outside the container.\n\n## CLI reference\n\n| Command | Description |\n|---|---|\n| `create --file <json> [--out <dir>]` | Generate `.kicad_sym` + SVG + viewer HTML from pin JSON |\n| `preview --file <kicad_sym> [--out <dir>]` | Render an existing symbol to a themed viewer |\n| `render --file <kicad_sym> --out <svg> [--iso <png>] [--chip-size large\\|medium\\|small]` | Render to a themed thumbnail SVG; auto-composites the 3D-chip outline + emits the outline contract |\n| `embed --file <kicad_sym> [--out <html>]` | Export a self-contained interactive HTML viewer (pan/zoom + pin info) |\n| `serve [--port 8781] [--file <kicad_sym>]` | Run the live AI-drivable viewer + layout studio |\n\n## 3D-chip outline contract (for adom-lbr)\n\nThe default `render` composites the part's **3D-chip vector outline** (white\n`heavy` style, with the part number lasered on the top face) into the symbol\nbody \u2014 sized to **0.62\u00d7** the body's smaller side, fitted from the source\n`320\u00d7320` outline canvas and centred on the body rectangle.\n\n\n\nBecause that exact placement was previously re-guessed downstream (adom-lbr fit\nthe outline to ~0.38\u00d7 of a different reference frame, so it drifted ~30% small),\n`render` now **exposes the placement** so it can be transcribed 1:1. Next to\n`<mpn>-symbol.svg` it writes:\n\n| File | What it is |\n|---|---|\n| `<mpn>-symbol-outline.mm.svg` | The outline strokes **only**, as decimated (lite) `<polyline>`s, in the **same units / origin / viewBox** as `<mpn>-symbol.svg` (mm, Y-down). A drop-in overlay; each stroke keeps the source style's real colour/width/dash (and the neon glow `<defs>`, blur scaled to mm). |\n| `<mpn>-symbol-outline.json` | A self-describing sidecar: the canonical `default_variant`, the source viewBox, segment count, and the exact transform in **both** frames \u2014 EAGLE/KiCad **Y-up** (what adom-lbr maps to) and the symbol-svg **Y-down** overlay frame. |\n\n`adom-lbr generate --symbol-art <mpn>-symbol-outline.mm.svg` detects the contract\n(via the sibling `.json`), derives the svg\u2192EAGLE offset/flip from the two frame\ncentres, and emits the outline as layer-94 `<wire>`s \u2014 no re-fitting, no\nre-decimation, so the art lands exactly where adom-symbol drew it.\n\n> The **canonical embedded variant is `heavy`** (white `#e6edf3`, single visible\n> layer) \u2014 clean as schematic wires. The multi-layer styles (`blueprint`/`xray`\n> add hidden dashed edges, `neon` is a 2-layer glow) are deliberately avoided for\n> embedding.\n\n### Outline placement (the math `render` exposes)\n\nFor a source outline point `(px, py)` in the `320\u00d7320` canvas:\n\n```\nscale = min(body_w, body_h) \u00b7 0.62 / 320 # mm per source unit\neagle_x = center_x + (px \u2212 160) \u00b7 scale # KiCad/EAGLE Y-up\neagle_y = center_y \u2212 (py \u2212 160) \u00b7 scale # (note the Y flip)\n```\n\n`center_x/center_y` (and the Y-down `symbol.svg`-frame equivalents) are written\nverbatim into the sidecar, so a consumer never has to reconstruct them.\n\n### The contract, proven\n\nThe emitted `.mm.svg` (recoloured magenta) placed over the live `-symbol.svg` \u2014\ndead-centre in the body, framed by the real pins, tracing the chip body, side\npads and lasered name. Zero drift.\n\n\n\nReal EAGLE `.lbr` output: **left** transcribed 1:1 from the contract (exact 0.62\nfit, centred); **right** the legacy guess \u2014 too small *and* off-centre, because\nit fit the source's ink bbox instead of the canvas.\n\n\n\n\n\n## Architecture\n\nPure Rust. Symbol generation (`src/sym_gen.rs`, `src/discrete_gen.rs`) is a\nbyte-for-byte port of the original generator, **verified against golden files**\nin `tests/`. The only network dependency is **service-kicad** for SVG rendering\n\u2014 a lightweight proxy to the shared KiCad-10 container, so nothing installs\nKiCad locally. The live app server (`src/server.rs`) follows the Adom\napp-creator contract: `GET /state`, `POST /load`, `POST /eval` +\n`GET /eval/pending` + `POST /eval/:id/result`, `GET/POST /console`,\n`POST /shutdown`, `GET /favicon.svg`, and best-effort HD port registration.\nPer-symbol layout (including dragged label positions) persists to each chip's\n`info.json` and bakes into its `.kicad_sym` on save.\n\n## Build from source\n\nThe full source ships on the wiki app page \u2014 anyone in the community can build\nit locally:\n\n```bash\n# Fetch the source bundle from the wiki\nadompkg source adom-symbol # downloads + unpacks the repo\n\ncargo build --release # standalone \u2014 only needs Rust + cargo\ncargo test --release # runs the golden-file parity tests\ncp target/release/adom-symbol ~/.local/bin/\n```\n\nThe only runtime dependency is network access to a service-kicad endpoint\n(`KICAD_SERVICE_API`, defaults to the shared container).\n\n## Wiki\n\nhttps://wiki.adom.inc/adom/adom-symbol\n\n## Contributing & forking \u2014 open source under the Adom org\n\n**adom-symbol** is **open source** under the **adom** org on the [Adom Wiki](https://wiki.adom.inc/adom/adom-symbol). The full source lives in this page's repo (public) \u2014 open the **Files** tab, or `adompkg source adom-symbol`. Third-party developers are welcome to modify it and contribute back.\n\n**Modify it**\n- Get the source from the Files tab (or `adompkg source adom-symbol`), make your changes, run `cargo test --release` (keep the golden tests green), and rebuild.\n\n**Contribute back to Adom \u2014 two paths**\n1. **Pull request (preferred).** The wiki runs a PR-per-page flow: propose your change on this page and the maintainer reviews + merges it \u2014 no fork needed.\n2. **Fork + breadcrumb.** Prefer your own fork or add-on? Publish it as your own wiki page, then drop a **breadcrumb on _this_ page** pointing at your fork so it's discoverable:\n - Read existing trails: `GET https://wiki.adom.inc/api/v1/pages/adom-symbol/breadcrumbs`\n - Attach a breadcrumb from your fork's page targeting this anchor (a short label + your slug).\n\n The breadcrumb leaves a **linked path back here**, so **Adom's AI can auto-discover your fork** and surface it to users \u2014 the trail is followable both ways. Your fork stays yours; the original stays discoverable.\n\n## License\n\n**MIT** \u2014 \u00a9 2026 Adom Industries Inc. Open source; see [LICENSE](LICENSE). Modify, fork, and redistribute freely.\n", "discovery_pitch": "Generate, preview, and lay out KiCad/EAGLE schematic symbols in an interactive studio, then deliver them straight to KiCad, Fusion 360, Altium, or OrCAD.", "discovery_triggers": [ "create a kicad symbol",@@ -67,4 +67,4 @@ "prompt": "open my RP2040.kicad_sym in the interactive symbol viewer" } ]-}+}
src/main.rs+19−3@@ -49,6 +49,12 @@ enum Cmd { /// create JSON, the cwd, or chip-fetcher's library/<mpn>/. #[arg(long)] outline_svg: Option<PathBuf>,+ /// Where the part number goes when the outline itself carries no name:+ /// `under` (default, lasered under the chip inside the icon box) or+ /// `none` (the outline already shows the MPN, e.g. a side-etched STEP).+ /// Same as `preferences.outlineName`.+ #[arg(long)]+ outline_name: Option<String>, }, /// Render an existing .kicad_sym to a themed viewer HTML. Preview {@@ -220,6 +226,10 @@ struct Preferences { /// "large" | "medium" | "small". Unset → global `chipSize`, else "large". #[serde(default, rename = "chipSize")] chip_size: Option<String>,+ /// Where the part number goes when the baked outline carries no name:+ /// "under" (default) or "none" (the outline already shows the MPN).+ #[serde(default, rename = "outlineName")]+ outline_name: Option<String>, } /// The user's global symbol preferences (`~/.claude/skills/adom/preferences.json`,@@ -314,7 +324,7 @@ fn main() { fn run() -> Result<()> { match Cli::parse().command {- Cmd::Create { file, out, no_chip_outline, chip_outline, chip_size, outline_svg } => cmd_create(file, out, no_chip_outline, chip_outline, chip_size, outline_svg),+ Cmd::Create { file, out, no_chip_outline, chip_outline, chip_size, outline_svg, outline_name } => cmd_create(file, out, no_chip_outline, chip_outline, chip_size, outline_svg, outline_name), Cmd::Render { file, out, iso, chip_size } => { let content = fs::read_to_string(&file).with_context(|| format!("reading {}", file.display()))?; let name = first_symbol_name(&content).unwrap_or_else(|| "symbol".to_string());@@ -505,7 +515,7 @@ fn annotate_contract(json: &str, kicad_sym: &str, name: &str) -> String { serde_json::to_string_pretty(&v).unwrap_or_else(|_| json.to_string()) } -fn cmd_create(file: Option<PathBuf>, out: Option<PathBuf>, no_chip_outline: bool, chip_outline_flag: bool, chip_size_flag: Option<String>, outline_svg_flag: Option<PathBuf>) -> Result<()> {+fn cmd_create(file: Option<PathBuf>, out: Option<PathBuf>, no_chip_outline: bool, chip_outline_flag: bool, chip_size_flag: Option<String>, outline_svg_flag: Option<PathBuf>, outline_name_flag: Option<String>) -> Result<()> { let file_dir: Option<PathBuf> = file.as_ref().and_then(|p| p.parent().map(|d| d.to_path_buf())); let body = match file { Some(p) => fs::read_to_string(&p).with_context(|| format!("reading {}", p.display()))?,@@ -575,6 +585,12 @@ fn cmd_create(file: Option<PathBuf>, out: Option<PathBuf>, no_chip_outline: bool } else { (None, "chip outline: off (--no-chip-outline / preferences.chipOutline=false)".to_string()) };+ let name_mode = outline_name_flag.clone().or_else(|| input.preferences.outline_name.clone()).unwrap_or_else(|| "under".to_string());+ let chip_outline = chip_outline.map(|mut o| {+ if name_mode == "none" { o.name_at = None; }+ o+ });+ let note = if name_mode == "none" && chip_outline.is_some() { format!("{note}; part number NOT lasered under the chip (--outline-name none: the outline carries it)") } else { note }; outline_note = note; let icinput = sym_gen::IcInput { symbol_name: input.symbol_name.clone(),@@ -640,7 +656,7 @@ fn cmd_create(file: Option<PathBuf>, out: Option<PathBuf>, no_chip_outline: bool } else if src.starts_with("generic-iso") { println!("_hint: GENERIC CHIP BAKED because no STEP/outline for {mpn} was found. Get the real body, in this order, then re-run this create: (0) the Adom wiki (`adom-wiki discover search --query {mpn}`: a component page ships the STEP, outline cache and symbol already); (1) the manufacturer's STEP — WebFetch/curl are blocked by ST/TI/Mouser-class bot walls (curl: (92) HTTP/2 INTERNAL_ERROR, 60 s WebFetch timeout), so use pup on the desktop with the site skill (`adom/electronics-sites-skillpack`, e.g. electronics-site-st: the CAD Resources tab is a SamacSys/UltraLibrarian widget); sign in from pup's vault (`pup_login`; seed it once with `pup_import_browser_logins {{}}` — one consent + one UAC is fine), and DRIVE any captcha yourself (trusted click + vision on the image grid; never hand it to the user, never switch to the CDP lane); (2) `chip-fetcher fetch {mpn}` runs that ladder for you; (3) if no STEP can be had, MODEL IT YOURSELF from the datasheet outline drawing (CadQuery: cap, windows, markings, pin-1) and ship that STEP — a library must carry a 3D body for the board render. Then `adom-chip-thumbnailer once {mpn}` (writes {mpn}-3d-outline-*-named.svg into chip-fetcher's library/{mpn}/). Off entirely: --no-chip-outline."); } else {- println!("_hint: The name is lasered under the chip (un-named outline). If you would rather have it on the die, use the `-named` outline: `--outline-svg .../{mpn}-3d-outline-heavy-named.svg`.");+ println!("_hint: The name is lasered under the chip (un-named outline) unless you passed `--outline-name none`. If the STEP behind this outline is side-etched (the MPN already shows on the chip's wall), pass `--outline-name none` so the part number is not shown twice. For a name on the die, use the `-named` outline: `--outline-svg .../{mpn}-3d-outline-heavy-named.svg` (only for plain tops; never for optical / feature-rich tops)."); } } Ok(())