llama-cpp-pro 0.2.2

package/package.json

@@ -0,0 +1,281 @@
+{
+  "name": "llama-cpp-pro",
+  "version": "0.2.2",
+  "description": "Pro llama.cpp Capacitor plugin for offline AI on iOS, Android, Web/PWA, and Desktop — text generation, chat, multimodal, TTS, LoRA, embeddings, and more.",
+  "main": "dist/plugin.cjs",
+  "type": "module",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/plugin.cjs",
+      "default": "./dist/esm/index.js"
+    },
+    "./wasm/llama_engine.js": {
+      "types": "./dist/wasm/llama_engine.d.ts",
+      "default": "./dist/wasm/llama_engine.js"
+    },
+    "./wasm/llama_engine.wasm": "./dist/wasm/llama_engine.wasm",
+    "./wasm/llama_engine_emscripten.mjs": "./dist/wasm/llama_engine_emscripten.mjs",
+    "./wasm/package.json": "./dist/wasm/package.json",
+    "./dist/*": "./dist/*",
+    "./desktop": "./desktop/src/main/index.cjs",
+    "./desktop/electron-builder": "./desktop/electron-builder.config.cjs",
+    "./desktop/resolve-package-root": "./desktop/resolve-package-root.cjs",
+    "./desktop/ipc-handlers": "./desktop/src/main/ipc-handlers.cjs",
+    "./desktop/preload": "./desktop/src/main/preload.cjs",
+    "./desktop/entitlements.mac.plist": "./desktop/entitlements.mac.plist",
+    "./package.json": "./package.json"
+  },
+  "unpkg": "dist/plugin.js",
+  "files": [
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    "android/src/main/",
+    "android/build.gradle",
+    "build-native.sh",
+    "cpp/",
+    "dist/",
+    "ios/CMakeLists.txt",
+    "ios/CMakeLists-arm64.txt",
+    "ios/CMakeLists-x86_64.txt",
+    "ios/metal-embed.cmake",
+    "ios/embed-metal-shaders.sh",
+    "ios/Sources",
+    "ios/Frameworks",
+    "scripts/ensure-llama-ios-xcframework.sh",
+    "scripts/embed-llama-ios-app-framework.sh",
+    "Package.swift",
+    "LlamaCpp.podspec",
+    "LlamaCppCapacitor.podspec",
+    "types/",
+    "desktop/",
+    "sidecar/CMakeLists.txt",
+    "sidecar/cap-sidecar-main.cpp",
+    "cmake/",
+    "extraResources/",
+    "scripts/stage-desktop-resources.cjs",
+    "scripts/ensure-desktop-sidecar-bundle.cjs",
+    "scripts/build-sidecar.sh",
+    "scripts/build-sidecar-linux.sh",
+    "scripts/build-sidecar-win.bat",
+    "scripts/build-js-preserve-wasm.cjs",
+    "scripts/fix-esm-extensions.cjs",
+    "scripts/prepare-js-dist.cjs"
+  ],
+  "readme": "README.md",
+  "author": "Mr. Yakub Mohammad <yakub@annadata.ai> (yakub@arusatech.com, yakub@arusallc.com)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arusatech/llama-cpp-pro.git"
+  },
+  "bugs": {
+    "url": "https://github.com/arusatech/llama-cpp-pro/issues"
+  },
+  "homepage": "https://annadata.ai",
+  "keywords": [
+    "capacitor",
+    "plugin",
+    "native",
+    "ios",
+    "rocm",
+    "intel",
+    "amd",
+    "nvidia",
+    "cuda",
+    "vulkan",
+    "metal",
+    "opengl",
+    "webgpu",
+    "webgl",
+    "webassembly",
+    "wasm",
+    "beaglebone",
+    "raspberry-pi",
+    "android",
+    "llama",
+    "llama-cpp",
+    "llama.cpp",
+    "bindings",
+    "ai",
+    "cmake",
+    "cmake-js",
+    "prebuilt-binaries",
+    "llm",
+    "gguf",
+    "grammar",
+    "embedding",
+    "rerank",
+    "reranking",
+    "json-grammar",
+    "json-schema-grammar",
+    "functions",
+    "function-calling",
+    "token-prediction",
+    "speculative-decoding",
+    "temperature",
+    "minP",
+    "topK",
+    "topP",
+    "seed",
+    "xtc",
+    "json-schema",
+    "self-hosted",
+    "local",
+    "catai",
+    "mistral",
+    "deepseek",
+    "qwen",
+    "qwq",
+    "gpt",
+    "gpt-oss",
+    "typescript",
+    "lora",
+    "batching",
+    "gpu",
+    "machine-learning",
+    "offline-ai",
+    "text-generation",
+    "multimodal",
+    "tts",
+    "text-to-speech",
+    "embeddings",
+    "chat-completion",
+    "annadata",
+    "annadata.ai",
+    "llama-cpp-pro",
+    "llama-cpp-capacitor",
+    "large-language-model"
+  ],
+  "scripts": {
+    "verify": "npm run verify:ios && npm run verify:android && npm run verify:web",
+    "verify:ios": "xcodebuild -scheme LlamaCpp -destination generic/platform=iOS",
+    "verify:android": "cd android && gradlew.bat clean build test && cd ..",
+    "verify:web": "npm run build",
+    "lint": "npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint",
+    "fmt": "npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format",
+    "eslint": "eslint . --ext ts",
+    "prettier": "prettier \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java",
+    "swiftlint": "node-swiftlint",
+    "docgen": "npx docgen --api LlamaCppPlugin --output-readme README.md --output-json dist/docs.json",
+    "build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs",
+    "build:js": "node ./scripts/build-js-preserve-wasm.cjs",
+    "prepare": "node ./scripts/prepare-js-dist.cjs",
+    "build:wasm": "LLAMA_WASM_JSPI=1 LLAMA_WASM_PTHREAD=0 ./scripts/build-wasm.sh",
+    "build:wasm:jspi": "LLAMA_WASM_JSPI=1 LLAMA_WASM_PTHREAD=0 ./scripts/build-wasm.sh",
+    "build:wasm:pthreads": "LLAMA_WASM_JSPI=1 LLAMA_WASM_PTHREAD=1 ./scripts/build-wasm.sh",
+    "build:wasm:full": "LLAMA_WASM_JSPI=1 LLAMA_WASM_PTHREAD=0 ./scripts/build-wasm.sh",
+    "build:worker": "node ./scripts/build-worker.mjs",
+    "build:wasm:assets": "node ./scripts/copy-wasm-assets.mjs",
+    "build:native": "./build-native.sh",
+    "build:sidecar": "./scripts/build-sidecar.sh",
+    "build:sidecar:metal": "./scripts/build-sidecar.sh metal-coreml",
+    "build:sidecar:cpu": "./scripts/build-sidecar.sh cpu",
+    "build:sidecar:linux": "bash ./scripts/build-sidecar-linux.sh",
+    "build:sidecar:win": "scripts\\build-sidecar-win.bat",
+    "build:sidecar:cuda": "./scripts/build-sidecar.sh cuda",
+    "build:sidecar:rocm": "./scripts/build-sidecar.sh rocm",
+    "build:sidecar:vulkan": "./scripts/build-sidecar.sh vulkan-openblas",
+    "build:sidecar:intel": "./scripts/build-sidecar.sh vulkan",
+    "build:sidecar:darwin-x64": "./scripts/build-sidecar.sh darwin-x64",
+    "build:sidecar:universal": "./scripts/build-sidecar.sh universal",
+    "stage:desktop": "node ./scripts/stage-desktop-resources.cjs",
+    "verify:desktop:bundle": "node ./scripts/ensure-desktop-sidecar-bundle.cjs",
+    "build:desktop": "npm run build:pwa && npm run build:sidecar && npm run stage:desktop",
+    "build:desktop:universal": "npm run build:pwa && npm run build:sidecar:universal && npm run stage:desktop",
+    "build:all": "npm run build && npm run build:native",
+    "build:pwa": "npm run build:wasm && npm run build:worker && npm run build:wasm:assets",
+    "build:pwa:full": "npm run build:wasm:full && npm run build:worker && npm run build:wasm:assets",
+    "build:ios:xcframework": "bash ./scripts/ensure-llama-ios-xcframework.sh",
+    "ios:prepare": "npm run build:ios:xcframework",
+    "build:package": "npm run build && npm run build:native && npm run build:pwa",
+    "build:package:full": "npm run build && npm run build:native && npm run build:pwa:full",
+    "verify:pack:artifacts": "node ./scripts/verify-pack-artifacts.mjs",
+    "build:ios": "cd ios && cmake -B build -S . && cmake --build build --config Release",
+    "build:android": "cd android && gradlew.bat assembleRelease",
+    "prepack": "npm run build:package && npm run verify:pack:artifacts",
+    "pack": "npm pack --dry-run",
+    "pack:full": "npm run build:package:full && npm run verify:pack:artifacts && npm pack --ignore-scripts",
+    "release:pack": "npm run build:wasm:assets && npm run verify:pack:artifacts && npm pack --ignore-scripts",
+    "release:0.2.0": "npm run build:package:full && npm run verify:pwa && npm run release:pack",
+    "test": "jest",
+    "test:pwa:smoke": "jest --config test/jest.pwa.config.cjs",
+    "verify:pwa": "npx tsc -p tsconfig.json --noEmit && npm run test:pwa:smoke",
+    "release:gate:pwa": "./scripts/pwa-release-gate.sh",
+    "test:integration": "./scripts/test-integration.sh",
+    "test:integration:jest": "jest --config test/jest.integration.config.js",
+    "test:integration:custom": "ts-node test/integration/test-runner.ts",
+    "test:unit": "jest --testPathIgnorePatterns=test/integration",
+    "test:coverage": "jest --coverage",
+    "clean": "rimraf ./dist",
+    "clean:native": "rimraf ios/build ios/Frameworks android/build android/src/main/jniLibs",
+    "clean:wasm": "rimraf src-rust/target src-rust/pkg dist/wasm",
+    "clean:all": "npm run clean && npm run clean:native && npm run clean:wasm",
+    "clean:test": "rimraf test/output test/coverage",
+    "watch": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@capacitor/android": "^8.0.0",
+    "@capacitor/core": "^8.0.0",
+    "@capacitor/docgen": "^0.3.0",
+    "@capacitor/ios": "^8.0.0",
+    "@ionic/eslint-config": "^0.4.0",
+    "@ionic/prettier-config": "^4.0.0",
+    "@ionic/swiftlint-config": "^2.0.0",
+    "@types/jest": "^30.0.0",
+    "eslint": "^8.57.0",
+    "jest": "^30.4.2",
+    "prettier": "^3.4.2",
+    "prettier-plugin-java": "^2.6.6",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.30.1",
+    "swiftlint": "^2.0.0",
+    "ts-jest": "^29.4.11",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "@capacitor/core": ">=6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@capacitor/core": {
+      "optional": false
+    }
+  },
+  "prettier": "@ionic/prettier-config",
+  "swiftlint": "@ionic/swiftlint-config",
+  "eslintConfig": {
+    "extends": "@ionic/eslint-config/recommended"
+  },
+  "jest": {
+    "preset": "ts-jest",
+    "testEnvironment": "node",
+    "roots": [
+      "<rootDir>/test"
+    ],
+    "testMatch": [
+      "**/*.test.ts"
+    ],
+    "moduleFileExtensions": [
+      "ts",
+      "js",
+      "json"
+    ],
+    "collectCoverageFrom": [
+      "src/**/*.ts",
+      "!src/**/*.d.ts"
+    ]
+  },
+  "capacitor": {
+    "ios": {
+      "src": "ios"
+    },
+    "android": {
+      "src": "android"
+    }
+  }
+}

