sldeditor 0.0.1

package/LICENSE

@@ -0,0 +1,25 @@
+MIT License
+
+Copyright (c) 2026 NovaShang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+Note: This software embeds electrical symbols originally from the QElectroTech
+project (https://qelectrotech.org), distributed under the Creative Commons
+Attribution 3.0 License. See THIRD_PARTY_NOTICES.md for attribution details.

package/README.md

@@ -0,0 +1,117 @@
+# sldeditor
+
+In-browser editor component for **electrical single-line diagrams (SLD / 一次系统图)**. Pure-frontend, no backend, no cloud. Designed to be dropped into a React app or used standalone.
+
+> The local source directory is named `oneline-editor` (legacy); the npm package is `sldeditor`.
+
+## What's in the box
+
+- **47 built-in symbols** — breaker, disconnector, transformer (2W/3W), busbar, CT/PT, generator, motor, PV, inverter, EV charger, battery, meter, arrester, fuse, recloser, VFD, and more. Symbol set lives in `src/element-library/*.json` and is hot-loaded into a typed registry.
+- **Terminal-level wiring** — connect to pins, not bounding boxes. Auto-snap + orthogonal routing.
+- **Busbar as a first-class element** — stretchable, multi-tap, handles arbitrary device attachments.
+- **Explicit topology model** — connectivity nodes computed from terminal coincidence, separate from rendering geometry. Exposed via the `compile()` function so you can run your own analyses on top.
+- **Undo/redo, multi-select, copy/paste, alignment, snap, grid, zoom/pan**.
+- **Local-first persistence** — JSON file open/save, plus SVG / PNG / DXF export. State is also cached in `localStorage` so refresh doesn't lose work.
+- **i18n** — Chinese + English UI, locale store exposed so embedders can sync with their own translation layer.
+
+## Install
+
+```bash
+npm install sldeditor
+```
+
+```tsx
+import { OneLineEditor } from 'sldeditor';
+import 'sldeditor/style.css';
+
+export default function App() {
+  return (
+    <div style={{ height: '100vh' }}>
+      <OneLineEditor />
+    </div>
+  );
+}
+```
+
+Peer deps: `react >= 18`, `react-dom >= 18` (React 19 tested).
+
+`OneLineEditor` mounts a full editor (canvas + toolbars + panels). Pass `diagram` to seed an initial `DiagramFile`; otherwise it loads from `localStorage` or starts empty.
+
+### Style isolation
+
+Every selector in `sldeditor/style.css` is scoped under `.ole-root` — including all Tailwind utilities and CSS variables. The editor always renders that wrapper, so the stylesheet is safe to drop into a host app that has its own Tailwind, design system, or hand-written CSS without collisions.
+
+### Migrating from a git submodule
+
+If your repo currently pulls this project as a submodule:
+
+```bash
+git submodule deinit -- oneline-editor
+git rm oneline-editor
+rm -rf .git/modules/oneline-editor
+npm install sldeditor
+```
+
+Then rewrite imports:
+
+```diff
+- import { OneLineEditor } from '../oneline-editor/src';
++ import { OneLineEditor } from 'sldeditor';
++ import 'sldeditor/style.css';
+```
+
+The `style.css` import is **required** in npm mode (in the submodule layout your bundler probably picked up the source Tailwind file via content scan; in npm mode you get the prebuilt bundle).
+
+## Public API
+
+The editor reads/writes from a built-in zustand store. For embedding apps that want programmatic control (importers, AI tool-calling, custom renderers), `src/index.ts` exports:
+
+- `useEditorStore` — full store: diagram, selection, viewport, undo stack
+- `compile(diagram)` — produces an `InternalModel` with resolved geometry + connectivity nodes; use it to build viewers or run topology analysis without re-implementing the model
+- `LIBRARY`, `getLibraryEntry` — the symbol registry
+- `newBusId`, `newElementId`, `wireIdFromEnds` — id allocators for programmatic edits (deterministic content-hash wire ids so the same endpoint pair always maps to the same id)
+- `FileMenu`, `ExportMenu` — optional toolbar widgets if you want the bundled file/export UX
+- `buildExportSvg`, `downloadSvg`, `downloadPng`, `buildExportDxf`, `downloadDxf` — export primitives if you're building your own export UI
+- `fitToContent`, `fitToContentSoon` — reset the viewport after programmatic edits
+- `useLocale` — sync editor UI language with your app's i18n
+
+## What it's not
+
+- Not a format converter — does **not** read/write CIM, IEC 61850 SCL, PSD-BPA, PSS/E, or PowerFactory formats. JSON only.
+- Not a simulator — no power flow, short-circuit, or stability calculations.
+- Not a SCADA viewer — no real-time binding.
+- Not a secondary / control-loop diagram tool.
+
+## Docs
+
+- [Getting started](./docs/getting-started.md) — install, sizing, seeding, theme/locale, exports
+- [API reference](./docs/api.md) — every public export, grouped by purpose
+- [Data model](./docs/data-model.md) — `DiagramFile` schema
+- [Embedding + viewer API design](./docs/binding-and-viewer-api.md) — runtime data-binding plans
+- [Runtime PRD](./docs/runtime-prd.md) — read-only viewer roadmap
+- [Blog / changelog notes](./docs/blog/)
+
+## Develop
+
+```bash
+npm install
+npm run dev          # standalone demo at localhost:5173
+npm run build:lib    # produces dist/sldeditor.js + dist/style.css
+npm run typecheck
+npm test
+```
+
+### Releasing
+
+Versions ship via [Changesets](https://github.com/changesets/changesets). After making a publishable change:
+
+```bash
+npx changeset             # write a patch/minor/major note
+git commit -am "feat: ..."
+```
+
+When the PR lands on `master`, the **Release** GitHub Action opens a "Version Packages" PR; merging that PR publishes to npm and creates a GitHub release. Repo needs an `NPM_TOKEN` secret with automation-token scope.
+
+## License
+
+MIT. Third-party attributions in [THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md).

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,31 @@
+# Third-Party Notices
+
+OneLineEditor 包含、使用或基于以下第三方资源。本文件汇总它们的来源、许可与使用约束。
+
+---
+
+## QElectroTech Elements Collection
+
+- **来源**：QElectroTech 项目, https://qelectrotech.org
+- **使用位置**：`third_party/qelectrotech/10_electric/`
+- **使用方式**：作为电气元件符号的素材来源。后续会通过脚本将 `.elmt` 文件转换为 SVG + 端口元数据，集成到本项目的元件库中。
+- **License**：Creative Commons Attribution 3.0 (CC-BY 3.0)
+  - 全文：https://creativecommons.org/licenses/by/3.0/
+  - 上游声明：见 `third_party/qelectrotech/ELEMENTS.LICENSE`
+
+### 署名（Attribution）
+
+> Electrical symbols originally from the QElectroTech project (https://qelectrotech.org), distributed under the Creative Commons Attribution 3.0 License.
+>
+> 本产品中的电气元件符号源自 QElectroTech 项目（https://qelectrotech.org），依 CC-BY 3.0 许可使用。如有改动（例如适配 Web 渲染、调整端子坐标），均为 OneLineEditor 项目所做的修改。
+
+### 使用约束
+
+1. **必须保留署名**：在产品的"关于"信息、文档或源代码注释中保留上述 attribution。
+2. **必须声明修改**：经过转换/修改的元件 SVG 应在元数据中保留 "modified from QElectroTech original" 字样。
+3. **不可暗示作者背书**：不得以任何方式暗示 QElectroTech 项目或其作者认可、推荐 OneLineEditor。
+4. **禁止用作机器学习训练数据**：上游 ELEMENTS.LICENSE 显式禁止将 elements 文件用于训练 ML 模型。本项目不得、亦不得允许第三方将 `third_party/qelectrotech/` 下的 `.elmt` 文件或其衍生产物用于此目的。
+
+### 注意
+
+- **QElectroTech 应用程序本体**采用 GPLv2 license。本项目**不**包含或链接其应用代码，仅使用其 elements collection（CC-BY 3.0）。GPLv2 不波及本项目。

package/dist/OneLineEditor.d.ts

@@ -0,0 +1,24 @@
+import { DiagramFile } from './model';
+import { Locale } from './i18n';
+import { Theme } from './hooks/use-theme';
+export interface OneLineEditorProps {
+    className?: string;
+    /** Initial DiagramFile to render. Re-renders when this reference changes. */
+    diagram?: DiagramFile;
+    /**
+     * Force the editor's UI language. When omitted, falls back to the user's
+     * previous choice (localStorage) or the browser's locale. When set, the
+     * embedder owns the language and any change to this prop is mirrored into
+     * the locale store.
+     */
+    locale?: Locale;
+    /**
+     * Force the editor's color mode. When omitted, uses the user's previous
+     * choice or OS `prefers-color-scheme`. Applied via the `dark` class on
+     * `<html>` (the standard Tailwind pattern), so embedding hosts that share
+     * the same documentElement will see the same class.
+     */
+    theme?: Theme;
+}
+export declare function OneLineEditor({ className, diagram, locale, theme }: OneLineEditorProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=OneLineEditor.d.ts.map

package/dist/OneLineEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OneLineEditor.d.ts","sourceRoot":"","sources":["../src/OneLineEditor.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,EAAa,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAc,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,wBAAgB,aAAa,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,kBAAkB,2CAoCtF"}

package/dist/canvas/AnnotationLayer.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Renders structural labels (element ID + showOnCanvas params) next to each
+ * element. Labels are derived purely from `Element` data and the library
+ * schema — they do not live in the diagram's serialized form.
+ *
+ * The label block is positioned at the world projection of the element's
+ * `LibraryEntry.label` anchor (or a viewBox-derived fallback). Element
+ * rotation moves the anchor accordingly, but the text itself is rendered
+ * upright (no rotate on the text group) so labels stay readable.
+ *
+ * Visibility is governed by `DiagramFile.meta.labelMode`:
+ *   - 'off' → no labels.
+ *   - 'id'  → element name/ID only.
+ *   - 'all' → ID plus each library param marked `showOnCanvas: true`.
+ * Default when unset: 'all'.
+ */
+export declare function AnnotationLayer(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AnnotationLayer.d.ts.map

package/dist/canvas/AnnotationLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnnotationLayer.d.ts","sourceRoot":"","sources":["../../src/canvas/AnnotationLayer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAaH,wBAAgB,eAAe,4CAoD9B"}

package/dist/canvas/BusHandles.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Stretch handles for the selected bus. Two `<circle>` grips at the bus's
+ * endpoints. Dragging a grip updates the bus's `span`, and — for the
+ * trailing grip — shifts `at` so the opposite end stays fixed visually.
+ *
+ * Handles capture pointer events themselves; SelectTool sees the drag start
+ * on a non-element target and won't try to also move the bus body.
+ */
+export declare function BusHandles(): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=BusHandles.d.ts.map

package/dist/canvas/BusHandles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BusHandles.d.ts","sourceRoot":"","sources":["../../src/canvas/BusHandles.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,wBAAgB,UAAU,mDAkCzB"}

package/dist/canvas/BusLayer.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Renders one `<g>` per bus. Each bus is a horizontal or vertical line
+ * segment whose length is `geometry.span` and direction is given by
+ * `geometry.axis` (x → horizontal, y → vertical). Tagged with `data-bus-id`
+ * so hit-test can identify clicks on the bus body.
+ */
+export declare function BusLayer(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=BusLayer.d.ts.map

package/dist/canvas/BusLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BusLayer.d.ts","sourceRoot":"","sources":["../../src/canvas/BusLayer.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,wBAAgB,QAAQ,4CA0EvB"}

package/dist/canvas/BusbarPreview.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Live preview for the busbar tool. Snaps the cursor to the dominant axis
+ * (horizontal or vertical) so users see exactly the line that will be
+ * created on pointerup.
+ */
+export declare function BusbarPreview(): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=BusbarPreview.d.ts.map

package/dist/canvas/BusbarPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BusbarPreview.d.ts","sourceRoot":"","sources":["../../src/canvas/BusbarPreview.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,wBAAgB,aAAa,mDAmC5B"}

package/dist/canvas/CanvasSvg.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Top-level canvas SVG. Owns the pan/zoom viewport `<g>`, the static grid
+ * background, and the active-tool dispatcher. Layers (wires, elements,
+ * selection, terminals, previews) are children of the viewport so they
+ * pan/zoom together.
+ *
+ * Z-order (back to front): grid → wires → elements → selection → terminals
+ * → wire preview → place ghost.
+ */
+export declare function CanvasSvg(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=CanvasSvg.d.ts.map

package/dist/canvas/CanvasSvg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CanvasSvg.d.ts","sourceRoot":"","sources":["../../src/canvas/CanvasSvg.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAyDH,wBAAgB,SAAS,4CAgRxB"}

package/dist/canvas/ElementHoverLabel.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Floating name tag that follows the hovered element on the canvas. Reads
+ * the hover signal published by `useHoverHighlight` and locates the
+ * element's `<g>` via the DOM (so it tracks pan, zoom, and live drags
+ * without re-rendering React). Shows `name (kind)` or just `id` for
+ * unnamed elements; portals to body so it isn't clipped.
+ */
+export declare function ElementHoverLabel(): import('react').ReactPortal | null;
+//# sourceMappingURL=ElementHoverLabel.d.ts.map

package/dist/canvas/ElementHoverLabel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElementHoverLabel.d.ts","sourceRoot":"","sources":["../../src/canvas/ElementHoverLabel.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwBH,wBAAgB,iBAAiB,uCAkGhC"}

package/dist/canvas/ElementLayer.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Renders one `<g>` per element. The library SVG fragment is inlined verbatim
+ * via `dangerouslySetInnerHTML` — the library JSON is build-time content
+ * (see `scripts/build-element-library.mjs`), not user input.
+ *
+ * Each `<g>` carries `data-element-id` so tools can hit-test via
+ * `event.target.closest('[data-element-id]')` without React state. Selection
+ * state is reflected as `data-selected="true"` so CSS / overlays can react
+ * without re-rendering this layer's children.
+ *
+ * To make every element comfortable to click — not just its thin strokes —
+ * we paint an invisible `<rect>` covering the library's viewBox before the
+ * symbol. `fill="transparent"` is hittable (unlike `none`); the visual lines
+ * still draw on top because they're added after.
+ */
+export declare function ElementLayer(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ElementLayer.d.ts.map

package/dist/canvas/ElementLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElementLayer.d.ts","sourceRoot":"","sources":["../../src/canvas/ElementLayer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAiCH,wBAAgB,YAAY,4CAgF3B"}

package/dist/canvas/FreeAnnotationLayer.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Renders user-created free text annotations from `diagram.annotations`.
+ * Each annotation is a draggable, editable note unattached to any element.
+ *
+ * Three render states per annotation:
+ *   1. Idle              → `<text>` painted at its position.
+ *   2. Selected (idle)   → text plus a dashed bbox halo (matches element halo).
+ *   3. Editing           → `<foreignObject>` hosting a contentEditable div;
+ *                          autoselects content on entry, commits on Enter or
+ *                          blur, drops empty content on commit (auto-cleanup
+ *                          of empty annotations created by the text tool).
+ *
+ * Hit-testing carries the annotation's id via `data-annotation-id` so tools
+ * can route the gesture without React state lookups, mirroring how elements
+ * use `data-element-id`.
+ */
+export declare function FreeAnnotationLayer(): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=FreeAnnotationLayer.d.ts.map

package/dist/canvas/FreeAnnotationLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FreeAnnotationLayer.d.ts","sourceRoot":"","sources":["../../src/canvas/FreeAnnotationLayer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH,wBAAgB,mBAAmB,mDAsBlC"}

package/dist/canvas/MarqueeOverlay.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Renders the in-progress marquee selection rect. Subscribes directly to
+ * `marquee-bus` to avoid going through React state for every pointermove.
+ */
+export declare function MarqueeOverlay(): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=MarqueeOverlay.d.ts.map

package/dist/canvas/MarqueeOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarqueeOverlay.d.ts","sourceRoot":"","sources":["../../src/canvas/MarqueeOverlay.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,wBAAgB,cAAc,mDAe7B"}

package/dist/canvas/PlaceGhost.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Half-transparent preview of the kind being placed, following the cursor
+ * during the place tool.
+ *
+ * The cursor "carries" one of the new element's terminals (the tap-side
+ * pin — same one `dropElement` snaps to a bus, and the same one used for
+ * free-placement). Visually this means the pointer touches the pin you'd
+ * expect to drop onto a wire/bus, not the element's centroid.
+ *
+ * In drag-from-terminal mode (`placeFromTerminal != null`) we additionally
+ * draw a dashed wire from the source terminal to whichever pin of the ghost
+ * is closest — same visual language as `WirePreview`, so the user sees the
+ * connection that will be committed on release.
+ */
+export declare function PlaceGhost(): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=PlaceGhost.d.ts.map

package/dist/canvas/PlaceGhost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaceGhost.d.ts","sourceRoot":"","sources":["../../src/canvas/PlaceGhost.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAUH,wBAAgB,UAAU,mDA0DzB"}

package/dist/canvas/SelectionOverlay.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Renders a non-scaling stroke rect around every selected element / bus
+ * using the library viewBox (devices) or BusGeometry (buses) as the base
+ * bbox, then applying the same transform.
+ */
+export declare function SelectionOverlay(): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=SelectionOverlay.d.ts.map

package/dist/canvas/SelectionOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectionOverlay.d.ts","sourceRoot":"","sources":["../../src/canvas/SelectionOverlay.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,wBAAgB,gBAAgB,mDAmD/B"}

package/dist/canvas/TerminalLayer.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Renders a `<circle>` per terminal at its world coords. Hidden by default;
+ * the wire tool reveals them via the `.tool-wire` class on the canvas root.
+ * In select mode, terminals on currently-selected elements are also revealed
+ * so the user can grab one to drag-connect without switching tools.
+ * `data-connected` distinguishes solid (connected) from hollow (dangling).
+ *
+ * Selected stretchable elements (e.g. busbar) get their terminals suppressed
+ * here because `BusHandles` already draws a larger grip at the same world
+ * coords — showing both produces visible "double" control points.
+ */
+export declare function TerminalLayer(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=TerminalLayer.d.ts.map

package/dist/canvas/TerminalLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TerminalLayer.d.ts","sourceRoot":"","sources":["../../src/canvas/TerminalLayer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,wBAAgB,aAAa,4CAiC5B"}

package/dist/canvas/WireLayer.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Renders one polyline per Wire. Each polyline carries `data-wire-id` so
+ * hit-test resolves to the specific wire (not the whole electrical node)
+ * and `data-node-id` for "select-whole-node" affordances.
+ *
+ * Each visible wire is paired with a wider invisible hit polyline. A 1px
+ * wire is too thin to comfortably click; the hit poly catches pointer
+ * events within ~8px of the line and carries the same data attributes.
+ */
+export declare function WireLayer(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WireLayer.d.ts.map

package/dist/canvas/WireLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WireLayer.d.ts","sourceRoot":"","sources":["../../src/canvas/WireLayer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,wBAAgB,SAAS,4CA6CxB"}

package/dist/canvas/WirePreview.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Dashed line from the chosen first terminal to the current cursor position
+ * while the wire tool is mid-drag. When the cursor is over a valid drop
+ * target (a terminal or a bus body), an additional ring + dot marks the
+ * exact landing point so the user can release with confidence.
+ */
+export declare function WirePreview(): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=WirePreview.d.ts.map

package/dist/canvas/WirePreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WirePreview.d.ts","sourceRoot":"","sources":["../../src/canvas/WirePreview.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,wBAAgB,WAAW,mDA0D1B"}

package/dist/canvas/drop-on-bus.d.ts

@@ -0,0 +1,45 @@
+import { BusId, ElementId, LibraryEntry, LibraryTerminal, Orientation, WireEnd } from '../model';
+export interface DropResult {
+    newElementId: ElementId;
+    attachedToBus: boolean;
+}
+export declare function dropElement(kind: string, at: [number, number]): DropResult;
+/**
+ * The library terminal that should sit at the cursor while a free placement
+ * is in progress — same "tap-side" rule as `pickTapTerminal`, returned as a
+ * full terminal so callers can offset placement (or the place ghost) so the
+ * cursor visually holds that pin instead of the element's hotspot.
+ *
+ * Stretchable kinds don't have a meaningful tap; returns null and callers
+ * use the element's hotspot.
+ */
+export declare function pickPlaceCursorTerminal(lib: LibraryEntry): LibraryTerminal | null;
+/**
+ * Resolved place-source: world coords + orientation of the terminal we're
+ * dragging from. Handles both real device terminals and a bare bus id
+ * (projected onto the bus axis at the cursor point, with orientation flipped
+ * to point toward the drag side so the new element body extends away).
+ */
+export interface PlaceSource {
+    ref: WireEnd;
+    world: [number, number];
+    orientation: Orientation;
+    /** True iff `ref` is a bus id (bare, no dot). */
+    isBus: boolean;
+    /** Set when isBus. */
+    busId?: BusId;
+}
+export declare function resolvePlaceSource(ref: WireEnd, cursorWorld: [number, number]): PlaceSource | null;
+/**
+ * Pick which terminal of the new element should connect to the source.
+ * Prefer a terminal whose orientation is opposite to the source's (so the
+ * body extends naturally *away* from the source). Tie-break by world
+ * distance to source.
+ */
+export declare function pickConnectTerminal(lib: LibraryEntry, source: PlaceSource, placeAt: [number, number]): LibraryTerminal;
+/**
+ * Place a new element with one of its terminals connected to `sourceRef` in
+ * a single undo step.
+ */
+export declare function dropElementFromTerminal(kind: string, sourceRef: WireEnd, cursorAt: [number, number]): DropResult | null;
+//# sourceMappingURL=drop-on-bus.d.ts.map

package/dist/canvas/drop-on-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop-on-bus.d.ts","sourceRoot":"","sources":["../../src/canvas/drop-on-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,KAAK,EAGL,SAAS,EACT,YAAY,EACZ,eAAe,EACf,WAAW,EAIX,OAAO,EACR,MAAM,UAAU,CAAC;AAOlB,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,SAAS,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,UAAU,CAkD1E;AA6CD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,YAAY,GAChB,eAAe,GAAG,IAAI,CAIxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxB,WAAW,EAAE,WAAW,CAAC;IACzB,iDAAiD;IACjD,KAAK,EAAE,OAAO,CAAC;IACf,sBAAsB;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,EACZ,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,WAAW,GAAG,IAAI,CA8BpB;AASD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GACxB,eAAe,CAkBjB;AAYD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,OAAO,EAClB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GACzB,UAAU,GAAG,IAAI,CA4CnB"}

package/dist/canvas/fit-to-content.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Fit-to-content viewport reset, shared by the explicit "fit" button in
+ * ViewToolbar and the automatic reset that fires on first mount / after
+ * loading a file.
+ *
+ * Element bboxes come from the live DOM (`data-element-id` nodes), so the
+ * canvas must already have rendered the diagram. `fitToContentSoon` defers
+ * via rAF until that's true (typical use: store update → next frame fit).
+ */
+/**
+ * Fit all rendered elements to the viewport with padding. Falls back to a
+ * centered 100% reset when the canvas is empty. Returns false if the
+ * viewport / canvas isn't ready yet.
+ */
+export declare function fitToContent(): boolean;
+/**
+ * Run `fitToContent` after the next paint, retrying for a few frames in case
+ * the canvas hasn't mounted yet (initial mount race) or the diagram has
+ * just been swapped and the new DOM nodes aren't yet attached.
+ */
+export declare function fitToContentSoon(): void;
+//# sourceMappingURL=fit-to-content.d.ts.map

package/dist/canvas/fit-to-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fit-to-content.d.ts","sourceRoot":"","sources":["../../src/canvas/fit-to-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiBH;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,OAAO,CA4CtC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAOvC"}

package/dist/canvas/grid.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Grid snap helpers. Snapping is bound to the visual grid: when the user
+ * hides the grid (ViewToolbar / `G`), `.hide-grid` lands on the canvas
+ * root and snap() returns the value untouched. So "show grid" and "snap to
+ * grid" are one switch.
+ *
+ * Used by: SelectTool drag move, BusHandles span resize, drop-on-bus
+ * placement, drag-drop from palette.
+ */
+export declare const GRID_SIZE = 10;
+export declare function isSnapEnabled(): boolean;
+export declare function snap(v: number): number;
+export declare function snapPoint(p: [number, number]): [number, number];
+//# sourceMappingURL=grid.d.ts.map

package/dist/canvas/grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid.d.ts","sourceRoot":"","sources":["../../src/canvas/grid.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B,wBAAgB,aAAa,IAAI,OAAO,CAIvC;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtC;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAE/D"}

package/dist/canvas/hit-test.d.ts

@@ -0,0 +1,14 @@
+import { AnnotationId, BusId, ElementId, NodeId, WireEnd, WireId } from '../model';
+export declare function hitElement(target: EventTarget | null): ElementId | null;
+export declare function hitBus(target: EventTarget | null): BusId | null;
+/**
+ * Returns either a device terminal ref ("X.Y") or a bare bus id under the
+ * cursor. Direct hit on a `data-terminal-id` node wins; otherwise if the
+ * click landed on a bus body fall back to the bus id so the wire tool can
+ * attach anywhere along the bus.
+ */
+export declare function hitTerminal(target: EventTarget | null): WireEnd | null;
+export declare function hitNode(target: EventTarget | null): NodeId | null;
+export declare function hitWire(target: EventTarget | null): WireId | null;
+export declare function hitAnnotation(target: EventTarget | null): AnnotationId | null;
+//# sourceMappingURL=hit-test.d.ts.map

package/dist/canvas/hit-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hit-test.d.ts","sourceRoot":"","sources":["../../src/canvas/hit-test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,KAAK,EACL,SAAS,EACT,MAAM,EAEN,OAAO,EACP,MAAM,EACP,MAAM,UAAU,CAAC;AAOlB,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAEvE;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,GAAG,IAAI,CAMtE;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAEjE;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAEjE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,YAAY,GAAG,IAAI,CAK7E"}

package/dist/canvas/hover-bus.d.ts

@@ -0,0 +1,7 @@
+import { ElementId } from '../model';
+type Listener = (id: ElementId | null) => void;
+export declare function publishHoverElement(id: ElementId | null): void;
+export declare function getHoverElement(): ElementId | null;
+export declare function subscribeHoverElement(fn: Listener): () => void;
+export {};
+//# sourceMappingURL=hover-bus.d.ts.map

package/dist/canvas/hover-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hover-bus.d.ts","sourceRoot":"","sources":["../../src/canvas/hover-bus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,KAAK,QAAQ,GAAG,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,CAAC;AAK/C,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI,CAI9D;AAED,wBAAgB,eAAe,IAAI,SAAS,GAAG,IAAI,CAElD;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,IAAI,CAK9D"}

package/dist/canvas/index.d.ts

@@ -0,0 +1,11 @@
+export { CanvasSvg } from './CanvasSvg';
+export { useViewport } from './useViewport';
+export { useTools } from './useTools';
+export { useKeyboardShortcuts } from './useKeyboardShortcuts';
+export { transformAttr } from './transform-attr';
+export { hitElement, hitTerminal, hitNode } from './hit-test';
+export { getScale, subscribeScale } from './zoom-bus';
+export { getViewportApi, setViewportApi } from './viewport-bus';
+export { fitToContent, fitToContentSoon } from './fit-to-content';
+export type { Viewport, ViewportApi } from './useViewport';
+//# sourceMappingURL=index.d.ts.map

package/dist/canvas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/canvas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAClE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/canvas/marquee-bus.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Tiny pub/sub for the marquee selection rect (in SVG coords). Used by
+ * SelectTool to publish rect updates and by `<MarqueeOverlay>` to render
+ * without bouncing through the editor store.
+ */
+export interface MarqueeRect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+type Listener = (rect: MarqueeRect | null) => void;
+export declare function publishMarquee(rect: MarqueeRect | null): void;
+export declare function getMarquee(): MarqueeRect | null;
+export declare function subscribeMarquee(fn: Listener): () => void;
+export {};
+//# sourceMappingURL=marquee-bus.d.ts.map

package/dist/canvas/marquee-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marquee-bus.d.ts","sourceRoot":"","sources":["../../src/canvas/marquee-bus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,KAAK,QAAQ,GAAG,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;AAKnD,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAG7D;AAED,wBAAgB,UAAU,IAAI,WAAW,GAAG,IAAI,CAE/C;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,IAAI,CAKzD"}

package/dist/canvas/resolve-wire-target.d.ts

@@ -0,0 +1,4 @@
+import { WireEnd } from '../model';
+import { WireTarget } from './wire-target-bus';
+export declare function resolveWireTarget(ref: WireEnd, cursorWorld: [number, number]): WireTarget | null;
+//# sourceMappingURL=resolve-wire-target.d.ts.map

package/dist/canvas/resolve-wire-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-wire-target.d.ts","sourceRoot":"","sources":["../../src/canvas/resolve-wire-target.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,EACZ,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,UAAU,GAAG,IAAI,CAwBnB"}