usearch 2.9.1 → 2.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "usearch",
-    "version": "2.9.1",
+    "version": "2.10.0",
     "description": "Smaller & Faster Single-File Vector Search Engine from Unum",
     "author": "Ash Vardanian (https://ashvardanian.com/)",
     "license": "Apache 2.0",
@@ -13,37 +13,39 @@
         "url": "https://github.com/unum-cloud/usearch/issues",
         "email": "info@unum.cloud"
     },
-    "main": "javascript/usearch.js",
-    "gypfile": true,
     "engines": {
         "node": "~10 >=10.20 || >=12.17"
     },
+    "files": [
+        "javascript/dist",
+        "prebuilds"
+    ],
     "dependencies": {
-        "@types/node": "^20.4.5",
-        "bindings": "~1.2.1",
-        "node-addon-api": "^3.0.0"
+        "bindings": "^1.5.0",
+        "node-addon-api": "^3.0.0",
+        "node-gyp-build": "^4.8.0"
     },
     "scripts": {
         "test": "node --test ./javascript/usearch.test.js",
-        "install": "node-gyp rebuild",
-        "typegen": "npx tsc"
+        "install": "node-gyp-build",
+        "prebuild-single": "prebuildify --napi --strip",
+        "prebuild-arm64": "prebuildify --arch arm64 --napi --strip",
+        "prebuild-darwin-x64+arm64": "prebuildify --arch arm64+x64 --napi --strip",
+        "build-js": "rm -fr javascript/dist/* && tsc -p javascript/tsconfig-esm.json && tsc -p javascript/tsconfig-cjs.json && cp javascript/dist-package-esm.json javascript/dist/esm/package.json && cp javascript/dist-package-cjs.json javascript/dist/cjs/package.json"
     },
     "devDependencies": {
-        "typescript": "^5.1.6"
+        "@types/bindings": "^1.5.5",
+        "@types/node": "^20.11.0",
+        "node-gyp": "^10.0.1",
+        "prebuildify": "^6.0.0",
+        "typescript": "^5.3.3"
     },
+    "main": "javascript/dist/cjs/usearch.js",
+    "module": "javascript/dist/esm/usearch.js",
     "exports": {
         ".": {
-            "types": "./javascript/types/usearch.d.ts",
-            "require": "./javascript/usearch.js",
-            "import": "./javascript/usearch.js"
-        },
-        "./package.json": "./package.json"
-    },
-    "typesVersions": {
-      "*": {
-          "*": [
-              "./javascript/types/usearch.d.ts"
-          ]
-      }
-  }
-}
+            "import": "./javascript/dist/esm/usearch.js",
+            "require": "./javascript/dist/cjs/usearch.js"
+        }
+    }
+}

package/.clang-format

@@ -1,10 +0,0 @@
-Language: Cpp
-BasedOnStyle:  LLVM
-IndentWidth: 4
-TabWidth: 4
-NamespaceIndentation: None
-ColumnLimit: 120
-ReflowComments: true
-UseTab: Never
-PointerAlignment: Left
-AllowShortCaseLabelsOnASingleLine: True

package/.clang-tidy

