neroued-vectorizer 0.1.0__tar.gz

neroued_vectorizer-0.1.0/.clang-format

@@ -0,0 +1,55 @@
+BasedOnStyle: LLVM
+
+# 预处理指令缩进
+IndentPPDirectives: AfterHash
+
+# 允许短句在同一行
+AllowShortIfStatementsOnASingleLine: true
+AllowShortLoopsOnASingleLine: true
+AllowShortBlocksOnASingleLine: true
+AllowShortFunctionsOnASingleLine: true
+AllowShortEnumsOnASingleLine: true
+
+ColumnLimit: 100
+
+# 连续声明对齐
+AlignConsecutiveAssignments: true
+AlignConsecutiveMacros: true
+AlignTrailingComments:
+  Kind: Always
+  OverEmptyLines: 0
+
+# 模板声明断行
+AlwaysBreakTemplateDeclarations: Yes
+
+# 打包参数
+BinPackArguments: true
+BinPackParameters: true
+
+# 移除访问修饰符之后所有的空行
+EmptyLineAfterAccessModifier: Never
+EmptyLineBeforeAccessModifier: Leave
+
+# include块风格
+IncludeBlocks: Regroup
+SortIncludes: Never
+
+SortUsingDeclarations: Never
+
+# 打包构造函数初始化列表
+PackConstructorInitializers: BinPack
+
+# 指针和引用对齐
+PointerAlignment: Left
+ReferenceAlignment: Left
+
+# 分离定义语句块
+SeparateDefinitionBlocks: Always
+
+# 缩进长度
+IndentWidth: 4
+TabWidth: 4
+AccessModifierOffset: -4
+
+# 最大空行数量
+MaxEmptyLinesToKeep: 3

neroued_vectorizer-0.1.0/.clangd

@@ -0,0 +1,3 @@
+CompileFlags:
+  CompilationDatabase: build
+  Add: [-std=c++20]

neroued_vectorizer-0.1.0/.cursor/rules/code-structure.mdc

@@ -0,0 +1,25 @@
+---
+description: 工具函数复用与实现结构规范
+globs: "**/*.cpp,**/*.h"
+alwaysApply: true
+---
+
+# 工具函数复用与实现结构
+
+## 工具函数复用
+
+- 禁止重复编写语义相同的工具函数。
+- 新增工具函数前，先检索项目内是否已有可复用实现。
+- 跨模块复用的函数应放入公共头文件（如 `src/detail/`）。
+- 仅当前文件使用的工具函数应保留为匿名命名空间局部实现。
+
+## .cpp 文件结构
+
+- 避免在 .cpp 内做非必要前向声明；优先通过合理的函数定义顺序解决依赖。
+- 实现文件应按"工具函数 → 核心流程 → 对外接口"组织。
+
+## 命名空间约定
+
+- 公共 API 使用 `neroued::vectorizer` 命名空间。
+- 内部实现使用 `neroued::vectorizer::detail` 命名空间。
+- 公共头文件位于 `include/neroued/vectorizer/`，内部头文件位于 `src/` 子目录。

neroued_vectorizer-0.1.0/.cursor/rules/cpp-formatting.mdc

@@ -0,0 +1,17 @@
+---
+description: C++ 代码格式化规范
+globs: "**/*.cpp,**/*.h,**/*.hpp,**/*.cc,**/*.cxx"
+alwaysApply: true
+---
+
+# C++ 代码格式化
+
+每次修改 `.cpp`、`.h`、`.hpp`、`.cc`、`.cxx` 文件后，必须使用项目根目录的 `.clang-format` 配置对修改的文件运行格式化：
+
+```bash
+clang-format -i <modified-files>
+```
+
+- 仅对本次修改过的文件执行，不要全量格式化
+- 在所有编辑完成后统一执行一次即可，无需每次编辑后都执行
+- 格式化风格基于 LLVM，缩进 4 空格，列宽限制 100

neroued_vectorizer-0.1.0/.cursor/rules/cross-platform-cpp.mdc

@@ -0,0 +1,27 @@
+---
+description: C++ 跨平台编译规范
+globs: "**/*.cpp,**/*.h,**/*.hpp,**/CMakeLists.txt,**/*.cmake"
+alwaysApply: false
+---
+
+# C++ 跨平台编译规范
+
+## 文件系统路径
+
+禁止硬编码 POSIX 路径，一律使用 `std::filesystem`（C++17）。
+
+## 随机数 / ID 生成
+
+禁止直接读取 `/dev/urandom`，使用 `std::random_device`。
+
+## CMake 外部库链接
+
+禁止硬编码 Linux 特有的库名，使用 find_package 或条件分支。
+
+## 平台宏判断
+
+需要平台差异时，使用标准宏：`_WIN32`、`__APPLE__`。
+
+## 变更检查
+
+每次新增系统调用或文件操作时，必须确认跨平台兼容性。

