[release] v1.0.0

.clang-format

@@ -0,0 +1,59 @@
+---
+BasedOnStyle: Mozilla
+AlignTrailingComments: true
+AllowAllParametersOfDeclarationOnNextLine: true
+AllowShortBlocksOnASingleLine: true
+AllowShortCaseLabelsOnASingleLine: true
+AllowShortFunctionsOnASingleLine: All
+AllowShortIfStatementsOnASingleLine: false
+AllowShortLoopsOnASingleLine: false
+AlwaysBreakAfterReturnType: None
+AlwaysBreakAfterDefinitionReturnType: None
+AlwaysBreakTemplateDeclarations: true
+BinPackArguments: false
+BinPackParameters: false
+BreakBeforeBraces: Custom
+BraceWrapping:
+  AfterClass: true
+  AfterControlStatement: true
+  AfterEnum: true
+  AfterFunction: true
+  AfterNamespace: false
+  AfterObjCDeclaration: false
+  AfterStruct: true
+  AfterUnion: true
+  AfterExternBlock: true
+  BeforeCatch: true
+  BeforeElse: true
+  IndentBraces: false
+  SplitEmptyFunction: false
+  SplitEmptyRecord: false
+  SplitEmptyNamespace: false
+BreakBeforeInheritanceComma: false
+ColumnLimit: 120
+CompactNamespaces: false
+ConstructorInitializerAllOnOneLineOrOnePerLine: false
+Cpp11BracedListStyle: true
+DerivePointerAlignment: false
+IndentCaseLabels: true
+IndentWidth: 4
+KeepEmptyLinesAtTheStartOfBlocks: false
+Language: Cpp
+PointerAlignment: Left
+ReflowComments: true
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeParens: Never
+SpaceInEmptyParentheses: false
+SpacesInContainerLiterals: false
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+Standard: "c++11"
+IncludeCategories:
+  - Regex:           '^".*"'
+    Priority:        1
+  - Regex:           '^<popsift/.*>'
+    Priority:        2
+  - Regex:           '^<.*\..*>'
+    Priority:        3
+SortIncludes: true
+IncludeBlocks: Regroup

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,36 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: "[bug]"
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Log**
+If applicable, copy paste the relevant log output (please embed the text in a markdown code tag "\`\`\`" )
+
+**Desktop (please complete the following and other pertinent information):**
+ - OS: [e.g. win 10, osx, ]
+ - PopSift version: please specify if you are using a release version or your own build
+   - Binary version (if applicable) [e.g. 2019.1]
+   - Commit reference (if applicable) [e.g. 08ddbe2]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: "[request]"
+labels: feature request
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/ISSUE_TEMPLATE/question_help.md

@@ -0,0 +1,29 @@
+---
+name: Question or help needed
+about: Ask question or for help for issues not related to program failures (e.g. "where I can find this feature", "my image is not recognized", "which parameter setting shall I use" etc...)
+title: "[question]"
+labels: type:question
+assignees: ''
+
+---
+
+**Describe the problem**
+A clear and concise description of what the problem is.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Dataset**
+If applicable, add a link or *few* images to help better understand where the problem may come from.
+
+**Log**
+If applicable, copy paste the relevant log output (please embed the text in a markdown code tag "\`\`\`" )
+
+**Desktop (please complete the following and other pertinent information):**
+ - OS: [e.g. win 10, osx, ]
+ - PopSift version: please specify if you are using a release version or your own build
+   - Binary version (if applicable) [e.g. 2019.1]
+   - Commit reference (if applicable) [e.g. 08ddbe2]
+
+**Additional context**
+Add any other context about the problem here.

.github/actions/build-config/action.yml

@@ -0,0 +1,81 @@
+name: 'Build Configuration'
+description: 'Build PopSift for a specific configuration (Release/Debug)'
+
+inputs:
+  build-type:
+    description: 'Build type (Release or Debug)'
+    required: true
+  platform:
+    description: 'Platform (linux or windows)'
+    required: true
+  deps-install-dir:
+    description: 'Dependencies install directory (Linux only)'
+    required: false
+    default: '/opt/'
+  vcpkg-root:
+    description: 'vcpkg root directory (Windows only)'
+    required: false
+  workspace-dir:
+    description: 'Workspace directory (Windows only)'
+    required: false
+
+runs:
+  using: 'composite'
+  steps:
+    # Linux steps
+    - name: Setup directories (Linux)
+      if: inputs.platform == 'linux'
+      shell: bash
+      run: |
+        source ./.github/scripts/build-linux.sh
+        BUILD_TYPE=${{ inputs.build-type }} setup_directories
+
+    - name: Configure CMake (Linux)
+      if: inputs.platform == 'linux'
+      shell: bash
+      run: |
+        source ./.github/scripts/build-linux.sh
+        configure_cmake "${{ inputs.build-type }}" "${{ inputs.deps-install-dir }}"
+
+    - name: Build and Install (Linux)
+      if: inputs.platform == 'linux'
+      shell: bash
+      run: |
+        source ./.github/scripts/build-linux.sh
+        build_and_install "${{ inputs.build-type }}"
+
+    - name: Build As Third Party (Linux)
+      if: inputs.platform == 'linux'
+      shell: bash
+      run: |
+        source ./.github/scripts/build-linux.sh
+        build_as_third_party "${{ inputs.build-type }}" "${{ inputs.deps-install-dir }}"
+
+    # Windows steps
+    - name: Setup directories (Windows)
+      if: inputs.platform == 'windows'
+      shell: powershell
+      run: |
+        . .\.github\scripts\build-windows.ps1
+        Setup-Directories -BuildType "${{ inputs.build-type }}"
+
+    - name: Configure CMake (Windows)
+      if: inputs.platform == 'windows'
+      shell: powershell
+      run: |
+        . .\.github\scripts\build-windows.ps1
+        Configure-CMake -BuildType "${{ inputs.build-type }}" -VcpkgRoot "${{ inputs.vcpkg-root }}" -WorkspaceDir "${{ inputs.workspace-dir }}"
+
+    - name: Build and Install (Windows)
+      if: inputs.platform == 'windows'
+      shell: powershell
+      run: |
+        . .\.github\scripts\build-windows.ps1
+        Build-AndInstall -BuildType "${{ inputs.build-type }}"
+
+    - name: Build As Third Party (Windows)
+      if: inputs.platform == 'windows'
+      shell: powershell
+      run: |
+        . .\.github\scripts\build-windows.ps1
+        Build-AsThirdParty -BuildType "${{ inputs.build-type }}" -VcpkgRoot "${{ inputs.vcpkg-root }}" -WorkspaceDir "${{ inputs.workspace-dir }}"

