robot-dam 0.6.0__tar.gz

robot_dam-0.6.0/.claude/launch.json

@@ -0,0 +1,13 @@
+{
+  "version": "0.0.1",
+  "configurations": [
+    {
+      "name": "frontend",
+      "runtimeExecutable": "npm",
+      "runtimeArgs": ["run", "dev"],
+      "port": 3000,
+      "autoPort": false,
+      "cwd": "dam-console"
+    }
+  ]
+}

robot_dam-0.6.0/.dockerignore

@@ -0,0 +1,37 @@
+# Python cache and compiled files
+__pycache__/
+*.pyc
+.mypy_cache/
+.pytest_cache/
+
+# Git repository
+.git/
+
+# Build artifacts
+build/
+dist/
+
+# Node.js and frontend build artifacts
+node_modules/
+dam-console/.next/
+dam-console/.swc/
+dam-rust/target/
+.hypothesis/
+
+venv/
+.venv/
+site/
+
+# IDE and editor files
+.vscode/
+.idea/
+
+# OS generated files
+.DS_Store
+
+# Environment files
+.env
+.env.*
+
+*.log
+*.whl

robot_dam-0.6.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,45 @@
+name: Bug Report
+description: Report a bug to help us improve
+title: "[BUG]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please check or start a [Discussion](https://github.com/ez945y/DAM/discussions) before opening an issue.
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What happened?
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Reproduction
+      description: Steps to reproduce.
+      placeholder: |
+        1.
+        2.
+        3.
+    validations:
+      required: true
+  - type: input
+    id: environment
+    attributes:
+      label: Environment
+      description: OS, Python version, DAM version.
+      placeholder: e.g. Ubuntu 22.04, Python 3.12, DAM v0.2.0
+    validations:
+      required: true
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: Screenshots
+      description: Visual evidence (Drag and drop images here).
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional Context
+      description: Any other info?

robot_dam-0.6.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,35 @@
+name: Feature Request
+description: Suggest an idea for DAM
+title: "[FEATURE]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please check or start a [Discussion](https://github.com/ez945y/DAM/discussions) before opening an issue.
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What is your idea?
+    validations:
+      required: true
+  - type: textarea
+    id: motivation
+    attributes:
+      label: Motivation
+      description: Why do we need this?
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: How should it work?
+    validations:
+      required: true
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional Context
+      description: Any other info or screenshots? (Drag and drop images here)

robot_dam-0.6.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,15 @@
+## Summary
+Briefly describe the changes and the problem they solve.
+
+## Linked Issues
+Fixes # (issue number)
+
+## Testing
+- [ ] Unit tests
+- [ ] Simulation/Hardware tests
+- [ ] Other:
+
+## Checklist
+- [ ] I have self-reviewed my changes
+- [ ] I have updated the documentation
+- [ ] I have added tests for my changes

robot_dam-0.6.0/.github/workflows/ci.yml