package/scripts/build-js-preserve-wasm.cjs

@@ -0,0 +1,53 @@
+/**
+ * Build TypeScript + Rollup JS without wiping dist/wasm (or workers).
+ */
+const { existsSync, mkdirSync, rmSync, renameSync, cpSync } = require('node:fs');
+const { join } = require('node:path');
+const { spawnSync } = require('node:child_process');
+
+const root = join(__dirname, '..');
+const dist = join(root, 'dist');
+const stash = join(root, '.dist-stash');
+
+const run = (cmd, args) => {
+  const r = spawnSync(cmd, args, { cwd: root, stdio: 'inherit', shell: process.platform === 'win32' });
+  if (r.status !== 0) process.exit(r.status ?? 1);
+};
+
+// Stash large assets if present.
+if (existsSync(stash)) rmSync(stash, { recursive: true, force: true });
+mkdirSync(stash, { recursive: true });
+for (const name of ['wasm', 'workers']) {
+  const from = join(dist, name);
+  if (existsSync(from)) {
+    renameSync(from, join(stash, name));
+  }
+}
+
+for (const name of [
+  'esm',
+  'plugin.js',
+  'plugin.cjs',
+  'plugin.cjs.js',
+  'plugin.js.map',
+  'plugin.cjs.map',
+  'plugin.cjs.js.map',
+  'docs.json',
+]) {
+  const p = join(dist, name);
+  if (existsSync(p)) rmSync(p, { recursive: true, force: true });
+}
+
+run(join(root, 'node_modules', '.bin', 'tsc'), []);
+run(process.execPath, [join(root, 'scripts', 'fix-esm-extensions.cjs')]);
+run(join(root, 'node_modules', '.bin', 'rollup'), ['-c', 'rollup.config.mjs']);
+mkdirSync(dist, { recursive: true });
+for (const name of ['wasm', 'workers']) {
+  const from = join(stash, name);
+  if (existsSync(from)) {
+    cpSync(from, join(dist, name), { recursive: true });
+  }
+}
+rmSync(stash, { recursive: true, force: true });
+
+console.log('[llama-cpp-pro] build:js complete (wasm preserved if present)');

