Dockerfile.dev

# --------------------------------------------------------------------------------------------------------------
# Img2Num Dockerfile.dev
#
# Be careful of how you update this file. Updating layer 2 forces the layers below it to rebuild, too!
# --------------------------------------------------------------------------------------------------------------

# Node 26 = Active LTS in Oct 2026 (>= 24.14 required by editorconfig-checker 7.x: see package.json).
FROM node:26-trixie

# --------------------------------------------------------------------------------------------------------------
# Build metadata
ARG BUILD_DATE
ARG GIT_SHA

LABEL org.opencontainers.image.title="Img2Num Dev"
LABEL org.opencontainers.image.description="Development environment for Img2Num"
LABEL org.opencontainers.image.source="https://github.com/Ryan-Millard/Img2Num"
LABEL org.opencontainers.image.created=$BUILD_DATE
LABEL org.opencontainers.image.revision=$GIT_SHA

# --------------------------------------------------------------------------------------------------------------
# OS setup & core tooling
RUN --mount=type=cache,target=/var/cache/apt,sharing=locked \
    --mount=type=cache,target=/var/lib/apt,sharing=locked \
    apt-get update && apt-get install -y --no-install-recommends \
      build-essential \
      gcc-14 \
      g++-14 \
      clang \
      cmake \
      ninja-build \
      python3 \
      python3-setuptools \
      python3-wheel \
      python3-pybind11 \
      git \
      curl \
      unzip \
      pkg-config \
      bash \
      ca-certificates \
      tzdata \
    && rm -rf /var/lib/apt/lists/*

ENV TZ=Africa/Johannesburg

ENV CC=gcc-14
ENV CXX=g++-14

ENV SHELL=/bin/bash
SHELL ["/bin/bash", "-c"]

WORKDIR /usr/src/app

# --------------------------------------------------------------------------------------------------------------
# Git safety
RUN git config --global --add safe.directory /usr/src/app

# --------------------------------------------------------------------------------------------------------------
# Emscripten setup (Slightly Expensive)
COPY .versions/.emscripten.json /tmp/.emscripten.json
COPY scripts/read-version.js /tmp/read-version.js

ENV EMSDK_DIR=/opt/emsdk

RUN EMSDK_VERSION=$(node /tmp/read-version.js /tmp/.emscripten.json) \
  && git clone --depth 1 https://github.com/emscripten-core/emsdk.git $EMSDK_DIR \
  && cd $EMSDK_DIR \
  && git fetch --tags \
  && git checkout $EMSDK_VERSION \
  && ./emsdk install $EMSDK_VERSION \
  && ./emsdk activate $EMSDK_VERSION
ENV PATH=$EMSDK_DIR:$EMSDK_DIR/upstream/emscripten:$PATH
ENV EMSDK=$EMSDK_DIR

# Auto-load emsdk in all shells
RUN echo "source /opt/emsdk/emsdk_env.sh" >> /etc/bash.bashrc

# --------------------------------------------------------------------------------------------------------------
# Dawn dependencies
RUN --mount=type=cache,target=/var/cache/apt,sharing=locked \
    --mount=type=cache,target=/var/lib/apt,sharing=locked \
    apt-get update && apt-get install -y --no-install-recommends \
      libvulkan1 \
      mesa-vulkan-drivers \
      libgl1-mesa-dev \
      libglu1-mesa-dev \
      vulkan-tools \
      libvips-dev \
    && rm -rf /var/lib/apt/lists/*

# --------------------------------------------------------------------------------------------------------------
# Dawn build (expensive layer)
COPY third_party/dawn third_party/dawn

RUN cmake -S third_party/dawn -B build/dawn \
    -DDAWN_SUPPORTS_GLFW_FOR_WINDOWING=OFF \
    -DDAWN_USE_X11=OFF \
    -DDAWN_FETCH_DEPENDENCIES=ON \
    -DDAWN_ENABLE_INSTALL=ON \
    -DDAWN_BUILD_TESTS=OFF \
    -DCMAKE_BUILD_TYPE=Release \
  && cmake --build build/dawn --parallel $(nproc) \
  && cmake --install build/dawn

# --------------------------------------------------------------------------------------------------------------
# Doxygen
RUN --mount=type=cache,target=/var/cache/apt,sharing=locked \
    --mount=type=cache,target=/var/lib/apt,sharing=locked \
    apt-get update && apt-get install -y --no-install-recommends \
      doxygen \
      graphviz \
    && rm -rf /var/lib/apt/lists/*

# --------------------------------------------------------------------------------------------------------------
# UV + Python environment
RUN curl -LsSf https://astral.sh/uv/0.12.13/install.sh | sh

ENV PATH="/root/.local/bin:${PATH}"
ENV UV_LINK_MODE=copy
ENV UV_PIP_CACHE_DIR=/root/.cache/uv/pip

RUN uv venv /usr/src/app/.venv

ENV VIRTUAL_ENV=/usr/src/app/.venv
ENV PATH="/usr/src/app/.venv/bin:$PATH"

COPY pyproject.toml uv.lock CMakeLists.txt ./
COPY packages/py/pyproject.toml packages/py/pyproject.toml
COPY scripts/py/pyproject.toml scripts/py/pyproject.toml
COPY example-apps/console-py/pyproject.toml example-apps/console-py/pyproject.toml
RUN --mount=type=cache,target=/root/.cache/uv \
    uv sync --frozen --no-install-project --no-install-workspace \
      --all-groups

# --------------------------------------------------------------------------------------------------------------
# Node / pnpm setup
RUN npm install -g pnpm@12.4.1

ENV PNPM_STORE_DIR=/pnpm/store
ENV PATH=/root/.local/share/pnpm:$PATH

COPY package.json pnpm-lock.yaml pnpm-workspace.yaml ./
COPY packages/js/package.json packages/js/package.json
COPY docs/package.json docs/package.json
COPY example-apps/react-js/package.json example-apps/react-js/package.json
COPY scripts/img2num-dev-scripts/package.json scripts/img2num-dev-scripts/package.json

RUN --mount=type=cache,target=/pnpm/store \
    pnpm install --no-frozen-lockfile

# --------------------------------------------------------------------------------------------------------------
# Just package manager
RUN curl --proto '=https' --tlsv1.2 -sSf https://just.systems/install.sh -o setup_just.sh && \
    bash setup_just.sh --to /usr/local/bin && \
    rm setup_just.sh
# --------------------------------------------------------------------------------------------------------------
# Dev UX settings
ENV CHOKIDAR_USEPOLLING=true
ENV CHOKIDAR_INTERVAL=100

# See docker-compose.yml ports
EXPOSE 3000 5173 4173 5174 4174 5175 5176

# --------------------------------------------------------------------------------------------------------------
# Healthcheck (Basic if container works)
HEALTHCHECK --interval=30s --timeout=5s --start-period=40s --retries=3 \
  CMD bash -lc '\
    for tool in node pnpm emcc cmake uv; do \
      command -v "$tool" >/dev/null && "$tool" --version >/dev/null || exit 1; \
    done'

CMD ["bash"]