@@ -0,0 +1,55 @@
+name: DAM CI
+
+on:
+  push:
+    branches: [main, dev]
+  pull_request:
+    branches: [main, dev]
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - uses: actions/cache@v4
+        with:
+          path: ~/.cargo/bin
+          key: ${{ runner.os }}_cargo_rust_${{ hashFiles('dam-rust/**/Cargo.lock') }}
+
+      - name: Install uv + maturin
+        run: pip install uv maturin
+
+      - name: Build Rust Extension
+        run: |
+          cd dam-rust/dam-py
+          maturin build --release --out dist
+          uv pip install --system dist/*.whl
+
+      - name: Install Python package
+        run: uv pip install --system -e '.[dev]'
+
+      - name: Check Format
+        run: ruff format --check dam/ tests/
+
+      - name: Check Linting
+        run: ruff check dam/
+
+      - name: Check Syntax
+        run: |
+          cat << 'EOF' > check.py
+          import ast, glob
+          for f in glob.glob('dam/**/*.py', recursive=True):
+              ast.parse(open(f).read())
+          EOF
+          python check.py
+
+      - name: Test Import
+        run: python -c 'import dam; import dam_rs; print(f"dam {dam.__version__}")'
+
+      - name: Validate Stackfiles
+        run: dam validate examples/stackfiles/*.yaml

robot_dam-0.6.0/.github/workflows/docs.yml

@@ -0,0 +1,31 @@
+name: Deploy MkDocs to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - 'mkdocs.yml'
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install mkdocs mkdocs-material mkdocs-minify-plugin
+
+      - name: Deploy to GitHub Pages
+        run: mkdocs gh-deploy --force

robot_dam-0.6.0/.github/workflows/release.yml

@@ -0,0 +1,132 @@
+name: Release to PyPI
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  # ─── Stage 1: Build dam-rs wheels (Rust extension) ─────────────────────────
+  build-rust-wheels:
+    name: Build dam-rs (${{ matrix.target }} / ${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          # Linux x86_64
+          - os: ubuntu-latest
+            target: x86_64-unknown-linux-gnu
+          # Linux aarch64
+          - os: ubuntu-latest
+            target: aarch64-unknown-linux-gnu
+          # macOS Apple Silicon
+          - os: macos-14
+            target: aarch64-apple-darwin
+          # Windows x86_64
+          - os: windows-latest
+            target: x86_64-pc-windows-msvc
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Build wheels (maturin)
+        uses: PyO3/maturin-action@v1
+        with:
+          working-directory: dam-rust/dam-py
+          target: ${{ matrix.target }}
+          args: --release --out dist -i python3.11
+          manylinux: auto
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-dam-rs-${{ matrix.target }}
+          path: dam-rust/dam-py/dist/*.whl
+
+  # ─── Stage 1b: Build dam-rs sdist ─────────────────────────────────────────
+  build-rust-sdist:
+    name: Build dam-rs sdist
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          working-directory: dam-rust/dam-py
+          command: sdist
+          args: --out dist
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-dam-rs-sdist
+          path: dam-rust/dam-py/dist/*.tar.gz
+
+  # ─── Stage 2: Build robot-dam (pure Python) ────────────────────────────────
+  build-python:
+    name: Build robot-dam
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install hatchling build
+
+      - name: Build sdist + wheel
+        run: python -m build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-robot-dam
+          path: dist/*
+
+  # ─── Stage 3: Publish dam-rs to PyPI ───────────────────────────────────────
+  publish-rust:
+    name: Publish dam-rs to PyPI
+    needs: [build-rust-wheels, build-rust-sdist]
+    runs-on: ubuntu-latest
+    environment: pypi
+
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-dam-rs-*
+          merge-multiple: true
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+          skip-existing: true
+
+  # ─── Stage 4: Publish robot-dam to PyPI ────────────────────────────────────
+  publish-python:
+    name: Publish robot-dam to PyPI
+    needs: [build-python, publish-rust]
+    runs-on: ubuntu-latest
+    environment: pypi
+
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: wheels-robot-dam
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+          skip-existing: true

robot_dam-0.6.0/.gitignore

@@ -0,0 +1,66 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+*.egg-info/
+dist/
+build/
+.venv/
+.env
+
+# Hypothesis property-based testing database
+# Stores generated examples and shrunk failures — local only, never commit
+.hypothesis/
+
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+Icon
+._*
+.Spotlight-V100
+.Trashes
+
+# Editors
+.vscode/
+.idea/
+.swc/
+*.swp
+*.swo
+
+# Docker
+.dockerenv
+# Generated by scripts/dam-compose.sh from Stackfile — contains host device paths
+docker-compose.override.yml
+
+# Rust
+dam-rust/target/
+# Compiled PyO3 extension (maturin develop output — platform-specific .so)
+dam-rust/dam-py/dam_rs*.so
+dam-rust/dam-py/dam_rs*.pyd
+
+# Web / Next.js
+node_modules/
+.next/
+out/
+coverage/
+.env*.local
+*.tsbuildinfo
+
+# MkDocs
+site/
+
+# PM logs (local-only, never commit)
+logs/
+
+# Project specific
+data/
+**.drawio.*
+**.png.bkp
+.dam_stackfile.yaml
+docs/DAM_Paper.md
+docs/DAM_入門學習指南.docx

robot_dam-0.6.0/.pre-commit-config.yaml

@@ -0,0 +1,47 @@
+# Pre-commit configuration for DAM
+# See https://pre-commit.com for more information
+# See https://pre-commit.com/hooks.html for more hooks
+
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+        args: [--unsafe]
+      - id: check-added-large-files
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.10
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+        args: [--check]
+
+  - repo: local
+    hooks:
+      - id: mypy
+        name: mypy
+        entry: .venv/bin/mypy
+        language: system
+        types: [python]
+        args: [--config-file, pyproject.toml, dam, tests]
+        pass_filenames: false
+
+      - id: cargo-fmt
+        name: cargo fmt
+        description: format rust code
+        entry: cargo fmt --all --manifest-path dam-rust/Cargo.toml --
+        language: system
+        types: [rust]
+        pass_filenames: false
+
+      - id: cargo-clippy
+        name: cargo clippy
+        description: lint rust code
+        entry: cargo clippy --manifest-path dam-rust/Cargo.toml -- -D warnings
+        language: system
+        types: [rust]
+        pass_filenames: false