feat: initial otko import

pyproject.toml

@@ -0,0 +1,123 @@
+[build-system]
+requires = ["hatchling>=1.24"]
+build-backend = "hatchling.build"
+
+[project]
+name = "otko"
+version = "0.1.0"
+description = "OTKO — a modern, SAP2000-style desktop GUI for OpenSeesPy."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { file = "LICENSE" }
+authors = [{ name = "Ozan" }]
+keywords = ["opensees", "openseespy", "structural", "earthquake", "fem", "gui"]
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Intended Audience :: Science/Research",
+    "Topic :: Scientific/Engineering",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "License :: OSI Approved :: GNU Affero General Public License v3",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    # ── Headless base (core + services, no Qt required) ──────────────────────
+    "pydantic>=2.5",
+    "numpy>=1.26",
+    "h5py>=3.10",
+    "openseespy==3.8.0.0",
+    "openseespywin==3.8.0.0 ; sys_platform == 'win32'",
+]
+
+[project.optional-dependencies]
+# ── GUI / visualization stack (desktop app only) ──────────────────────────
+# Install with: pip install -e ".[gui]"   (desktop)
+#               pip install -e ".[gui,dev]"  (desktop + dev tools)
+# Headless / web reuse: pip install -e .   (base only, no Qt pulled in)
+gui = [
+    "PySide6>=6.6",
+    "pyvista>=0.43",
+    "pyvistaqt>=0.11",
+    "vtk>=9.3",
+    "pyqtgraph>=0.13",
+    "imageio[ffmpeg]>=2.34",
+    # scipy and pandas are listed for forward-compatibility; they are not
+    # currently imported by any module in this repo (phantom deps as of 2026-06-15).
+    "scipy>=1.11",
+    "pandas>=2.1",
+]
+dev = [
+    "pytest>=7.4",
+    "pytest-qt>=4.2",
+    "pytest-cov>=4.1",
+    "ruff>=0.4",
+    "mypy>=1.8",
+    "pre-commit>=3.6",
+    "hatch>=1.9",
+]
+docs = [
+    "sphinx>=7.2",
+    "myst-parser>=2.0",
+    "furo>=2024.1.29",
+]
+
+[project.scripts]
+otko = "otko.__main__:main"
+
+[project.urls]
+Homepage = "https://github.com/ogunc/otko"
+Issues = "https://github.com/ogunc/otko/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/otko"]
+
+# ─────────── Ruff ───────────
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = [
+    "E", "W",   # pycodestyle
+    "F",        # pyflakes
+    "I",        # isort
+    "B",        # bugbear
+    "UP",       # pyupgrade
+    "N",        # pep8-naming
+    "SIM",      # simplify
+    "RUF",      # ruff-specific
+]
+ignore = ["E501"]  # line length handled by formatter
+
+[tool.ruff.format]
+quote-style = "double"
+
+# ─────────── Mypy ───────────
+[tool.mypy]
+python_version = "3.10"
+strict = true
+warn_unused_ignores = true
+warn_return_any = true
+disallow_untyped_defs = true
+plugins = []
+
+[[tool.mypy.overrides]]
+module = ["openseespy.*", "pyvista.*", "pyvistaqt.*", "vtk.*", "pyqtgraph.*"]
+ignore_missing_imports = true
+
+# ─────────── Pytest ───────────
+[tool.pytest.ini_options]
+minversion = "7.0"
+addopts = "-ra -q --strict-markers"
+testpaths = ["tests"]
+markers = [
+    "gui: marks tests that require a Qt event loop",
+    "slow: marks slow tests (deselect with '-m \"not slow\"')",
+]
+
+[tool.coverage.run]
+branch = true
+source = ["src/otko"]
+omit = ["src/otko/views/*"]  # GUI excluded from coverage targets