package/scripts/build-sidecar-linux.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+# Build llama-cpp sidecar for Linux (x64) with Vulkan default; optional variant arg.
+set -euo pipefail
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+VARIANT="${1:-vulkan-openblas}"
+exec "${ROOT}/scripts/build-sidecar.sh" "${VARIANT}"

package/scripts/build-sidecar-win.bat

@@ -0,0 +1,19 @@
+@echo off
+REM Build llama-cpp sidecar for Windows x64 (Vulkan + OpenBLAS default)
+setlocal
+set ROOT=%~dp0..
+set VARIANT=%1
+if "%VARIANT%"=="" set VARIANT=vulkan-openblas
+
+if not exist "%ROOT%\sidecar\build" mkdir "%ROOT%\sidecar\build"
+
+cmake -B "%ROOT%\sidecar\build" -S "%ROOT%\sidecar" ^
+  -DCMAKE_BUILD_TYPE=Release ^
+  -DSIDECAR_VARIANT=%VARIANT%
+
+cmake --build "%ROOT%\sidecar\build" --config Release -j
+
+if not exist "%ROOT%\sidecar\bin" mkdir "%ROOT%\sidecar\bin"
+copy /Y "%ROOT%\sidecar\build\bin\*" "%ROOT%\sidecar\bin\"
+
+echo Sidecar built: %ROOT%\sidecar\bin

