ducsvg 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ducflair
+
+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.

package/README.md

@@ -0,0 +1,46 @@
+<p align="center">
+  <br/>
+  <a href="https://duc.ducflair.com" target="_blank"><img width="256px" src="https://raw.githubusercontent.com/ducflair/assets/refs/heads/main/src/duc/duc-extended.png" /></a>
+  <p align="center">SVG Adapter for the duc 2D CAD File Format</p>
+  <p align="center" style="align: center;">
+    <a href="https://www.npmjs.com/package/ducsvg"><img src="https://shields.io/badge/NPM-cc3534?logo=Npm&logoColor=white&style=round-square" alt="NPM" /></a>
+    <a href="https://www.npmjs.com/package/ducsvg"><img src="https://img.shields.io/npm/v/ducsvg/latest?style=round-square&label=latest%20stable" alt="NPM ducsvg@latest release" /></a>
+    <a href="https://www.npmtrends.com/ducsvg"><img src="https://img.shields.io/npm/dm/ducsvg?style=round-square&color=salmon" alt="Downloads" /></a>
+    <img src="https://shields.io/badge/TypeScript-3178C6?logo=TypeScript&logoColor=fff&style=round-square" alt="TypeScript" />
+  </p>
+</p>
+
+# ducsvg
+
+`ducsvg` is a lightweight adapter for rendering `duc` CAD documents to SVG. It’s built on top of `ducjs` and focuses on accurate, standards-compliant SVG output you can embed in browsers or export from Node.js.
+
+- Convert duc files to SVG strings
+- Strongly typed with TypeScript
+
+> A more realistic approach to `ducsvg` would be to use `PDF.js` from mozilla in combination with the `ducpdf` library to convert the duc to PDF and then to SVG so that we have a more modular and robust solution.
+
+## Documentation
+
+For detailed documentation, including all available types and utility functions, visit our [Documentation](https://duc.ducflair.com).
+
+## Tools
+
+- [Playground](https://ducflair.com/core): Experiment with the `duc` format in a live environment.
+- [Documentation](https://duc.ducflair.com): Comprehensive guides and API references.
+
+## Contributing
+
+At the moment we are not accepting contributions to this package. However, we welcome feedback and suggestions for future improvements. Feel free to open an issue or contact us at [Ducflair Support](https://www.ducflair.com/support).
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for more details.
+
+
+## Commit Message Guidelines
+
+To ensure smooth releases with semantic-release, please follow [these guidelines](https://semantic-release.gitbook.io/semantic-release#how-does-it-work).
+
+---
+
+*The duc format and libraries are constantly evolving, aiming to set new standards in the 2D CAD industry. Be a part of this transformation and help shape the future of design technology!*

package/dist/ducToSvg.d.ts

@@ -0,0 +1,15 @@
+import { DucElement, DucFrameLikeElement, DucGlobalState, DucLocalState, ElementBackground, ElementStroke, RestoredDataState, Scope } from "ducjs";
+export type PartialDucState = Partial<DucLocalState & DucGlobalState>;
+export type FrameRendering = {
+    enabled: boolean;
+    outline: boolean;
+    name: boolean;
+    clip: boolean;
+};
+export declare const ducToSvg: (elements: RestoredDataState["elements"], localState: RestoredDataState["localState"], globalState: RestoredDataState["globalState"], files: RestoredDataState["files"], opts?: {
+    exportingFrame?: DucFrameLikeElement | null;
+    exportWithDarkMode?: boolean;
+    skipInliningFonts?: boolean;
+}) => Promise<string>;
+export declare const renderElementToSvg: (_element: DucElement, elementsMap: Map<string, DucElement>, ducState: PartialDucState, files: RestoredDataState["files"], defs: SVGDefsElement, currentScope: Scope) => SVGElement | null;
+export declare const applyStyles: (element: SVGElement, strokes: readonly ElementStroke[], backgrounds: readonly ElementBackground[]) => void;