@@ -1,60 +0,0 @@
-Checks: '*,
-         -altera-id-dependent-backward-branch,
-         -altera-struct-pack-align,
-         -altera-unroll-loops,
-         -android-cloexec-fopen,
-         -bugprone-easily-swappable-parameters,
-         -cert-err58-cpp,
-         -concurrency-mt-unsafe,
-         -cppcoreguidelines-avoid-const-or-ref-data-members,
-         -cppcoreguidelines-avoid-do-while,
-         -cppcoreguidelines-avoid-goto,
-         -cppcoreguidelines-avoid-magic-numbers,
-         -cppcoreguidelines-avoid-non-const-global-variables,
-         -cppcoreguidelines-macro-usage,
-         -cppcoreguidelines-pro-bounds-array-to-pointer-decay,
-         -cppcoreguidelines-pro-bounds-constant-array-index,
-         -cppcoreguidelines-pro-bounds-pointer-arithmetic,
-         -cppcoreguidelines-pro-type-reinterpret-cast,
-         -cppcoreguidelines-pro-type-union-access,
-         -cppcoreguidelines-rvalue-reference-param-not-moved,
-         -cppcoreguidelines-virtual-class-destructor,
-         -fuchsia-default-arguments-calls,
-         -fuchsia-default-arguments-declarations,
-         -fuchsia-overloaded-operator,
-         -google-explicit-constructor,
-         -google-readability-function-size,
-         -google-runtime-int,
-         -google-runtime-references,
-         -hicpp-avoid-goto,
-         -hicpp-explicit-conversions,
-         -hicpp-function-size,
-         -hicpp-no-array-decay,
-         -hicpp-no-assembler,
-         -hicpp-signed-bitwise,
-         -hicpp-uppercase-literal-suffix,
-         -llvm-header-guard,
-         -llvm-include-order,
-         -llvmlibc-*,
-         -misc-use-anonymous-namespace,
-         -misc-confusable-identifiers,
-         -misc-no-recursion,
-         -misc-non-private-member-variables-in-classes,
-         -modernize-concat-nested-namespaces,
-         -modernize-type-traits,
-         -modernize-use-nodiscard,
-         -modernize-use-trailing-return-type,
-         -readability-function-cognitive-complexity,
-         -readability-function-size,
-         -readability-identifier-length,
-         -readability-magic-numbers,
-         -readability-redundant-access-specifiers,
-         -readability-simplify-boolean-expr,
-         -readability-uppercase-literal-suffix'
-
-CheckOptions:
-  - key: hicpp-special-member-functions.AllowSoleDefaultDtor
-    value: 1
-
-WarningsAsErrors: '*'
-HeaderFilterRegex: '.*hpp$'

package/.cmake-format.py

@@ -1,19 +0,0 @@
-# -----------------------------
-# Options effecting formatting.
-# -----------------------------
-with section("format"):
-    # How wide to allow formatted cmake files
-    line_width = 120
-
-    # How many spaces to tab for indent
-    tab_size = 4
-
-    # If true, separate flow control names from their parentheses with a space
-    separate_ctrl_name_with_space = True
-
-    # If true, separate function names from parentheses with a space
-    separate_fn_name_with_space = False
-
-    # If a statement is wrapped to more than one line, than dangle the closing
-    # parenthesis on its own line.
-    dangle_parens = True

package/.dockerignore

@@ -1,93 +0,0 @@
-# Ignore all files without an extension
-*
-!/**/
-!*.*
-
-# Temporary files
-.DS_Store
-*.fbin
-*.ibin
-datasets
-bin
-*.usearch
-.cache
-
-# C++ builds
-build
-build_release
-build_debug
-_deps
-CMakeCache.txt
-CMakeFiles
-cmake_install.cmake
-
-# Profiling with GProf and `perf` on Linux
-gmon.out
-perf.data
-
-# Python wrappers
-__pycache__
-*.egg-info
-dist/
-wheelhouse/
-
-# Python Environments
-venv/
-
-# JS wrappers
-package-lock.json
-node_modules/
-
-# Rust builds
-Cargo.lock
-target/
-
-# Java bindings
-.gradle
-*.class
-
-# ObjC and Swift
-.build
-.swiftpm
-
-# C# builds
-csharp/**/[Bb]in/
-csharp/**/[Oo]bj/
-csharp/lib
-csharp/packages
-
-# Prerequisites
-*.d
-
-# Compiled Object files
-*.slo
-*.lo
-*.o
-*.obj
-
-# Precompiled Headers
-*.gch
-*.pch
-
-# Compiled Dynamic libraries
-*.so
-*.dylib
-*.dll
-
-# Fortran module files
-*.mod
-*.smod
-
-# Allow golang go.mod
-!go.mod
-
-# Compiled Static libraries
-*.lai
-*.la
-*.a
-*.lib
-
-# Executables
-*.exe
-*.out
-*.app