package/scripts/build-sidecar.sh

@@ -0,0 +1,184 @@
+#!/usr/bin/env bash
+# Build the llama-cpp desktop sidecar for the current host platform.
+#
+# Usage:
+#   ./scripts/build-sidecar.sh [variant]
+#   ./scripts/build-sidecar.sh [variant] --arch arm64|x64|host
+#   ./scripts/build-sidecar.sh darwin-x64          # cross-build Intel Mac binary
+#   ./scripts/build-sidecar.sh universal           # arm64 + x64 on macOS
+#
+# Variants: metal-coreml | metal | vulkan-openblas | cuda | rocm | cpu | openblas | vulkan
+#
+# Optional env:
+#   LLAMA_CPP_UPSTREAM=/path/to/llama.cpp  — also build ggml GPU backend plugins
+#   OPENBLAS_ROOT=/path/to/openblas
+#   SIDECAR_ARCH=arm64|x64                 — same as --arch
+
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+VARIANT=""
+ARCH_OPT="${SIDECAR_ARCH:-host}"
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --arch)
+      shift
+      ARCH_OPT="${1:-}"
+      if [[ -z "${ARCH_OPT}" ]]; then
+        echo "error: --arch requires arm64|x64|host" >&2
+        exit 1
+      fi
+      ;;
+    --arch=*)
+      ARCH_OPT="${1#--arch=}"
+      ;;
+    -h|--help)
+      sed -n '2,16p' "$0"
+      exit 0
+      ;;
+    *)
+      if [[ -z "${VARIANT}" ]]; then
+        VARIANT="$1"
+      else
+        echo "error: unexpected argument: $1" >&2
+        exit 1
+      fi
+      ;;
+  esac
+  shift
+done
+
+# Aliases that imply arch + Metal backend on macOS
+if [[ "${VARIANT}" == "darwin-x64" ]]; then
+  VARIANT="metal"
+  ARCH_OPT="x64"
+elif [[ "${VARIANT}" == "darwin-arm64" ]]; then
+  if [[ "$(uname -m)" == "arm64" ]]; then
+    VARIANT="metal-coreml"
+  else
+    VARIANT="metal"
+  fi
+  ARCH_OPT="arm64"
+elif [[ "${VARIANT}" == "universal" ]]; then
+  if [[ "$(uname -s)" != "Darwin" ]]; then
+    echo "error: universal sidecar builds are only supported on macOS" >&2
+    exit 1
+  fi
+  echo "==> Building universal macOS sidecars (arm64 + x64)"
+  "$0" metal-coreml --arch=arm64
+  "$0" metal --arch=x64
+  echo "==> Universal sidecar binaries:"
+  ls -la "${ROOT}/sidecar/bin"/darwin-* || true
+  exit 0
+fi
+
+if [[ -z "${VARIANT}" ]]; then
+  case "$(uname -s)" in
+    Darwin)
+      if [[ "$(uname -m)" == "arm64" && "${ARCH_OPT}" != "x64" ]]; then
+        VARIANT="metal-coreml"
+      else
+        VARIANT="metal"
+      fi
+      ;;
+    Linux) VARIANT="vulkan-openblas" ;;
+    *) VARIANT="cpu" ;;
+  esac
+fi
+
+# Resolve arch → CMAKE_OSX_ARCHITECTURES / build dir suffix
+HOST_ARCH="$(uname -m)"
+case "${ARCH_OPT}" in
+  host|"")
+    if [[ "${HOST_ARCH}" == "arm64" ]]; then
+      TARGET_ARCH="arm64"
+      OSX_ARCH="arm64"
+    else
+      TARGET_ARCH="x64"
+      OSX_ARCH="x86_64"
+    fi
+    ;;
+  arm64)
+    TARGET_ARCH="arm64"
+    OSX_ARCH="arm64"
+    ;;
+  x64|x86_64|amd64)
+    TARGET_ARCH="x64"
+    OSX_ARCH="x86_64"
+    ;;
+  *)
+    echo "error: unknown arch '${ARCH_OPT}' (use arm64|x64|host)" >&2
+    exit 1
+    ;;
+esac
+
+# metal-coreml is Apple Silicon only
+if [[ "${VARIANT}" == "metal-coreml" && "${TARGET_ARCH}" == "x64" ]]; then
+  echo "==> Note: metal-coreml is arm64-only; using metal for darwin-x64"
+  VARIANT="metal"
+fi
+
+BUILD_DIR="${ROOT}/sidecar/build-${TARGET_ARCH}"
+BIN_DIR="${ROOT}/sidecar/bin"
+mkdir -p "${BIN_DIR}"
+
+CMAKE_ARGS=(
+  -B "${BUILD_DIR}"
+  -S "${ROOT}/sidecar"
+  -DCMAKE_BUILD_TYPE=Release
+  "-DSIDECAR_VARIANT=${VARIANT}"
+)
+
+if [[ "$(uname -s)" == "Darwin" ]]; then
+  CMAKE_ARGS+=("-DCMAKE_OSX_ARCHITECTURES=${OSX_ARCH}")
+fi
+
+if [[ -n "${LLAMA_CPP_UPSTREAM:-}" ]]; then
+  CMAKE_ARGS+=("-DLLAMA_CPP_UPSTREAM=${LLAMA_CPP_UPSTREAM}")
+fi
+
+echo "==> Configuring sidecar (variant=${VARIANT} arch=${TARGET_ARCH})"
+cmake "${CMAKE_ARGS[@]}"
+
+echo "==> Building sidecar"
+cmake --build "${BUILD_DIR}" --config Release -j"$(nproc 2>/dev/null || sysctl -n hw.ncpu 2>/dev/null || echo 4)"
+
+echo "==> Staging binaries to sidecar/bin/"
+# Prefer the expected named binary; fall back to copying executables from build/bin
+EXPECTED_NAME=""
+if [[ "$(uname -s)" == "Darwin" ]]; then
+  EXPECTED_NAME="darwin-${TARGET_ARCH}"
+elif [[ "$(uname -s)" == "Linux" ]]; then
+  if [[ "${VARIANT}" == "vulkan-openblas" ]]; then
+    EXPECTED_NAME="linux-${TARGET_ARCH}"
+  else
+    EXPECTED_NAME="linux-${TARGET_ARCH}-${VARIANT}"
+  fi
+fi
+
+if [[ -n "${EXPECTED_NAME}" && -f "${BUILD_DIR}/bin/${EXPECTED_NAME}" ]]; then
+  cp -f "${BUILD_DIR}/bin/${EXPECTED_NAME}" "${BIN_DIR}/"
+elif [[ -n "${EXPECTED_NAME}" && -f "${BUILD_DIR}/bin/${EXPECTED_NAME}.exe" ]]; then
+  cp -f "${BUILD_DIR}/bin/${EXPECTED_NAME}.exe" "${BIN_DIR}/"
+else
+  find "${BUILD_DIR}/bin" -maxdepth 1 -type f -perm +111 2>/dev/null | while read -r f; do
+    cp -f "$f" "${BIN_DIR}/"
+  done
+fi
+
+find "${BUILD_DIR}/bin" -maxdepth 1 -type f \( -name "*.exe" -o -name "*.dll" -o -name "*.so" -o -name "libggml-*" -o -name "ggml-*" \) 2>/dev/null | while read -r f; do
+  cp -f "$f" "${BIN_DIR}/" || true
+done
+
+if [[ -n "${EXPECTED_NAME}" ]]; then
+  STAGED="${BIN_DIR}/${EXPECTED_NAME}"
+  if [[ -f "${STAGED}" ]]; then
+    echo "==> Built $(file "${STAGED}")"
+  else
+    echo "warning: expected ${EXPECTED_NAME} not found in ${BIN_DIR}" >&2
+  fi
+fi
+
+echo "==> Done. Binaries in ${BIN_DIR}:"
+ls -la "${BIN_DIR}" || true