neroued_vectorizer-0.1.0/.cursor/rules/git-policy.mdc

@@ -0,0 +1,11 @@
+---
+description: Git 提交与合并规范
+globs: "**/*"
+alwaysApply: true
+---
+
+# Git 提交与合并规范
+
+- 禁止在 master/main 分支直接提交代码并推送。
+- 所有代码改动必须在独立分支完成，并通过 Pull Request 合并。
+- 分支命名：feat/<topic>、fix/<topic>、refactor/<topic>、docs/<topic>、chore/<topic>

neroued_vectorizer-0.1.0/.cursor/rules/sync-docs.mdc

@@ -0,0 +1,15 @@
+---
+description: 文档同步规范
+globs: "**/*"
+alwaysApply: true
+---
+
+# 文档同步
+
+当修改涉及以下内容时，检查 README.md 和 AGENTS.md 是否需要同步更新：
+
+- 公共 API 变更（头文件增删、函数签名变化）
+- 配置参数增删
+- 构建选项变化
+- CLI 工具参数变更
+- 依赖变化

neroued_vectorizer-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,78 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:
+  # ── C++ build & test ──────────────────────────────────────────────────────
+  cpp-build:
+    name: C++ (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-24.04, macos-14]
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Install dependencies (Linux)
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libopencv-dev libpotrace-dev
+
+      - name: Install dependencies (macOS)
+        if: runner.os == 'macOS'
+        run: brew install opencv potrace
+
+      - name: Configure
+        run: >
+          cmake -S . -B build
+          -DCMAKE_BUILD_TYPE=Release
+          -DNV_BUILD_TESTS=ON
+          -DNV_BUILD_EVAL=ON
+          -DNV_BUILD_APPS=ON
+
+      - name: Build
+        run: cmake --build build -j$(nproc 2>/dev/null || sysctl -n hw.ncpu)
+
+      - name: Test
+        run: ctest --test-dir build --output-on-failure
+
+  # ── Python bindings build & test ──────────────────────────────────────────
+  python-test:
+    name: Python (${{ matrix.python-version }}, ubuntu)
+    runs-on: ubuntu-24.04
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libopencv-dev libpotrace-dev
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package
+        run: pip install --verbose ".[test]" || pip install --verbose .
+
+      - name: Install test dependencies
+        run: pip install pytest numpy opencv-python-headless
+
+      - name: Run tests
+        run: pytest python/tests -v

neroued_vectorizer-0.1.0/.github/workflows/wheels.yml