package/.gitattributes

@@ -1,9 +0,0 @@
-#
-# https://help.github.com/articles/dealing-with-line-endings/
-#
-# Linux start script should use lf
-/gradlew        text eol=lf
-
-# These are Windows script files and should use crlf
-*.bat           text eol=crlf
-

package/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,90 +0,0 @@
-name: Report a bug
-description: Something doesn't work as expected?
-title: "Bug: "
-labels: ["bug"]
-assignees:
-  - octocat
-body:
-  - type: markdown
-    attributes:
-      value: |
-        Thanks for taking the time to fill out this bug report!
-        If you have a small question, it may be faster to ask the maintainers on [Discord](https://discord.gg/4mxGrenbNt).
-  - type: textarea
-    id: what
-    attributes:
-      label: Describe the bug
-      placeholder: A short description of what the bug is.
-    validations:
-      required: true
-  - type: textarea
-    id: steps
-    attributes:
-      label: Steps to reproduce
-      placeholder: Detail the steps taken to reproduce the behavior.
-    validations:
-      required: true
-  - type: textarea
-    id: expected
-    attributes:
-      label: Expected behavior
-      placeholder: A clear and concise description of what you expected to happen.
-    validations:
-      required: true
-  - type: input
-    id: version
-    attributes:
-      label: USearch version
-      placeholder: v0.4.X
-    validations:
-      required: true
-  - type: input
-    id: os
-    attributes:
-      label: Operating System
-      placeholder: Ubuntu 22.04
-    validations:
-      required: true
-  - type: dropdown
-    id: hardware
-    attributes:
-      label: Hardware architecture
-      options:
-        - x86
-        - Arm
-    validations:
-      required: true
-  - type: dropdown
-    id: frontend
-    attributes:
-      label: Which interface are you using?
-      options:
-        - C++ implementation
-        - Python bindings
-        - Other bindings
-    validations:
-      required: true
-  - type: input
-    id: contact
-    attributes:
-      label: Contact Details
-      description: How can we get in touch with you if we need more info?
-      placeholder: email@example.com
-    validations:
-      required: false
-  - type: checkboxes
-    id: duplicate
-    attributes:
-      label: Is there an existing issue for this?
-      description: Please search [our issues](https://github.com/unum-cloud/usearch/issues) to see if this bug already exists.
-      options:
-        - label: I have searched the existing issues
-          required: true
-  - type: checkboxes
-    id: terms
-    attributes:
-      label: Code of Conduct
-      description: By submitting this issue, you agree to follow our [Code of Conduct](https://github.com/unum-cloud/usearch/blob/main/CODE_OF_CONDUCT.md)
-      options:
-        - label: I agree to follow this project's Code of Conduct
-          required: true

package/.github/ISSUE_TEMPLATE/config.yml

@@ -1,5 +0,0 @@
-blank_issues_enabled: false
-contact_links:
-  - name: 💬 Ask on Discord
-    url: https://discord.gg/A6wxt6dS9j
-    about: Real-time communication with maintainers, contributors, and broader community

package/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -1,64 +0,0 @@
-name: Request a feature
-description: Something we haven't implemented yet?
-title: "Feature: "
-labels: ["enhancement"]
-assignees:
-  - octocat
-body:
-  - type: markdown
-    attributes:
-      value: |
-        Thanks for taking the time to fill out this feature request!
-        We have already scheduled a few features for our [next milestone](https://github.com/unum-cloud/usearch/milestones).
-        Still, if it is something we have yet to think about, we will happily extend our [roadmap](https://github.com/orgs/unum-cloud/projects/2).
-        It is also worth noting that choosing between speed and functionality, we generally prefer the former.
-        So in some cases, it makes more sense to build something on top of USearch rather than patch it 🤗
-  - type: textarea
-    id: what
-    attributes:
-      label: Describe what you are looking for
-      placeholder: A short description of what the feature would look like, ideally with code examples.
-    validations:
-      required: true
-  - type: checkboxes
-    id: check
-    attributes:
-      label: Can you contribute to the implementation?
-      options:
-        - label: I can contribute
-  - type: dropdown
-    id: interface
-    attributes:
-      label: Is your feature request specific to a certain interface?
-      options:
-        - It applies to everything
-        - C++ implementation
-        - Python bindings
-        - Other bindings
-        - Other
-    validations:
-      required: true
-  - type: input
-    id: contact
-    attributes:
-      label: Contact Details
-      description: How can we get in touch with you if we need more info?
-      placeholder: email@example.com
-    validations:
-      required: false
-  - type: checkboxes
-    id: duplicate
-    attributes:
-      label: Is there an existing issue for this?
-      description: Please search [our issues](https://github.com/unum-cloud/usearch/issues) to see if this bug already exists.
-      options:
-        - label: I have searched the existing issues
-          required: true
-  - type: checkboxes
-    id: terms
-    attributes:
-      label: Code of Conduct
-      description: By submitting this issue, you agree to follow our [Code of Conduct](https://github.com/unum-cloud/usearch/blob/main/CODE_OF_CONDUCT.md)
-      options:
-        - label: I agree to follow this project's Code of Conduct
-          required: true

package/.github/workflows/Dockerfile.libs

@@ -1,36 +0,0 @@
-FROM ubuntu:22.04
-ENV DEBIAN_FRONTEND=noninteractive
-
-ENV user_name="runner"
-ARG TARGETPLATFORM
-ARG docker_ip
-ARG user_pass
-
-RUN apt-get update && \
-    apt-get install -y --no-install-recommends cmake g++-12 gcc-12 libc++-dev libc++abi-dev build-essential libjemalloc-dev openssh-client sshpass && \
-    apt-get clean && \
-    rm -rf /var/lib/apt/lists/*
-
-ENV CC=gcc-12
-ENV CXX=g++-12
-
-COPY . .
-
-RUN cmake -DCMAKE_BUILD_TYPE=Release -DUSEARCH_BUILD_LIB_C=1 -DUSEARCH_BUILD_TEST_CPP=0 -DUSEARCH_BUILD_BENCH_CPP=0 -B ./build_release
-RUN cmake --build ./build_release --config Release
-
-RUN if [ "$TARGETPLATFORM" = "linux/amd64" ]; then \
-        export arch="amd"; \
-    elif [ "$TARGETPLATFORM" = "linux/arm64" ]; then \
-        export arch="arm"; \
-    fi && \
-    version=$(cat VERSION) && \
-    mkdir -p usearch_linux_"$arch"_"$version"/DEBIAN && \
-    touch usearch_linux_"$arch"_"$version"/DEBIAN/control && \
-    mkdir -p usearch_linux_"$arch"_"$version"/usr/local/lib && \
-    mkdir usearch_linux_"$arch"_"$version"/usr/local/include && \
-    cp c/usearch.h usearch_linux_"$arch"_"$version"/usr/local/include/ && \
-    cp build_release/libusearch_c.so usearch_linux_"$arch"_"$version"/usr/local/lib/ && \
-    echo "Package: usearch\nVersion: $version\nMaintainer: Ash Vardanian\nArchitecture: "$arch"\nDescription: Faster & Smaller Single-File Search Engine for Vectors & Texts" > usearch_linux_"$arch"_"$version"/DEBIAN/control && \
-    dpkg-deb --build usearch_linux_"$arch"_"$version" && \
-    sshpass -p "$user_pass" scp -o StrictHostKeyChecking=no usearch_linux_"$arch"_"$version".deb "$user_name"@"$docker_ip":/home/$user_name/work/usearch/usearch/