package/scripts/embed-llama-ios-app-framework.sh

@@ -0,0 +1,63 @@
+#!/usr/bin/env bash
+# Copy the correct llama-cpp.xcframework slice into App.app/Frameworks for dlopen.
+# Invoked from the iOS app Xcode target (Run Script) or manually with Xcode env vars set.
+set -euo pipefail
+
+if [ -z "${TARGET_BUILD_DIR:-}" ] || [ -z "${FRAMEWORKS_FOLDER_PATH:-}" ]; then
+  echo "embed-llama-ios-app-framework: skip (not running inside an Xcode build)."
+  exit 0
+fi
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PLUGIN_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+XCF="$PLUGIN_DIR/ios/Frameworks/llama-cpp.xcframework"
+
+if [ ! -d "$XCF" ]; then
+  echo "error: missing $XCF" >&2
+  echo "  From your app root run: npm run ios:prepare-llama-cpp" >&2
+  exit 1
+fi
+
+pick_slice() {
+  case "${PLATFORM_NAME:-}" in
+    iphoneos)
+      echo "ios-arm64"
+      ;;
+    iphonesimulator)
+      if [ -d "$XCF/ios-arm64-simulator" ]; then
+        echo "ios-arm64-simulator"
+      elif [ -d "$XCF/ios-x86_64-simulator" ]; then
+        echo "ios-x86_64-simulator"
+      else
+        echo "error: no simulator slice in $XCF" >&2
+        exit 1
+      fi
+      ;;
+    *)
+      echo "error: unsupported PLATFORM_NAME=${PLATFORM_NAME:-}" >&2
+      exit 1
+      ;;
+  esac
+}
+
+SLICE="$(pick_slice)"
+SRC_FW="$XCF/$SLICE/llama-cpp.framework"
+DEST_DIR="${TARGET_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}"
+DEST_FW="$DEST_DIR/llama-cpp.framework"
+DEST_BIN="$DEST_FW/llama-cpp"
+
+if [ ! -f "$SRC_FW/llama-cpp" ]; then
+  echo "error: xcframework slice binary missing: $SRC_FW/llama-cpp" >&2
+  exit 1
+fi
+
+mkdir -p "$DEST_DIR"
+rm -rf "$DEST_FW"
+ditto "$SRC_FW" "$DEST_FW"
+
+if [ -n "${EXPANDED_CODE_SIGN_IDENTITY:-}" ] && [ "${CODE_SIGNING_ALLOWED:-}" != "NO" ]; then
+  /usr/bin/codesign --force --sign "${EXPANDED_CODE_SIGN_IDENTITY}" \
+    --preserve-metadata=identifier,entitlements,flags "$DEST_BIN" 2>/dev/null || true
+fi
+
+echo "Embedded llama-cpp.framework ($SLICE) -> $DEST_FW"