@@ -0,0 +1,82 @@
+name: Build wheels
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+jobs:
+  # ── Build wheels on each platform ─────────────────────────────────────────
+  build-wheels:
+    name: Wheels (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-24.04, macos-13, macos-14, windows-latest]
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Set up vcpkg cache (Windows)
+        if: runner.os == 'Windows'
+        uses: actions/cache@v4
+        with:
+          path: C:\vcpkg\installed
+          key: vcpkg-${{ runner.os }}-${{ hashFiles('ci/install-deps-windows.bat') }}
+
+      - uses: pypa/cibuildwheel@v2.21
+        env:
+          CIBW_ARCHS_LINUX: x86_64
+          CIBW_ARCHS_MACOS: ${{ matrix.os == 'macos-14' && 'arm64' || 'x86_64' }}
+          CIBW_ARCHS_WINDOWS: AMD64
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}
+          path: wheelhouse/*.whl
+
+  # ── Build source distribution ─────────────────────────────────────────────
+  build-sdist:
+    name: Source distribution
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build sdist
+        run: pipx run build --sdist
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+
+  # ── Publish to PyPI ───────────────────────────────────────────────────────
+  publish:
+    name: Publish to PyPI
+    needs: [build-wheels, build-sdist]
+    runs-on: ubuntu-24.04
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    environment:
+      name: pypi
+      url: https://pypi.org/p/neroued-vectorizer
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: dist
+          merge-multiple: true
+
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist

neroued_vectorizer-0.1.0/.gitignore

@@ -0,0 +1,46 @@
+# Build
+build/
+cmake-build-*/
+*.o
+*.a
+*.so
+*.dylib
+*.exe
+*.dll
+*.lib
+*.exp
+*.pdb
+*.ilk
+compile_commands.json
+
+# IDE
+.cache/
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test artifacts (generated per run)
+*.log
+test_data/images/results/
+test_data/eval_out/
+test_data/eval_report.json
+test_data/baselines/current/*.svg
+test_data/baselines/current/*_report.png
+test_data/history.csv
+
+# Test images (user-provided, too large for git)
+test_data/images/simple/
+test_data/images/complex/
+
+# Python bindings build
+dist/
+*.egg-info/
+*.whl
+__pycache__/
+*.pyc

neroued_vectorizer-0.1.0/.gitmodules

@@ -0,0 +1,6 @@
+[submodule "3rdparty/spdlog"]
+	path = 3rdparty/spdlog
+	url = https://github.com/gabime/spdlog.git
+[submodule "3rdparty/clipper2"]
+	path = 3rdparty/clipper2
+	url = https://github.com/AngusJohnson/Clipper2.git

neroued_vectorizer-0.1.0/3rdparty/clipper2/CPP/BenchMark/CMakeLists.txt

@@ -0,0 +1,80 @@
+cmake_minimum_required(VERSION 3.15)
+project(Clipper2_benchmarks VERSION 1.0 LANGUAGES C CXX)
+
+if(NOT DEFINED CMAKE_CXX_STANDARD OR CMAKE_CXX_STANDARD LESS 17)
+    set(CMAKE_CXX_STANDARD 17)
+endif()
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+
+# fetch the google benchmark library
+include(FetchContent)
+set(BENCHMARK_ENABLE_GTEST_TESTS OFF)
+set(BENCHMARK_ENABLE_TESTING OFF)
+message("start fetching the googlebenchmark")
+FetchContent_Declare(googlebenchmark
+        GIT_REPOSITORY https://github.com/google/benchmark.git
+        GIT_TAG v1.7.1
+)
+
+FetchContent_MakeAvailable(
+        googlebenchmark)
+set(gtest_force_shared_crt ON CACHE BOOL "" FORCE)
+message("fetching is done")
+
+set(benchmark_srcs
+    GetIntersectPtBenchmark.cpp
+    PointInPolygonBenchmark.cpp
+    StripDuplicateBenchmark.cpp
+    # more to add
+)
+
+set(CLIPPER2_INC
+  ${CLIPPER2_INC_FOLDER}/clipper.h
+  ${CLIPPER2_INC_FOLDER}/clipper.version.h
+  ${CLIPPER2_INC_FOLDER}/clipper.core.h
+)
+
+add_library(Clipper2_bm INTERFACE)
+target_include_directories(Clipper2_bm INTERFACE CLIPPER2_INC)
+
+set(CLIPPER2_UTILS_INC
+  ../Utils/clipper.svg.h
+  ../Utils/ClipFileLoad.h
+  ../Utils/ClipFileSave.h
+  ../Utils/Timer.h
+  ../Utils/Colors.h
+  ../Utils/CommonUtils.h
+)
+set(CLIPPER2_UTILS_SRC
+  ../Utils/clipper.svg.cpp
+  ../Utils/ClipFileLoad.cpp
+  ../Utils/ClipFileSave.cpp
+)
+set(CLIPPER2_UTILS "")
+  list(APPEND CLIPPER2_UTILS Clipper2utils_bm)
+  add_library(Clipper2utils_bm STATIC ${CLIPPER2_UTILS_INC} ${CLIPPER2_UTILS_SRC})
+  target_include_directories(Clipper2utils_bm
+    PUBLIC ../Clipper2Lib/include
+    PUBLIC ../Utils
+  )
+  target_link_libraries(Clipper2utils_bm PUBLIC Clipper2_bm)
+
+# add each benchmark from the benchmark_srcs
+foreach(benchmark ${benchmark_srcs})
+    get_filename_component(benchmark_target ${benchmark} NAME_WE)
+
+    message(STATUS "${PROJECT_NAME} add benchmark ${benchmark_target}")
+    add_executable(${benchmark_target} ${benchmark})
+
+    target_include_directories(${benchmark_target}
+      PUBLIC ../Clipper2Lib/include
+      PUBLIC ../Utils
+    )
+
+    target_link_libraries(${benchmark_target}
+        benchmark::benchmark
+        Clipper2_bm
+        Clipper2utils_bm
+    )
+endforeach()