.github/pull_request_template.md

@@ -0,0 +1,29 @@
+<!-- Checklist before submission:
+
+ - I have read the [contribution guidelines](../CONTRIBUTING.md).
+ - I have updated the documentation, if applicable.
+ - I have ensured that the change is tested somewhere.
+ - I have followed the prevailing code style (for history readability and limit conflicts for maintainance).
+
+-->
+## Description
+
+
+
+## Features list
+
+<!--
+- [ ] Feature one. Fix #XXX
+- [ ] Improve something else
+- [ ] Connect to #3 (to declare link to issues without closing it when the PR is merged).
+- [X] Add "X" when it is done.
+-->
+
+
+## Implementation remarks
+
+
+<!--
+Explain main implementation choices.
+It is also the right place to ask for feedback and help when you hesitate on the implementation.
+-->

.github/scripts/build-linux.sh

@@ -0,0 +1,71 @@
+#!/bin/bash
+# Linux build functions for PopSift
+# Usage: source this file and call the individual functions
+
+# Creates the necessary build directories for different build types
+# Uses BUILD_TYPE environment variable to create build and install directories
+setup_directories() {
+    echo "Setting up build directories..."
+    mkdir -p ./build_"${BUILD_TYPE,,}"
+    mkdir -p ./build_as_3rdparty_"${BUILD_TYPE,,}"
+    mkdir -p ../popsift_install_"${BUILD_TYPE,,}"
+}
+
+# Configures CMake for PopSift build with specified options
+# Parameters:
+#   $1 - build_type: Release or Debug
+#   $2 - deps_dir: Directory containing pre-installed dependencies (e.g., /opt/)
+# Creates a build directory named <build_$build_type> and runs CMake configuration with PopSift-specific options
+configure_cmake() {
+    local build_type="$1"
+    local deps_dir="$2"
+    local build_dir="build_${build_type,,}"
+    local install_dir="../popsift_install_${build_type,,}"
+
+    echo "Configuring CMake for $build_type..."
+    cd "./$build_dir" || exit
+    cmake .. \
+     -DCMAKE_BUILD_TYPE="$build_type" \
+     -DBUILD_SHARED_LIBS:BOOL=ON \
+     -DCMAKE_PREFIX_PATH="$deps_dir" \
+     -DPopSift_BUILD_DOCS:BOOL=OFF \
+     -DCMAKE_INSTALL_PREFIX:PATH="$PWD/$install_dir"
+    cd ..
+}
+
+# Builds and installs PopSift for the specified build type
+# Parameters:
+#   $1 - build_type: Release or Debug
+# Uses parallel build with all available CPU cores
+build_and_install() {
+    local build_type="$1"
+    local build_dir="build_${build_type,,}"
+
+    echo "Building and installing $build_type..."
+    cd "./$build_dir" || exit
+    cmake --build . --config "$build_type" --parallel
+    cmake --install . --config "$build_type"
+    cd ..
+}
+
+# Tests building PopSift applications as a third-party consumer
+# This verifies that the installed PopSift can be found and used by external projects
+# Parameters:
+#   $1 - build_type: Release or Debug
+#   $2 - deps_dir: Directory containing pre-installed dependencies
+# Builds only the application from src/application using the installed PopSift library
+build_as_third_party() {
+    local build_type="$1"
+    local deps_dir="$2"
+    local build_dir="build_as_3rdparty_${build_type,,}"
+    local install_dir="../popsift_install_${build_type,,}"
+
+    echo "Testing third-party build for $build_type..."
+    cd "./$build_dir" || exit
+    cmake ../src/application \
+     -DBUILD_SHARED_LIBS:BOOL=ON \
+     -DCMAKE_BUILD_TYPE="$build_type" \
+     -DCMAKE_PREFIX_PATH:PATH="$PWD/$install_dir;$deps_dir"
+    cmake --build . --config "$build_type" --parallel
+    cd ..
+}