aboutsummaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
Diffstat (limited to 'src')
-rw-r--r--src/build.h64
-rw-r--r--src/cli.c834
-rw-r--r--src/config.c305
-rw-r--r--src/config.h8
-rw-r--r--src/cuda.cu2052
-rw-r--r--src/cuda.h80
-rw-r--r--src/embed.c1814
-rw-r--r--src/embed.h355
-rw-r--r--src/internal.h110
-rw-r--r--src/kernels.c1469
-rw-r--r--src/kernels.h219
-rw-r--r--src/kernels_avx.c439
-rw-r--r--src/kernels_generic.c44
-rw-r--r--src/kernels_impl.h53
-rw-r--r--src/kernels_neon.c179
-rw-r--r--src/mlx.c2752
-rw-r--r--src/mlx.h167
-rw-r--r--src/safetensors.c559
-rw-r--r--src/safetensors.h76
-rw-r--r--src/server.c3724
-rw-r--r--src/server.h42
-rw-r--r--src/tokenizer_bpe.c2018
-rw-r--r--src/tokenizer_bpe.h86
-rw-r--r--src/tokenizer_unicode.h4985
-rw-r--r--src/tokenizer_wordpiece.c678
-rw-r--r--src/tokenizer_wordpiece.h79
26 files changed, 23191 insertions, 0 deletions
diff --git a/src/build.h b/src/build.h
new file mode 100644
index 0000000..dc68405
--- /dev/null
+++ b/src/build.h
@@ -0,0 +1,64 @@
+/* embed_build.h - build identity for the embed and embed-server front-ends.
+ *
+ * The real values come from the Makefile's VERSION_CFLAGS at compile time; the
+ * fallbacks below apply when those flags are absent. Front-end only: the
+ * inference library does not use these. */
+#ifndef EMBED_BUILD_H
+#define EMBED_BUILD_H
+
+#include <stdio.h>
+#include <string.h>
+
+#ifndef EMBED_VERSION
+#define EMBED_VERSION "development"
+#endif
+#ifndef EMBED_BUILD_COMMIT
+#define EMBED_BUILD_COMMIT "unknown"
+#endif
+#ifndef EMBED_BUILD_DATE
+#define EMBED_BUILD_DATE "unknown"
+#endif
+#ifndef EMBED_BUILD_OS
+#define EMBED_BUILD_OS "unknown"
+#endif
+#ifndef EMBED_BUILD_ARCH
+#define EMBED_BUILD_ARCH "unknown"
+#endif
+
+/* Backend label for --build-info, selected by the same macro that picks the
+ * compiled inference path. */
+#if defined(USE_MLX)
+#define EMBED_BUILD_BACKENDS "accelerate,mlx"
+#elif defined(USE_CUDA)
+#define EMBED_BUILD_BACKENDS "openblas,cuda"
+#elif defined(__APPLE__)
+#define EMBED_BUILD_BACKENDS "accelerate"
+#else
+#define EMBED_BUILD_BACKENDS "openblas"
+#endif
+
+/* Program name with any leading directory removed. */
+static inline const char *embed_prog_name(const char *argv0)
+{
+ const char *slash = strrchr(argv0, '/');
+ return slash ? slash + 1 : argv0;
+}
+
+static inline void embed_print_version(const char *prog)
+{
+ printf("%s %s (%s/%s)\n", prog, EMBED_VERSION,
+ EMBED_BUILD_OS, EMBED_BUILD_ARCH);
+}
+
+static inline void embed_print_build_info(const char *prog)
+{
+ embed_print_version(prog);
+ printf("backend: %s\n"
+ "compiler: %s\n"
+ "built: %s\n"
+ "commit: %s\n",
+ EMBED_BUILD_BACKENDS, __VERSION__,
+ EMBED_BUILD_DATE, EMBED_BUILD_COMMIT);
+}
+
+#endif /* EMBED_BUILD_H */
diff --git a/src/cli.c b/src/cli.c
new file mode 100644
index 0000000..7d951e4
--- /dev/null
+++ b/src/cli.c
@@ -0,0 +1,834 @@
+/* embed_cli.c - embed command-line tool */
+
+#include "embed.h"
+#include "build.h"
+#include "kernels.h"
+#include "tokenizer_bpe.h"
+#include "tokenizer_wordpiece.h"
+
+#ifdef USE_MLX
+#include "mlx.h"
+#endif
+#ifdef USE_CUDA
+#include "cuda.h"
+#endif
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <time.h>
+#include <limits.h>
+#include <unistd.h>
+
+static double now_ms(void) {
+ struct timespec ts;
+ clock_gettime(CLOCK_MONOTONIC, &ts);
+ return (double)ts.tv_sec * 1000.0 + (double)ts.tv_nsec / 1e6;
+}
+
+static void print_usage(const char *prog) {
+ fprintf(stderr,
+ "Usage: %s -d <model_dir> [options] [text...]\n"
+ "\n"
+ "Options:\n"
+ " -d <dir> Model directory (required)\n"
+#ifdef USE_MLX
+ " --mlx Use Apple MLX GPU backend\n"
+#endif
+#ifdef USE_CUDA
+ " --cuda Use CUDA/cuBLAS GPU backend\n"
+#endif
+ " --stream Read lines from stdin, write one JSON embedding per line\n"
+ " --json Emit JSON instead of plain text (embedding or matrix)\n"
+#ifdef USE_MLX
+ " --mlx-quant-bits N\n"
+ " Quantize MLX linear weights to 8 bits at load time\n"
+ " --mlx-quant-group-size N\n"
+ " MLX quantization group size (default: 64)\n"
+#endif
+#ifdef USE_CUDA
+ " --cuda-gemm-mode MODE\n"
+ " CUDA GEMM compute mode: f32, tf32, bf16, or 16f (default: f32)\n"
+ " --cuda-weight-dtype DTYPE\n"
+ " CUDA weight storage: f32 or bf16 (default: f32). bf16 halves\n"
+ " weight memory and uses BF16 tensor cores\n"
+#endif
+ " -b, --batch-size N\n"
+ " Max texts per engine batch (default: all; --stream: 1)\n"
+ " -t, --threads N\n"
+ " CPU threads (default: available cores, cgroup-aware)\n"
+ " -e, --embeddings\n"
+ " Print raw embeddings (with multiple texts)\n"
+ " -v, --verbose\n"
+ " Verbose (-vv for debug)\n"
+ " -V, --version\n"
+ " Print version and exit\n"
+ " --build-info Print build details and exit\n"
+ " -h Show this help\n"
+ "\n"
+ "Modes:\n"
+ " 1 text arg Embedding as space-separated floats (JSON with --json)\n"
+ " 2+ text args Cosine similarity matrix, one row per line (JSON with --json)\n"
+ " no args Batch: read all stdin lines, then similarity matrix\n"
+ " --stream Streaming: read stdin lines, write JSON per line\n"
+ "\n"
+ "Examples:\n"
+ " %s -d ./model \"what is AI?\"\n"
+#ifdef USE_MLX
+ " %s -d ./model --mlx --stream < texts.txt\n",
+ prog, prog, prog);
+#else
+ ,
+ prog, prog);
+#endif
+}
+
+/* ========================================================================
+ * Embed one text: tokenize > forward > return float[dim]
+ * ======================================================================== */
+
+typedef struct {
+ embed_model_t *model;
+ embed_workspace_t *workspace;
+#ifdef USE_MLX
+ embed_mlx_ctx_t *mlx_ctx;
+#endif
+#ifdef USE_CUDA
+ embed_cuda_ctx_t *cuda_ctx;
+#endif
+ embed_tokenizer_t *tok;
+ embed_tokenizer_workspace_t *tok_ws;
+ /* BERT-family WordPiece tokenizer, selected by a vocab.txt probe at load.
+ * When wp_tok is set, tokenize_text wraps the ids with [CLS]/[SEP] and the
+ * Qwen byte-level BPE fields above stay NULL. */
+ wordpiece_tokenizer_t *wp_tok;
+ wordpiece_workspace_t *wp_tok_ws;
+ int cls_id;
+ int sep_id;
+ int dim;
+ int terminal_token_id;
+ int append_terminal_token;
+} engine_t;
+
+static void engine_free_tokenizers(engine_t *e) {
+ embed_tokenizer_workspace_free(e->tok_ws);
+ embed_tokenizer_free(e->tok);
+ wordpiece_workspace_free(e->wp_tok_ws);
+ wordpiece_tokenizer_free(e->wp_tok);
+}
+
+typedef struct {
+ int *ids;
+ int n_tokens;
+} token_buf_t;
+
+static int
+engine_embed_batch(engine_t *e, const embed_input_t *inputs, int batch, float *out_embeddings) {
+#ifdef USE_MLX
+ if (e->mlx_ctx)
+ return embed_mlx_encode_batch(e->mlx_ctx, inputs, batch, out_embeddings);
+#endif
+#ifdef USE_CUDA
+ if (e->cuda_ctx)
+ return embed_cuda_encode_batch(e->cuda_ctx, inputs, batch, out_embeddings);
+#endif
+ return embed_model_encode_batch(e->model, e->workspace, inputs, batch, out_embeddings);
+}
+
+static int tokenize_text(engine_t *e, const char *text, token_buf_t *out) {
+ memset(out, 0, sizeof(*out));
+ if (e->wp_tok) {
+ /* BERT: WordPiece encode, then wrap [CLS] ... [SEP] (the same contract
+ * as the BPE terminal-token append below). An empty clean yields the
+ * bare pair, matching Hugging Face. Grow the buffer in place. */
+ int n = 0;
+ int *core = wordpiece_tokenizer_encode_with_workspace(e->wp_tok, e->wp_tok_ws, text, &n);
+ if (n < 0 || n > INT_MAX - 2) {
+ free(core);
+ return -1;
+ }
+ int *ids = (int *)realloc(core, (size_t)(n + 2) * sizeof(*ids));
+ if (!ids) {
+ free(core);
+ return -1;
+ }
+ memmove(ids + 1, ids, (size_t)n * sizeof(*ids));
+ ids[0] = e->cls_id;
+ ids[n + 1] = e->sep_id;
+ out->ids = ids;
+ out->n_tokens = n + 2;
+ } else {
+ out->ids = embed_tokenizer_encode_with_workspace(e->tok, e->tok_ws, text, &out->n_tokens);
+ if (!out->ids || out->n_tokens == 0) {
+ fprintf(stderr, "tokenization failed: %s\n", text);
+ free(out->ids);
+ out->ids = NULL;
+ out->n_tokens = 0;
+ return -1;
+ }
+ if (e->append_terminal_token) {
+ if (out->n_tokens == INT_MAX) {
+ free(out->ids);
+ memset(out, 0, sizeof(*out));
+ return -1;
+ }
+ int *ids = (int *)realloc(out->ids, (size_t)(out->n_tokens + 1) * sizeof(*out->ids));
+ if (!ids) {
+ free(out->ids);
+ memset(out, 0, sizeof(*out));
+ return -1;
+ }
+ out->ids = ids;
+ out->ids[out->n_tokens++] = e->terminal_token_id;
+ }
+ }
+
+ if (embed_verbose >= 1) {
+ fprintf(stderr, "tokens (%d): ", out->n_tokens);
+ for (int i = 0; i < out->n_tokens && i < 20; i++)
+ fprintf(stderr, "%d ", out->ids[i]);
+ if (out->n_tokens > 20)
+ fprintf(stderr, "...");
+ fprintf(stderr, "\n");
+ }
+ return 0;
+}
+
+static void free_tokens(token_buf_t *tokens, int n) {
+ if (!tokens)
+ return;
+ for (int i = 0; i < n; i++)
+ free(tokens[i].ids);
+}
+
+/* ========================================================================
+ * Output helpers
+ * ======================================================================== */
+
+static void print_embedding_raw(const float *emb, int dim) {
+ for (int i = 0; i < dim; i++) {
+ if (i > 0)
+ putchar(' ');
+ printf("%.8f", (double)emb[i]);
+ }
+ putchar('\n');
+}
+
+/* Single embedding as a JSON array of floats. */
+static void print_embedding_array(const float *emb, int dim) {
+ putchar('[');
+ for (int i = 0; i < dim; i++) {
+ if (i)
+ putchar(',');
+ printf("%.8f", (double)emb[i]);
+ }
+ puts("]");
+}
+
+static size_t engine_workspace_nbytes(const engine_t *e) {
+ return (e && e->workspace) ? embed_workspace_nbytes(e->workspace) : 0;
+}
+
+static void
+print_embedding_json(const float *emb, int dim, int n_tokens, double ms, size_t workspace_bytes) {
+ printf("{\"embedding\":[");
+ for (int i = 0; i < dim; i++) {
+ if (i > 0)
+ putchar(',');
+ printf("%.8f", (double)emb[i]);
+ }
+ printf("],\"dim\":%d,\"tokens\":%d,\"ms\":%.1f,\"workspace_bytes\":%zu}\n", dim, n_tokens, ms,
+ workspace_bytes);
+ fflush(stdout);
+}
+
+/* ========================================================================
+ * Stdin mode: read lines from stdin, write JSON to stdout
+ * ======================================================================== */
+
+static int process_stdin_batch(engine_t *e, char **lines, int n_lines) {
+ if (n_lines <= 0)
+ return 0;
+
+ token_buf_t *tokens = (token_buf_t *)calloc((size_t)n_lines, sizeof(token_buf_t));
+ embed_input_t *inputs = (embed_input_t *)malloc((size_t)n_lines * sizeof(embed_input_t));
+ int *input_to_line = (int *)malloc((size_t)n_lines * sizeof(int));
+ float *embs = (float *)malloc((size_t)n_lines * e->dim * sizeof(float));
+ if (!tokens || !inputs || !input_to_line || !embs) {
+ fprintf(stderr, "OOM\n");
+ free(tokens);
+ free(inputs);
+ free(input_to_line);
+ free(embs);
+ for (int i = 0; i < n_lines; i++)
+ printf("{\"error\":\"embedding failed\"}\n");
+ fflush(stdout);
+ return 1;
+ }
+
+ int n_inputs = 0;
+ for (int i = 0; i < n_lines; i++) {
+ if (tokenize_text(e, lines[i], &tokens[i]) == 0) {
+ inputs[n_inputs].ids = tokens[i].ids;
+ inputs[n_inputs].n_tokens = tokens[i].n_tokens;
+ input_to_line[n_inputs] = i;
+ n_inputs++;
+ }
+ }
+
+ double ms = 0.0;
+ int rc = 0;
+ if (n_inputs > 0) {
+ double t0 = now_ms();
+ rc = engine_embed_batch(e, inputs, n_inputs, embs);
+ ms = now_ms() - t0;
+ if (embed_verbose >= 1)
+ fprintf(stderr, "embed batch: %d texts in %.1f ms\n", n_inputs, ms);
+ }
+
+ int next_valid = 0;
+ for (int i = 0; i < n_lines; i++) {
+ if (!tokens[i].ids) {
+ printf("{\"error\":\"tokenization failed\"}\n");
+ continue;
+ }
+ if (rc != 0) {
+ printf("{\"error\":\"embedding failed\"}\n");
+ continue;
+ }
+ while (next_valid < n_inputs && input_to_line[next_valid] != i)
+ next_valid++;
+ if (next_valid >= n_inputs) {
+ printf("{\"error\":\"embedding failed\"}\n");
+ continue;
+ }
+ print_embedding_json(embs + (size_t)next_valid * e->dim, e->dim, tokens[i].n_tokens, ms,
+ engine_workspace_nbytes(e));
+ next_valid++;
+ }
+ fflush(stdout);
+
+ free_tokens(tokens, n_lines);
+ free(tokens);
+ free(inputs);
+ free(input_to_line);
+ free(embs);
+ return rc == 0 ? 0 : 1;
+}
+
+static int run_stdin(engine_t *e, int batch_size) {
+ char line[65536];
+ if (batch_size <= 0)
+ batch_size = 1;
+
+ if (embed_verbose >= 1)
+ fprintf(stderr, "stdin: ready, reading from stdin (batch_size=%d)\n", batch_size);
+
+ char **batch_lines = (char **)calloc((size_t)batch_size, sizeof(char *));
+ if (!batch_lines) {
+ fprintf(stderr, "OOM\n");
+ return 1;
+ }
+ int n_batch = 0;
+ int rc = 0;
+
+ while (fgets(line, sizeof(line), stdin)) {
+ /* Strip newline */
+ size_t len = strlen(line);
+ while (len > 0 && (line[len - 1] == '\n' || line[len - 1] == '\r'))
+ line[--len] = '\0';
+ if (len == 0)
+ continue;
+
+ if (embed_verbose >= 1)
+ fprintf(stderr, "stdin: \"%.*s%s\"\n", (int)(len > 60 ? 60 : len), line,
+ len > 60 ? "..." : "");
+
+ batch_lines[n_batch] = strdup(line);
+ if (!batch_lines[n_batch]) {
+ fprintf(stderr, "OOM\n");
+ rc = 1;
+ break;
+ }
+ n_batch++;
+
+ if (n_batch == batch_size) {
+ if (process_stdin_batch(e, batch_lines, n_batch) != 0)
+ rc = 1;
+ for (int i = 0; i < n_batch; i++) {
+ free(batch_lines[i]);
+ batch_lines[i] = NULL;
+ }
+ n_batch = 0;
+ }
+ }
+
+ if (n_batch > 0) {
+ if (process_stdin_batch(e, batch_lines, n_batch) != 0)
+ rc = 1;
+ for (int i = 0; i < n_batch; i++)
+ free(batch_lines[i]);
+ }
+ free(batch_lines);
+
+ if (embed_verbose >= 1)
+ fprintf(stderr, "stdin: EOF\n");
+
+ return rc;
+}
+
+/* ========================================================================
+ * Batch mode: embed args or stdin lines, then print similarity or vectors
+ * ======================================================================== */
+
+static int append_text(char ***texts, int *n_texts, int *cap, const char *s) {
+ if (*n_texts == *cap) {
+ int new_cap = *cap ? *cap * 2 : 8;
+ char **new_texts = (char **)realloc(*texts, (size_t)new_cap * sizeof(char *));
+ if (!new_texts)
+ return -1;
+ *texts = new_texts;
+ *cap = new_cap;
+ }
+
+ (*texts)[*n_texts] = strdup(s);
+ if (!(*texts)[*n_texts])
+ return -1;
+ (*n_texts)++;
+ return 0;
+}
+
+/* Cosine similarity matrix. --json emits a JSON array of rows; otherwise one
+ * row of space-separated values per line. With print_embs the raw embeddings
+ * follow, one per line after a blank line (plain-text output only). */
+static void print_matrix(const float *embs, int n, int dim, int json, int print_embs) {
+ if (json) {
+ putchar('[');
+ for (int i = 0; i < n; i++) {
+ if (i)
+ putchar(',');
+ putchar('[');
+ for (int j = 0; j < n; j++) {
+ if (j)
+ putchar(',');
+ printf("%.6f", (double)embed_cosine_similarity(embs + (size_t)i * dim,
+ embs + (size_t)j * dim, dim));
+ }
+ putchar(']');
+ }
+ puts("]");
+ return;
+ }
+
+ for (int i = 0; i < n; i++) {
+ for (int j = 0; j < n; j++) {
+ if (j)
+ putchar(' ');
+ printf("%.6f", (double)embed_cosine_similarity(embs + (size_t)i * dim,
+ embs + (size_t)j * dim, dim));
+ }
+ putchar('\n');
+ }
+ if (print_embs) {
+ putchar('\n');
+ for (int i = 0; i < n; i++)
+ print_embedding_raw(embs + (size_t)i * dim, dim);
+ }
+}
+
+static int run_batch(
+ engine_t *e, int argc, char **argv, int arg_start, int print_embs, int batch_size, int json) {
+ int n_texts = 0, cap = 0;
+ char **texts = NULL;
+ int rc = 0;
+
+ if (arg_start < argc) {
+ for (int i = arg_start; i < argc; i++) {
+ if (append_text(&texts, &n_texts, &cap, argv[i]) != 0)
+ goto oom_texts;
+ }
+ } else {
+ char line[65536];
+ while (fgets(line, sizeof(line), stdin)) {
+ size_t l = strlen(line);
+ while (l > 0 && (line[l - 1] == '\n' || line[l - 1] == '\r'))
+ line[--l] = '\0';
+ if (l == 0)
+ continue;
+ if (append_text(&texts, &n_texts, &cap, line) != 0)
+ goto oom_texts;
+ }
+ }
+
+ if (n_texts == 0) {
+ fprintf(stderr, "no input texts\n");
+ free(texts);
+ return 1;
+ }
+
+ int dim = e->dim;
+ token_buf_t *tokens = (token_buf_t *)calloc((size_t)n_texts, sizeof(token_buf_t));
+ embed_input_t *inputs = (embed_input_t *)malloc((size_t)n_texts * sizeof(embed_input_t));
+ float *embs = (float *)malloc((size_t)n_texts * dim * sizeof(float));
+ if (!tokens || !inputs || !embs) {
+ fprintf(stderr, "OOM\n");
+ free(tokens);
+ free(inputs);
+ free(embs);
+ for (int i = 0; i < n_texts; i++)
+ free(texts[i]);
+ free(texts);
+ return 1;
+ }
+
+ for (int i = 0; i < n_texts; i++) {
+ if (embed_verbose >= 1)
+ fprintf(stderr, "[%d/%d] \"%s\"\n", i + 1, n_texts, texts[i]);
+ if (tokenize_text(e, texts[i], &tokens[i]) != 0) {
+ rc = 1;
+ goto done;
+ }
+ inputs[i].ids = tokens[i].ids;
+ inputs[i].n_tokens = tokens[i].n_tokens;
+ }
+
+ int max_batch = batch_size > 0 ? batch_size : n_texts;
+ for (int start = 0; start < n_texts; start += max_batch) {
+ int cur = n_texts - start;
+ if (cur > max_batch)
+ cur = max_batch;
+
+ double t0 = now_ms();
+ if (engine_embed_batch(e, inputs + start, cur, embs + (size_t)start * dim) != 0) {
+ fprintf(stderr, "forward pass failed\n");
+ rc = 1;
+ goto done;
+ }
+ if (embed_verbose >= 1)
+ fprintf(stderr, "embed batch: [%d..%d] %d texts in %.1f ms\n", start, start + cur - 1,
+ cur, now_ms() - t0);
+ }
+
+ if (n_texts == 1) {
+ if (json)
+ print_embedding_array(embs, dim);
+ else
+ print_embedding_raw(embs, dim);
+ } else {
+ print_matrix(embs, n_texts, dim, json, print_embs);
+ }
+
+done:
+ free_tokens(tokens, n_texts);
+ for (int i = 0; i < n_texts; i++)
+ free(texts[i]);
+ free(texts);
+ free(tokens);
+ free(inputs);
+ free(embs);
+ return rc;
+
+oom_texts:
+ fprintf(stderr, "OOM\n");
+ for (int i = 0; i < n_texts; i++)
+ free(texts[i]);
+ free(texts);
+ return 1;
+}
+
+/* ========================================================================
+ * Main
+ * ======================================================================== */
+
+int main(int argc, char *argv[]) {
+ const char *model_dir = NULL;
+ int n_threads = 0;
+ int print_embs = 0;
+ int verbose = 0;
+ int stdin_mode = 0;
+ int batch_size = 0;
+ int json = 0;
+ const char *prog = embed_prog_name(argv[0]);
+#ifdef USE_MLX
+ int use_mlx = 0;
+ int mlx_quantize_bits = 0;
+ int mlx_quantize_group_size = 64;
+#endif
+#ifdef USE_CUDA
+ int use_cuda = 0;
+ const char *cuda_fast_gemm = NULL;
+ const char *cuda_weights = NULL;
+#endif
+
+ int arg_start = 1;
+ while (arg_start < argc && argv[arg_start][0] == '-') {
+ const char *f = argv[arg_start];
+ if (!strcmp(f, "-d")) {
+ model_dir = argv[++arg_start];
+ } else if (!strcmp(f, "-V") || !strcmp(f, "--version")) {
+ embed_print_version(prog);
+ return 0;
+ } else if (!strcmp(f, "--build-info")) {
+ embed_print_build_info(prog);
+ return 0;
+ } else if (!strcmp(f, "-t") || !strcmp(f, "--threads")) {
+ n_threads = atoi(argv[++arg_start]);
+ } else if (!strcmp(f, "-b") || !strcmp(f, "--batch-size")) {
+ batch_size = atoi(argv[++arg_start]);
+ } else if (!strcmp(f, "--json")) {
+ json = 1;
+ }
+#ifdef USE_MLX
+ else if (!strcmp(f, "--mlx-quant-bits")) {
+ mlx_quantize_bits = atoi(argv[++arg_start]);
+ if (mlx_quantize_bits != 0 && mlx_quantize_bits != 8) {
+ fprintf(stderr, "--mlx-quant-bits must be 0 or 8\n");
+ return 1;
+ }
+ } else if (!strcmp(f, "--mlx-quant-group-size")) {
+ mlx_quantize_group_size = atoi(argv[++arg_start]);
+ if (mlx_quantize_group_size <= 0) {
+ fprintf(stderr, "--mlx-quant-group-size must be > 0\n");
+ return 1;
+ }
+ }
+#endif
+#ifdef USE_CUDA
+ else if (!strcmp(f, "--cuda-gemm-mode")) {
+ cuda_fast_gemm = argv[++arg_start];
+ } else if (!strcmp(f, "--cuda-weight-dtype")) {
+ cuda_weights = argv[++arg_start];
+ }
+#endif
+ else if (!strcmp(f, "-e") || !strcmp(f, "--embeddings")) {
+ print_embs = 1;
+ } else if (!strcmp(f, "-v") || !strcmp(f, "--verbose")) {
+ verbose++;
+ } else if (!strcmp(f, "-vv")) {
+ verbose = 2;
+ } else if (!strcmp(f, "--stream")) {
+ stdin_mode = 1;
+ }
+#ifdef USE_MLX
+ else if (!strcmp(f, "--mlx")) {
+ use_mlx = 1;
+ }
+#endif
+#ifdef USE_CUDA
+ else if (!strcmp(f, "--cuda")) {
+ use_cuda = 1;
+ }
+#endif
+ else if (!strcmp(f, "-h") || !strcmp(f, "--help")) {
+ print_usage(prog);
+ return 0;
+ } else
+ break;
+ arg_start++;
+ }
+
+ embed_verbose = verbose;
+
+#ifdef USE_CUDA
+ if (cuda_fast_gemm) {
+ if (!use_cuda) {
+ fprintf(stderr, "--cuda-gemm-mode requires --cuda\n");
+ return 1;
+ }
+ if (embed_cuda_set_fast_gemm(cuda_fast_gemm) != 0) {
+ fprintf(stderr, "--cuda-gemm-mode must be f32, tf32, bf16, or 16f\n");
+ return 1;
+ }
+ }
+ if (cuda_weights) {
+ if (!use_cuda) {
+ fprintf(stderr, "--cuda-weight-dtype requires --cuda\n");
+ return 1;
+ }
+ if (!strcmp(cuda_weights, "bf16")) {
+ embed_cuda_set_weights_bf16(1);
+ } else if (!strcmp(cuda_weights, "f32")) {
+ embed_cuda_set_weights_bf16(0);
+ } else {
+ fprintf(stderr, "--cuda-weight-dtype must be f32 or bf16\n");
+ return 1;
+ }
+ }
+#endif
+#ifdef USE_MLX
+ if (mlx_quantize_bits && !use_mlx) {
+ fprintf(stderr, "--mlx-quant-bits requires --mlx\n");
+ return 1;
+ }
+#endif
+
+ if (!model_dir || !model_dir[0]) {
+ fprintf(stderr, "model directory required (-d <dir>)\n");
+ print_usage(prog);
+ return 1;
+ }
+
+#ifdef USE_MLX
+ if (use_mlx) {
+ if (verbose >= 1)
+ fprintf(stderr, "Using MLX GPU backend\n");
+ } else
+#endif
+#ifdef USE_CUDA
+ if (use_cuda) {
+ if (verbose >= 1)
+ fprintf(stderr, "Using CUDA GPU backend\n");
+ } else
+#endif
+ {
+ if (n_threads <= 0)
+ n_threads = embed_get_num_cpus();
+ embed_set_threads(n_threads);
+ if (verbose >= 1)
+ fprintf(stderr, "Using %d CPU thread(s)\n", n_threads);
+ }
+
+ /* Tokenizer: a WordPiece vocab.txt selects the BERT tokenizer (the frontend
+ * wraps [CLS]/[SEP]); otherwise the Qwen byte-level BPE vocab.json. */
+ engine_t e = {0};
+ e.cls_id = -1;
+ e.sep_id = -1;
+ double t0 = now_ms();
+ char wp_path[1024];
+ snprintf(wp_path, sizeof(wp_path), "%s/vocab.txt", model_dir);
+ if (access(wp_path, R_OK) == 0) {
+ e.wp_tok = wordpiece_tokenizer_load(model_dir);
+ if (e.wp_tok) {
+ e.cls_id = wordpiece_tokenizer_token_id(e.wp_tok, "[CLS]");
+ e.sep_id = wordpiece_tokenizer_token_id(e.wp_tok, "[SEP]");
+ }
+ if (!e.wp_tok || e.cls_id < 0 || e.sep_id < 0) {
+ fprintf(stderr, "failed to load WordPiece tokenizer: %s\n", wp_path);
+ wordpiece_tokenizer_free(e.wp_tok);
+ return 1;
+ }
+ } else {
+ char vocab_path[1024];
+ snprintf(vocab_path, sizeof(vocab_path), "%s/vocab.json", model_dir);
+ e.tok = embed_tokenizer_load(vocab_path);
+ if (!e.tok) {
+ fprintf(stderr, "failed to load tokenizer: %s\n", vocab_path);
+ return 1;
+ }
+ }
+ if (verbose >= 1)
+ fprintf(stderr, "Tokenizer: %.0f ms\n", now_ms() - t0);
+
+ /* Model */
+ t0 = now_ms();
+ const embed_config_t *config = NULL;
+
+#ifdef USE_MLX
+ if (use_mlx) {
+ embed_mlx_options_t mlx_opts = {
+ .quantize_bits = mlx_quantize_bits,
+ .quantize_group_size = mlx_quantize_group_size,
+ };
+ e.mlx_ctx = embed_mlx_load_with_options(model_dir, &mlx_opts);
+ if (!e.mlx_ctx) {
+ fprintf(stderr, "failed to load model\n");
+ engine_free_tokenizers(&e);
+ return 1;
+ }
+ config = embed_mlx_config(e.mlx_ctx);
+ e.dim = config->hidden_size;
+ } else
+#endif
+#ifdef USE_CUDA
+ if (use_cuda) {
+ e.cuda_ctx = embed_cuda_load(model_dir);
+ if (!e.cuda_ctx) {
+ fprintf(stderr, "failed to load CUDA model\n");
+ engine_free_tokenizers(&e);
+ return 1;
+ }
+ config = embed_cuda_config(e.cuda_ctx);
+ e.dim = config->hidden_size;
+ } else
+#endif
+ {
+ e.model = embed_model_load(model_dir);
+ if (!e.model) {
+ fprintf(stderr, "failed to load model\n");
+ engine_free_tokenizers(&e);
+ return 1;
+ }
+ e.workspace = embed_workspace_new(e.model);
+ if (!e.workspace) {
+ fprintf(stderr, "failed to allocate workspace\n");
+ embed_model_free(e.model);
+ engine_free_tokenizers(&e);
+ return 1;
+ }
+ config = embed_model_config(e.model);
+ e.dim = config->hidden_size;
+ }
+ e.append_terminal_token = config->append_terminal_token;
+ /* The appended terminal token is the tokenizer's <|endoftext|>, resolved
+ * like the contextual separator: a vocab that defines it (test models)
+ * wins; otherwise the released-model family constant applies. */
+ if (e.append_terminal_token) {
+ int eot = embed_tokenizer_token_id(e.tok, "<|endoftext|>");
+ e.terminal_token_id = eot >= 0 ? eot : EMBED_CONTEXT_SEPARATOR_TOKEN_ID;
+ }
+ if (verbose >= 1)
+ fprintf(stderr, "Model: %d-dim, %.0f ms%s\n", e.dim, now_ms() - t0,
+#ifdef USE_MLX
+ use_mlx ? " (MLX)" :
+#endif
+#ifdef USE_CUDA
+ use_cuda ? " (CUDA)"
+ :
+#endif
+ "");
+
+ if (e.wp_tok)
+ e.wp_tok_ws = wordpiece_workspace_new();
+ else
+ e.tok_ws = embed_tokenizer_workspace_new();
+ if (!e.tok_ws && !e.wp_tok_ws) {
+ fprintf(stderr, "failed to allocate tokenizer workspace\n");
+ if (e.workspace)
+ embed_workspace_free(e.workspace);
+ if (e.model)
+ embed_model_free(e.model);
+#ifdef USE_MLX
+ if (e.mlx_ctx)
+ embed_mlx_free(e.mlx_ctx);
+#endif
+#ifdef USE_CUDA
+ if (e.cuda_ctx)
+ embed_cuda_free(e.cuda_ctx);
+#endif
+ engine_free_tokenizers(&e);
+ return 1;
+ }
+
+ /* Run */
+ int rc;
+ if (stdin_mode)
+ rc = run_stdin(&e, batch_size > 0 ? batch_size : 1);
+ else
+ rc = run_batch(&e, argc, argv, arg_start, print_embs, batch_size, json);
+
+ /* Cleanup */
+ if (e.workspace)
+ embed_workspace_free(e.workspace);
+ if (e.model)
+ embed_model_free(e.model);
+#ifdef USE_MLX
+ if (e.mlx_ctx)
+ embed_mlx_free(e.mlx_ctx);
+#endif
+#ifdef USE_CUDA
+ if (e.cuda_ctx)
+ embed_cuda_free(e.cuda_ctx);
+#endif
+ engine_free_tokenizers(&e);
+ return rc;
+}
diff --git a/src/config.c b/src/config.c
new file mode 100644
index 0000000..f693843
--- /dev/null
+++ b/src/config.c
@@ -0,0 +1,305 @@
+#include "config.h"
+
+#include <ctype.h>
+#include <errno.h>
+#include <limits.h>
+#include <math.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+
+typedef enum {
+ JSON_BOOL_MISSING = 0,
+ JSON_BOOL_FALSE = 1,
+ JSON_BOOL_TRUE = 2,
+ JSON_BOOL_INVALID = -1,
+} json_bool_t;
+
+static const char *skip_ws(const char *p) {
+ while (*p == ' ' || *p == '\n' || *p == '\r' || *p == '\t')
+ p++;
+ return p;
+}
+
+static const char *json_find_key(const char *json, const char *key) {
+ size_t klen = strlen(key);
+ const char *p = json;
+ while ((p = strstr(p, key)) != NULL) {
+ if (p > json && p[-1] == '"') {
+ const char *after = p + klen;
+ if (*after == '"') {
+ after = skip_ws(after + 1);
+ if (*after == ':')
+ return skip_ws(after + 1);
+ }
+ }
+ p += klen;
+ }
+ return NULL;
+}
+
+static int json_get_int(const char *json, const char *key, int fallback) {
+ const char *v = json_find_key(json, key);
+ return v ? atoi(v) : fallback;
+}
+
+static double json_get_double(const char *json, const char *key, double fallback) {
+ const char *v = json_find_key(json, key);
+ return v ? atof(v) : fallback;
+}
+
+static int json_string_equals(const char *json, const char *key, const char *expected) {
+ const char *v = json_find_key(json, key);
+ if (!v || *v != '"')
+ return 0;
+ v++;
+ size_t len = strlen(expected);
+ return strncmp(v, expected, len) == 0 && v[len] == '"';
+}
+
+static json_bool_t json_get_bool(const char *json, const char *key) {
+ const char *v = json_find_key(json, key);
+ if (!v)
+ return JSON_BOOL_MISSING;
+ if (strncmp(v, "true", 4) == 0 && !isalnum((unsigned char)v[4]) && v[4] != '_')
+ return JSON_BOOL_TRUE;
+ if (strncmp(v, "false", 5) == 0 && !isalnum((unsigned char)v[5]) && v[5] != '_')
+ return JSON_BOOL_FALSE;
+ return JSON_BOOL_INVALID;
+}
+
+/* Return 1 with a NUL-terminated buffer, 0 when an optional file is absent,
+ * and -1 for an existing file that could not be read. */
+static int read_optional_file(const char *model_dir, const char *relative, char **out) {
+ char path[1024];
+ int n = snprintf(path, sizeof(path), "%s/%s", model_dir, relative);
+ if (n < 0 || (size_t)n >= sizeof(path)) {
+ fprintf(stderr, "embed_config: model path too long\n");
+ return -1;
+ }
+
+ FILE *f = fopen(path, "rb");
+ if (!f && errno == ENOENT)
+ return 0;
+ if (!f) {
+ fprintf(stderr, "embed_config: cannot open %s\n", path);
+ return -1;
+ }
+ if (fseek(f, 0, SEEK_END) != 0) {
+ fclose(f);
+ return -1;
+ }
+ long sz = ftell(f);
+ if (sz < 0 || (size_t)sz == SIZE_MAX || fseek(f, 0, SEEK_SET) != 0) {
+ fclose(f);
+ return -1;
+ }
+ char *buf = (char *)malloc((size_t)sz + 1);
+ if (!buf || fread(buf, 1, (size_t)sz, f) != (size_t)sz) {
+ fclose(f);
+ free(buf);
+ return -1;
+ }
+ fclose(f);
+ buf[sz] = '\0';
+ *out = buf;
+ return 1;
+}
+
+static int parse_sentence_transformers_metadata(embed_config_t *cfg, const char *model_dir) {
+ char *buf = NULL;
+ int rc = read_optional_file(model_dir, "1_Pooling/config.json", &buf);
+ if (rc < 0)
+ return -1;
+ if (rc > 0) {
+ json_bool_t mean = json_get_bool(buf, "pooling_mode_mean_tokens");
+ json_bool_t last = json_get_bool(buf, "pooling_mode_lasttoken");
+ json_bool_t cls = json_get_bool(buf, "pooling_mode_cls_token");
+ json_bool_t max = json_get_bool(buf, "pooling_mode_max_tokens");
+ json_bool_t sqrt_len = json_get_bool(buf, "pooling_mode_mean_sqrt_len_tokens");
+ json_bool_t weighted = json_get_bool(buf, "pooling_mode_weightedmean_tokens");
+ if (mean < 0 || last < 0 || cls < 0 || max < 0 || sqrt_len < 0 || weighted < 0) {
+ fprintf(stderr, "embed_config: invalid pooling metadata\n");
+ free(buf);
+ return -1;
+ }
+ int supported =
+ (mean == JSON_BOOL_TRUE) + (last == JSON_BOOL_TRUE) + (cls == JSON_BOOL_TRUE);
+ int unsupported =
+ max == JSON_BOOL_TRUE || sqrt_len == JSON_BOOL_TRUE || weighted == JSON_BOOL_TRUE;
+ if (supported != 1 || unsupported) {
+ fprintf(stderr, "embed_config: unsupported Sentence Transformers pooling mode\n");
+ free(buf);
+ return -1;
+ }
+ cfg->pooling_mode = cls == JSON_BOOL_TRUE ? EMBED_POOL_CLS
+ : last == JSON_BOOL_TRUE ? EMBED_POOL_LAST_TOKEN
+ : EMBED_POOL_MEAN;
+ free(buf);
+ buf = NULL;
+ }
+
+ rc = read_optional_file(model_dir, "modules.json", &buf);
+ if (rc < 0)
+ return -1;
+ if (rc > 0) {
+ cfg->normalize_embeddings =
+ strstr(buf, "\"sentence_transformers.models.Normalize\"") != NULL;
+ free(buf);
+ buf = NULL;
+ }
+
+ rc = read_optional_file(model_dir, "tokenizer_config.json", &buf);
+ if (rc < 0)
+ return -1;
+ if (rc > 0) {
+ json_bool_t add_eos = json_get_bool(buf, "add_eos_token");
+ if (add_eos < 0) {
+ fprintf(stderr, "embed_config: invalid add_eos_token metadata\n");
+ free(buf);
+ return -1;
+ }
+ if (add_eos != JSON_BOOL_MISSING)
+ cfg->append_terminal_token = add_eos == JSON_BOOL_TRUE;
+ free(buf);
+ }
+ return 0;
+}
+
+int embed_config_parse(embed_config_t *cfg, const char *model_dir) {
+ char path[1024];
+ int n = snprintf(path, sizeof(path), "%s/config.json", model_dir);
+ if (n < 0 || (size_t)n >= sizeof(path)) {
+ fprintf(stderr, "embed_config: model path too long\n");
+ return -1;
+ }
+
+ FILE *f = fopen(path, "rb");
+ if (!f) {
+ fprintf(stderr, "embed_config: cannot open %s\n", path);
+ return -1;
+ }
+
+ if (fseek(f, 0, SEEK_END) != 0) {
+ fclose(f);
+ return -1;
+ }
+ long sz = ftell(f);
+ if (sz < 0 || (size_t)sz == SIZE_MAX || fseek(f, 0, SEEK_SET) != 0) {
+ fclose(f);
+ return -1;
+ }
+ char *buf = (char *)malloc((size_t)sz + 1);
+ if (!buf || fread(buf, 1, (size_t)sz, f) != (size_t)sz) {
+ fclose(f);
+ free(buf);
+ return -1;
+ }
+ fclose(f);
+ buf[sz] = '\0';
+
+ cfg->hidden_size = json_get_int(buf, "hidden_size", 0);
+ cfg->n_layers = json_get_int(buf, "num_hidden_layers", 0);
+ cfg->n_heads = json_get_int(buf, "num_attention_heads", 0);
+ cfg->n_kv_heads = json_get_int(buf, "num_key_value_heads", 0);
+ cfg->head_dim = json_get_int(buf, "head_dim", EMBED_HEAD_DIM);
+ cfg->intermediate_size = json_get_int(buf, "intermediate_size", 0);
+ cfg->vocab_size = json_get_int(buf, "vocab_size", EMBED_VOCAB_SIZE);
+ cfg->rms_norm_eps = (float)json_get_double(buf, "rms_norm_eps", 1e-6);
+ cfg->layer_norm_eps = (float)json_get_double(buf, "layer_norm_eps", 1e-12);
+ cfg->rope_theta = (float)json_get_double(buf, "rope_theta", 1000000.0);
+ cfg->max_position_embeddings = json_get_int(buf, "max_position_embeddings", 0);
+ cfg->family = EMBED_FAMILY_QWEN3;
+ cfg->qk_norm = 1;
+ cfg->qkv_bias = 0;
+ cfg->attention_mode = EMBED_ATTENTION_BIDIRECTIONAL;
+ cfg->pooling_mode = EMBED_POOL_MEAN;
+ cfg->normalize_embeddings = 0;
+ cfg->append_terminal_token = 0;
+
+ if (json_string_equals(buf, "model_type", "qwen3")) {
+ cfg->attention_mode = EMBED_ATTENTION_CAUSAL;
+ cfg->pooling_mode = EMBED_POOL_LAST_TOKEN;
+ cfg->normalize_embeddings = 1;
+ cfg->append_terminal_token = 1;
+ } else if (json_string_equals(buf, "model_type", "qwen2")) {
+ cfg->qk_norm = 0;
+ cfg->qkv_bias = 1;
+ cfg->attention_mode = EMBED_ATTENTION_CAUSAL;
+ } else if (json_string_equals(buf, "model_type", "bert")) {
+ cfg->family = EMBED_FAMILY_BERT;
+ cfg->qk_norm = 0;
+ cfg->qkv_bias = 1; /* q/k/v/o and both dense layers carry bias */
+ cfg->attention_mode = EMBED_ATTENTION_BIDIRECTIONAL;
+ cfg->n_kv_heads = cfg->n_heads; /* full multi-head attention, no GQA */
+ cfg->head_dim = cfg->n_heads > 0 ? cfg->hidden_size / cfg->n_heads : 0;
+ /* hidden_act selects the feed-forward GeLU curve. gelu_new and
+ * gelu_pytorch_tanh are the same tanh approximation; everything else
+ * (gelu, absent) is the exact erf GeLU the released encoders use. */
+ if (json_string_equals(buf, "hidden_act", "gelu_new") ||
+ json_string_equals(buf, "hidden_act", "gelu_pytorch_tanh")) {
+ cfg->ffn_act = EMBED_ACT_GELU_TANH;
+ }
+ if (cfg->max_position_embeddings <= 0 || !isfinite(cfg->layer_norm_eps) ||
+ cfg->layer_norm_eps <= 0.0f) {
+ fprintf(stderr, "embed_config: invalid BERT layer_norm_eps/max_position_embeddings\n");
+ free(buf);
+ return -1;
+ }
+ }
+
+ json_bool_t is_causal = json_get_bool(buf, "is_causal");
+ if (is_causal < 0) {
+ fprintf(stderr, "embed_config: invalid is_causal in %s\n", path);
+ free(buf);
+ return -1;
+ }
+ if (is_causal != JSON_BOOL_MISSING) {
+ cfg->attention_mode =
+ is_causal == JSON_BOOL_TRUE ? EMBED_ATTENTION_CAUSAL : EMBED_ATTENTION_BIDIRECTIONAL;
+ }
+
+ cfg->q_dim = 0;
+ cfg->kv_dim = 0;
+ if (cfg->n_heads > 0 && cfg->head_dim > 0 && cfg->n_heads <= INT_MAX / cfg->head_dim)
+ cfg->q_dim = cfg->n_heads * cfg->head_dim;
+ if (cfg->n_kv_heads > 0 && cfg->head_dim > 0 && cfg->n_kv_heads <= INT_MAX / cfg->head_dim)
+ cfg->kv_dim = cfg->n_kv_heads * cfg->head_dim;
+
+ free(buf);
+
+ if (parse_sentence_transformers_metadata(cfg, model_dir) != 0)
+ return -1;
+
+ if (cfg->hidden_size <= 0 || cfg->n_layers <= 0 || cfg->n_heads <= 0 || cfg->n_kv_heads <= 0 ||
+ cfg->head_dim <= 0 || cfg->intermediate_size <= 0 || cfg->vocab_size <= 0 ||
+ cfg->q_dim <= 0 || cfg->kv_dim <= 0 || (cfg->head_dim & 1) ||
+ cfg->n_heads % cfg->n_kv_heads != 0 || !isfinite(cfg->rms_norm_eps) ||
+ cfg->rms_norm_eps <= 0.0f || !isfinite(cfg->rope_theta) || cfg->rope_theta <= 0.0f) {
+ fprintf(stderr,
+ "embed_config: invalid config in %s "
+ "(hidden=%d, layers=%d, heads=%d/%d, head_dim=%d, inter=%d)\n",
+ path, cfg->hidden_size, cfg->n_layers, cfg->n_heads, cfg->n_kv_heads, cfg->head_dim,
+ cfg->intermediate_size);
+ return -1;
+ }
+ if (cfg->n_layers > EMBED_MAX_LAYERS) {
+ fprintf(stderr, "embed_config: too many layers (%d > %d)\n", cfg->n_layers,
+ EMBED_MAX_LAYERS);
+ return -1;
+ }
+
+ if (embed_verbose >= 1)
+ fprintf(stderr,
+ "config: hidden=%d, layers=%d, heads=%d/%d, "
+ "inter=%d, head_dim=%d, attention=%s, pooling=%s, qk_norm=%s, qkv_bias=%s\n",
+ cfg->hidden_size, cfg->n_layers, cfg->n_heads, cfg->n_kv_heads,
+ cfg->intermediate_size, cfg->head_dim,
+ cfg->attention_mode == EMBED_ATTENTION_CAUSAL ? "causal" : "bidirectional",
+ cfg->pooling_mode == EMBED_POOL_LAST_TOKEN ? "last-token"
+ : cfg->pooling_mode == EMBED_POOL_CLS ? "cls"
+ : "mean",
+ cfg->qk_norm ? "yes" : "no", cfg->qkv_bias ? "yes" : "no");
+
+ return 0;
+}
diff --git a/src/config.h b/src/config.h
new file mode 100644
index 0000000..e8353d3
--- /dev/null
+++ b/src/config.h
@@ -0,0 +1,8 @@
+#ifndef EMBED_CONFIG_H
+#define EMBED_CONFIG_H
+
+#include "embed.h"
+
+int embed_config_parse(embed_config_t *cfg, const char *model_dir);
+
+#endif /* EMBED_CONFIG_H */
diff --git a/src/cuda.cu b/src/cuda.cu
new file mode 100644
index 0000000..6ce7dfb
--- /dev/null
+++ b/src/cuda.cu
@@ -0,0 +1,2052 @@
+extern "C" {
+#include "cuda.h"
+#include "internal.h"
+}
+
+#include <cuda_runtime.h>
+#include <cuda_bf16.h>
+#include <cublas_v2.h>
+
+#include <limits.h>
+#include <math.h>
+#include <stdint.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+
+typedef struct {
+ float *d; // device buffer; holds __nv_bfloat16 elements when bf16
+ int rows;
+ int cols;
+ int bf16; // 1 if d holds __nv_bfloat16, 0 if F32
+} cuda_matrix_t;
+
+typedef struct {
+ cuda_matrix_t qkv, wo;
+ float *qkv_bias;
+ float *q_norm;
+ float *k_norm;
+ float *input_norm;
+ float *post_attn_norm;
+ cuda_matrix_t gate_up_proj, down_proj;
+ /* BERT family (NULL for Qwen3). The two block LayerNorm weights reuse
+ * input_norm (post-attention) and post_attn_norm (post-FFN); gate_up_proj
+ * holds the single BERT up_proj. These add the biases those slots lack. */
+ float *o_bias;
+ float *attn_ln_bias;
+ float *ffn_inter_bias;
+ float *ffn_out_bias;
+ float *ffn_ln_bias;
+} cuda_layer_t;
+
+struct embed_cuda_ctx {
+ embed_model_t *cpu;
+ int own_cpu; // free ctx->cpu in embed_cuda_free only when this context owns it
+ embed_config_t config;
+ cudaStream_t stream;
+ cublasHandle_t blas;
+ cuda_matrix_t embed_tokens;
+ cuda_layer_t *layers;
+ float *norm;
+ /* BERT family (NULL for Qwen3): learned absolute position embeddings, the
+ * token-type[0] embedding (row 0 only, [hidden]), and the embedding
+ * LayerNorm weight/bias. */
+ float *position_embeddings;
+ float *token_type_embedding;
+ float *embed_ln_w;
+ float *embed_ln_b;
+
+ int seq_cap;
+ int batch_cap;
+ int max_seq_cap;
+ float *x;
+ float *x_norm;
+ float *qkv;
+ float *attn_out;
+ float *ffn_gate_up;
+ void *act_bf16; // BF16 cast of a GEMM activation operand (bf16 weights)
+ float *weight_f32; // F32 widen scratch for one BF16 weight (memory-only bf16)
+ size_t weight_f32_elems;
+ float *pooled_out;
+ float *rope_cos;
+ float *rope_sin;
+ int *token_ids;
+ int *offsets;
+ int *offsets_host;
+ int *positions;
+ float *kexp;
+ float *vexp;
+ float *attn_scores;
+ void *attn_probs; // BF16 softmax output (bf16 weights)
+ long long attn_scores_elems;
+ long long attn_probs_elems;
+ // Equal-length micro-batch attention: pointer arrays for batched GEMMs,
+ // built once per forward pass (layer-invariant buffer addresses).
+ // attn_G is the number of sequences whose score tensors fit the scratch
+ // budget at once; 0 disables the batched path for this forward.
+ const void **attn_ptrs; // device: [K|Q|S|V|P|O] x batch x n_heads
+ const void **attn_ptrs_host;
+ int attn_ptrs_cap; // capacity in pointer entries
+ int attn_G;
+ int attn_L;
+ int *span_starts;
+ int *span_lens;
+ int pooled_rows_cap;
+ int span_cap;
+};
+
+// Scratch budget for the batched-attention score tensors (F32 elements).
+enum { CUDA_ATTN_SCORES_BUDGET = 64 * 1024 * 1024 };
+// Above this sequence length the per-sequence strided-batched loop beats the
+// pointer-array batched GEMMs (L4: batched wins <=80tok, ties ~140, loses
+// >=256; both paths are identical precision).
+enum { CUDA_ATTN_BATCHED_MAX_LEN = 192 };
+
+#define CUDA_CHECK(expr) \
+ do { \
+ cudaError_t _e = (expr); \
+ if (_e != cudaSuccess) { \
+ fprintf(stderr, "cuda: %s failed: %s\n", #expr, cudaGetErrorString(_e)); \
+ return -1; \
+ } \
+ } while (0)
+
+#define CUBLAS_CHECK(expr) \
+ do { \
+ cublasStatus_t _s = (expr); \
+ if (_s != CUBLAS_STATUS_SUCCESS) { \
+ fprintf(stderr, "cuda: %s failed: cublas status %d\n", #expr, (int)_s); \
+ return -1; \
+ } \
+ } while (0)
+
+static int parse_gemm_compute(const char *mode, cublasComputeType_t *out) {
+ if (!mode || !mode[0] || !strcmp(mode, "f32")) {
+ *out = CUBLAS_COMPUTE_32F;
+ return 0;
+ }
+ if (!strcmp(mode, "tf32")) {
+ *out = CUBLAS_COMPUTE_32F_FAST_TF32;
+ return 0;
+ }
+ if (!strcmp(mode, "bf16")) {
+ *out = CUBLAS_COMPUTE_32F_FAST_16BF;
+ return 0;
+ }
+ if (!strcmp(mode, "16f")) {
+ *out = CUBLAS_COMPUTE_32F_FAST_16F;
+ return 0;
+ }
+ return -1;
+}
+
+static cublasComputeType_t g_gemm_compute = CUBLAS_COMPUTE_32F;
+static int g_gemm_compute_set = 0;
+
+int embed_cuda_set_fast_gemm(const char *mode) {
+ cublasComputeType_t ct;
+ if (parse_gemm_compute(mode, &ct) != 0)
+ return -1;
+ g_gemm_compute = ct;
+ g_gemm_compute_set = 1;
+ return 0;
+}
+
+static void cuda_matrix_free(cuda_matrix_t *m) {
+ if (!m)
+ return;
+ cudaFree(m->d);
+ memset(m, 0, sizeof(*m));
+}
+
+static float bf16_to_f32(uint16_t v) {
+ uint32_t u = ((uint32_t)v) << 16;
+ float f;
+ memcpy(&f, &u, sizeof(f));
+ return f;
+}
+
+// Round F32 to BF16 (truncate the low 16 bits, round to nearest even). NaNs are
+// preserved. BF16 shares F32's 8-bit exponent, so this never overflows.
+static uint16_t f32_to_bf16(float f) {
+ uint32_t x;
+ memcpy(&x, &f, sizeof(x));
+ if ((x & 0x7fffffffu) > 0x7f800000u) // NaN
+ return (uint16_t)((x >> 16) | 0x0040u);
+ x += 0x7fffu + ((x >> 16) & 1u); // round to nearest even
+ return (uint16_t)(x >> 16);
+}
+
+// Store weights as native BF16 on the device when set (halves weight memory and
+// feeds BF16 tensor cores); default keeps exact F32 for F32 model files. When
+// the flag was never set explicitly, the loader follows the model file dtype,
+// matching the CPU and MLX backends.
+static int g_weights_bf16 = 0;
+static int g_weights_bf16_set = 0;
+
+int embed_cuda_set_weights_bf16(int on) {
+ g_weights_bf16 = on ? 1 : 0;
+ g_weights_bf16_set = 1;
+ return 0;
+}
+
+static int copy_weight_host_f32(float *dst, const embed_weight_ref_t *w, size_t count) {
+ if (!dst || !w || !w->data)
+ return -1;
+ if (w->dtype == DTYPE_F32) {
+ memcpy(dst, w->data, count * sizeof(float));
+ return 0;
+ }
+ if (w->dtype == DTYPE_BF16) {
+ const uint16_t *src = (const uint16_t *)w->data;
+ for (size_t i = 0; i < count; i++)
+ dst[i] = bf16_to_f32(src[i]);
+ return 0;
+ }
+ return -1;
+}
+
+// Upload a host F32 weight buffer to the device, as BF16 when g_weights_bf16 is
+// set (rounding each value) or as F32 otherwise. Sets m->d, rows, cols, bf16.
+static int upload_weight(cuda_matrix_t *m, const float *src, size_t count, int rows, int cols) {
+ cudaError_t e;
+ if (g_weights_bf16) {
+ uint16_t *tmp16 = (uint16_t *)malloc(count * sizeof(uint16_t));
+ if (!tmp16)
+ return -1;
+ for (size_t i = 0; i < count; i++)
+ tmp16[i] = f32_to_bf16(src[i]);
+ e = cudaMalloc((void **)&m->d, count * sizeof(__nv_bfloat16));
+ if (e != cudaSuccess) {
+ fprintf(stderr, "cudaMalloc weight failed: %s\n", cudaGetErrorString(e));
+ free(tmp16);
+ return -1;
+ }
+ e = cudaMemcpy(m->d, tmp16, count * sizeof(__nv_bfloat16), cudaMemcpyHostToDevice);
+ free(tmp16);
+ m->bf16 = 1;
+ } else {
+ e = cudaMalloc((void **)&m->d, count * sizeof(float));
+ if (e != cudaSuccess) {
+ fprintf(stderr, "cudaMalloc weight failed: %s\n", cudaGetErrorString(e));
+ return -1;
+ }
+ e = cudaMemcpy(m->d, src, count * sizeof(float), cudaMemcpyHostToDevice);
+ m->bf16 = 0;
+ }
+ if (e != cudaSuccess) {
+ fprintf(stderr, "cudaMemcpy weight failed: %s\n", cudaGetErrorString(e));
+ cuda_matrix_free(m);
+ return -1;
+ }
+ m->rows = rows;
+ m->cols = cols;
+ return 0;
+}
+
+static int load_matrix(cuda_matrix_t *m, const embed_weight_ref_t *w, int rows, int cols) {
+ if (!m || !w || rows <= 0 || cols <= 0)
+ return -1;
+ size_t count = (size_t)rows * (size_t)cols;
+ float *tmp = (float *)malloc(count * sizeof(float));
+ if (!tmp)
+ return -1;
+ if (copy_weight_host_f32(tmp, w, count) != 0) {
+ free(tmp);
+ return -1;
+ }
+ int r = upload_weight(m, tmp, count, rows, cols);
+ free(tmp);
+ return r;
+}
+
+static int load_qkv_matrix(cuda_matrix_t *m, const embed_layer_t *src, const embed_config_t *c) {
+ if (!m || !src || !c)
+ return -1;
+ int rows = c->q_dim + 2 * c->kv_dim;
+ int cols = c->hidden_size;
+ size_t q_count = (size_t)c->q_dim * cols;
+ size_t kv_count = (size_t)c->kv_dim * cols;
+ size_t total = q_count + 2 * kv_count;
+ float *tmp = (float *)malloc(total * sizeof(float));
+ if (!tmp)
+ return -1;
+ if (copy_weight_host_f32(tmp, &src->wq, q_count) != 0 ||
+ copy_weight_host_f32(tmp + q_count, &src->wk, kv_count) != 0 ||
+ copy_weight_host_f32(tmp + q_count + kv_count, &src->wv, kv_count) != 0) {
+ free(tmp);
+ return -1;
+ }
+ int r = upload_weight(m, tmp, total, rows, cols);
+ free(tmp);
+ return r;
+}
+
+static int
+load_gate_up_matrix(cuda_matrix_t *m, const embed_layer_t *src, const embed_config_t *c) {
+ if (!m || !src || !c)
+ return -1;
+ int rows = 2 * c->intermediate_size;
+ int cols = c->hidden_size;
+ size_t proj_count = (size_t)c->intermediate_size * cols;
+ size_t total = 2 * proj_count;
+ float *tmp = (float *)malloc(total * sizeof(float));
+ if (!tmp)
+ return -1;
+ if (copy_weight_host_f32(tmp, &src->gate_proj, proj_count) != 0 ||
+ copy_weight_host_f32(tmp + proj_count, &src->up_proj, proj_count) != 0) {
+ free(tmp);
+ return -1;
+ }
+ int r = upload_weight(m, tmp, total, rows, cols);
+ free(tmp);
+ return r;
+}
+
+static int load_vector(float **out, const float *src, int n) {
+ if (!out || !src || n <= 0)
+ return -1;
+ cudaError_t e = cudaMalloc((void **)out, (size_t)n * sizeof(float));
+ if (e != cudaSuccess) {
+ fprintf(stderr, "cudaMalloc vector failed: %s\n", cudaGetErrorString(e));
+ return -1;
+ }
+ e = cudaMemcpy(*out, src, (size_t)n * sizeof(float), cudaMemcpyHostToDevice);
+ if (e != cudaSuccess) {
+ fprintf(stderr, "cudaMemcpy vector failed: %s\n", cudaGetErrorString(e));
+ cudaFree(*out);
+ *out = NULL;
+ return -1;
+ }
+ return 0;
+}
+
+static int load_qkv_bias(float **out, const embed_layer_t *src, const embed_config_t *c) {
+ int n = c->q_dim + 2 * c->kv_dim;
+ float *host = (float *)malloc((size_t)n * sizeof(float));
+ if (!host)
+ return -1;
+ memcpy(host, src->q_bias, (size_t)c->q_dim * sizeof(float));
+ memcpy(host + c->q_dim, src->k_bias, (size_t)c->kv_dim * sizeof(float));
+ memcpy(host + c->q_dim + c->kv_dim, src->v_bias, (size_t)c->kv_dim * sizeof(float));
+ int rc = load_vector(out, host, n);
+ free(host);
+ return rc;
+}
+
+__global__ static void add_row_bias_kernel(float *x, const float *bias, int rows, int dim) {
+ int idx = blockIdx.x * blockDim.x + threadIdx.x;
+ int count = rows * dim;
+ if (idx < count)
+ x[idx] += bias[idx % dim];
+}
+
+__global__ static void embed_lookup_kernel(
+ float *x, const int *ids, const void *emb, int emb_bf16, int total, int hidden, int vocab) {
+ int idx = blockIdx.x * blockDim.x + threadIdx.x;
+ int count = total * hidden;
+ if (idx >= count)
+ return;
+ int tok = idx / hidden;
+ int d = idx - tok * hidden;
+ int id = ids[tok];
+ if (id < 0 || id >= vocab) {
+ x[idx] = 0.0f;
+ return;
+ }
+ size_t off = (size_t)id * hidden + d;
+ x[idx] =
+ emb_bf16 ? __bfloat162float(((const __nv_bfloat16 *)emb)[off]) : ((const float *)emb)[off];
+}
+
+// Cast n F32 values to BF16 (used to feed BF16-weight projection GEMMs).
+__global__ static void cast_f32_to_bf16_kernel(__nv_bfloat16 *out, const float *in, size_t n) {
+ size_t i = (size_t)blockIdx.x * blockDim.x + threadIdx.x;
+ if (i < n)
+ out[i] = __float2bfloat16(in[i]);
+}
+
+// Widen n BF16 values to F32 (used to run an exact F32 GEMM on BF16-stored
+// weights - memory-only BF16, no precision loss from the operands).
+__global__ static void cast_bf16_to_f32_kernel(float *out, const __nv_bfloat16 *in, size_t n) {
+ size_t i = (size_t)blockIdx.x * blockDim.x + threadIdx.x;
+ if (i < n)
+ out[i] = __bfloat162float(in[i]);
+}
+
+__device__ static float block_sum(float v) {
+ __shared__ float partial[8];
+ __shared__ float total;
+ int lane = threadIdx.x & 31;
+ int warp = threadIdx.x >> 5;
+ int warps = blockDim.x >> 5;
+
+ for (int offset = 16; offset > 0; offset >>= 1)
+ v += __shfl_down_sync(0xffffffff, v, offset);
+ if (lane == 0)
+ partial[warp] = v;
+ __syncthreads();
+
+ if (warp == 0) {
+ v = lane < warps ? partial[lane] : 0.0f;
+ for (int offset = 16; offset > 0; offset >>= 1)
+ v += __shfl_down_sync(0xffffffff, v, offset);
+ if (lane == 0)
+ total = v;
+ }
+ __syncthreads();
+ return total;
+}
+
+__device__ static inline void store_act(float *out, size_t i, float v) { out[i] = v; }
+
+__device__ static inline void store_act(__nv_bfloat16 *out, size_t i, float v) {
+ out[i] = __float2bfloat16(v);
+}
+
+// OUT_T is float, or __nv_bfloat16 when the result feeds a BF16-weight
+// projection GEMM directly (same rounding as a separate cast kernel).
+template <typename OUT_T>
+__global__ static void
+rms_norm_kernel(OUT_T *out, const float *x, const float *weight, int rows, int dim, float eps) {
+ int row = blockIdx.x;
+ int tid = threadIdx.x;
+ float sum = 0.0f;
+ for (int d = tid; d < dim; d += blockDim.x) {
+ float v = x[(size_t)row * dim + d];
+ sum += v * v;
+ }
+ float total = block_sum(sum);
+ float inv = rsqrtf(total / (float)dim + eps);
+ for (int d = tid; d < dim; d += blockDim.x)
+ store_act(out, (size_t)row * dim + d, x[(size_t)row * dim + d] * inv * weight[d]);
+}
+
+// One grid covers Q and K: blockIdx.y < n_heads selects the Q head with
+// q_norm/q_offset, the remaining blocks the K head with k_norm/k_offset.
+__global__ static void rms_norm_rope_qk_kernel(float *x,
+ const float *q_norm,
+ const float *k_norm,
+ const int *positions,
+ const float *cosv,
+ const float *sinv,
+ int rows,
+ int n_heads,
+ int n_kv_heads,
+ int head_dim,
+ int row_stride,
+ int q_offset,
+ int k_offset,
+ int qk_norm,
+ float eps) {
+ __shared__ float partial[4];
+ __shared__ float total;
+ int row = blockIdx.x;
+ int head = blockIdx.y;
+ int tid = threadIdx.x;
+ int lane = tid & 31;
+ int warp = tid >> 5;
+ int half = head_dim / 2;
+ int pair_d = tid < half ? tid + half : tid - half;
+ float sign = tid < half ? -1.0f : 1.0f;
+ const float *weight = head < n_heads ? q_norm : k_norm;
+ int base_offset = head < n_heads ? q_offset : k_offset;
+ if (head >= n_heads)
+ head -= n_heads;
+ size_t base = (size_t)row * row_stride + base_offset + head * head_dim;
+ float v = tid < head_dim ? x[base + tid] : 0.0f;
+ float pair_v = tid < head_dim ? x[base + pair_d] : 0.0f;
+ if (qk_norm) {
+ float sum = v * v;
+ for (int offset = 16; offset > 0; offset >>= 1)
+ sum += __shfl_down_sync(0xffffffff, sum, offset);
+ if (lane == 0)
+ partial[warp] = sum;
+ __syncthreads();
+ if (warp == 0) {
+ sum = lane < 4 ? partial[lane] : 0.0f;
+ for (int offset = 16; offset > 0; offset >>= 1)
+ sum += __shfl_down_sync(0xffffffff, sum, offset);
+ if (lane == 0)
+ total = sum;
+ }
+ __syncthreads();
+ }
+
+ if (tid < head_dim) {
+ int pos = positions[row];
+ float c = cosv[(size_t)pos * head_dim + tid];
+ float s = sinv[(size_t)pos * head_dim + tid];
+ float a = v;
+ float b = pair_v;
+ if (qk_norm) {
+ float inv = rsqrtf(total / (float)head_dim + eps);
+ a *= inv * weight[tid];
+ b *= inv * weight[pair_d];
+ }
+ x[base + tid] = a * c + sign * b * s;
+ }
+}
+
+// Writes SiLU(gate)*up to out with out_stride. The F32 path writes in place
+// over the gate half (out = gate_up, out_stride = 2*intermediate); the BF16
+// path writes a packed [rows x intermediate] BF16 matrix for the down GEMM.
+template <typename OUT_T>
+__global__ static void silu_mul_packed_kernel(
+ OUT_T *out, int out_stride, const float *gate_up, int rows, int intermediate) {
+ int i = blockIdx.x * blockDim.x + threadIdx.x;
+ int n = rows * intermediate;
+ if (i < n) {
+ int row = i / intermediate;
+ int d = i - row * intermediate;
+ size_t base = (size_t)row * (2 * intermediate);
+ float g = gate_up[base + d];
+ float u = gate_up[base + intermediate + d];
+ store_act(out, (size_t)row * out_stride + d, (g / (1.0f + expf(-g))) * u);
+ }
+}
+
+// Expand K and V from the n_kv_heads layout to a contiguous [total x q_dim]
+// per-query-head layout (GQA: each kv head repeated n_heads/n_kv_heads times)
+// so the attention GEMMs can stride uniformly over query heads.
+// V_T is float, or __nv_bfloat16 when V feeds a BF16 @V GEMM directly.
+template <typename V_T>
+__global__ static void attn_expand_kv_kernel(float *kexp,
+ V_T *vexp,
+ const float *qkv,
+ int total,
+ int n_heads,
+ int n_kv_heads,
+ int head_dim,
+ int qkv_dim,
+ int k_offset,
+ int v_offset) {
+ int q_dim = n_heads * head_dim;
+ size_t idx = (size_t)blockIdx.x * blockDim.x + threadIdx.x;
+ size_t count = (size_t)total * q_dim;
+ if (idx >= count)
+ return;
+ int t = (int)(idx / q_dim);
+ int rem = (int)(idx - (size_t)t * q_dim);
+ int h = rem / head_dim;
+ int e = rem - h * head_dim;
+ int kv = h / (n_heads / n_kv_heads);
+ const float *base = qkv + (size_t)t * qkv_dim;
+ kexp[idx] = base[k_offset + kv * head_dim + e];
+ store_act(vexp, idx, base[v_offset + kv * head_dim + e]);
+}
+
+// Row softmax over the key dimension for one sequence's score tensor laid out
+// as scores[head * L * L + i * L + j]; normalizes across j for each (head, i).
+// One block per (head, query) row; scores are pre-scaled by the QK^T GEMM.
+// P_T is float with probs == scores (in place), or __nv_bfloat16 when the
+// probabilities feed a BF16 @V GEMM.
+template <typename P_T>
+__global__ static void attn_softmax_kernel(float *scores, P_T *probs, int L) {
+ float *s = scores + (size_t)blockIdx.x * L;
+ P_T *p = probs + (size_t)blockIdx.x * L;
+ int tid = threadIdx.x;
+ __shared__ float red[256];
+
+ float m = -3.402823466e+38F;
+ for (int j = tid; j < L; j += blockDim.x)
+ m = fmaxf(m, s[j]);
+ red[tid] = m;
+ __syncthreads();
+ for (int o = blockDim.x / 2; o > 0; o >>= 1) {
+ if (tid < o)
+ red[tid] = fmaxf(red[tid], red[tid + o]);
+ __syncthreads();
+ }
+ m = red[0];
+ __syncthreads();
+
+ float sum = 0.0f;
+ for (int j = tid; j < L; j += blockDim.x) {
+ float e = __expf(s[j] - m);
+ s[j] = e;
+ sum += e;
+ }
+ red[tid] = sum;
+ __syncthreads();
+ for (int o = blockDim.x / 2; o > 0; o >>= 1) {
+ if (tid < o)
+ red[tid] += red[tid + o];
+ __syncthreads();
+ }
+ float inv = 1.0f / red[0];
+ for (int j = tid; j < L; j += blockDim.x)
+ store_act(p, (size_t)j, s[j] * inv);
+}
+
+template <typename P_T>
+__global__ static void attn_causal_softmax_kernel(float *scores, P_T *probs, int L) {
+ float *s = scores + (size_t)blockIdx.x * L;
+ P_T *p = probs + (size_t)blockIdx.x * L;
+ int query = blockIdx.x % L;
+ int keys = query + 1;
+ int tid = threadIdx.x;
+ __shared__ float red[256];
+
+ float m = -3.402823466e+38F;
+ for (int j = tid; j < keys; j += blockDim.x)
+ m = fmaxf(m, s[j]);
+ red[tid] = m;
+ __syncthreads();
+ for (int o = blockDim.x / 2; o > 0; o >>= 1) {
+ if (tid < o)
+ red[tid] = fmaxf(red[tid], red[tid + o]);
+ __syncthreads();
+ }
+ m = red[0];
+ __syncthreads();
+
+ float sum = 0.0f;
+ for (int j = tid; j < keys; j += blockDim.x) {
+ float e = __expf(s[j] - m);
+ s[j] = e;
+ sum += e;
+ }
+ red[tid] = sum;
+ __syncthreads();
+ for (int o = blockDim.x / 2; o > 0; o >>= 1) {
+ if (tid < o)
+ red[tid] += red[tid + o];
+ __syncthreads();
+ }
+ float inv = 1.0f / red[0];
+ for (int j = tid; j < L; j += blockDim.x)
+ store_act(p, (size_t)j, j < keys ? s[j] * inv : 0.0f);
+}
+
+__global__ static void
+mean_pool_kernel(float *out, const float *x, const int *offsets, int batch, int hidden) {
+ int b = blockIdx.x;
+ int tid = threadIdx.x;
+ int start = offsets[b];
+ int end = offsets[b + 1];
+ int len = end - start;
+ for (int d = tid; d < hidden; d += blockDim.x) {
+ float sum = 0.0f;
+ for (int t = start; t < end; t++)
+ sum += x[(size_t)t * hidden + d];
+ out[(size_t)b * hidden + d] = sum / (float)len;
+ }
+}
+
+__global__ static void
+last_pool_kernel(float *out, const float *x, const int *offsets, int batch, int hidden) {
+ int b = blockIdx.x;
+ int tid = threadIdx.x;
+ int last = offsets[b + 1] - 1;
+ for (int d = tid; d < hidden; d += blockDim.x)
+ out[(size_t)b * hidden + d] = x[(size_t)last * hidden + d];
+}
+
+/* CLS pooling: gather the first token of each packed sequence. */
+__global__ static void
+first_pool_kernel(float *out, const float *x, const int *offsets, int batch, int hidden) {
+ int b = blockIdx.x;
+ int tid = threadIdx.x;
+ int first = offsets[b];
+ for (int d = tid; d < hidden; d += blockDim.x)
+ out[(size_t)b * hidden + d] = x[(size_t)first * hidden + d];
+}
+
+__global__ static void span_pool_kernel(
+ float *out, const float *x, const int *starts, const int *lens, int n_spans, int hidden) {
+ int s = blockIdx.x;
+ int tid = threadIdx.x;
+ int start = starts[s];
+ int len = lens[s];
+ for (int d = tid; d < hidden; d += blockDim.x) {
+ float sum = 0.0f;
+ for (int t = 0; t < len; t++)
+ sum += x[(size_t)(start + t) * hidden + d];
+ out[(size_t)s * hidden + d] = sum / (float)len;
+ }
+}
+
+// BERT LayerNorm: mean-subtract, biased variance (/dim), scale by gamma, shift
+// by beta. One block per row, two block reductions before any write, so it is
+// safe in place (out == x). Matches the CPU embed_layer_norm.
+__global__ static void layer_norm_kernel(float *out,
+ const float *x,
+ const float *gamma,
+ const float *beta,
+ int rows,
+ int dim,
+ float eps) {
+ int row = blockIdx.x;
+ int tid = threadIdx.x;
+ const float *xr = x + (size_t)row * dim;
+ float s = 0.0f;
+ for (int d = tid; d < dim; d += blockDim.x)
+ s += xr[d];
+ float mean = block_sum(s) / (float)dim;
+ float vs = 0.0f;
+ for (int d = tid; d < dim; d += blockDim.x) {
+ float c = xr[d] - mean;
+ vs += c * c;
+ }
+ float inv = rsqrtf(block_sum(vs) / (float)dim + eps);
+ float *o = out + (size_t)row * dim;
+ for (int d = tid; d < dim; d += blockDim.x)
+ o[d] = (xr[d] - mean) * inv * gamma[d] + beta[d];
+}
+
+// Exact-erf GeLU in place: 0.5 x (1 + erf(x / sqrt(2))). The released encoders
+// use this; the tanh approximation below is for gelu_new / gelu_pytorch_tanh.
+__global__ static void gelu_kernel(float *x, size_t n) {
+ size_t i = (size_t)blockIdx.x * blockDim.x + threadIdx.x;
+ if (i < n) {
+ float v = x[i];
+ x[i] = 0.5f * v * (1.0f + erff(v * 0.70710678118654752f));
+ }
+}
+
+// Tanh-approximation GeLU in place: 0.5 x (1 + tanh(sqrt(2/pi) (x + 0.044715 x^3))).
+__global__ static void gelu_tanh_kernel(float *x, size_t n) {
+ size_t i = (size_t)blockIdx.x * blockDim.x + threadIdx.x;
+ if (i < n) {
+ float v = x[i];
+ float inner = 0.79788456080286536f * (v + 0.044715f * v * v * v);
+ x[i] = 0.5f * v * (1.0f + tanhf(inner));
+ }
+}
+
+// Add the learned absolute position embedding (indexed by the within-sequence
+// position) and the token-type[0] embedding to the token embeddings already in
+// x. token_type holds row 0 only; every input token has segment id 0.
+__global__ static void bert_pos_type_add_kernel(float *x,
+ const int *positions,
+ const float *pos_emb,
+ const float *token_type,
+ int total,
+ int hidden) {
+ size_t idx = (size_t)blockIdx.x * blockDim.x + threadIdx.x;
+ size_t count = (size_t)total * hidden;
+ if (idx >= count)
+ return;
+ int tok = (int)(idx / hidden);
+ int d = (int)(idx - (size_t)tok * hidden);
+ int pos = positions[tok];
+ x[idx] += pos_emb[(size_t)pos * hidden + d] + token_type[d];
+}
+
+static int launch_check(void) {
+ cudaError_t e = cudaGetLastError();
+ if (e != cudaSuccess) {
+ fprintf(stderr, "cuda kernel failed: %s\n", cudaGetErrorString(e));
+ return -1;
+ }
+ return 0;
+}
+
+// Compute type for CUDA GEMMs. Default is exact F32 (== cublasSgemm).
+// EMBED_CUDA_GEMM_MODE={bf16,tf32,16f} selects a reduced-precision tensor-core
+// matmul that keeps F32 inputs/outputs and F32 accumulation but rounds operands
+// internally.
+static cublasComputeType_t gemm_compute(void) {
+ static int env_init = 0;
+ if (!g_gemm_compute_set && !env_init) {
+ const char *e = getenv("EMBED_CUDA_GEMM_MODE");
+ if (e && parse_gemm_compute(e, &g_gemm_compute) == 0)
+ g_gemm_compute_set = 1;
+ env_init = 1;
+ }
+ return g_gemm_compute;
+}
+
+// Grow the F32 weight-widen scratch to hold `elems` floats. The memory-only
+// BF16 path materializes one F32 weight at a time into this buffer.
+static int ensure_weight_f32(embed_cuda_ctx_t *ctx, size_t elems) {
+ if (ctx->weight_f32_elems >= elems)
+ return 0;
+ cudaFree(ctx->weight_f32);
+ ctx->weight_f32 = NULL;
+ ctx->weight_f32_elems = 0;
+ CUDA_CHECK(cudaMalloc((void **)&ctx->weight_f32, elems * sizeof(float)));
+ ctx->weight_f32_elems = elems;
+ return 0;
+}
+
+// y = w @ x (+ beta*y). With BF16 weights and an already-BF16 activation
+// (x_is_bf16 - the Qwen fused path) both inputs are BF16 with F32 accumulation.
+// For the BERT family the activation stays F32 and the BF16 weight is widened
+// back to F32 here, so the GEMM is exact (honoring gemm_compute): BF16 is then a
+// storage choice that costs no quality, which the post-norm LayerNorm needs.
+// With F32 weights this is the exact path.
+static int linear_ex(embed_cuda_ctx_t *ctx,
+ const cuda_matrix_t *w,
+ const void *x,
+ int x_is_bf16,
+ float *y,
+ int rows,
+ int in_dim,
+ int out_dim,
+ int x_stride,
+ float beta) {
+ const float alpha = 1.0f;
+ if (w->bf16) {
+ if (!x_is_bf16 && ctx->config.family == EMBED_FAMILY_BERT) {
+ size_t welems = (size_t)out_dim * (size_t)in_dim;
+ if (ensure_weight_f32(ctx, welems) != 0)
+ return -1;
+ int wt = 256;
+ cast_bf16_to_f32_kernel<<<(welems + wt - 1) / wt, wt, 0, ctx->stream>>>(
+ ctx->weight_f32, (const __nv_bfloat16 *)w->d, welems);
+ if (launch_check() != 0)
+ return -1;
+ CUBLAS_CHECK(cublasGemmEx(ctx->blas, CUBLAS_OP_T, CUBLAS_OP_N, out_dim, rows, in_dim,
+ &alpha, ctx->weight_f32, CUDA_R_32F, in_dim, x, CUDA_R_32F,
+ x_stride, &beta, y, CUDA_R_32F, out_dim, gemm_compute(),
+ CUBLAS_GEMM_DEFAULT));
+ return 0;
+ }
+ const void *xb = x;
+ if (!x_is_bf16) {
+ size_t n = (size_t)rows * (size_t)x_stride;
+ int threads = 256;
+ cast_f32_to_bf16_kernel<<<(n + threads - 1) / threads, threads, 0, ctx->stream>>>(
+ (__nv_bfloat16 *)ctx->act_bf16, (const float *)x, n);
+ if (launch_check() != 0)
+ return -1;
+ xb = ctx->act_bf16;
+ }
+ CUBLAS_CHECK(cublasGemmEx(ctx->blas, CUBLAS_OP_T, CUBLAS_OP_N, out_dim, rows, in_dim,
+ &alpha, w->d, CUDA_R_16BF, in_dim, xb, CUDA_R_16BF, x_stride,
+ &beta, y, CUDA_R_32F, out_dim, CUBLAS_COMPUTE_32F,
+ CUBLAS_GEMM_DEFAULT));
+ return 0;
+ }
+ CUBLAS_CHECK(cublasGemmEx(ctx->blas, CUBLAS_OP_T, CUBLAS_OP_N, out_dim, rows, in_dim, &alpha,
+ w->d, CUDA_R_32F, in_dim, x, CUDA_R_32F, x_stride, &beta, y,
+ CUDA_R_32F, out_dim, gemm_compute(), CUBLAS_GEMM_DEFAULT));
+ return 0;
+}
+
+static int linear(embed_cuda_ctx_t *ctx,
+ const cuda_matrix_t *w,
+ const float *x,
+ float *y,
+ int rows,
+ int in_dim,
+ int out_dim) {
+ return linear_ex(ctx, w, x, 0, y, rows, in_dim, out_dim, in_dim, 0.0f);
+}
+
+// x points at activations already stored as BF16 (e.g. ctx->act_bf16).
+static int linear_bf16x(embed_cuda_ctx_t *ctx,
+ const cuda_matrix_t *w,
+ const void *x,
+ float *y,
+ int rows,
+ int in_dim,
+ int out_dim,
+ int x_stride,
+ float beta) {
+ return linear_ex(ctx, w, x, 1, y, rows, in_dim, out_dim, x_stride, beta);
+}
+
+static int linear_accum(embed_cuda_ctx_t *ctx,
+ const cuda_matrix_t *w,
+ const float *x,
+ float *y,
+ int rows,
+ int in_dim,
+ int out_dim) {
+ return linear_ex(ctx, w, x, 0, y, rows, in_dim, out_dim, in_dim, 1.0f);
+}
+
+static int gemm_strided_batched(cublasHandle_t blas,
+ cublasOperation_t transa,
+ cublasOperation_t transb,
+ int m,
+ int n,
+ int k,
+ const float *alpha,
+ const float *A,
+ int lda,
+ long long strideA,
+ const float *B,
+ int ldb,
+ long long strideB,
+ const float *beta,
+ float *C,
+ int ldc,
+ long long strideC,
+ int batch_count) {
+ cublasComputeType_t ct = gemm_compute();
+ if (ct == CUBLAS_COMPUTE_32F) {
+ CUBLAS_CHECK(cublasSgemmStridedBatched(blas, transa, transb, m, n, k, alpha, A, lda,
+ strideA, B, ldb, strideB, beta, C, ldc, strideC,
+ batch_count));
+ } else {
+ CUBLAS_CHECK(cublasGemmStridedBatchedEx(
+ blas, transa, transb, m, n, k, alpha, A, CUDA_R_32F, lda, strideA, B, CUDA_R_32F, ldb,
+ strideB, beta, C, CUDA_R_32F, ldc, strideC, batch_count, ct, CUBLAS_GEMM_DEFAULT));
+ }
+ return 0;
+}
+
+// Attention for one micro-batch. Expands K/V to the per-query-head layout,
+// then for each sequence runs batched-over-heads Q@K^T (scaled) -> row softmax
+// -> @V via cuBLAS. Requires ctx->kexp, ctx->vexp ([total x q_dim]) and
+// ctx->attn_scores ([n_heads x max_seq x max_seq]) to be allocated. h_offsets
+// is the host copy of the packed sequence boundaries.
+// Prepare the equal-length batched-attention path for one forward pass:
+// grow the score/probability scratch to hold attn_G sequences at once and
+// upload the pointer arrays for the two batched GEMMs (buffer addresses are
+// layer-invariant). attn_G stays 0 - per-sequence fallback - for ragged
+// batches, single sequences, or when one sequence's scores exceed the
+// budget.
+static int attn_batched_setup(embed_cuda_ctx_t *ctx, int batch, int q_offset, int qkv_dim) {
+ const embed_config_t *c = &ctx->config;
+ ctx->attn_G = 0;
+ if (batch < 2)
+ return 0;
+ int L = ctx->offsets_host[1] - ctx->offsets_host[0];
+ if (L > CUDA_ATTN_BATCHED_MAX_LEN)
+ return 0;
+ for (int b = 1; b < batch; b++)
+ if (ctx->offsets_host[b + 1] - ctx->offsets_host[b] != L)
+ return 0;
+ int H = c->n_heads, hd = c->head_dim, q_dim = c->q_dim;
+ long long per = (long long)H * L * L;
+ if (per <= 0 || per > CUDA_ATTN_SCORES_BUDGET / 2)
+ return 0;
+ int G = (int)(CUDA_ATTN_SCORES_BUDGET / per);
+ if (G > batch)
+ G = batch;
+ if (G < 2)
+ return 0;
+
+ int bf16 = g_weights_bf16;
+ long long want = (long long)G * per;
+ if (want > ctx->attn_scores_elems) {
+ cudaFree(ctx->attn_scores);
+ ctx->attn_scores = NULL;
+ ctx->attn_scores_elems = 0;
+ CUDA_CHECK(cudaMalloc((void **)&ctx->attn_scores, (size_t)want * sizeof(float)));
+ ctx->attn_scores_elems = want;
+ }
+ if (bf16 && want > ctx->attn_probs_elems) {
+ cudaFree(ctx->attn_probs);
+ ctx->attn_probs = NULL;
+ ctx->attn_probs_elems = 0;
+ CUDA_CHECK(cudaMalloc(&ctx->attn_probs, (size_t)want * sizeof(__nv_bfloat16)));
+ ctx->attn_probs_elems = want;
+ }
+
+ int entries = 6 * batch * H;
+ if (entries > ctx->attn_ptrs_cap) {
+ cudaFree((void *)ctx->attn_ptrs);
+ free((void *)ctx->attn_ptrs_host);
+ ctx->attn_ptrs = NULL;
+ ctx->attn_ptrs_cap = 0;
+ ctx->attn_ptrs_host = (const void **)malloc((size_t)entries * sizeof(void *));
+ if (!ctx->attn_ptrs_host)
+ return -1;
+ CUDA_CHECK(cudaMalloc((void **)&ctx->attn_ptrs, (size_t)entries * sizeof(void *)));
+ ctx->attn_ptrs_cap = entries;
+ }
+
+ const void **K = ctx->attn_ptrs_host;
+ const void **Q = K + (size_t)batch * H;
+ const void **S = Q + (size_t)batch * H;
+ const void **V = S + (size_t)batch * H;
+ const void **P = V + (size_t)batch * H;
+ const void **O = P + (size_t)batch * H;
+ const __nv_bfloat16 *vb = (const __nv_bfloat16 *)ctx->vexp;
+ const __nv_bfloat16 *pb = (const __nv_bfloat16 *)ctx->attn_probs;
+ const __nv_bfloat16 *ab = (const __nv_bfloat16 *)ctx->act_bf16;
+ for (int b = 0; b < batch; b++) {
+ // Score/probability rows cycle every G sequences (chunked reuse).
+ long long srow = (long long)(b % G) * per;
+ size_t tok = (size_t)b * L;
+ for (int h = 0; h < H; h++) {
+ size_t i = (size_t)b * H + h;
+ K[i] = ctx->kexp + tok * q_dim + (size_t)h * hd;
+ Q[i] = ctx->qkv + tok * qkv_dim + q_offset + (size_t)h * hd;
+ S[i] = ctx->attn_scores + srow + (long long)h * L * L;
+ if (bf16) {
+ V[i] = vb + tok * q_dim + (size_t)h * hd;
+ P[i] = pb + srow + (long long)h * L * L;
+ O[i] = ab + tok * q_dim + (size_t)h * hd;
+ } else {
+ V[i] = ctx->vexp + tok * q_dim + (size_t)h * hd;
+ P[i] = S[i];
+ O[i] = ctx->attn_out + tok * q_dim + (size_t)h * hd;
+ }
+ }
+ }
+ CUDA_CHECK(cudaMemcpy((void *)ctx->attn_ptrs, ctx->attn_ptrs_host,
+ (size_t)entries * sizeof(void *), cudaMemcpyHostToDevice));
+ ctx->attn_G = G;
+ ctx->attn_L = L;
+ return 0;
+}
+
+// out_bf16 != NULL selects the BF16-weight layout: V and the softmax
+// probabilities are stored BF16 and the @V GEMM emits BF16 attention output
+// at out_bf16 (stride q_dim), ready for the wo projection without a cast.
+static int cuda_attention_gemm(embed_cuda_ctx_t *ctx,
+ const int *h_offsets,
+ int batch,
+ int q_offset,
+ int k_offset,
+ int v_offset,
+ int qkv_dim,
+ float scale,
+ __nv_bfloat16 *out_bf16) {
+ const embed_config_t *c = &ctx->config;
+ int q_dim = c->q_dim;
+ int hd = c->head_dim;
+ int H = c->n_heads;
+ int total = h_offsets[batch];
+ int causal = c->attention_mode == EMBED_ATTENTION_CAUSAL;
+ const float alpha = scale, beta = 0.0f, one = 1.0f;
+
+ int threads = 256;
+ size_t exp_count = (size_t)total * q_dim;
+ if (out_bf16) {
+ attn_expand_kv_kernel<<<(exp_count + threads - 1) / threads, threads, 0, ctx->stream>>>(
+ ctx->kexp, (__nv_bfloat16 *)ctx->vexp, ctx->qkv, total, H, c->n_kv_heads, hd, qkv_dim,
+ k_offset, v_offset);
+ } else {
+ attn_expand_kv_kernel<<<(exp_count + threads - 1) / threads, threads, 0, ctx->stream>>>(
+ ctx->kexp, ctx->vexp, ctx->qkv, total, H, c->n_kv_heads, hd, qkv_dim, k_offset,
+ v_offset);
+ }
+ if (launch_check() != 0)
+ return -1;
+
+ if (ctx->attn_G >= 2) {
+ int G = ctx->attn_G, L = ctx->attn_L;
+ const void *const *K = (const void *const *)ctx->attn_ptrs;
+ const void *const *Q = K + (size_t)batch * H;
+ void *const *S = (void *const *)(Q + (size_t)batch * H);
+ const void *const *V = (const void *const *)S + (size_t)batch * H;
+ const void *const *P = V + (size_t)batch * H;
+ void *const *O = (void *const *)(P + (size_t)batch * H);
+ cudaDataType pv = out_bf16 ? CUDA_R_16BF : CUDA_R_32F;
+ cublasComputeType_t av_ct = out_bf16 ? CUBLAS_COMPUTE_32F : gemm_compute();
+ for (int s = 0; s < batch; s += G) {
+ int g = batch - s < G ? batch - s : G;
+ int n = g * H;
+ size_t off = (size_t)s * H;
+ /* scores = scale * Q @ K^T, batched over (seq, head) */
+ CUBLAS_CHECK(cublasGemmBatchedEx(ctx->blas, CUBLAS_OP_T, CUBLAS_OP_N, L, L, hd, &alpha,
+ K + off, CUDA_R_32F, q_dim, Q + off, CUDA_R_32F,
+ qkv_dim, &beta, S + off, CUDA_R_32F, L, n,
+ gemm_compute(), CUBLAS_GEMM_DEFAULT));
+ if (out_bf16) {
+ if (causal)
+ attn_causal_softmax_kernel<<<n * L, 256, 0, ctx->stream>>>(
+ ctx->attn_scores, (__nv_bfloat16 *)ctx->attn_probs, L);
+ else
+ attn_softmax_kernel<<<n * L, 256, 0, ctx->stream>>>(
+ ctx->attn_scores, (__nv_bfloat16 *)ctx->attn_probs, L);
+ } else {
+ if (causal)
+ attn_causal_softmax_kernel<<<n * L, 256, 0, ctx->stream>>>(ctx->attn_scores,
+ ctx->attn_scores, L);
+ else
+ attn_softmax_kernel<<<n * L, 256, 0, ctx->stream>>>(ctx->attn_scores,
+ ctx->attn_scores, L);
+ }
+ if (launch_check() != 0)
+ return -1;
+ /* O = P @ V, batched over (seq, head) */
+ CUBLAS_CHECK(cublasGemmBatchedEx(ctx->blas, CUBLAS_OP_N, CUBLAS_OP_N, hd, L, L, &one,
+ V + off, pv, q_dim, P + off, pv, L, &beta, O + off, pv,
+ q_dim, n, av_ct, CUBLAS_GEMM_DEFAULT));
+ }
+ return 0;
+ }
+
+ for (int b = 0; b < batch; b++) {
+ int start = h_offsets[b];
+ int L = h_offsets[b + 1] - start;
+ const float *Q = ctx->qkv + (size_t)start * qkv_dim + q_offset;
+ const float *K = ctx->kexp + (size_t)start * q_dim;
+ /* scores[h] = scale * Q[h] @ K[h]^T (row-major C = A @ B^T) */
+ if (gemm_strided_batched(ctx->blas, CUBLAS_OP_T, CUBLAS_OP_N, L, L, hd, &alpha, K, q_dim,
+ hd, Q, qkv_dim, hd, &beta, ctx->attn_scores, L, (long long)L * L,
+ H) != 0)
+ return -1;
+ if (out_bf16) {
+ __nv_bfloat16 *P = (__nv_bfloat16 *)ctx->attn_probs;
+ const __nv_bfloat16 *V = (const __nv_bfloat16 *)ctx->vexp + (size_t)start * q_dim;
+ __nv_bfloat16 *O = out_bf16 + (size_t)start * q_dim;
+ if (causal)
+ attn_causal_softmax_kernel<<<H * L, 256, 0, ctx->stream>>>(ctx->attn_scores, P, L);
+ else
+ attn_softmax_kernel<<<H * L, 256, 0, ctx->stream>>>(ctx->attn_scores, P, L);
+ if (launch_check() != 0)
+ return -1;
+ /* O[h] = P[h] @ V[h] (row-major C = A @ B) */
+ CUBLAS_CHECK(cublasGemmStridedBatchedEx(
+ ctx->blas, CUBLAS_OP_N, CUBLAS_OP_N, hd, L, L, &one, V, CUDA_R_16BF, q_dim, hd, P,
+ CUDA_R_16BF, L, (long long)L * L, &beta, O, CUDA_R_16BF, q_dim, hd, H,
+ CUBLAS_COMPUTE_32F, CUBLAS_GEMM_DEFAULT));
+ } else {
+ const float *V = ctx->vexp + (size_t)start * q_dim;
+ float *O = ctx->attn_out + (size_t)start * q_dim;
+ if (causal)
+ attn_causal_softmax_kernel<<<H * L, 256, 0, ctx->stream>>>(ctx->attn_scores,
+ ctx->attn_scores, L);
+ else
+ attn_softmax_kernel<<<H * L, 256, 0, ctx->stream>>>(ctx->attn_scores,
+ ctx->attn_scores, L);
+ if (launch_check() != 0)
+ return -1;
+ /* O[h] = P[h] @ V[h] (row-major C = A @ B) */
+ if (gemm_strided_batched(ctx->blas, CUBLAS_OP_N, CUBLAS_OP_N, hd, L, L, &one, V, q_dim,
+ hd, ctx->attn_scores, L, (long long)L * L, &beta, O, q_dim, hd,
+ H) != 0)
+ return -1;
+ }
+ }
+ return 0;
+}
+
+static int ensure_buffers(embed_cuda_ctx_t *ctx, int total, int batch, int max_seq) {
+ const embed_config_t *c = &ctx->config;
+ if (total > ctx->seq_cap) {
+ cudaFree(ctx->x);
+ cudaFree(ctx->x_norm);
+ cudaFree(ctx->qkv);
+ cudaFree(ctx->attn_out);
+ cudaFree(ctx->ffn_gate_up);
+ cudaFree(ctx->token_ids);
+ cudaFree(ctx->positions);
+ cudaFree(ctx->kexp);
+ cudaFree(ctx->vexp);
+ cudaFree(ctx->act_bf16);
+ ctx->x = ctx->x_norm = ctx->qkv = NULL;
+ ctx->attn_out = ctx->ffn_gate_up = NULL;
+ ctx->token_ids = ctx->positions = NULL;
+ ctx->kexp = ctx->vexp = NULL;
+ ctx->act_bf16 = NULL;
+ CUDA_CHECK(cudaMalloc((void **)&ctx->x, (size_t)total * c->hidden_size * sizeof(float)));
+ CUDA_CHECK(
+ cudaMalloc((void **)&ctx->x_norm, (size_t)total * c->hidden_size * sizeof(float)));
+ CUDA_CHECK(cudaMalloc((void **)&ctx->qkv,
+ (size_t)total * (c->q_dim + 2 * c->kv_dim) * sizeof(float)));
+ CUDA_CHECK(cudaMalloc((void **)&ctx->attn_out, (size_t)total * c->q_dim * sizeof(float)));
+ CUDA_CHECK(cudaMalloc((void **)&ctx->ffn_gate_up,
+ (size_t)total * 2 * c->intermediate_size * sizeof(float)));
+ CUDA_CHECK(cudaMalloc((void **)&ctx->token_ids, (size_t)total * sizeof(int)));
+ CUDA_CHECK(cudaMalloc((void **)&ctx->positions, (size_t)total * sizeof(int)));
+ CUDA_CHECK(cudaMalloc((void **)&ctx->kexp, (size_t)total * c->q_dim * sizeof(float)));
+ CUDA_CHECK(cudaMalloc((void **)&ctx->vexp, (size_t)total * c->q_dim * sizeof(float)));
+ if (g_weights_bf16)
+ CUDA_CHECK(cudaMalloc(&ctx->act_bf16, (size_t)total * 2 * c->intermediate_size *
+ sizeof(__nv_bfloat16)));
+ ctx->seq_cap = total;
+ }
+ if (batch + 1 > ctx->batch_cap) {
+ cudaFree(ctx->offsets);
+ free(ctx->offsets_host);
+ CUDA_CHECK(cudaMalloc((void **)&ctx->offsets, (size_t)(batch + 1) * sizeof(int)));
+ ctx->offsets_host = (int *)malloc((size_t)(batch + 1) * sizeof(int));
+ if (!ctx->offsets_host)
+ return -1;
+ ctx->batch_cap = batch + 1;
+ }
+ if (max_seq > ctx->max_seq_cap) {
+ cudaFree(ctx->rope_cos);
+ cudaFree(ctx->rope_sin);
+ long long score_elems = (long long)c->n_heads * max_seq * max_seq;
+ if (score_elems > ctx->attn_scores_elems) {
+ cudaFree(ctx->attn_scores);
+ ctx->attn_scores = NULL;
+ ctx->attn_scores_elems = 0;
+ CUDA_CHECK(cudaMalloc((void **)&ctx->attn_scores, (size_t)score_elems * sizeof(float)));
+ ctx->attn_scores_elems = score_elems;
+ }
+ if (g_weights_bf16 && score_elems > ctx->attn_probs_elems) {
+ cudaFree(ctx->attn_probs);
+ ctx->attn_probs = NULL;
+ ctx->attn_probs_elems = 0;
+ CUDA_CHECK(cudaMalloc(&ctx->attn_probs, (size_t)score_elems * sizeof(__nv_bfloat16)));
+ ctx->attn_probs_elems = score_elems;
+ }
+ float *hcos = (float *)malloc((size_t)max_seq * c->head_dim * sizeof(float));
+ float *hsin = (float *)malloc((size_t)max_seq * c->head_dim * sizeof(float));
+ if (!hcos || !hsin) {
+ free(hcos);
+ free(hsin);
+ return -1;
+ }
+ int half = c->head_dim / 2;
+ for (int pos = 0; pos < max_seq; pos++) {
+ for (int d = 0; d < half; d++) {
+ float inv = 1.0f / powf(c->rope_theta, (float)(2 * d) / (float)c->head_dim);
+ float angle = (float)pos * inv;
+ float cv = cosf(angle);
+ float sv = sinf(angle);
+ hcos[(size_t)pos * c->head_dim + d] = cv;
+ hcos[(size_t)pos * c->head_dim + half + d] = cv;
+ hsin[(size_t)pos * c->head_dim + d] = sv;
+ hsin[(size_t)pos * c->head_dim + half + d] = sv;
+ }
+ }
+ CUDA_CHECK(
+ cudaMalloc((void **)&ctx->rope_cos, (size_t)max_seq * c->head_dim * sizeof(float)));
+ CUDA_CHECK(
+ cudaMalloc((void **)&ctx->rope_sin, (size_t)max_seq * c->head_dim * sizeof(float)));
+ CUDA_CHECK(cudaMemcpyAsync(ctx->rope_cos, hcos,
+ (size_t)max_seq * c->head_dim * sizeof(float),
+ cudaMemcpyHostToDevice, ctx->stream));
+ CUDA_CHECK(cudaMemcpyAsync(ctx->rope_sin, hsin,
+ (size_t)max_seq * c->head_dim * sizeof(float),
+ cudaMemcpyHostToDevice, ctx->stream));
+ free(hcos);
+ free(hsin);
+ ctx->max_seq_cap = max_seq;
+ }
+ return 0;
+}
+
+static int ensure_pooled_rows(embed_cuda_ctx_t *ctx, int rows) {
+ if (rows <= ctx->pooled_rows_cap)
+ return 0;
+ const embed_config_t *c = &ctx->config;
+ cudaFree(ctx->pooled_out);
+ ctx->pooled_out = NULL;
+ CUDA_CHECK(
+ cudaMalloc((void **)&ctx->pooled_out, (size_t)rows * c->hidden_size * sizeof(float)));
+ ctx->pooled_rows_cap = rows;
+ return 0;
+}
+
+static int ensure_span_buffers(embed_cuda_ctx_t *ctx, int n_spans) {
+ if (n_spans <= ctx->span_cap)
+ return 0;
+ cudaFree(ctx->span_starts);
+ cudaFree(ctx->span_lens);
+ ctx->span_starts = NULL;
+ ctx->span_lens = NULL;
+ CUDA_CHECK(cudaMalloc((void **)&ctx->span_starts, (size_t)n_spans * sizeof(int)));
+ CUDA_CHECK(cudaMalloc((void **)&ctx->span_lens, (size_t)n_spans * sizeof(int)));
+ ctx->span_cap = n_spans;
+ return 0;
+}
+
+static int load_layer(cuda_layer_t *dst, const embed_layer_t *src, const embed_config_t *c) {
+ return load_qkv_matrix(&dst->qkv, src, c) ||
+ load_matrix(&dst->wo, &src->wo, c->hidden_size, c->q_dim) ||
+ (c->qkv_bias && load_qkv_bias(&dst->qkv_bias, src, c)) ||
+ (c->qk_norm && load_vector(&dst->q_norm, src->q_norm, c->head_dim)) ||
+ (c->qk_norm && load_vector(&dst->k_norm, src->k_norm, c->head_dim)) ||
+ load_vector(&dst->input_norm, src->input_norm, c->hidden_size) ||
+ load_vector(&dst->post_attn_norm, src->post_attn_norm, c->hidden_size) ||
+ load_gate_up_matrix(&dst->gate_up_proj, src, c) ||
+ load_matrix(&dst->down_proj, &src->down_proj, c->hidden_size, c->intermediate_size);
+}
+
+/* BERT layer: attention reuses the fused qkv matrix and qkv_bias (q_dim ==
+ * kv_dim == hidden); the two block LayerNorm weights load into input_norm
+ * (post-attention) and post_attn_norm (post-FFN); gate_up_proj holds the single
+ * up_proj. The added fields carry the biases the Qwen slots lack. */
+static int load_bert_layer(cuda_layer_t *dst, const embed_layer_t *src, const embed_config_t *c) {
+ return load_qkv_matrix(&dst->qkv, src, c) ||
+ load_matrix(&dst->wo, &src->wo, c->hidden_size, c->q_dim) ||
+ load_qkv_bias(&dst->qkv_bias, src, c) ||
+ load_vector(&dst->o_bias, src->o_bias, c->hidden_size) ||
+ load_vector(&dst->input_norm, src->input_norm, c->hidden_size) ||
+ load_vector(&dst->attn_ln_bias, src->attn_ln_bias, c->hidden_size) ||
+ load_vector(&dst->post_attn_norm, src->post_attn_norm, c->hidden_size) ||
+ load_vector(&dst->ffn_ln_bias, src->ffn_ln_bias, c->hidden_size) ||
+ load_matrix(&dst->gate_up_proj, &src->up_proj, c->intermediate_size, c->hidden_size) ||
+ load_vector(&dst->ffn_inter_bias, src->ffn_inter_bias, c->intermediate_size) ||
+ load_matrix(&dst->down_proj, &src->down_proj, c->hidden_size, c->intermediate_size) ||
+ load_vector(&dst->ffn_out_bias, src->ffn_out_bias, c->hidden_size);
+}
+
+static void free_layer(cuda_layer_t *l) {
+ cuda_matrix_free(&l->qkv);
+ cuda_matrix_free(&l->wo);
+ cudaFree(l->qkv_bias);
+ cudaFree(l->q_norm);
+ cudaFree(l->k_norm);
+ cudaFree(l->input_norm);
+ cudaFree(l->post_attn_norm);
+ cuda_matrix_free(&l->gate_up_proj);
+ cuda_matrix_free(&l->down_proj);
+ cudaFree(l->o_bias);
+ cudaFree(l->attn_ln_bias);
+ cudaFree(l->ffn_inter_bias);
+ cudaFree(l->ffn_out_bias);
+ cudaFree(l->ffn_ln_bias);
+}
+
+/* Build a device context from an already-loaded CPU model. own_cpu records
+ * whether embed_cuda_free should release that CPU model: embed_cuda_load owns
+ * the model it loaded; the late path passes a model owned by its CPU late
+ * model and sets own_cpu = 0. */
+static embed_cuda_ctx_t *cuda_ctx_from_model(embed_model_t *cpu, int own_cpu) {
+ if (!cpu)
+ return NULL;
+
+ embed_cuda_ctx_t *ctx = (embed_cuda_ctx_t *)calloc(1, sizeof(*ctx));
+ if (!ctx) {
+ if (own_cpu)
+ embed_model_free(cpu);
+ return NULL;
+ }
+ ctx->cpu = cpu;
+ ctx->own_cpu = own_cpu;
+ ctx->config = cpu->config;
+
+ /* Without an explicit --cuda-weight-dtype, store weights in the model
+ * file's dtype: BF16 snapshots load as BF16 (bit-exact pass-through),
+ * F32 snapshots keep the exact F32 default. */
+ if (!g_weights_bf16_set) {
+ g_weights_bf16 = cpu->weights.embed_tokens.dtype == DTYPE_BF16;
+ if (g_weights_bf16)
+ fprintf(stderr, "cuda: BF16 model file; storing weights as BF16 "
+ "(use --cuda-weight-dtype f32 to override)\n");
+ }
+
+ if (cudaStreamCreate(&ctx->stream) != cudaSuccess ||
+ cublasCreate(&ctx->blas) != CUBLAS_STATUS_SUCCESS ||
+ cublasSetStream(ctx->blas, ctx->stream) != CUBLAS_STATUS_SUCCESS) {
+ embed_cuda_free(ctx);
+ return NULL;
+ }
+
+ const embed_config_t *c = &ctx->config;
+ ctx->layers = (cuda_layer_t *)calloc((size_t)c->n_layers, sizeof(*ctx->layers));
+ if (!ctx->layers) {
+ embed_cuda_free(ctx);
+ return NULL;
+ }
+ if (load_matrix(&ctx->embed_tokens, &cpu->weights.embed_tokens, c->vocab_size,
+ c->hidden_size) != 0) {
+ embed_cuda_free(ctx);
+ return NULL;
+ }
+ if (c->family == EMBED_FAMILY_BERT) {
+ /* BERT has no final norm; it adds learned position + token-type[0]
+ * embeddings and an embedding LayerNorm (only row 0 of token-type is
+ * ever used, so load just that row). */
+ const embed_weights_t *w = &cpu->weights;
+ if (load_vector(&ctx->position_embeddings, w->position_embeddings,
+ c->max_position_embeddings * c->hidden_size) != 0 ||
+ load_vector(&ctx->token_type_embedding, w->token_type_embeddings, c->hidden_size) !=
+ 0 ||
+ load_vector(&ctx->embed_ln_w, w->embed_ln_w, c->hidden_size) != 0 ||
+ load_vector(&ctx->embed_ln_b, w->embed_ln_b, c->hidden_size) != 0) {
+ embed_cuda_free(ctx);
+ return NULL;
+ }
+ } else if (load_vector(&ctx->norm, cpu->weights.norm, c->hidden_size) != 0) {
+ embed_cuda_free(ctx);
+ return NULL;
+ }
+ for (int i = 0; i < c->n_layers; i++) {
+ int rc = c->family == EMBED_FAMILY_BERT
+ ? load_bert_layer(&ctx->layers[i], &cpu->weights.layers[i], c)
+ : load_layer(&ctx->layers[i], &cpu->weights.layers[i], c);
+ if (rc != 0) {
+ fprintf(stderr, "cuda: failed to load layer %d\n", i);
+ embed_cuda_free(ctx);
+ return NULL;
+ }
+ }
+ cudaStreamSynchronize(ctx->stream);
+ return ctx;
+}
+
+embed_cuda_ctx_t *embed_cuda_load(const char *model_dir) {
+ return cuda_ctx_from_model(embed_model_load(model_dir), 1);
+}
+
+void embed_cuda_free(embed_cuda_ctx_t *ctx) {
+ if (!ctx)
+ return;
+ cuda_matrix_free(&ctx->embed_tokens);
+ if (ctx->layers) {
+ for (int i = 0; i < ctx->config.n_layers; i++)
+ free_layer(&ctx->layers[i]);
+ free(ctx->layers);
+ }
+ cudaFree(ctx->norm);
+ cudaFree(ctx->position_embeddings);
+ cudaFree(ctx->token_type_embedding);
+ cudaFree(ctx->embed_ln_w);
+ cudaFree(ctx->embed_ln_b);
+ cudaFree(ctx->x);
+ cudaFree(ctx->x_norm);
+ cudaFree(ctx->qkv);
+ cudaFree(ctx->attn_out);
+ cudaFree(ctx->ffn_gate_up);
+ cudaFree(ctx->pooled_out);
+ cudaFree(ctx->rope_cos);
+ cudaFree(ctx->rope_sin);
+ cudaFree(ctx->token_ids);
+ cudaFree(ctx->offsets);
+ free(ctx->offsets_host);
+ cudaFree(ctx->positions);
+ cudaFree(ctx->kexp);
+ cudaFree(ctx->vexp);
+ cudaFree(ctx->act_bf16);
+ cudaFree(ctx->weight_f32);
+ cudaFree(ctx->attn_scores);
+ cudaFree(ctx->attn_probs);
+ cudaFree((void *)ctx->attn_ptrs);
+ free((void *)ctx->attn_ptrs_host);
+ cudaFree(ctx->span_starts);
+ cudaFree(ctx->span_lens);
+ if (ctx->blas)
+ cublasDestroy(ctx->blas);
+ if (ctx->stream)
+ cudaStreamDestroy(ctx->stream);
+ if (ctx->own_cpu)
+ embed_model_free(ctx->cpu);
+ free(ctx);
+}
+
+const embed_config_t *embed_cuda_config(const embed_cuda_ctx_t *ctx) {
+ return ctx ? &ctx->config : NULL;
+}
+
+// Pack inputs into the device scratch every forward shares: token ids, the
+// per-sequence positions 0..L-1, and the batch offsets. Grows scratch via
+// ensure_buffers. Returns the packed token count in *out_total, or -1 on error.
+static int cuda_upload_packed_inputs(embed_cuda_ctx_t *ctx,
+ const embed_input_t *inputs,
+ int batch,
+ int *out_total) {
+ int *h_offsets = (int *)malloc((size_t)(batch + 1) * sizeof(int));
+ if (!h_offsets)
+ return -1;
+ int total = 0, max_seq = 0;
+ for (int b = 0; b < batch; b++) {
+ if (!inputs[b].ids || inputs[b].n_tokens <= 0) {
+ free(h_offsets);
+ return -1;
+ }
+ h_offsets[b] = total;
+ total += inputs[b].n_tokens;
+ if (inputs[b].n_tokens > max_seq)
+ max_seq = inputs[b].n_tokens;
+ }
+ h_offsets[batch] = total;
+ int *h_ids = (int *)malloc((size_t)total * sizeof(int));
+ int *h_pos = (int *)malloc((size_t)total * sizeof(int));
+ if (!h_ids || !h_pos) {
+ free(h_offsets);
+ free(h_ids);
+ free(h_pos);
+ return -1;
+ }
+ for (int b = 0; b < batch; b++) {
+ int off = h_offsets[b];
+ memcpy(h_ids + off, inputs[b].ids, (size_t)inputs[b].n_tokens * sizeof(int));
+ for (int i = 0; i < inputs[b].n_tokens; i++)
+ h_pos[off + i] = i;
+ }
+ if (ensure_buffers(ctx, total, batch, max_seq) != 0) {
+ free(h_offsets);
+ free(h_ids);
+ free(h_pos);
+ return -1;
+ }
+ memcpy(ctx->offsets_host, h_offsets, (size_t)(batch + 1) * sizeof(int));
+ cudaError_t ce = cudaMemcpyAsync(ctx->token_ids, h_ids, (size_t)total * sizeof(int),
+ cudaMemcpyHostToDevice, ctx->stream);
+ if (ce == cudaSuccess)
+ ce = cudaMemcpyAsync(ctx->positions, h_pos, (size_t)total * sizeof(int),
+ cudaMemcpyHostToDevice, ctx->stream);
+ if (ce == cudaSuccess)
+ ce = cudaMemcpyAsync(ctx->offsets, h_offsets, (size_t)(batch + 1) * sizeof(int),
+ cudaMemcpyHostToDevice, ctx->stream);
+ free(h_offsets);
+ free(h_ids);
+ free(h_pos);
+ if (ce != cudaSuccess) {
+ fprintf(stderr, "cuda input copy failed: %s\n", cudaGetErrorString(ce));
+ return -1;
+ }
+ *out_total = total;
+ return 0;
+}
+
+// BERT-family forward (post-norm encoder), mirroring the CPU forward_packed_bert.
+// Embeddings: token + learned position + token-type[0], then the embedding
+// LayerNorm. Each layer: QKV(+bias) from x directly -> bidirectional attention
+// -> output dense(+bias) -> residual -> LayerNorm -> dense(+bias) -> GeLU ->
+// dense(+bias) -> residual -> LayerNorm. No RoPE, no qk-norm, no final norm.
+// F32 activations: BERT checkpoints are F32, so the linear/linear_accum F32
+// entry points are used throughout (they still handle bf16 weights via an
+// internal cast, which keeps a future bf16 BERT correct if not yet optimized).
+static int cuda_forward_batch_bert(embed_cuda_ctx_t *ctx, const embed_input_t *inputs, int batch) {
+ const embed_config_t *c = &ctx->config;
+ int total = 0;
+ if (cuda_upload_packed_inputs(ctx, inputs, batch, &total) != 0)
+ return -1;
+
+ int hidden = c->hidden_size;
+ int inter = c->intermediate_size;
+ int qkv_dim = c->q_dim + 2 * c->kv_dim;
+ int q_offset = 0, k_offset = c->q_dim, v_offset = c->q_dim + c->kv_dim;
+ float scale = 1.0f / sqrtf((float)c->head_dim);
+ float eps = c->layer_norm_eps;
+ int threads = 256;
+ int blocks_hidden = (total * hidden + threads - 1) / threads;
+
+ embed_lookup_kernel<<<blocks_hidden, threads, 0, ctx->stream>>>(
+ ctx->x, ctx->token_ids, ctx->embed_tokens.d, ctx->embed_tokens.bf16, total, hidden,
+ c->vocab_size);
+ if (launch_check() != 0)
+ return -1;
+ bert_pos_type_add_kernel<<<blocks_hidden, threads, 0, ctx->stream>>>(
+ ctx->x, ctx->positions, ctx->position_embeddings, ctx->token_type_embedding, total, hidden);
+ if (launch_check() != 0)
+ return -1;
+ layer_norm_kernel<<<total, 256, 0, ctx->stream>>>(ctx->x, ctx->x, ctx->embed_ln_w,
+ ctx->embed_ln_b, total, hidden, eps);
+ if (launch_check() != 0)
+ return -1;
+
+ if (attn_batched_setup(ctx, batch, q_offset, qkv_dim) != 0)
+ return -1;
+
+ for (int layer = 0; layer < c->n_layers; layer++) {
+ cuda_layer_t *l = &ctx->layers[layer];
+
+ // Self-attention (post-norm): QKV read x directly, then +bias.
+ if (linear(ctx, &l->qkv, ctx->x, ctx->qkv, total, hidden, qkv_dim) != 0)
+ return -1;
+ int qkv_count = total * qkv_dim;
+ add_row_bias_kernel<<<(qkv_count + 255) / 256, 256, 0, ctx->stream>>>(ctx->qkv, l->qkv_bias,
+ total, qkv_dim);
+ if (launch_check() != 0)
+ return -1;
+ if (cuda_attention_gemm(ctx, ctx->offsets_host, batch, q_offset, k_offset, v_offset,
+ qkv_dim, scale, NULL) != 0)
+ return -1;
+
+ // Output dense(+bias), residual into x, then post-attention LayerNorm.
+ if (linear_accum(ctx, &l->wo, ctx->attn_out, ctx->x, total, c->q_dim, hidden) != 0)
+ return -1;
+ add_row_bias_kernel<<<(total * hidden + 255) / 256, 256, 0, ctx->stream>>>(
+ ctx->x, l->o_bias, total, hidden);
+ if (launch_check() != 0)
+ return -1;
+ layer_norm_kernel<<<total, 256, 0, ctx->stream>>>(ctx->x, ctx->x, l->input_norm,
+ l->attn_ln_bias, total, hidden, eps);
+ if (launch_check() != 0)
+ return -1;
+
+ // Feed-forward (post-norm): dense(+bias) -> GeLU -> dense(+bias).
+ if (linear(ctx, &l->gate_up_proj, ctx->x, ctx->ffn_gate_up, total, hidden, inter) != 0)
+ return -1;
+ int inter_count = total * inter;
+ add_row_bias_kernel<<<(inter_count + 255) / 256, 256, 0, ctx->stream>>>(
+ ctx->ffn_gate_up, l->ffn_inter_bias, total, inter);
+ if (launch_check() != 0)
+ return -1;
+ if (c->ffn_act == EMBED_ACT_GELU_TANH)
+ gelu_tanh_kernel<<<(inter_count + threads - 1) / threads, threads, 0, ctx->stream>>>(
+ ctx->ffn_gate_up, (size_t)inter_count);
+ else
+ gelu_kernel<<<(inter_count + threads - 1) / threads, threads, 0, ctx->stream>>>(
+ ctx->ffn_gate_up, (size_t)inter_count);
+ if (launch_check() != 0)
+ return -1;
+ if (linear_accum(ctx, &l->down_proj, ctx->ffn_gate_up, ctx->x, total, inter, hidden) != 0)
+ return -1;
+ add_row_bias_kernel<<<(total * hidden + 255) / 256, 256, 0, ctx->stream>>>(
+ ctx->x, l->ffn_out_bias, total, hidden);
+ if (launch_check() != 0)
+ return -1;
+ layer_norm_kernel<<<total, 256, 0, ctx->stream>>>(ctx->x, ctx->x, l->post_attn_norm,
+ l->ffn_ln_bias, total, hidden, eps);
+ if (launch_check() != 0)
+ return -1;
+ }
+ // No final norm; embed_cuda_encode_batch pools ctx->x directly.
+ return 0;
+}
+
+static int cuda_forward_batch(embed_cuda_ctx_t *ctx, const embed_input_t *inputs, int batch) {
+ if (!ctx || !inputs || batch <= 0)
+ return -1;
+ const embed_config_t *c = &ctx->config;
+ if (c->family == EMBED_FAMILY_BERT)
+ return cuda_forward_batch_bert(ctx, inputs, batch);
+ int total = 0;
+ if (cuda_upload_packed_inputs(ctx, inputs, batch, &total) != 0)
+ return -1;
+
+ int threads = 256;
+ int blocks_hidden = (total * c->hidden_size + threads - 1) / threads;
+ embed_lookup_kernel<<<blocks_hidden, threads, 0, ctx->stream>>>(
+ ctx->x, ctx->token_ids, ctx->embed_tokens.d, ctx->embed_tokens.bf16, total, c->hidden_size,
+ c->vocab_size);
+ if (launch_check() != 0)
+ return -1;
+
+ float scale = 1.0f / sqrtf((float)c->head_dim);
+ int q_offset = 0;
+ int k_offset = c->q_dim;
+ int v_offset = c->q_dim + c->kv_dim;
+ int qkv_dim = c->q_dim + 2 * c->kv_dim;
+ // With BF16 weights every producer (norm, SiLU, attention @V GEMM)
+ // stores its result as BF16 directly into ctx->act_bf16, which the next
+ // projection GEMM consumes before any later producer reuses the buffer
+ // (single stream). No cast launches remain in the layer loop.
+ __nv_bfloat16 *act = (__nv_bfloat16 *)ctx->act_bf16;
+ if (attn_batched_setup(ctx, batch, q_offset, qkv_dim) != 0)
+ return -1;
+ for (int layer = 0; layer < c->n_layers; layer++) {
+ cuda_layer_t *l = &ctx->layers[layer];
+ int wbf16 = l->qkv.bf16;
+ if (wbf16) {
+ rms_norm_kernel<<<total, 256, 0, ctx->stream>>>(act, ctx->x, l->input_norm, total,
+ c->hidden_size, c->rms_norm_eps);
+ if (launch_check() != 0)
+ return -1;
+ if (linear_bf16x(ctx, &l->qkv, act, ctx->qkv, total, c->hidden_size, qkv_dim,
+ c->hidden_size, 0.0f) != 0)
+ return -1;
+ } else {
+ rms_norm_kernel<<<total, 256, 0, ctx->stream>>>(ctx->x_norm, ctx->x, l->input_norm,
+ total, c->hidden_size, c->rms_norm_eps);
+ if (launch_check() != 0)
+ return -1;
+ if (linear(ctx, &l->qkv, ctx->x_norm, ctx->qkv, total, c->hidden_size, qkv_dim) != 0)
+ return -1;
+ }
+
+ if (c->qkv_bias) {
+ int count = total * qkv_dim;
+ add_row_bias_kernel<<<(count + 255) / 256, 256, 0, ctx->stream>>>(ctx->qkv, l->qkv_bias,
+ total, qkv_dim);
+ if (launch_check() != 0)
+ return -1;
+ }
+
+ rms_norm_rope_qk_kernel<<<dim3(total, c->n_heads + c->n_kv_heads), 128, 0, ctx->stream>>>(
+ ctx->qkv, l->q_norm, l->k_norm, ctx->positions, ctx->rope_cos, ctx->rope_sin, total,
+ c->n_heads, c->n_kv_heads, c->head_dim, qkv_dim, q_offset, k_offset, c->qk_norm,
+ c->rms_norm_eps);
+ if (launch_check() != 0)
+ return -1;
+
+ if (cuda_attention_gemm(ctx, ctx->offsets_host, batch, q_offset, k_offset, v_offset,
+ qkv_dim, scale, wbf16 ? act : NULL) != 0)
+ return -1;
+
+ if (wbf16) {
+ if (linear_bf16x(ctx, &l->wo, act, ctx->x, total, c->q_dim, c->hidden_size, c->q_dim,
+ 1.0f) != 0)
+ return -1;
+ } else {
+ if (linear_accum(ctx, &l->wo, ctx->attn_out, ctx->x, total, c->q_dim, c->hidden_size) !=
+ 0)
+ return -1;
+ }
+
+ int inter_count = total * c->intermediate_size;
+ if (wbf16) {
+ rms_norm_kernel<<<total, 256, 0, ctx->stream>>>(act, ctx->x, l->post_attn_norm, total,
+ c->hidden_size, c->rms_norm_eps);
+ if (launch_check() != 0)
+ return -1;
+ if (linear_bf16x(ctx, &l->gate_up_proj, act, ctx->ffn_gate_up, total, c->hidden_size,
+ 2 * c->intermediate_size, c->hidden_size, 0.0f) != 0)
+ return -1;
+ silu_mul_packed_kernel<<<(inter_count + threads - 1) / threads, threads, 0,
+ ctx->stream>>>(act, c->intermediate_size, ctx->ffn_gate_up,
+ total, c->intermediate_size);
+ if (launch_check() != 0)
+ return -1;
+ if (linear_bf16x(ctx, &l->down_proj, act, ctx->x, total, c->intermediate_size,
+ c->hidden_size, c->intermediate_size, 1.0f) != 0)
+ return -1;
+ } else {
+ rms_norm_kernel<<<total, 256, 0, ctx->stream>>>(ctx->x_norm, ctx->x, l->post_attn_norm,
+ total, c->hidden_size, c->rms_norm_eps);
+ if (launch_check() != 0)
+ return -1;
+ if (linear(ctx, &l->gate_up_proj, ctx->x_norm, ctx->ffn_gate_up, total, c->hidden_size,
+ 2 * c->intermediate_size) != 0)
+ return -1;
+ silu_mul_packed_kernel<<<(inter_count + threads - 1) / threads, threads, 0,
+ ctx->stream>>>(ctx->ffn_gate_up, 2 * c->intermediate_size,
+ ctx->ffn_gate_up, total, c->intermediate_size);
+ if (launch_check() != 0)
+ return -1;
+ if (linear_ex(ctx, &l->down_proj, ctx->ffn_gate_up, 0, ctx->x, total,
+ c->intermediate_size, c->hidden_size, 2 * c->intermediate_size,
+ 1.0f) != 0)
+ return -1;
+ }
+ }
+
+ rms_norm_kernel<<<total, 256, 0, ctx->stream>>>(ctx->x, ctx->x, ctx->norm, total,
+ c->hidden_size, c->rms_norm_eps);
+ if (launch_check() != 0)
+ return -1;
+
+ return 0;
+}
+
+int embed_cuda_encode_batch(embed_cuda_ctx_t *ctx,
+ const embed_input_t *inputs,
+ int batch,
+ float *out_embeddings) {
+ if (!ctx || !inputs || batch <= 0 || !out_embeddings)
+ return -1;
+ const embed_config_t *c = &ctx->config;
+ if (cuda_forward_batch(ctx, inputs, batch) != 0)
+ return -1;
+ if (ensure_pooled_rows(ctx, batch) != 0)
+ return -1;
+ if (c->pooling_mode == EMBED_POOL_LAST_TOKEN)
+ last_pool_kernel<<<batch, 256, 0, ctx->stream>>>(ctx->pooled_out, ctx->x, ctx->offsets,
+ batch, c->hidden_size);
+ else if (c->pooling_mode == EMBED_POOL_CLS)
+ first_pool_kernel<<<batch, 256, 0, ctx->stream>>>(ctx->pooled_out, ctx->x, ctx->offsets,
+ batch, c->hidden_size);
+ else
+ mean_pool_kernel<<<batch, 256, 0, ctx->stream>>>(ctx->pooled_out, ctx->x, ctx->offsets,
+ batch, c->hidden_size);
+ if (launch_check() != 0)
+ return -1;
+ cudaError_t ce = cudaMemcpyAsync(out_embeddings, ctx->pooled_out,
+ (size_t)batch * c->hidden_size * sizeof(float),
+ cudaMemcpyDeviceToHost, ctx->stream);
+ if (ce == cudaSuccess)
+ ce = cudaStreamSynchronize(ctx->stream);
+ if (ce != cudaSuccess) {
+ fprintf(stderr, "cuda output copy failed: %s\n", cudaGetErrorString(ce));
+ return -1;
+ }
+ if (c->normalize_embeddings) {
+ for (int b = 0; b < batch; b++) {
+ if (embed_l2_normalize(out_embeddings + (size_t)b * c->hidden_size, c->hidden_size) !=
+ 0)
+ return -1;
+ }
+ }
+ return 0;
+}
+
+int embed_cuda_encode_spans_batch(embed_cuda_ctx_t *ctx,
+ const embed_context_input_t *inputs,
+ int batch,
+ float *out_embeddings) {
+ if (!ctx || !inputs || batch <= 0 || !out_embeddings)
+ return -1;
+ const embed_config_t *c = &ctx->config;
+ int total_spans = 0;
+ int total_tokens = 0;
+ for (int b = 0; b < batch; b++) {
+ const embed_context_input_t *input = &inputs[b];
+ int n_tokens = input->input.n_tokens;
+ if (!input->input.ids || n_tokens <= 0 || !input->spans || input->n_spans <= 0 ||
+ total_spans > INT_MAX - input->n_spans || total_tokens > INT_MAX - n_tokens)
+ return -1;
+ for (int s = 0; s < input->n_spans; s++) {
+ int start = input->spans[s].start;
+ int len = input->spans[s].n_tokens;
+ if (start < 0 || len <= 0 || start > n_tokens || len > n_tokens - start)
+ return -1;
+ }
+ total_spans += input->n_spans;
+ total_tokens += n_tokens;
+ }
+
+ embed_input_t *packed = (embed_input_t *)malloc((size_t)batch * sizeof(*packed));
+ int *h_starts = (int *)malloc((size_t)total_spans * sizeof(int));
+ int *h_lens = (int *)malloc((size_t)total_spans * sizeof(int));
+ if (!packed || !h_starts || !h_lens) {
+ free(packed);
+ free(h_starts);
+ free(h_lens);
+ return -1;
+ }
+
+ int token_offset = 0;
+ int span_offset = 0;
+ for (int b = 0; b < batch; b++) {
+ const embed_context_input_t *input = &inputs[b];
+ packed[b] = input->input;
+ for (int s = 0; s < input->n_spans; s++) {
+ h_starts[span_offset] = token_offset + input->spans[s].start;
+ h_lens[span_offset] = input->spans[s].n_tokens;
+ span_offset++;
+ }
+ token_offset += input->input.n_tokens;
+ }
+
+ int rc = -1;
+ cudaError_t ce;
+ if (cuda_forward_batch(ctx, packed, batch) != 0)
+ goto cleanup;
+ if (ensure_pooled_rows(ctx, total_spans) != 0 || ensure_span_buffers(ctx, total_spans) != 0)
+ goto cleanup;
+ ce = cudaMemcpyAsync(ctx->span_starts, h_starts, (size_t)total_spans * sizeof(int),
+ cudaMemcpyHostToDevice, ctx->stream);
+ if (ce == cudaSuccess)
+ ce = cudaMemcpyAsync(ctx->span_lens, h_lens, (size_t)total_spans * sizeof(int),
+ cudaMemcpyHostToDevice, ctx->stream);
+ if (ce != cudaSuccess) {
+ fprintf(stderr, "cuda span copy failed: %s\n", cudaGetErrorString(ce));
+ goto cleanup;
+ }
+ span_pool_kernel<<<total_spans, 256, 0, ctx->stream>>>(
+ ctx->pooled_out, ctx->x, ctx->span_starts, ctx->span_lens, total_spans, c->hidden_size);
+ if (launch_check() != 0)
+ goto cleanup;
+ ce = cudaMemcpyAsync(out_embeddings, ctx->pooled_out,
+ (size_t)total_spans * c->hidden_size * sizeof(float),
+ cudaMemcpyDeviceToHost, ctx->stream);
+ if (ce == cudaSuccess)
+ ce = cudaStreamSynchronize(ctx->stream);
+ if (ce != cudaSuccess) {
+ fprintf(stderr, "cuda span output copy failed: %s\n", cudaGetErrorString(ce));
+ goto cleanup;
+ }
+ rc = 0;
+
+cleanup:
+ free(h_lens);
+ free(h_starts);
+ free(packed);
+ return rc;
+}
+
+int embed_cuda_encode_into(embed_cuda_ctx_t *ctx,
+ const int *token_ids,
+ int n_tokens,
+ float *out_embedding) {
+ embed_input_t input = {token_ids, n_tokens};
+ return embed_cuda_encode_batch(ctx, &input, 1, out_embedding);
+}
+
+float *embed_cuda_encode(embed_cuda_ctx_t *ctx, const int *token_ids, int n_tokens) {
+ if (!ctx)
+ return NULL;
+ int hidden = ctx->config.hidden_size;
+ float *out = (float *)malloc((size_t)hidden * sizeof(float));
+ if (!out)
+ return NULL;
+ if (embed_cuda_encode_into(ctx, token_ids, n_tokens, out) != 0) {
+ free(out);
+ return NULL;
+ }
+ return out;
+}
+
+/* ========================================================================
+ * Late-interaction CUDA path
+ *
+ * The transformer forward and the 1_Dense projection run on the GPU; MaxSim
+ * scoring stays on the host, where the grouped-GEMM scorer is far faster than a
+ * device graph for this small op. So the encoders copy the projected token
+ * vectors back to host memory and the caller runs embed_late_maxsim_batch there.
+ * ======================================================================== */
+
+struct embed_cuda_late_ctx {
+ embed_cuda_ctx_t *base; // device base model; does not own its CPU model
+ embed_late_model_t *cpu_late; // owns the CPU base model + projection host data
+ cuda_matrix_t projection; // device [token_dim, hidden]
+ float *proj_dev; // device scratch [total_tokens, token_dim], grown on demand
+ size_t proj_cap; // capacity of proj_dev in floats
+ int token_dim;
+};
+
+embed_cuda_late_ctx_t *embed_cuda_late_load(const char *model_dir) {
+ embed_late_model_t *cpu_late = embed_late_model_load(model_dir);
+ if (!cpu_late)
+ return NULL;
+
+ embed_cuda_late_ctx_t *ctx = (embed_cuda_late_ctx_t *)calloc(1, sizeof(*ctx));
+ if (!ctx) {
+ embed_late_model_free(cpu_late);
+ return NULL;
+ }
+ ctx->cpu_late = cpu_late;
+ ctx->token_dim = embed_late_model_token_dim(cpu_late);
+
+ // Upload the base transformer weights; the CPU late model keeps ownership.
+ ctx->base = cuda_ctx_from_model(embed_late_model_base(cpu_late), 0);
+ if (!ctx->base) {
+ embed_cuda_late_free(ctx);
+ return NULL;
+ }
+
+ // Upload the 1_Dense projection [token_dim, hidden].
+ const embed_weight_ref_t *proj = embed_late_model_projection(cpu_late);
+ if (!proj || ctx->token_dim <= 0 ||
+ load_matrix(&ctx->projection, proj, ctx->token_dim, ctx->base->config.hidden_size) != 0) {
+ embed_cuda_late_free(ctx);
+ return NULL;
+ }
+ return ctx;
+}
+
+void embed_cuda_late_free(embed_cuda_late_ctx_t *ctx) {
+ if (!ctx)
+ return;
+ cuda_matrix_free(&ctx->projection);
+ cudaFree(ctx->proj_dev);
+ embed_cuda_free(ctx->base); // own_cpu = 0, so this keeps the CPU model
+ embed_late_model_free(ctx->cpu_late); // frees the CPU base model + projection
+ free(ctx);
+}
+
+const embed_config_t *embed_cuda_late_config(const embed_cuda_late_ctx_t *ctx) {
+ return ctx ? &ctx->base->config : NULL;
+}
+
+int embed_cuda_late_token_dim(const embed_cuda_late_ctx_t *ctx) { return ctx ? ctx->token_dim : 0; }
+
+static int ensure_late_proj(embed_cuda_late_ctx_t *ctx, int total) {
+ size_t need = (size_t)total * (size_t)ctx->token_dim;
+ if (need <= ctx->proj_cap)
+ return 0;
+ cudaFree(ctx->proj_dev);
+ ctx->proj_dev = NULL;
+ ctx->proj_cap = 0;
+ if (cudaMalloc((void **)&ctx->proj_dev, need * sizeof(float)) != cudaSuccess)
+ return -1;
+ ctx->proj_cap = need;
+ return 0;
+}
+
+/* Forward all inputs, project every token to token_dim, and copy the packed
+ * [total, token_dim] F32 result to a freshly malloc'd host buffer (caller frees).
+ * On success *proj_host and *total_out are set; base->offsets_host holds the
+ * packed per-document token offsets. */
+static int cuda_late_forward_project(embed_cuda_late_ctx_t *ctx,
+ const embed_input_t *inputs,
+ int n_docs,
+ float **proj_host,
+ int *total_out) {
+ embed_cuda_ctx_t *base = ctx->base;
+ const embed_config_t *c = &base->config;
+ if (cuda_forward_batch(base, inputs, n_docs) != 0)
+ return -1;
+ int total = base->offsets_host[n_docs];
+ if (total <= 0 || ensure_late_proj(ctx, total) != 0)
+ return -1;
+ if (linear(base, &ctx->projection, base->x, ctx->proj_dev, total, c->hidden_size,
+ ctx->token_dim) != 0)
+ return -1;
+ float *host = (float *)malloc((size_t)total * (size_t)ctx->token_dim * sizeof(float));
+ if (!host)
+ return -1;
+ cudaError_t ce =
+ cudaMemcpyAsync(host, ctx->proj_dev, (size_t)total * (size_t)ctx->token_dim * sizeof(float),
+ cudaMemcpyDeviceToHost, base->stream);
+ if (ce == cudaSuccess)
+ ce = cudaStreamSynchronize(base->stream);
+ if (ce != cudaSuccess) {
+ fprintf(stderr, "cuda late output copy failed: %s\n", cudaGetErrorString(ce));
+ free(host);
+ return -1;
+ }
+ *proj_host = host;
+ *total_out = total;
+ return 0;
+}
+
+int embed_cuda_late_encode_tokens(embed_cuda_late_ctx_t *ctx,
+ const int *token_ids,
+ int n_tokens,
+ int normalize,
+ float *out_vectors) {
+ if (!ctx || !token_ids || n_tokens <= 0 || !out_vectors || ctx->token_dim <= 0)
+ return -1;
+ embed_input_t input = {token_ids, n_tokens};
+ float *proj_host = NULL;
+ int total = 0;
+ if (cuda_late_forward_project(ctx, &input, 1, &proj_host, &total) != 0)
+ return -1;
+ memcpy(out_vectors, proj_host, (size_t)total * (size_t)ctx->token_dim * sizeof(float));
+ free(proj_host);
+ if (normalize) {
+ for (int i = 0; i < total; i++)
+ if (embed_l2_normalize(out_vectors + (size_t)i * ctx->token_dim, ctx->token_dim) != 0)
+ return -1;
+ }
+ return 0;
+}
+
+int embed_cuda_late_encode_docs(embed_cuda_late_ctx_t *ctx,
+ const int *const *doc_ids,
+ const int *n_tokens,
+ const int *const *keep,
+ const int *n_keep,
+ int n_docs,
+ int normalize,
+ float *out_vectors,
+ int *out_offsets) {
+ if (!ctx || !doc_ids || !n_tokens || !keep || !n_keep || n_docs <= 0 || !out_vectors ||
+ !out_offsets || ctx->token_dim <= 0)
+ return -1;
+ int dim = ctx->token_dim;
+
+ embed_input_t *inputs = (embed_input_t *)malloc((size_t)n_docs * sizeof(*inputs));
+ if (!inputs)
+ return -1;
+
+ int total_keep = 0;
+ out_offsets[0] = 0;
+ for (int d = 0; d < n_docs; d++) {
+ if (!doc_ids[d] || n_tokens[d] <= 0 || !keep[d] || n_keep[d] <= 0 ||
+ n_keep[d] > n_tokens[d] || total_keep > INT_MAX - n_keep[d]) {
+ free(inputs);
+ return -1;
+ }
+ for (int k = 0; k < n_keep[d]; k++) {
+ if (keep[d][k] < 0 || keep[d][k] >= n_tokens[d]) {
+ free(inputs);
+ return -1;
+ }
+ }
+ inputs[d].ids = doc_ids[d];
+ inputs[d].n_tokens = n_tokens[d];
+ total_keep += n_keep[d];
+ out_offsets[d + 1] = total_keep;
+ }
+
+ float *proj_host = NULL;
+ int total = 0;
+ if (cuda_late_forward_project(ctx, inputs, n_docs, &proj_host, &total) != 0) {
+ free(inputs);
+ return -1;
+ }
+
+ /* Gather each document's kept token rows (in packed forward order) into the
+ * output, the layout MaxSim consumes - matching the CPU/MLX paths. */
+ const int *off = ctx->base->offsets_host;
+ int pos = 0;
+ for (int d = 0; d < n_docs; d++) {
+ int start = off[d];
+ for (int k = 0; k < n_keep[d]; k++) {
+ memcpy(out_vectors + (size_t)pos * dim, proj_host + (size_t)(start + keep[d][k]) * dim,
+ (size_t)dim * sizeof(float));
+ pos++;
+ }
+ }
+ free(proj_host);
+ free(inputs);
+
+ if (normalize) {
+ for (int i = 0; i < total_keep; i++)
+ if (embed_l2_normalize(out_vectors + (size_t)i * dim, dim) != 0)
+ return -1;
+ }
+ return 0;
+}
diff --git a/src/cuda.h b/src/cuda.h
new file mode 100644
index 0000000..aad20ab
--- /dev/null
+++ b/src/cuda.h
@@ -0,0 +1,80 @@
+/*
+ * embed_cuda.h - CUDA/cuBLAS backend
+ */
+
+#ifndef EMBED_CUDA_H
+#define EMBED_CUDA_H
+
+/* Public-API export annotation. The libraries are built with
+ * -fvisibility=hidden, so only declarations carrying EMBED_API are exported
+ * from the shared library; everything else stays internal. */
+#ifndef EMBED_API
+#if defined(__GNUC__)
+#define EMBED_API __attribute__((visibility("default")))
+#else
+#define EMBED_API
+#endif
+#endif
+
+#include "embed.h"
+
+typedef struct embed_cuda_ctx embed_cuda_ctx_t;
+typedef struct embed_cuda_late_ctx embed_cuda_late_ctx_t;
+
+EMBED_API int embed_cuda_set_fast_gemm(const char *mode);
+EMBED_API int embed_cuda_set_weights_bf16(int on);
+
+EMBED_API embed_cuda_ctx_t *embed_cuda_load(const char *model_dir);
+EMBED_API void embed_cuda_free(embed_cuda_ctx_t *ctx);
+
+/*
+ * Late-interaction CUDA path. Encoding (transformer forward + projection) runs
+ * on the GPU; MaxSim scoring stays on the host, where the grouped-GEMM scorer is
+ * much faster than a device graph for this small op. The encoders therefore copy
+ * the projected token vectors back to host memory.
+ */
+EMBED_API embed_cuda_late_ctx_t *embed_cuda_late_load(const char *model_dir);
+EMBED_API void embed_cuda_late_free(embed_cuda_late_ctx_t *ctx);
+EMBED_API const embed_config_t *embed_cuda_late_config(const embed_cuda_late_ctx_t *ctx);
+EMBED_API int embed_cuda_late_token_dim(const embed_cuda_late_ctx_t *ctx);
+
+/* Encode token_ids into out_vectors[n_tokens, token_dim] (host). */
+EMBED_API int embed_cuda_late_encode_tokens(embed_cuda_late_ctx_t *ctx,
+ const int *token_ids,
+ int n_tokens,
+ int normalize,
+ float *out_vectors);
+
+/*
+ * Encode n_docs documents in one packed forward and pack each document's kept
+ * token vectors back-to-back into out_vectors[total_keep, token_dim] (host) in
+ * document order. out_offsets[n_docs + 1] receives the prefix sum of kept counts
+ * (the layout embed_late_maxsim_batch consumes). Returns 0 on success.
+ */
+EMBED_API int embed_cuda_late_encode_docs(embed_cuda_late_ctx_t *ctx,
+ const int *const *doc_ids,
+ const int *n_tokens,
+ const int *const *keep,
+ const int *n_keep,
+ int n_docs,
+ int normalize,
+ float *out_vectors,
+ int *out_offsets);
+
+EMBED_API const embed_config_t *embed_cuda_config(const embed_cuda_ctx_t *ctx);
+
+EMBED_API int embed_cuda_encode_into(embed_cuda_ctx_t *ctx,
+ const int *token_ids,
+ int n_tokens,
+ float *out_embedding);
+EMBED_API float *embed_cuda_encode(embed_cuda_ctx_t *ctx, const int *token_ids, int n_tokens);
+EMBED_API int embed_cuda_encode_batch(embed_cuda_ctx_t *ctx,
+ const embed_input_t *inputs,
+ int batch,
+ float *out_embeddings);
+EMBED_API int embed_cuda_encode_spans_batch(embed_cuda_ctx_t *ctx,
+ const embed_context_input_t *inputs,
+ int batch,
+ float *out_embeddings);
+
+#endif /* EMBED_CUDA_H */
diff --git a/src/embed.c b/src/embed.c
new file mode 100644
index 0000000..f482c95
--- /dev/null
+++ b/src/embed.c
@@ -0,0 +1,1814 @@
+#include "embed.h"
+#include "config.h"
+#include "internal.h"
+#include "kernels.h"
+#include "safetensors.h"
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <math.h>
+#include <limits.h>
+#include <float.h>
+
+struct embed_late_model {
+ embed_model_t *base;
+ safetensors_file_t *dense_sf;
+ embed_weight_ref_t projection; /* [token_dim, hidden] */
+ int token_dim;
+};
+
+struct embed_late_workspace {
+ const embed_late_model_t *model;
+ embed_workspace_t *base_ws;
+ float *states;
+ int states_seq_cap;
+};
+
+/* ========================================================================
+ * Globals
+ * ======================================================================== */
+
+int embed_verbose = 0;
+
+#define EMBED_BF16_QKV_FUSE_MAX_SEQ 16
+#define EMBED_BF16_PAIR_FUSE_MAX_SEQ 4
+#define EMBED_MIN_WORKSPACE_SEQ_CAP 16
+#define EMBED_WORKSPACE_SEQ_GRANULARITY 16
+
+/* ========================================================================
+ * Size helpers
+ * ======================================================================== */
+
+static int mul_size(size_t a, size_t b, size_t *out) {
+ if (a != 0 && b > SIZE_MAX / a)
+ return -1;
+ *out = a * b;
+ return 0;
+}
+
+static int add_size(size_t a, size_t b, size_t *out) {
+ if (b > SIZE_MAX - a)
+ return -1;
+ *out = a + b;
+ return 0;
+}
+
+static int grow_cap(int current, int needed, int *out) {
+ if (needed <= 0)
+ return -1;
+
+ int cap = needed;
+ if (cap < EMBED_MIN_WORKSPACE_SEQ_CAP)
+ cap = EMBED_MIN_WORKSPACE_SEQ_CAP;
+
+ int rem = cap % EMBED_WORKSPACE_SEQ_GRANULARITY;
+ if (rem != 0) {
+ int add = EMBED_WORKSPACE_SEQ_GRANULARITY - rem;
+ if (cap > INT_MAX - add)
+ return -1;
+ cap += add;
+ }
+
+ if (cap < current)
+ cap = current;
+
+ *out = cap;
+ return 0;
+}
+
+static int realloc_floats(float **ptr, size_t count) {
+ size_t bytes;
+ if (mul_size(count, sizeof(float), &bytes) != 0)
+ return -1;
+
+ void *p = realloc(*ptr, bytes);
+ if (!p && bytes != 0)
+ return -1;
+ *ptr = (float *)p;
+ return 0;
+}
+
+static float *malloc_floats(size_t count) {
+ size_t bytes;
+ if (mul_size(count, sizeof(float), &bytes) != 0)
+ return NULL;
+ return (float *)malloc(bytes);
+}
+
+static int model_dir_has_file(const char *model_dir, const char *rel) {
+ char path[1024];
+ int n = snprintf(path, sizeof(path), "%s/%s", model_dir, rel);
+ if (n < 0 || (size_t)n >= sizeof(path))
+ return 0;
+ FILE *f = fopen(path, "rb");
+ if (!f)
+ return 0;
+ fclose(f);
+ return 1;
+}
+
+static int model_dir_has_late_projection(const char *model_dir) {
+ return model_dir_has_file(model_dir, "1_Dense/config.json") &&
+ model_dir_has_file(model_dir, "1_Dense/model.safetensors");
+}
+
+static int realloc_floats_2d(float **ptr, int rows, int cols) {
+ if (rows < 0 || cols < 0)
+ return -1;
+
+ size_t count;
+ if (mul_size((size_t)rows, (size_t)cols, &count) != 0)
+ return -1;
+ return realloc_floats(ptr, count);
+}
+
+static int ensure_late_state_buffer(embed_late_workspace_t *ws, int n_tokens) {
+ if (!ws || !ws->model || n_tokens <= 0)
+ return -1;
+ if (n_tokens <= ws->states_seq_cap)
+ return 0;
+ int hidden = ws->model->base->config.hidden_size;
+ if (realloc_floats_2d(&ws->states, n_tokens, hidden) != 0)
+ return -1;
+ ws->states_seq_cap = n_tokens;
+ return 0;
+}
+
+static int realloc_ints(int **ptr, size_t count) {
+ size_t bytes;
+ if (mul_size(count, sizeof(int), &bytes) != 0)
+ return -1;
+
+ void *p = realloc(*ptr, bytes);
+ if (!p && bytes != 0)
+ return -1;
+ *ptr = (int *)p;
+ return 0;
+}
+
+/* ========================================================================
+ * Weight loading (direct mmap pointers into safetensors)
+ * ======================================================================== */
+
+static size_t dtype_size(safetensor_dtype_t dtype) {
+ switch (dtype) {
+ case DTYPE_F32:
+ return sizeof(float);
+ case DTYPE_BF16:
+ return sizeof(uint16_t);
+ default:
+ return 0;
+ }
+}
+
+static const char *dtype_name(safetensor_dtype_t dtype) {
+ switch (dtype) {
+ case DTYPE_F32:
+ return "F32";
+ case DTYPE_F16:
+ return "F16";
+ case DTYPE_BF16:
+ return "BF16";
+ case DTYPE_I32:
+ return "I32";
+ case DTYPE_I64:
+ return "I64";
+ case DTYPE_BOOL:
+ return "BOOL";
+ default:
+ return "UNKNOWN";
+ }
+}
+
+static int tensor_has_supported_shape(const safetensors_file_t *sf,
+ const safetensor_t *t,
+ const char *name,
+ const int64_t *shape,
+ int ndim,
+ int bf16_ok) {
+ if (t->dtype != DTYPE_F32 && !(bf16_ok && t->dtype == DTYPE_BF16)) {
+ fprintf(stderr, "embed: unsupported dtype for %s: got %s, expected %s\n", name,
+ dtype_name(t->dtype), bf16_ok ? "F32 or BF16" : "F32");
+ return 0;
+ }
+ if (t->ndim != ndim) {
+ fprintf(stderr, "embed: bad rank for %s: got %d, expected %d\n", name, t->ndim, ndim);
+ return 0;
+ }
+
+ size_t numel = 1;
+ for (int i = 0; i < ndim; i++) {
+ if (t->shape[i] != shape[i]) {
+ fprintf(stderr,
+ "embed: bad shape for %s at dim %d: "
+ "got %lld, expected %lld\n",
+ name, i, (long long)t->shape[i], (long long)shape[i]);
+ return 0;
+ }
+ if (shape[i] < 0 || (uint64_t)shape[i] > SIZE_MAX / numel) {
+ fprintf(stderr, "embed: shape too large for %s\n", name);
+ return 0;
+ }
+ numel *= (size_t)shape[i];
+ }
+
+ size_t elem_size = dtype_size(t->dtype);
+ if (elem_size == 0) {
+ fprintf(stderr, "embed: unsupported dtype for %s: got %s\n", name, dtype_name(t->dtype));
+ return 0;
+ }
+
+ size_t bytes;
+ if (mul_size(numel, elem_size, &bytes) != 0) {
+ fprintf(stderr, "embed: tensor data too large for %s\n", name);
+ return 0;
+ }
+ if (t->data_size != bytes) {
+ fprintf(stderr, "embed: bad data size for %s: got %zu, expected %zu\n", name, t->data_size,
+ bytes);
+ return 0;
+ }
+
+ size_t data_start = 8 + sf->header_size;
+ if (data_start > sf->file_size || t->data_offset > sf->file_size - data_start ||
+ t->data_size > sf->file_size - data_start - t->data_offset) {
+ fprintf(stderr, "embed: tensor data out of bounds for %s\n", name);
+ return 0;
+ }
+ return 1;
+}
+
+static embed_weight_ref_t
+load_weight_direct(multi_safetensors_t *ms, const char *name, const int64_t *shape, int ndim) {
+ embed_weight_ref_t ref = {DTYPE_UNKNOWN, NULL};
+ safetensors_file_t *sf = NULL;
+ const safetensor_t *t = multi_safetensors_find(ms, name, &sf);
+ if (!t) {
+ fprintf(stderr, "embed: tensor not found: %s\n", name);
+ return ref;
+ }
+ if (!tensor_has_supported_shape(sf, t, name, shape, ndim, 1))
+ return ref;
+
+ ref.dtype = t->dtype;
+ ref.data = safetensors_data(sf, t);
+ return ref;
+}
+
+static float *
+load_norm_f32(multi_safetensors_t *ms, const char *name, const int64_t *shape, int ndim) {
+ safetensors_file_t *sf = NULL;
+ const safetensor_t *t = multi_safetensors_find(ms, name, &sf);
+ if (!t) {
+ fprintf(stderr, "embed: tensor not found: %s\n", name);
+ return NULL;
+ }
+ if (!tensor_has_supported_shape(sf, t, name, shape, ndim, 1))
+ return NULL;
+ return safetensors_get_f32(sf, t);
+}
+
+static void bf16_row_to_f32(float *dst, const uint16_t *src, int n) {
+ for (int i = 0; i < n; i++) {
+ uint32_t u = ((uint32_t)src[i]) << 16;
+ memcpy(dst + i, &u, sizeof(float));
+ }
+}
+
+static void copy_weight_row(float *dst, const embed_weight_ref_t *w, size_t row, int row_width) {
+ if (w->dtype == DTYPE_F32) {
+ const float *src = (const float *)w->data + row * (size_t)row_width;
+ memcpy(dst, src, (size_t)row_width * sizeof(float));
+ } else {
+ const uint16_t *src = (const uint16_t *)w->data + row * (size_t)row_width;
+ bf16_row_to_f32(dst, src, row_width);
+ }
+}
+
+static int ensure_bf16_widen(embed_workspace_t *ws, size_t count) {
+ if (ws->bf16_widen_count >= count)
+ return 0;
+ float *p = (float *)realloc(ws->bf16_widen, count * sizeof(float));
+ if (!p)
+ return -1;
+ ws->bf16_widen = p;
+ ws->bf16_widen_count = count;
+ return 0;
+}
+
+static void linear_nobias_weight(embed_workspace_t *ws,
+ float *y,
+ const float *x,
+ const embed_weight_ref_t *w,
+ int seq_len,
+ int in_dim,
+ int out_dim) {
+ if (w->dtype == DTYPE_F32) {
+ embed_linear_nobias(y, x, (const float *)w->data, seq_len, in_dim, out_dim);
+ return;
+ }
+ if (seq_len > 16) {
+ /* Widen the weight matrix once into workspace scratch and use the
+ * BLAS-backed F32 path; below that the fused BF16 row kernels win. */
+ size_t count = (size_t)out_dim * (size_t)in_dim;
+ if (ensure_bf16_widen(ws, count) == 0) {
+ embed_bf16_to_f32_buf(ws->bf16_widen, (const uint16_t *)w->data, count);
+ embed_linear_nobias(y, x, ws->bf16_widen, seq_len, in_dim, out_dim);
+ return;
+ }
+ }
+ embed_linear_nobias_bf16(y, x, (const uint16_t *)w->data, seq_len, in_dim, out_dim);
+}
+
+static void linear_qkv_weight(embed_workspace_t *ws,
+ float *q,
+ float *k,
+ float *v,
+ const float *x,
+ const embed_weight_ref_t *wq,
+ const embed_weight_ref_t *wk,
+ const embed_weight_ref_t *wv,
+ int seq_len,
+ int in_dim,
+ int q_dim,
+ int kv_dim) {
+ if (wq->dtype == DTYPE_BF16 && wk->dtype == DTYPE_BF16 && wv->dtype == DTYPE_BF16 &&
+ seq_len <= EMBED_BF16_QKV_FUSE_MAX_SEQ) {
+ embed_linear_nobias_bf16_qkv(q, k, v, x, (const uint16_t *)wq->data,
+ (const uint16_t *)wk->data, (const uint16_t *)wv->data, seq_len,
+ in_dim, q_dim, kv_dim);
+ return;
+ }
+
+ linear_nobias_weight(ws, q, x, wq, seq_len, in_dim, q_dim);
+ linear_nobias_weight(ws, k, x, wk, seq_len, in_dim, kv_dim);
+ linear_nobias_weight(ws, v, x, wv, seq_len, in_dim, kv_dim);
+}
+
+static void add_bias_rows(float *x, const float *bias, int rows, int dim) {
+ if (!bias)
+ return;
+ for (int row = 0; row < rows; row++) {
+ float *dst = x + (size_t)row * dim;
+ for (int d = 0; d < dim; d++)
+ dst[d] += bias[d];
+ }
+}
+
+static void linear_pair_weight(embed_workspace_t *ws,
+ float *a,
+ float *b,
+ const float *x,
+ const embed_weight_ref_t *wa,
+ const embed_weight_ref_t *wb,
+ int seq_len,
+ int in_dim,
+ int a_dim,
+ int b_dim) {
+ if (wa->dtype == DTYPE_BF16 && wb->dtype == DTYPE_BF16 &&
+ seq_len <= EMBED_BF16_PAIR_FUSE_MAX_SEQ) {
+ embed_linear_nobias_bf16_pair(a, b, x, (const uint16_t *)wa->data,
+ (const uint16_t *)wb->data, seq_len, in_dim, a_dim, b_dim);
+ return;
+ }
+
+ linear_nobias_weight(ws, a, x, wa, seq_len, in_dim, a_dim);
+ linear_nobias_weight(ws, b, x, wb, seq_len, in_dim, b_dim);
+}
+
+/* ========================================================================
+ * Working buffer management
+ * ======================================================================== */
+
+static int ensure_buffers(embed_workspace_t *ws, const embed_config_t *c, int seq) {
+ if (seq <= ws->buf_seq_cap)
+ return 0;
+
+ int cap;
+ if (grow_cap(ws->buf_seq_cap, seq, &cap) != 0)
+ return -1;
+
+#define R(ptr, n) \
+ do { \
+ if (realloc_floats_2d(&(ptr), cap, (n)) != 0) \
+ return -1; \
+ } while (0)
+
+ R(ws->x, c->hidden_size);
+ R(ws->x_norm, c->hidden_size);
+ R(ws->q, c->q_dim);
+ R(ws->k, c->kv_dim);
+ R(ws->v, c->kv_dim);
+ R(ws->attn_out, c->q_dim);
+ R(ws->proj_out, c->hidden_size);
+ R(ws->ffn_gate, c->intermediate_size);
+ R(ws->ffn_up, c->intermediate_size);
+
+#undef R
+
+ ws->buf_seq_cap = cap;
+ return 0;
+}
+
+static void ensure_attention_scores(embed_workspace_t *ws, const int *offsets, int batch) {
+ size_t bytes = embed_bidirectional_gqa_attention_packed_scratch_bytes(offsets, batch);
+ if (bytes <= ws->attn_scores_bytes)
+ return;
+
+ void *p = realloc(ws->attn_scores, bytes);
+ if (!p)
+ return;
+ ws->attn_scores = (float *)p;
+ ws->attn_scores_bytes = bytes;
+}
+
+/* ========================================================================
+ * RoPE cache
+ * ======================================================================== */
+
+static int ensure_rope_cache(embed_workspace_t *ws, const embed_config_t *cfg, int n_pos) {
+ if (n_pos <= ws->rope_cache_cap)
+ return 0;
+
+ int cap = ws->rope_cache_cap > 0 ? ws->rope_cache_cap : 512;
+ while (cap < n_pos) {
+ if (cap > INT_MAX / 2)
+ return -1;
+ cap *= 2;
+ }
+
+ int head_dim = cfg->head_dim;
+ int half = head_dim / 2;
+ float theta = cfg->rope_theta;
+
+ size_t count;
+ if (mul_size((size_t)cap, (size_t)head_dim, &count) != 0)
+ return -1;
+ if (realloc_floats(&ws->rope_cos, count) != 0)
+ return -1;
+ if (realloc_floats(&ws->rope_sin, count) != 0)
+ return -1;
+
+ for (int pos = ws->rope_cache_cap; pos < cap; pos++) {
+ float fp = (float)pos;
+ float *c = ws->rope_cos + (size_t)pos * head_dim;
+ float *s = ws->rope_sin + (size_t)pos * head_dim;
+ for (int d = 0; d < half; d++) {
+ float inv = 1.0f / powf(theta, (float)(2 * d) / (float)head_dim);
+ float angle = fp * inv;
+ float cv = cosf(angle), sv = sinf(angle);
+ c[d] = cv;
+ c[half + d] = cv;
+ s[d] = sv;
+ s[half + d] = sv;
+ }
+ }
+
+ ws->rope_cache_cap = cap;
+ return 0;
+}
+
+static int ensure_offsets(embed_workspace_t *ws, int batch) {
+ if (!ws || batch <= 0 || batch == INT_MAX)
+ return -1;
+
+ int needed = batch + 1;
+ if (needed <= ws->offsets_cap)
+ return 0;
+
+ if (realloc_ints(&ws->offsets, (size_t)needed) != 0)
+ return -1;
+ ws->offsets_cap = needed;
+ return 0;
+}
+
+/* ========================================================================
+ * Model / workspace load and free
+ * ======================================================================== */
+
+/* BERT-family weight loader. The tensor names differ entirely from the Qwen
+ * block (encoder.layer.N.*, embeddings.*), so the family gets its own entry
+ * point. Reused embed_layer_t slots carry their BERT meaning: wo is the
+ * attention output dense, input_norm/post_attn_norm are the two block LayerNorm
+ * weights, up_proj/down_proj are the two FFN matrices (see embed_internal.h). */
+static int
+load_bert_weights(embed_model_t *model, multi_safetensors_t *ms, int layer_start, int layer_end) {
+ const embed_config_t *cfg = &model->config;
+ embed_weights_t *w = &model->weights;
+ char name[256];
+
+ /* sentence-transformers checkpoints store the BERT submodule unprefixed;
+ * raw HF checkpoints prefix every tensor with "bert.". */
+ const char *p;
+ if (multi_safetensors_find(ms, "embeddings.word_embeddings.weight", NULL))
+ p = "";
+ else if (multi_safetensors_find(ms, "bert.embeddings.word_embeddings.weight", NULL))
+ p = "bert.";
+ else {
+ fprintf(stderr, "embed_model_load: BERT word embeddings not found\n");
+ return -1;
+ }
+
+ int hidden = cfg->hidden_size, inter = cfg->intermediate_size;
+
+ if (layer_start == 0) {
+ const int64_t emb_shape[2] = {cfg->vocab_size, hidden};
+ snprintf(name, sizeof(name), "%sembeddings.word_embeddings.weight", p);
+ w->embed_tokens = load_weight_direct(ms, name, emb_shape, 2);
+ const int64_t pos_shape[2] = {cfg->max_position_embeddings, hidden};
+ snprintf(name, sizeof(name), "%sembeddings.position_embeddings.weight", p);
+ w->position_embeddings = load_norm_f32(ms, name, pos_shape, 2);
+ const int64_t type_shape[2] = {2, hidden};
+ snprintf(name, sizeof(name), "%sembeddings.token_type_embeddings.weight", p);
+ w->token_type_embeddings = load_norm_f32(ms, name, type_shape, 2);
+ const int64_t ln_shape[1] = {hidden};
+ snprintf(name, sizeof(name), "%sembeddings.LayerNorm.weight", p);
+ w->embed_ln_w = load_norm_f32(ms, name, ln_shape, 1);
+ snprintf(name, sizeof(name), "%sembeddings.LayerNorm.bias", p);
+ w->embed_ln_b = load_norm_f32(ms, name, ln_shape, 1);
+ if (!w->embed_tokens.data || !w->position_embeddings || !w->token_type_embeddings ||
+ !w->embed_ln_w || !w->embed_ln_b)
+ return -1;
+ }
+
+ w->layers = (embed_layer_t *)calloc(cfg->n_layers, sizeof(embed_layer_t));
+ if (!w->layers)
+ return -1;
+
+ for (int i = layer_start; i < layer_end; i++) {
+ embed_layer_t *l = &w->layers[i];
+
+#define BERT_W(field, suffix, d0, d1) \
+ do { \
+ const int64_t e[2] = {(d0), (d1)}; \
+ snprintf(name, sizeof(name), "%sencoder.layer.%d." suffix, p, i); \
+ l->field = load_weight_direct(ms, name, e, 2); \
+ if (!l->field.data) \
+ return -1; \
+ } while (0)
+#define BERT_V(field, suffix, d0) \
+ do { \
+ const int64_t e[1] = {(d0)}; \
+ snprintf(name, sizeof(name), "%sencoder.layer.%d." suffix, p, i); \
+ l->field = load_norm_f32(ms, name, e, 1); \
+ if (!l->field) \
+ return -1; \
+ } while (0)
+
+ BERT_W(wq, "attention.self.query.weight", hidden, hidden);
+ BERT_V(q_bias, "attention.self.query.bias", hidden);
+ BERT_W(wk, "attention.self.key.weight", hidden, hidden);
+ BERT_V(k_bias, "attention.self.key.bias", hidden);
+ BERT_W(wv, "attention.self.value.weight", hidden, hidden);
+ BERT_V(v_bias, "attention.self.value.bias", hidden);
+ BERT_W(wo, "attention.output.dense.weight", hidden, hidden);
+ BERT_V(o_bias, "attention.output.dense.bias", hidden);
+ BERT_V(input_norm, "attention.output.LayerNorm.weight", hidden);
+ BERT_V(attn_ln_bias, "attention.output.LayerNorm.bias", hidden);
+ BERT_W(up_proj, "intermediate.dense.weight", inter, hidden);
+ BERT_V(ffn_inter_bias, "intermediate.dense.bias", inter);
+ BERT_W(down_proj, "output.dense.weight", hidden, inter);
+ BERT_V(ffn_out_bias, "output.dense.bias", hidden);
+ BERT_V(post_attn_norm, "output.LayerNorm.weight", hidden);
+ BERT_V(ffn_ln_bias, "output.LayerNorm.bias", hidden);
+
+#undef BERT_W
+#undef BERT_V
+ }
+ /* BERT has no final norm: w->norm stays NULL, and pooling skips it. */
+ return 0;
+}
+
+static embed_model_t *
+model_load_range_ex(const char *model_dir, int layer_start, int layer_end, int allow_late) {
+ if (!allow_late && model_dir_has_late_projection(model_dir)) {
+ fprintf(stderr, "embed_model_load: late-interaction models require "
+ "token-level MaxSim support and are not valid pooled "
+ "embedding models yet\n");
+ return NULL;
+ }
+
+ embed_model_t *model = (embed_model_t *)calloc(1, sizeof(embed_model_t));
+ if (!model)
+ return NULL;
+
+ /* Parse config.json */
+ if (embed_config_parse(&model->config, model_dir) != 0) {
+ free(model);
+ return NULL;
+ }
+
+ const embed_config_t *cfg = &model->config;
+ if (layer_end == -1)
+ layer_end = cfg->n_layers;
+ if (layer_start < 0 || layer_start >= layer_end || layer_end > cfg->n_layers) {
+ fprintf(stderr,
+ "embed_model_load: invalid layer range [%d, %d) "
+ "for %d-layer model\n",
+ layer_start, layer_end, cfg->n_layers);
+ free(model);
+ return NULL;
+ }
+ model->layer_start = layer_start;
+ model->layer_end = layer_end;
+ model->attention = cfg->attention_mode == EMBED_ATTENTION_CAUSAL
+ ? embed_causal_gqa_attention_packed_with_scratch
+ : embed_bidirectional_gqa_attention_packed_with_scratch;
+
+ /* Open safetensors (handles single file or multi-shard) */
+ multi_safetensors_t *ms = multi_safetensors_open(model_dir);
+ if (!ms) {
+ fprintf(stderr, "embed_model_load: failed to open safetensors in %s\n", model_dir);
+ free(model);
+ return NULL;
+ }
+ model->safetensors = ms;
+
+ if (cfg->family == EMBED_FAMILY_BERT) {
+ if (load_bert_weights(model, ms, layer_start, layer_end) != 0)
+ goto fail;
+ if (embed_verbose >= 1)
+ fprintf(stderr, "embed_model_load: BERT layers [%d, %d) loaded (%d-dim)\n", layer_start,
+ layer_end, cfg->hidden_size);
+ return model;
+ }
+
+ const char *weight_prefix = multi_safetensors_weight_prefix(ms, "embed_tokens.weight");
+ if (!weight_prefix) {
+ fprintf(stderr, "embed_model_load: neither embed_tokens.weight nor "
+ "model.embed_tokens.weight was found\n");
+ goto fail;
+ }
+
+ if (embed_verbose >= 1)
+ fprintf(stderr, "embed_model_load: loading weights from %s\n", model_dir);
+
+ char name[256];
+
+ /* Only the first stage needs token embeddings. */
+ embed_weights_t *w = &model->weights;
+ if (layer_start == 0) {
+ const int64_t embed_shape[2] = {cfg->vocab_size, cfg->hidden_size};
+ snprintf(name, sizeof(name), "%sembed_tokens.weight", weight_prefix);
+ w->embed_tokens = load_weight_direct(ms, name, embed_shape, 2);
+ if (!w->embed_tokens.data)
+ goto fail;
+ }
+
+ /* Allocate layer array */
+ w->layers = (embed_layer_t *)calloc(cfg->n_layers, sizeof(embed_layer_t));
+ if (!w->layers)
+ goto fail;
+
+ /* Per-layer weights */
+ for (int i = layer_start; i < layer_end; i++) {
+ embed_layer_t *l = &w->layers[i];
+
+#define LOAD_NORM(field, fmt, d0) \
+ do { \
+ const int64_t expect[1] = {(d0)}; \
+ snprintf(name, sizeof(name), fmt, weight_prefix, i); \
+ l->field = load_norm_f32(ms, name, expect, 1); \
+ if (!l->field) \
+ goto fail; \
+ } while (0)
+
+#define LOAD2(field, fmt, d0, d1) \
+ do { \
+ const int64_t expect[2] = {(d0), (d1)}; \
+ snprintf(name, sizeof(name), fmt, weight_prefix, i); \
+ l->field = load_weight_direct(ms, name, expect, 2); \
+ if (!l->field.data) \
+ goto fail; \
+ } while (0)
+
+ LOAD2(wq, "%slayers.%d.self_attn.q_proj.weight", cfg->q_dim, cfg->hidden_size);
+ LOAD2(wk, "%slayers.%d.self_attn.k_proj.weight", cfg->kv_dim, cfg->hidden_size);
+ LOAD2(wv, "%slayers.%d.self_attn.v_proj.weight", cfg->kv_dim, cfg->hidden_size);
+ LOAD2(wo, "%slayers.%d.self_attn.o_proj.weight", cfg->hidden_size, cfg->q_dim);
+ if (cfg->qkv_bias) {
+ LOAD_NORM(q_bias, "%slayers.%d.self_attn.q_proj.bias", cfg->q_dim);
+ LOAD_NORM(k_bias, "%slayers.%d.self_attn.k_proj.bias", cfg->kv_dim);
+ LOAD_NORM(v_bias, "%slayers.%d.self_attn.v_proj.bias", cfg->kv_dim);
+ }
+ if (cfg->qk_norm) {
+ LOAD_NORM(q_norm, "%slayers.%d.self_attn.q_norm.weight", cfg->head_dim);
+ LOAD_NORM(k_norm, "%slayers.%d.self_attn.k_norm.weight", cfg->head_dim);
+ }
+ LOAD_NORM(input_norm, "%slayers.%d.input_layernorm.weight", cfg->hidden_size);
+ LOAD_NORM(post_attn_norm, "%slayers.%d.post_attention_layernorm.weight", cfg->hidden_size);
+ LOAD2(gate_proj, "%slayers.%d.mlp.gate_proj.weight", cfg->intermediate_size,
+ cfg->hidden_size);
+ LOAD2(up_proj, "%slayers.%d.mlp.up_proj.weight", cfg->intermediate_size, cfg->hidden_size);
+ LOAD2(down_proj, "%slayers.%d.mlp.down_proj.weight", cfg->hidden_size,
+ cfg->intermediate_size);
+
+#undef LOAD2
+#undef LOAD_NORM
+
+ if (embed_verbose >= 2)
+ fprintf(stderr, " layer %d loaded\n", i);
+ }
+
+ /* Only the final stage applies the output RMSNorm. */
+ if (layer_end == cfg->n_layers) {
+ const int64_t norm_shape[1] = {cfg->hidden_size};
+ snprintf(name, sizeof(name), "%snorm.weight", weight_prefix);
+ w->norm = load_norm_f32(ms, name, norm_shape, 1);
+ if (!w->norm)
+ goto fail;
+ }
+
+ if (embed_verbose >= 1)
+ fprintf(stderr,
+ "embed_model_load: layers [%d, %d) loaded "
+ "(%d-dim embeddings)\n",
+ layer_start, layer_end, cfg->hidden_size);
+
+ return model;
+
+fail:
+ embed_model_free(model);
+ return NULL;
+}
+
+embed_model_t *embed_model_load(const char *model_dir) {
+ return model_load_range_ex(model_dir, 0, -1, 0);
+}
+
+void embed_model_free(embed_model_t *model) {
+ if (!model)
+ return;
+ if (model->weights.layers) {
+ for (int i = 0; i < model->config.n_layers; i++) {
+ embed_layer_t *l = &model->weights.layers[i];
+ free((void *)l->q_bias);
+ free((void *)l->k_bias);
+ free((void *)l->v_bias);
+ free((void *)l->q_norm);
+ free((void *)l->k_norm);
+ free((void *)l->input_norm);
+ free((void *)l->post_attn_norm);
+ free((void *)l->o_bias);
+ free((void *)l->attn_ln_bias);
+ free((void *)l->ffn_inter_bias);
+ free((void *)l->ffn_out_bias);
+ free((void *)l->ffn_ln_bias);
+ }
+ }
+ free((void *)model->weights.norm);
+ free((void *)model->weights.position_embeddings);
+ free((void *)model->weights.token_type_embeddings);
+ free((void *)model->weights.embed_ln_w);
+ free((void *)model->weights.embed_ln_b);
+ if (model->safetensors)
+ multi_safetensors_close((multi_safetensors_t *)model->safetensors);
+ free(model->weights.layers);
+ free(model);
+}
+
+embed_workspace_t *embed_workspace_new(const embed_model_t *model) {
+ if (!model)
+ return NULL;
+ embed_workspace_t *ws = (embed_workspace_t *)calloc(1, sizeof(embed_workspace_t));
+ if (!ws)
+ return NULL;
+ ws->model = model;
+ return ws;
+}
+
+void embed_workspace_free(embed_workspace_t *ws) {
+ if (!ws)
+ return;
+ free(ws->x);
+ free(ws->x_norm);
+ free(ws->q);
+ free(ws->k);
+ free(ws->v);
+ free(ws->attn_out);
+ free(ws->proj_out);
+ free(ws->ffn_gate);
+ free(ws->ffn_up);
+ free(ws->attn_scores);
+ free(ws->offsets);
+ free(ws->rope_cos);
+ free(ws->rope_sin);
+ free(ws->bf16_widen);
+ free(ws);
+}
+
+const embed_config_t *embed_model_config(const embed_model_t *model) {
+ return model ? &model->config : NULL;
+}
+
+static const safetensor_t *find_single_safetensor(const safetensors_file_t *sf, const char *name) {
+ if (!sf || !name)
+ return NULL;
+ for (int i = 0; i < sf->num_tensors; i++) {
+ if (strcmp(sf->tensors[i].name, name) == 0)
+ return &sf->tensors[i];
+ }
+ return NULL;
+}
+
+embed_late_model_t *embed_late_model_load(const char *model_dir) {
+ if (!model_dir_has_late_projection(model_dir)) {
+ fprintf(stderr, "embed_late_model_load: missing 1_Dense projection\n");
+ return NULL;
+ }
+
+ embed_late_model_t *late = (embed_late_model_t *)calloc(1, sizeof(*late));
+ if (!late)
+ return NULL;
+
+ late->base = model_load_range_ex(model_dir, 0, -1, 1);
+ if (!late->base)
+ goto fail;
+
+ char path[1024];
+ int n = snprintf(path, sizeof(path), "%s/1_Dense/model.safetensors", model_dir);
+ if (n < 0 || (size_t)n >= sizeof(path)) {
+ fprintf(stderr, "embed_late_model_load: model path too long\n");
+ goto fail;
+ }
+
+ late->dense_sf = safetensors_open(path);
+ if (!late->dense_sf) {
+ fprintf(stderr, "embed_late_model_load: cannot open %s\n", path);
+ goto fail;
+ }
+
+ const safetensor_t *t = find_single_safetensor(late->dense_sf, "linear.weight");
+ if (!t) {
+ fprintf(stderr, "embed_late_model_load: missing linear.weight\n");
+ goto fail;
+ }
+ if (t->ndim != 2 || t->shape[0] <= 0 || t->shape[0] > INT_MAX) {
+ fprintf(stderr, "embed_late_model_load: bad projection shape\n");
+ goto fail;
+ }
+
+ int64_t shape[2] = {t->shape[0], late->base->config.hidden_size};
+ if (!tensor_has_supported_shape(late->dense_sf, t, "linear.weight", shape, 2, 1))
+ goto fail;
+
+ late->projection.dtype = t->dtype;
+ late->projection.data = safetensors_data(late->dense_sf, t);
+ late->token_dim = (int)t->shape[0];
+ return late;
+
+fail:
+ embed_late_model_free(late);
+ return NULL;
+}
+
+void embed_late_model_free(embed_late_model_t *model) {
+ if (!model)
+ return;
+ embed_model_free(model->base);
+ safetensors_close(model->dense_sf);
+ free(model);
+}
+
+embed_late_workspace_t *embed_late_workspace_new(const embed_late_model_t *model) {
+ if (!model || !model->base)
+ return NULL;
+ embed_late_workspace_t *ws = (embed_late_workspace_t *)calloc(1, sizeof(*ws));
+ if (!ws)
+ return NULL;
+ ws->model = model;
+ ws->base_ws = embed_workspace_new(model->base);
+ if (!ws->base_ws) {
+ free(ws);
+ return NULL;
+ }
+ return ws;
+}
+
+void embed_late_workspace_free(embed_late_workspace_t *ws) {
+ if (!ws)
+ return;
+ embed_workspace_free(ws->base_ws);
+ free(ws->states);
+ free(ws);
+}
+
+const embed_config_t *embed_late_model_config(const embed_late_model_t *model) {
+ return model && model->base ? &model->base->config : NULL;
+}
+
+int embed_late_model_token_dim(const embed_late_model_t *model) {
+ return model ? model->token_dim : 0;
+}
+
+/* Internal (embed_internal.h): expose the base model and projection so GPU
+ * backends can upload them to device without seeing struct embed_late_model. */
+embed_model_t *embed_late_model_base(const embed_late_model_t *model) {
+ return model ? model->base : NULL;
+}
+
+const embed_weight_ref_t *embed_late_model_projection(const embed_late_model_t *model) {
+ return model ? &model->projection : NULL;
+}
+
+int embed_late_model_encode_tokens(const embed_late_model_t *model,
+ embed_late_workspace_t *ws,
+ const int *token_ids,
+ int n_tokens,
+ int normalize,
+ float *out_vectors) {
+ if (!model || !ws || ws->model != model || !token_ids || n_tokens <= 0 || !out_vectors ||
+ model->token_dim <= 0)
+ return -1;
+
+ int hidden = model->base->config.hidden_size;
+ int dim = model->token_dim;
+ if (ensure_late_state_buffer(ws, n_tokens) != 0)
+ return -1;
+ if (embed_model_forward_into(model->base, ws->base_ws, token_ids, n_tokens, ws->states) != 0)
+ return -1;
+
+ linear_nobias_weight(ws->base_ws, out_vectors, ws->states, &model->projection, n_tokens, hidden,
+ dim);
+ if (normalize) {
+ for (int i = 0; i < n_tokens; i++) {
+ if (embed_l2_normalize(out_vectors + (size_t)i * dim, dim) != 0)
+ return -1;
+ }
+ }
+ return 0;
+}
+
+float embed_late_maxsim(const float *query_vectors,
+ int query_tokens,
+ const float *doc_vectors,
+ int doc_tokens,
+ int dim) {
+ if (!query_vectors || !doc_vectors || query_tokens <= 0 || doc_tokens <= 0 || dim <= 0)
+ return 0.0f;
+
+ float score = 0.0f;
+ for (int qi = 0; qi < query_tokens; qi++) {
+ const float *q = query_vectors + (size_t)qi * dim;
+ float best = -FLT_MAX;
+ for (int di = 0; di < doc_tokens; di++) {
+ const float *d = doc_vectors + (size_t)di * dim;
+ float dot = embed_dot_f32(q, d, dim);
+ if (dot > best)
+ best = dot;
+ }
+ score += best;
+ }
+ return score;
+}
+
+int embed_late_maxsim_batch(const float *query_vectors,
+ int query_tokens,
+ const float *doc_vectors,
+ const int *doc_offsets,
+ int docs,
+ int dim,
+ float *scores) {
+ if (!query_vectors || !doc_vectors || !doc_offsets || !scores || query_tokens <= 0 ||
+ docs <= 0 || dim <= 0 || doc_offsets[0] != 0)
+ return -1;
+
+ for (int i = 0; i < docs; i++) {
+ if (doc_offsets[i] < 0 || doc_offsets[i + 1] <= doc_offsets[i])
+ return -1;
+ }
+
+#ifdef USE_BLAS
+ /* One similarity GEMM per group of whole candidates:
+ * S[query_tokens, group_tokens] = Q @ D_group^T, then per-document
+ * row-max plus sum. The group token budget bounds the scratch matrix;
+ * one oversized document still runs alone in a group of its own. */
+ enum { LATE_GROUP_TOKEN_BUDGET = 4096 };
+ int total = doc_offsets[docs];
+ int budget = LATE_GROUP_TOKEN_BUDGET;
+ size_t cap = (size_t)query_tokens * (size_t)(total < budget ? total : budget);
+ int largest = 0;
+ for (int i = 0; i < docs; i++) {
+ int len = doc_offsets[i + 1] - doc_offsets[i];
+ if (len > largest)
+ largest = len;
+ }
+ if ((size_t)query_tokens * (size_t)largest > cap)
+ cap = (size_t)query_tokens * (size_t)largest;
+ float *sim = (float *)malloc(cap * sizeof(float));
+ if (sim) {
+ int doc = 0;
+ while (doc < docs) {
+ int first = doc;
+ int start = doc_offsets[first];
+ doc++;
+ while (doc < docs && doc_offsets[doc + 1] - start <= budget &&
+ doc_offsets[doc + 1] - start <= (int)(cap / (size_t)query_tokens))
+ doc++;
+ int group_tokens = doc_offsets[doc] - start;
+
+ embed_matmul_t(sim, query_vectors, doc_vectors + (size_t)start * dim, query_tokens, dim,
+ group_tokens);
+
+ for (int i = first; i < doc; i++) {
+ int s0 = doc_offsets[i] - start;
+ int s1 = doc_offsets[i + 1] - start;
+ float score = 0.0f;
+ for (int qi = 0; qi < query_tokens; qi++) {
+ const float *row = sim + (size_t)qi * group_tokens;
+ float best = row[s0];
+ for (int t = s0 + 1; t < s1; t++)
+ if (row[t] > best)
+ best = row[t];
+ score += best;
+ }
+ scores[i] = score;
+ }
+ }
+ free(sim);
+ return 0;
+ }
+ /* Allocation failure: fall through to the scalar path. */
+#endif
+
+ for (int i = 0; i < docs; i++) {
+ int start = doc_offsets[i];
+ int end = doc_offsets[i + 1];
+ scores[i] = embed_late_maxsim(query_vectors, query_tokens,
+ doc_vectors + (size_t)start * dim, end - start, dim);
+ }
+ return 0;
+}
+
+size_t embed_workspace_nbytes(const embed_workspace_t *ws) {
+ if (!ws)
+ return 0;
+
+ size_t total = sizeof(*ws);
+ const embed_model_t *model = ws->model;
+ if (!model)
+ return total;
+
+ const embed_config_t *c = &model->config;
+ size_t row_floats = 0;
+ const int dims[] = {
+ c->hidden_size, /* x */
+ c->hidden_size, /* x_norm */
+ c->q_dim, /* q */
+ c->kv_dim, /* k */
+ c->kv_dim, /* v */
+ c->q_dim, /* attn_out */
+ c->hidden_size, /* proj_out */
+ c->intermediate_size, /* ffn_gate */
+ c->intermediate_size, /* ffn_up */
+ };
+
+ for (size_t i = 0; i < sizeof(dims) / sizeof(dims[0]); i++) {
+ if (dims[i] < 0 || add_size(row_floats, (size_t)dims[i], &row_floats) != 0)
+ return SIZE_MAX;
+ }
+
+ size_t buf_floats = 0;
+ if (ws->buf_seq_cap > 0 && mul_size((size_t)ws->buf_seq_cap, row_floats, &buf_floats) != 0)
+ return SIZE_MAX;
+
+ size_t rope_floats = 0;
+ if (ws->rope_cache_cap > 0) {
+ size_t rope_rows = 0;
+ if (mul_size((size_t)ws->rope_cache_cap, (size_t)c->head_dim, &rope_rows) != 0 ||
+ mul_size(rope_rows, 2, &rope_floats) != 0)
+ return SIZE_MAX;
+ }
+
+ size_t all_floats = 0, bytes = 0;
+ if (add_size(buf_floats, rope_floats, &all_floats) != 0 ||
+ mul_size(all_floats, sizeof(float), &bytes) != 0 || add_size(total, bytes, &total) != 0)
+ return SIZE_MAX;
+
+ size_t offset_bytes = 0;
+ if (ws->offsets_cap > 0 && mul_size((size_t)ws->offsets_cap, sizeof(int), &offset_bytes) != 0)
+ return SIZE_MAX;
+ if (add_size(total, offset_bytes, &total) != 0)
+ return SIZE_MAX;
+ if (add_size(total, ws->attn_scores_bytes, &total) != 0)
+ return SIZE_MAX;
+
+ size_t widen_bytes = 0;
+ if (ws->bf16_widen_count > 0 &&
+ mul_size(ws->bf16_widen_count, sizeof(float), &widen_bytes) != 0)
+ return SIZE_MAX;
+ if (add_size(total, widen_bytes, &total) != 0)
+ return SIZE_MAX;
+
+ return total;
+}
+
+/* ========================================================================
+ * Packed forward pass
+ * ======================================================================== */
+
+static int build_offsets(const embed_input_t *inputs,
+ int batch,
+ int require_ids,
+ int *offsets,
+ int *total_out,
+ int *max_out) {
+ if (!inputs || batch <= 0 || !offsets || !total_out || !max_out)
+ return -1;
+
+ int total = 0;
+ int max_seq = 0;
+ for (int b = 0; b < batch; b++) {
+ if ((require_ids && !inputs[b].ids) || inputs[b].n_tokens <= 0)
+ return -1;
+ if (total > INT32_MAX - inputs[b].n_tokens)
+ return -1;
+ offsets[b] = total;
+ total += inputs[b].n_tokens;
+ if (inputs[b].n_tokens > max_seq)
+ max_seq = inputs[b].n_tokens;
+ }
+ offsets[batch] = total;
+ *total_out = total;
+ *max_out = max_seq;
+ return 0;
+}
+
+static int forward_packed_slice_inplace(const embed_model_t *model,
+ embed_workspace_t *ws,
+ const embed_input_t *inputs,
+ int batch,
+ const int *offsets,
+ int total_seq,
+ int max_seq,
+ const float *input_states,
+ int layer_start,
+ int layer_end,
+ int apply_final_norm) {
+ if (!model || !ws || ws->model != model || !inputs || batch <= 0 || !offsets ||
+ total_seq <= 0 || max_seq <= 0)
+ return -1;
+
+ const embed_config_t *cfg = &model->config;
+ const embed_weights_t *w = &model->weights;
+ if (layer_start < 0 || layer_start > layer_end || layer_end > cfg->n_layers ||
+ layer_start < model->layer_start || layer_end > model->layer_end ||
+ (layer_start == 0 && input_states) || (layer_start != 0 && !input_states) ||
+ (layer_start == 0 && !w->embed_tokens.data) ||
+ (apply_final_norm && (layer_end != cfg->n_layers || !w->norm)))
+ return -1;
+
+ int hidden = cfg->hidden_size;
+ int n_heads = cfg->n_heads;
+ int n_kv_heads = cfg->n_kv_heads;
+ int head_dim = cfg->head_dim;
+ int q_dim = cfg->q_dim;
+ int kv_dim = cfg->kv_dim;
+ int inter = cfg->intermediate_size;
+ float eps = cfg->rms_norm_eps;
+
+ if (ensure_buffers(ws, cfg, total_seq) != 0)
+ return -1;
+ if (ensure_rope_cache(ws, cfg, max_seq) != 0)
+ return -1;
+ ensure_attention_scores(ws, offsets, batch);
+
+ const float *rope_cos = ws->rope_cos;
+ const float *rope_sin = ws->rope_sin;
+
+ float *x = ws->x;
+ float *x_norm = ws->x_norm;
+ float *q_buf = ws->q;
+ float *k_buf = ws->k;
+ float *v_buf = ws->v;
+ float *attn_out = ws->attn_out;
+ float *proj_out = ws->proj_out;
+ float *ffn_gate = ws->ffn_gate;
+ float *ffn_up = ws->ffn_up;
+
+ /* A first stage performs embedding lookup. Later stages resume from a
+ * packed hidden-state tensor received from the preceding stage. */
+ if (layer_start == 0) {
+ for (int b = 0; b < batch; b++) {
+ int start = offsets[b];
+ for (int i = 0; i < inputs[b].n_tokens; i++) {
+ int id = inputs[b].ids[i];
+ if (id < 0 || id >= cfg->vocab_size) {
+ fprintf(stderr, "embed: invalid token id %d at input %d position %d\n", id, b,
+ i);
+ return -1;
+ }
+ copy_weight_row(x + (size_t)(start + i) * hidden, &w->embed_tokens, (size_t)id,
+ hidden);
+ }
+ }
+ } else {
+ memcpy(x, input_states, (size_t)total_seq * hidden * sizeof(float));
+ }
+
+ float scale = 1.0f / sqrtf((float)head_dim);
+
+ /* 2. Transformer layers. Linear/MLP ops run over all packed tokens;
+ * attention is explicitly block-diagonal by sequence offsets. */
+ for (int layer = layer_start; layer < layer_end; layer++) {
+ const embed_layer_t *l = &w->layers[layer];
+
+ embed_rms_norm(x_norm, x, l->input_norm, total_seq, hidden, eps);
+
+ linear_qkv_weight(ws, q_buf, k_buf, v_buf, x_norm, &l->wq, &l->wk, &l->wv, total_seq,
+ hidden, q_dim, kv_dim);
+
+ add_bias_rows(q_buf, l->q_bias, total_seq, q_dim);
+ add_bias_rows(k_buf, l->k_bias, total_seq, kv_dim);
+ add_bias_rows(v_buf, l->v_bias, total_seq, kv_dim);
+ if (cfg->qk_norm) {
+ embed_rms_norm_per_head(q_buf, l->q_norm, total_seq, n_heads, head_dim, eps);
+ embed_rms_norm_per_head(k_buf, l->k_norm, total_seq, n_kv_heads, head_dim, eps);
+ }
+
+ for (int b = 0; b < batch; b++) {
+ int start = offsets[b];
+ int len = offsets[b + 1] - start;
+ embed_apply_rope_neox(q_buf + (size_t)start * q_dim, rope_cos, rope_sin, len, n_heads,
+ head_dim);
+ embed_apply_rope_neox(k_buf + (size_t)start * kv_dim, rope_cos, rope_sin, len,
+ n_kv_heads, head_dim);
+ }
+
+ model->attention(attn_out, q_buf, k_buf, v_buf, offsets, batch, n_heads, n_kv_heads,
+ head_dim, scale, ws->attn_scores, ws->attn_scores_bytes);
+
+ linear_nobias_weight(ws, proj_out, attn_out, &l->wo, total_seq, q_dim, hidden);
+ embed_add_inplace(x, proj_out, total_seq * hidden);
+
+ embed_rms_norm(x_norm, x, l->post_attn_norm, total_seq, hidden, eps);
+
+ linear_pair_weight(ws, ffn_gate, ffn_up, x_norm, &l->gate_proj, &l->up_proj, total_seq,
+ hidden, inter, inter);
+ embed_silu_mul_inplace(ffn_gate, ffn_up, total_seq * inter);
+ linear_nobias_weight(ws, proj_out, ffn_gate, &l->down_proj, total_seq, inter, hidden);
+ embed_add_inplace(x, proj_out, total_seq * hidden);
+ }
+
+ if (apply_final_norm)
+ embed_rms_norm(x, x, w->norm, total_seq, hidden, eps);
+ return 0;
+}
+
+static int forward_packed_inplace(const embed_model_t *model,
+ embed_workspace_t *ws,
+ const embed_input_t *inputs,
+ int batch,
+ const int *offsets,
+ int total_seq,
+ int max_seq,
+ int apply_final_norm) {
+ return forward_packed_slice_inplace(model, ws, inputs, batch, offsets, total_seq, max_seq, NULL,
+ 0, model->config.n_layers, apply_final_norm);
+}
+
+/* BERT-family forward: token + learned-position + token-type embeddings and an
+ * embedding LayerNorm, then post-norm encoder layers (bias on every projection,
+ * GeLU feed-forward, no RoPE, no per-head norm). Bidirectional attention is
+ * block-diagonal over the packed batch, so each sequence's positions restart at
+ * 0. Leaves the final hidden states in ws->x; pooling reads them as-is because
+ * the last layer's LayerNorm is already the model's final normalization. */
+static int forward_packed_bert(const embed_model_t *model,
+ embed_workspace_t *ws,
+ const embed_input_t *inputs,
+ int batch,
+ const int *offsets,
+ int total_seq,
+ int max_seq) {
+ if (!model || !ws || ws->model != model || !inputs || batch <= 0 || !offsets ||
+ total_seq <= 0 || max_seq <= 0)
+ return -1;
+
+ const embed_config_t *cfg = &model->config;
+ const embed_weights_t *w = &model->weights;
+ int hidden = cfg->hidden_size;
+ int n_heads = cfg->n_heads;
+ int head_dim = cfg->head_dim;
+ int inter = cfg->intermediate_size;
+ float eps = cfg->layer_norm_eps;
+
+ if (!w->embed_tokens.data || !w->position_embeddings || !w->token_type_embeddings ||
+ !w->embed_ln_w || !w->embed_ln_b)
+ return -1;
+ if (max_seq > cfg->max_position_embeddings) {
+ fprintf(stderr, "embed: sequence length %d exceeds max_position_embeddings %d\n", max_seq,
+ cfg->max_position_embeddings);
+ return -1;
+ }
+ if (ensure_buffers(ws, cfg, total_seq) != 0)
+ return -1;
+ ensure_attention_scores(ws, offsets, batch);
+
+ float *x = ws->x;
+ float *q_buf = ws->q, *k_buf = ws->k, *v_buf = ws->v;
+ float *attn_out = ws->attn_out, *proj_out = ws->proj_out, *ffn_up = ws->ffn_up;
+
+ /* Embeddings: token + learned absolute position + token-type[0], then the
+ * embedding LayerNorm over every packed token. */
+ for (int b = 0; b < batch; b++) {
+ int start = offsets[b];
+ for (int i = 0; i < inputs[b].n_tokens; i++) {
+ int id = inputs[b].ids[i];
+ if (id < 0 || id >= cfg->vocab_size) {
+ fprintf(stderr, "embed: invalid token id %d at input %d position %d\n", id, b, i);
+ return -1;
+ }
+ float *row = x + (size_t)(start + i) * hidden;
+ copy_weight_row(row, &w->embed_tokens, (size_t)id, hidden);
+ embed_add_inplace(row, w->position_embeddings + (size_t)i * hidden, hidden);
+ embed_add_inplace(row, w->token_type_embeddings, hidden);
+ }
+ }
+ embed_layer_norm(x, x, w->embed_ln_w, w->embed_ln_b, total_seq, hidden, eps);
+
+ float scale = 1.0f / sqrtf((float)head_dim);
+
+ for (int layer = 0; layer < cfg->n_layers; layer++) {
+ const embed_layer_t *l = &w->layers[layer];
+
+ /* Self-attention (post-norm): projections read x directly. */
+ linear_qkv_weight(ws, q_buf, k_buf, v_buf, x, &l->wq, &l->wk, &l->wv, total_seq, hidden,
+ hidden, hidden);
+ add_bias_rows(q_buf, l->q_bias, total_seq, hidden);
+ add_bias_rows(k_buf, l->k_bias, total_seq, hidden);
+ add_bias_rows(v_buf, l->v_bias, total_seq, hidden);
+
+ model->attention(attn_out, q_buf, k_buf, v_buf, offsets, batch, n_heads, n_heads, head_dim,
+ scale, ws->attn_scores, ws->attn_scores_bytes);
+
+ linear_nobias_weight(ws, proj_out, attn_out, &l->wo, total_seq, hidden, hidden);
+ add_bias_rows(proj_out, l->o_bias, total_seq, hidden);
+ embed_add_inplace(x, proj_out, total_seq * hidden);
+ embed_layer_norm(x, x, l->input_norm, l->attn_ln_bias, total_seq, hidden, eps);
+
+ /* Feed-forward (post-norm): dense -> GeLU -> dense. */
+ linear_nobias_weight(ws, ffn_up, x, &l->up_proj, total_seq, hidden, inter);
+ add_bias_rows(ffn_up, l->ffn_inter_bias, total_seq, inter);
+ if (cfg->ffn_act == EMBED_ACT_GELU_TANH)
+ embed_gelu_tanh_inplace(ffn_up, total_seq * inter);
+ else
+ embed_gelu_inplace(ffn_up, total_seq * inter);
+ linear_nobias_weight(ws, proj_out, ffn_up, &l->down_proj, total_seq, inter, hidden);
+ add_bias_rows(proj_out, l->ffn_out_bias, total_seq, hidden);
+ embed_add_inplace(x, proj_out, total_seq * hidden);
+ embed_layer_norm(x, x, l->post_attn_norm, l->ffn_ln_bias, total_seq, hidden, eps);
+ }
+ return 0;
+}
+
+static int pool_embeddings(const embed_model_t *model,
+ const embed_workspace_t *ws,
+ const int *offsets,
+ int batch,
+ float *out_embeddings) {
+ const embed_config_t *cfg = &model->config;
+ int hidden = cfg->hidden_size;
+ float eps = cfg->rms_norm_eps;
+ /* Qwen pools pre-final-norm states and applies the final RMSNorm here; BERT
+ * pools already-normed states (no final norm), signalled by a NULL norm. */
+ const float *norm_weight = model->weights.norm;
+ const float *x = ws->x;
+ if (hidden <= 0 || !x)
+ return -1;
+
+ for (int b = 0; b < batch; b++) {
+ int start = offsets[b];
+ int end = offsets[b + 1];
+ int len = end - start;
+ float *emb = out_embeddings + (size_t)b * hidden;
+
+ if (cfg->pooling_mode == EMBED_POOL_LAST_TOKEN || cfg->pooling_mode == EMBED_POOL_CLS) {
+ /* Single-token pooling: CLS takes the first token, last-token the
+ * final one. */
+ int idx = cfg->pooling_mode == EMBED_POOL_CLS ? start : end - 1;
+ const float *row = x + (size_t)idx * hidden;
+ if (norm_weight) {
+ float sum_sq = 0.0f;
+ for (int d = 0; d < hidden; d++)
+ sum_sq += row[d] * row[d];
+ float rms_inv = 1.0f / sqrtf(sum_sq / (float)hidden + eps);
+ for (int d = 0; d < hidden; d++)
+ emb[d] = row[d] * rms_inv * norm_weight[d];
+ } else {
+ memcpy(emb, row, (size_t)hidden * sizeof(float));
+ }
+ } else {
+ memset(emb, 0, (size_t)hidden * sizeof(float));
+ for (int i = start; i < end; i++) {
+ const float *row = x + (size_t)i * hidden;
+ if (norm_weight) {
+ float sum_sq = 0.0f;
+ for (int d = 0; d < hidden; d++)
+ sum_sq += row[d] * row[d];
+ float rms_inv = 1.0f / sqrtf(sum_sq / (float)hidden + eps);
+ for (int d = 0; d < hidden; d++)
+ emb[d] += row[d] * rms_inv * norm_weight[d];
+ } else {
+ for (int d = 0; d < hidden; d++)
+ emb[d] += row[d];
+ }
+ }
+ float inv_len = 1.0f / (float)len;
+ for (int d = 0; d < hidden; d++)
+ emb[d] *= inv_len;
+ }
+
+ if (cfg->normalize_embeddings && embed_l2_normalize(emb, hidden) != 0)
+ return -1;
+ }
+ return 0;
+}
+
+/* ========================================================================
+ * Public forward/embed APIs
+ * ======================================================================== */
+
+int embed_model_forward_into(const embed_model_t *model,
+ embed_workspace_t *ws,
+ const int *token_ids,
+ int n_tokens,
+ float *out_states) {
+ if (!model || !ws || !token_ids || n_tokens <= 0 || !out_states)
+ return -1;
+
+ size_t count, bytes;
+ if (mul_size((size_t)n_tokens, (size_t)model->config.hidden_size, &count) != 0 ||
+ mul_size(count, sizeof(float), &bytes) != 0)
+ return -1;
+
+ embed_input_t input = {token_ids, n_tokens};
+ int offsets[2] = {0, n_tokens};
+ if (forward_packed_inplace(model, ws, &input, 1, offsets, n_tokens, n_tokens, 1) != 0)
+ return -1;
+
+ memcpy(out_states, ws->x, bytes);
+ return 0;
+}
+
+int embed_pool_spans(const embed_config_t *cfg,
+ const float *states,
+ int n_tokens,
+ const embed_span_t *spans,
+ int n_spans,
+ float *out_embeddings) {
+ if (!cfg || !states || n_tokens <= 0 || !spans || n_spans <= 0 || !out_embeddings)
+ return -1;
+
+ int hidden = cfg->hidden_size;
+ if (hidden <= 0)
+ return -1;
+
+ for (int s = 0; s < n_spans; s++) {
+ int start = spans[s].start;
+ int len = spans[s].n_tokens;
+ if (start < 0 || len <= 0 || start > n_tokens || len > n_tokens - start)
+ return -1;
+
+ float *emb = out_embeddings + (size_t)s * hidden;
+ memset(emb, 0, (size_t)hidden * sizeof(float));
+
+ for (int t = 0; t < len; t++) {
+ const float *row = states + (size_t)(start + t) * hidden;
+ for (int d = 0; d < hidden; d++)
+ emb[d] += row[d];
+ }
+
+ float inv_len = 1.0f / (float)len;
+ for (int d = 0; d < hidden; d++) {
+ emb[d] *= inv_len;
+ }
+ }
+ return 0;
+}
+
+int embed_model_encode_spans_batch(const embed_model_t *model,
+ embed_workspace_t *ws,
+ const embed_context_input_t *inputs,
+ int batch,
+ float *out_embeddings) {
+ if (!model || !ws || !inputs || batch <= 0 || !out_embeddings)
+ return -1;
+
+ if (ensure_offsets(ws, batch) != 0)
+ return -1;
+ if ((size_t)batch > SIZE_MAX / sizeof(embed_input_t))
+ return -1;
+ embed_input_t *packed_inputs = malloc((size_t)batch * sizeof(*packed_inputs));
+ if (!packed_inputs)
+ return -1;
+ int *offsets = ws->offsets;
+ int total_seq = 0;
+ int max_seq = 0;
+ int total_spans = 0;
+ for (int b = 0; b < batch; b++) {
+ const embed_context_input_t *input = &inputs[b];
+ int n_tokens = input->input.n_tokens;
+ if (!input->input.ids || n_tokens <= 0 || !input->spans || input->n_spans <= 0 ||
+ total_seq > INT_MAX - n_tokens || total_spans > INT_MAX - input->n_spans) {
+ free(packed_inputs);
+ return -1;
+ }
+ packed_inputs[b] = input->input;
+ offsets[b] = total_seq;
+ total_seq += n_tokens;
+ total_spans += input->n_spans;
+ if (n_tokens > max_seq)
+ max_seq = n_tokens;
+ for (int s = 0; s < input->n_spans; s++) {
+ int start = input->spans[s].start;
+ int len = input->spans[s].n_tokens;
+ if (start < 0 || len <= 0 || start > n_tokens || len > n_tokens - start) {
+ free(packed_inputs);
+ return -1;
+ }
+ }
+ }
+ offsets[batch] = total_seq;
+
+ if (forward_packed_inplace(model, ws, packed_inputs, batch, offsets, total_seq, max_seq, 1) !=
+ 0) {
+ free(packed_inputs);
+ return -1;
+ }
+ free(packed_inputs);
+
+ int span_offset = 0;
+ int hidden = model->config.hidden_size;
+ for (int b = 0; b < batch; b++) {
+ const embed_context_input_t *input = &inputs[b];
+ if (embed_pool_spans(&model->config, ws->x + (size_t)offsets[b] * hidden,
+ input->input.n_tokens, input->spans, input->n_spans,
+ out_embeddings + (size_t)span_offset * hidden) != 0)
+ return -1;
+ span_offset += input->n_spans;
+ }
+ return 0;
+}
+
+int embed_model_encode_spans(const embed_model_t *model,
+ embed_workspace_t *ws,
+ const int *token_ids,
+ int n_tokens,
+ const embed_span_t *spans,
+ int n_spans,
+ float *out_embeddings) {
+ embed_context_input_t input = {
+ .input = {token_ids, n_tokens},
+ .spans = spans,
+ .n_spans = n_spans,
+ };
+ return embed_model_encode_spans_batch(model, ws, &input, 1, out_embeddings);
+}
+
+float *embed_model_forward(const embed_model_t *model,
+ embed_workspace_t *ws,
+ const int *token_ids,
+ int n_tokens) {
+ if (!model || !ws || !token_ids || n_tokens <= 0)
+ return NULL;
+
+ size_t n;
+ if (mul_size((size_t)n_tokens, (size_t)model->config.hidden_size, &n) != 0)
+ return NULL;
+ float *out = malloc_floats(n);
+ if (!out)
+ return NULL;
+
+ if (embed_model_forward_into(model, ws, token_ids, n_tokens, out) != 0) {
+ free(out);
+ return NULL;
+ }
+ return out;
+}
+
+int embed_model_encode_batch(const embed_model_t *model,
+ embed_workspace_t *ws,
+ const embed_input_t *inputs,
+ int batch,
+ float *out_embeddings) {
+ if (!model || !ws || !inputs || batch <= 0 || !out_embeddings)
+ return -1;
+
+ if (ensure_offsets(ws, batch) != 0)
+ return -1;
+ int *offsets = ws->offsets;
+
+ int total_seq = 0;
+ int max_seq = 0;
+ if (build_offsets(inputs, batch, 1, offsets, &total_seq, &max_seq) != 0)
+ return -1;
+
+ int rc = model->config.family == EMBED_FAMILY_BERT
+ ? forward_packed_bert(model, ws, inputs, batch, offsets, total_seq, max_seq)
+ : forward_packed_inplace(model, ws, inputs, batch, offsets, total_seq, max_seq, 0);
+ if (rc == 0)
+ rc = pool_embeddings(model, ws, offsets, batch, out_embeddings);
+
+ return rc;
+}
+
+/* Late-interaction batch encoder. Lives here, beside the packed/ragged batch
+ * machinery it reuses, rather than next to embed_late_model_encode_tokens. */
+int embed_late_model_encode_docs(const embed_late_model_t *model,
+ embed_late_workspace_t *ws,
+ const int *const *doc_ids,
+ const int *n_tokens,
+ const int *const *keep,
+ const int *n_keep,
+ int n_docs,
+ int normalize,
+ float *out_vectors,
+ int *out_offsets) {
+ if (!model || !ws || ws->model != model || !doc_ids || !n_tokens || !keep || !n_keep ||
+ n_docs <= 0 || !out_vectors || !out_offsets || model->token_dim <= 0)
+ return -1;
+
+ int hidden = model->base->config.hidden_size;
+ int dim = model->token_dim;
+
+ /* Pack all candidates for one block-diagonal forward. inputs/offsets index
+ * the full token stream; out_offsets is the prefix sum of kept tokens. */
+ embed_input_t *inputs = (embed_input_t *)malloc((size_t)n_docs * sizeof(*inputs));
+ int *offsets = (int *)malloc((size_t)(n_docs + 1) * sizeof(*offsets));
+ if (!inputs || !offsets) {
+ free(inputs);
+ free(offsets);
+ return -1;
+ }
+
+ int total_keep = 0;
+ out_offsets[0] = 0;
+ for (int d = 0; d < n_docs; d++) {
+ if (!doc_ids[d] || n_tokens[d] <= 0 || !keep[d] || n_keep[d] <= 0 ||
+ n_keep[d] > n_tokens[d] || total_keep > INT_MAX - n_keep[d]) {
+ free(inputs);
+ free(offsets);
+ return -1;
+ }
+ for (int k = 0; k < n_keep[d]; k++) {
+ if (keep[d][k] < 0 || keep[d][k] >= n_tokens[d]) {
+ free(inputs);
+ free(offsets);
+ return -1;
+ }
+ }
+ inputs[d].ids = doc_ids[d];
+ inputs[d].n_tokens = n_tokens[d];
+ total_keep += n_keep[d];
+ out_offsets[d + 1] = total_keep;
+ }
+
+ int total_seq = 0, max_seq = 0;
+ int rc = build_offsets(inputs, n_docs, 1, offsets, &total_seq, &max_seq);
+ if (rc == 0)
+ rc = forward_packed_inplace(model->base, ws->base_ws, inputs, n_docs, offsets, total_seq,
+ max_seq, 1);
+ free(inputs);
+ if (rc != 0) {
+ free(offsets);
+ return -1;
+ }
+
+ /* Gather each document's kept hidden rows into ws->states (its natural
+ * [seq, hidden] shape), then project the packed [total_keep, hidden] block
+ * to [total_keep, dim] in one GEMM, matching the per-document path. */
+ if (ensure_late_state_buffer(ws, total_keep) != 0) {
+ free(offsets);
+ return -1;
+ }
+ const float *states = ws->base_ws->x;
+ int pos = 0;
+ for (int d = 0; d < n_docs; d++) {
+ int start = offsets[d];
+ for (int k = 0; k < n_keep[d]; k++) {
+ memcpy(ws->states + (size_t)pos * hidden,
+ states + (size_t)(start + keep[d][k]) * hidden, (size_t)hidden * sizeof(float));
+ pos++;
+ }
+ }
+ free(offsets);
+
+ linear_nobias_weight(ws->base_ws, out_vectors, ws->states, &model->projection, total_keep,
+ hidden, dim);
+ if (normalize) {
+ for (int i = 0; i < total_keep; i++) {
+ if (embed_l2_normalize(out_vectors + (size_t)i * dim, dim) != 0)
+ return -1;
+ }
+ }
+ return 0;
+}
+
+int embed_pool_batch(const embed_config_t *cfg,
+ const float *states,
+ const int *seq_lengths,
+ int batch,
+ float *out_embeddings) {
+ if (!cfg || !states || !seq_lengths || batch <= 0 || !out_embeddings || cfg->hidden_size <= 0)
+ return -1;
+
+ int offset = 0;
+ for (int b = 0; b < batch; b++) {
+ int len = seq_lengths[b];
+ if (len <= 0 || offset > INT_MAX - len)
+ return -1;
+
+ float *emb = out_embeddings + (size_t)b * cfg->hidden_size;
+ if (cfg->pooling_mode == EMBED_POOL_LAST_TOKEN || cfg->pooling_mode == EMBED_POOL_CLS) {
+ /* CLS takes the first token, last-token the final one; these states
+ * already carry the model's final RMSNorm. */
+ int idx = cfg->pooling_mode == EMBED_POOL_CLS ? offset : offset + len - 1;
+ const float *row = states + (size_t)idx * cfg->hidden_size;
+ memcpy(emb, row, (size_t)cfg->hidden_size * sizeof(float));
+ } else {
+ memset(emb, 0, (size_t)cfg->hidden_size * sizeof(float));
+ for (int t = 0; t < len; t++) {
+ const float *row = states + (size_t)(offset + t) * cfg->hidden_size;
+ for (int d = 0; d < cfg->hidden_size; d++)
+ emb[d] += row[d];
+ }
+ float inv_len = 1.0f / (float)len;
+ for (int d = 0; d < cfg->hidden_size; d++)
+ emb[d] *= inv_len;
+ }
+ if (cfg->normalize_embeddings && embed_l2_normalize(emb, cfg->hidden_size) != 0)
+ return -1;
+ offset += len;
+ }
+ return 0;
+}
+
+int embed_model_encode_into(const embed_model_t *model,
+ embed_workspace_t *ws,
+ const int *token_ids,
+ int n_tokens,
+ float *out_embedding) {
+ embed_input_t input = {token_ids, n_tokens};
+ return embed_model_encode_batch(model, ws, &input, 1, out_embedding);
+}
+
+float *embed_model_encode(const embed_model_t *model,
+ embed_workspace_t *ws,
+ const int *token_ids,
+ int n_tokens) {
+ if (!model || !ws || !token_ids || n_tokens <= 0)
+ return NULL;
+
+ int hidden = model->config.hidden_size;
+ if (hidden <= 0)
+ return NULL;
+ float *emb = malloc_floats((size_t)hidden);
+ if (!emb)
+ return NULL;
+
+ if (embed_model_encode_into(model, ws, token_ids, n_tokens, emb) != 0) {
+ free(emb);
+ return NULL;
+ }
+ return emb;
+}
+
+/* ========================================================================
+ * Vector helpers
+ * ======================================================================== */
+
+int embed_l2_normalize(float *vec, int dim) {
+ if (!vec || dim <= 0)
+ return -1;
+
+ float norm_sq = 0.0f;
+ for (int i = 0; i < dim; i++)
+ norm_sq += vec[i] * vec[i];
+
+ if (!(norm_sq > 0.0f) || !isfinite(norm_sq))
+ return -1;
+
+ float inv_norm = 1.0f / sqrtf(norm_sq);
+ for (int i = 0; i < dim; i++)
+ vec[i] *= inv_norm;
+ return 0;
+}
+
+float embed_cosine_similarity(const float *a, const float *b, int dim) {
+ if (!a || !b || dim <= 0)
+ return 0.0f;
+
+ float dot = 0.0f;
+ float norm_a_sq = 0.0f;
+ float norm_b_sq = 0.0f;
+ for (int i = 0; i < dim; i++) {
+ dot += a[i] * b[i];
+ norm_a_sq += a[i] * a[i];
+ norm_b_sq += b[i] * b[i];
+ }
+
+ if (!(norm_a_sq > 0.0f) || !(norm_b_sq > 0.0f) || !isfinite(norm_a_sq) || !isfinite(norm_b_sq))
+ return 0.0f;
+ return dot / sqrtf(norm_a_sq * norm_b_sq);
+}
diff --git a/src/embed.h b/src/embed.h
new file mode 100644
index 0000000..028b3d8
--- /dev/null
+++ b/src/embed.h
@@ -0,0 +1,355 @@
+/*
+ * embed.h - embed API
+ */
+
+#ifndef EMBED_H
+#define EMBED_H
+
+/* Public-API export annotation. The libraries are built with
+ * -fvisibility=hidden, so only declarations carrying EMBED_API are exported
+ * from the shared library; everything else stays internal. */
+#ifndef EMBED_API
+#if defined(__GNUC__)
+#define EMBED_API __attribute__((visibility("default")))
+#else
+#define EMBED_API
+#endif
+#endif
+
+#include <stddef.h>
+#include <stdint.h>
+
+/* ========================================================================
+ * Shared constants and family defaults
+ * ======================================================================== */
+
+#define EMBED_VOCAB_SIZE 151936
+#define EMBED_HEAD_DIM 128
+#define EMBED_MAX_LAYERS 64 /* upper bound for stack arrays */
+#define EMBED_CONTEXT_SEPARATOR_TOKEN_ID 151643 /* <|endoftext|> */
+
+/* ========================================================================
+ * Model Configuration (populated from config.json at load time)
+ * ======================================================================== */
+
+typedef enum {
+ EMBED_ATTENTION_BIDIRECTIONAL = 0,
+ EMBED_ATTENTION_CAUSAL = 1,
+} embed_attention_mode_t;
+
+typedef enum {
+ EMBED_POOL_MEAN = 0,
+ EMBED_POOL_LAST_TOKEN = 1,
+ EMBED_POOL_CLS = 2, /* first token; the encoder-family [CLS] sentence vector */
+} embed_pooling_mode_t;
+
+typedef enum {
+ EMBED_FAMILY_QWEN3 = 0, /* RMSNorm + RoPE + SwiGLU decoder block (pplx, Qwen2/3) */
+ EMBED_FAMILY_BERT = 1, /* LayerNorm + learned positions + GeLU encoder block */
+} embed_family_t;
+
+/* BERT feed-forward activation. The released MiniLM/BGE encoders use exact erf
+ * GeLU; some encoders publish the tanh approximation (hidden_act gelu_new or
+ * gelu_pytorch_tanh), which is a different curve and must be matched exactly. */
+typedef enum {
+ EMBED_ACT_GELU_ERF = 0, /* 0.5 x (1 + erf(x / sqrt(2))) */
+ EMBED_ACT_GELU_TANH = 1, /* 0.5 x (1 + tanh(sqrt(2/pi) (x + 0.044715 x^3))) */
+} embed_act_t;
+
+typedef struct {
+ embed_family_t family;
+ embed_act_t ffn_act; /* BERT feed-forward GeLU variant; ERF for Qwen/SwiGLU */
+ int hidden_size;
+ int n_layers;
+ int n_heads;
+ int n_kv_heads;
+ int head_dim;
+ int q_dim; /* n_heads * head_dim */
+ int kv_dim; /* n_kv_heads * head_dim */
+ int intermediate_size;
+ int vocab_size;
+ int max_position_embeddings; /* BERT learned position table size */
+ float rms_norm_eps;
+ float layer_norm_eps; /* BERT LayerNorm epsilon */
+ float rope_theta;
+ int qk_norm;
+ int qkv_bias;
+ embed_attention_mode_t attention_mode;
+ embed_pooling_mode_t pooling_mode;
+ int normalize_embeddings;
+ /* Qwen3-Embedding pools the last token, which is the tokenizer's
+ * <|endoftext|> suffix added by its post-processor - not the model's chat
+ * eos_token_id (<|im_end|>). Text frontends append it and resolve the id
+ * from the tokenizer exactly like the contextual separator
+ * (EMBED_CONTEXT_SEPARATOR_TOKEN_ID is the released-model fallback). The
+ * model forward consumes token ids exactly and never appends. */
+ int append_terminal_token;
+} embed_config_t;
+
+/* ========================================================================
+ * Model + workspace ownership
+ * ======================================================================== */
+
+typedef struct embed_model embed_model_t;
+typedef struct embed_workspace embed_workspace_t;
+typedef struct embed_late_model embed_late_model_t;
+typedef struct embed_late_workspace embed_late_workspace_t;
+
+typedef struct {
+ const int *ids;
+ int n_tokens;
+} embed_input_t;
+
+typedef struct {
+ int start;
+ int n_tokens;
+} embed_span_t;
+
+typedef struct {
+ embed_input_t input;
+ const embed_span_t *spans;
+ int n_spans;
+} embed_context_input_t;
+
+/* ========================================================================
+ * API
+ * ======================================================================== */
+
+/*
+ * Load immutable model data from a directory containing:
+ * config.json - model hyperparameters
+ * model.safetensors (or sharded) - F32 or BF16 weights
+ * vocab.json + merges.txt - BPE tokenizer
+ *
+ * Reads config.json to determine model size (0.6B vs 4B).
+ * Returns NULL on error.
+ */
+EMBED_API embed_model_t *embed_model_load(const char *model_dir);
+
+EMBED_API void embed_model_free(embed_model_t *model);
+
+/*
+ * Allocate/free mutable scratch buffers for a model. The model must outlive
+ * workspaces created from it.
+ */
+EMBED_API embed_workspace_t *embed_workspace_new(const embed_model_t *model);
+EMBED_API void embed_workspace_free(embed_workspace_t *ws);
+
+/* Config accessor for opaque model ownership. */
+EMBED_API const embed_config_t *embed_model_config(const embed_model_t *model);
+
+/*
+ * Current mutable workspace memory owned by this workspace, in bytes.
+ *
+ * This includes the workspace struct, scratch buffers, and RoPE cache capacity.
+ * It does not include immutable mmap'd model weights.
+ */
+EMBED_API size_t embed_workspace_nbytes(const embed_workspace_t *ws);
+
+/*
+ * Compute embedding for a token sequence.
+ *
+ * 1. Token embedding lookup
+ * 2. N transformer layers (GQA + RoPE + SwiGLU)
+ * 3. Final RMSNorm
+ * 4. Model-defined pooling and optional L2 normalization
+ *
+ * pplx-embed-v1 uses bidirectional attention and unnormalized mean pooling.
+ * Qwen3-Embedding uses causal attention and normalized last-token pooling.
+ * Token IDs are consumed exactly as provided; text frontends append any
+ * model-required terminal token before calling this API.
+ *
+ * Returns malloc'd float[hidden_size] (caller frees). NULL on error.
+ */
+EMBED_API float *embed_model_encode(const embed_model_t *model,
+ embed_workspace_t *ws,
+ const int *token_ids,
+ int n_tokens);
+
+/*
+ * Compute one embedding into caller-provided out[hidden_size].
+ * Returns 0 on success, -1 on error.
+ */
+EMBED_API int embed_model_encode_into(const embed_model_t *model,
+ embed_workspace_t *ws,
+ const int *token_ids,
+ int n_tokens,
+ float *out_embedding);
+
+/*
+ * Compute embeddings for a true packed/ragged batch.
+ *
+ * out_embeddings is caller-provided [batch, hidden_size].
+ * Each sequence attends only to tokens from the same input, and RoPE
+ * positions restart at zero for every input.
+ *
+ * Returns 0 on success, -1 on error.
+ */
+EMBED_API int embed_model_encode_batch(const embed_model_t *model,
+ embed_workspace_t *ws,
+ const embed_input_t *inputs,
+ int batch,
+ float *out_embeddings);
+
+/*
+ * Apply the config's pooling mode to packed final hidden states.
+ *
+ * states is [sum(n_tokens), hidden_size]. seq_lengths contains one positive
+ * token count per sequence. The states must already include final RMSNorm.
+ */
+EMBED_API int embed_pool_batch(const embed_config_t *cfg,
+ const float *states,
+ const int *seq_lengths,
+ int batch,
+ float *out_embeddings);
+
+/*
+ * Run the transformer forward pass WITHOUT pooling.
+ * Returns the full [n_tokens * hidden_size] output after final RMSNorm.
+ * Caller frees the returned buffer. NULL on error.
+ *
+ * Useful for contextual (late-chunking) models where you need
+ * per-token embeddings before splitting by separator positions.
+ */
+EMBED_API float *embed_model_forward(const embed_model_t *model,
+ embed_workspace_t *ws,
+ const int *token_ids,
+ int n_tokens);
+
+/*
+ * Run the transformer forward pass into caller-provided
+ * out_states[n_tokens * hidden_size]. Returns 0 on success, -1 on error.
+ */
+EMBED_API int embed_model_forward_into(const embed_model_t *model,
+ embed_workspace_t *ws,
+ const int *token_ids,
+ int n_tokens,
+ float *out_states);
+
+/*
+ * Pool embeddings from final hidden states.
+ *
+ * states is [n_tokens, hidden_size], normally produced by
+ * embed_model_forward_into(). Each span is mean pooled into
+ * out_embeddings[n_spans, hidden_size] without L2 normalization.
+ */
+EMBED_API int embed_pool_spans(const embed_config_t *cfg,
+ const float *states,
+ int n_tokens,
+ const embed_span_t *spans,
+ int n_spans,
+ float *out_embeddings);
+
+/*
+ * Run one contextual sequence and pool selected token spans.
+ * Returns 0 on success, -1 on error.
+ */
+EMBED_API int embed_model_encode_spans(const embed_model_t *model,
+ embed_workspace_t *ws,
+ const int *token_ids,
+ int n_tokens,
+ const embed_span_t *spans,
+ int n_spans,
+ float *out_embeddings);
+
+/*
+ * Run a packed/ragged contextual document batch and pool every selected span.
+ *
+ * Documents attend independently, RoPE positions restart for each document,
+ * and out_embeddings contains spans in document order.
+ */
+EMBED_API int embed_model_encode_spans_batch(const embed_model_t *model,
+ embed_workspace_t *ws,
+ const embed_context_input_t *inputs,
+ int batch,
+ float *out_embeddings);
+
+/*
+ * L2-normalize vec[dim] in place.
+ *
+ * Returns 0 on success. Returns -1 for invalid arguments or a zero-length
+ * vector, which cannot be normalized.
+ */
+EMBED_API int embed_l2_normalize(float *vec, int dim);
+
+/*
+ * Cosine similarity between two vectors.
+ * Returns 0 for invalid arguments or if either vector has zero length.
+ */
+EMBED_API float embed_cosine_similarity(const float *a, const float *b, int dim);
+
+/*
+ * Late-interaction model API.
+ *
+ * A late model produces one 128D vector per retained token. The vectors are
+ * projected by the snapshot's 1_Dense head and L2-normalized per token by
+ * default, matching ColBERT/MaxSim scoring semantics.
+ */
+EMBED_API embed_late_model_t *embed_late_model_load(const char *model_dir);
+EMBED_API void embed_late_model_free(embed_late_model_t *model);
+
+EMBED_API embed_late_workspace_t *embed_late_workspace_new(const embed_late_model_t *model);
+EMBED_API void embed_late_workspace_free(embed_late_workspace_t *ws);
+
+EMBED_API const embed_config_t *embed_late_model_config(const embed_late_model_t *model);
+EMBED_API int embed_late_model_token_dim(const embed_late_model_t *model);
+
+/*
+ * Encode token_ids into out_vectors[n_tokens, token_dim].
+ *
+ * If normalize is non-zero, every non-zero token vector is L2-normalized.
+ */
+EMBED_API int embed_late_model_encode_tokens(const embed_late_model_t *model,
+ embed_late_workspace_t *ws,
+ const int *token_ids,
+ int n_tokens,
+ int normalize,
+ float *out_vectors);
+
+/*
+ * Encode n_docs documents in one block-diagonal forward and pack each
+ * document's kept token vectors back-to-back into out_vectors[total_keep,
+ * token_dim] in document order, where total_keep is the sum of n_keep.
+ * out_offsets[n_docs + 1] receives the prefix sum of kept counts, the layout
+ * embed_late_maxsim_batch consumes. keep[d] lists the n_keep[d] token indices to
+ * retain from document d. Returns 0 on success, -1 on error.
+ */
+EMBED_API int embed_late_model_encode_docs(const embed_late_model_t *model,
+ embed_late_workspace_t *ws,
+ const int *const *doc_ids,
+ const int *n_tokens,
+ const int *const *keep,
+ const int *n_keep,
+ int n_docs,
+ int normalize,
+ float *out_vectors,
+ int *out_offsets);
+
+/*
+ * Sum over query tokens of max dot product against document tokens.
+ */
+EMBED_API float embed_late_maxsim(const float *query_vectors,
+ int query_tokens,
+ const float *doc_vectors,
+ int doc_tokens,
+ int dim);
+
+/*
+ * Score one query against a packed/ragged batch of documents.
+ *
+ * doc_offsets has docs + 1 entries. Document i is stored in
+ * doc_vectors[doc_offsets[i] * dim .. doc_offsets[i + 1] * dim).
+ * scores is caller-provided [docs].
+ */
+EMBED_API int embed_late_maxsim_batch(const float *query_vectors,
+ int query_tokens,
+ const float *doc_vectors,
+ const int *doc_offsets,
+ int docs,
+ int dim,
+ float *scores);
+
+/* Verbose level: 0=quiet, 1=info, 2=debug */
+EMBED_API extern int embed_verbose;
+
+#endif /* EMBED_H */
diff --git a/src/internal.h b/src/internal.h
new file mode 100644
index 0000000..cdc02a1
--- /dev/null
+++ b/src/internal.h
@@ -0,0 +1,110 @@
+#ifndef EMBED_INTERNAL_H
+#define EMBED_INTERNAL_H
+
+#include "embed.h"
+#include "safetensors.h"
+
+typedef struct {
+ safetensor_dtype_t dtype;
+ const void *data;
+} embed_weight_ref_t;
+
+typedef struct {
+ embed_weight_ref_t wq; /* [q_dim, hidden] */
+ embed_weight_ref_t wk; /* [kv_dim, hidden] */
+ embed_weight_ref_t wv; /* [kv_dim, hidden] */
+ embed_weight_ref_t wo; /* [hidden, q_dim] */
+ const float *q_bias; /* [q_dim], optional */
+ const float *k_bias; /* [kv_dim], optional */
+ const float *v_bias; /* [kv_dim], optional */
+ const float *q_norm; /* [head_dim] */
+ const float *k_norm; /* [head_dim] */
+ const float *input_norm; /* [hidden] */
+ const float *post_attn_norm; /* [hidden] */
+ embed_weight_ref_t gate_proj; /* [intermediate, hidden] */
+ embed_weight_ref_t up_proj; /* [intermediate, hidden] */
+ embed_weight_ref_t down_proj; /* [hidden, intermediate] */
+ /* BERT family (all NULL for Qwen3). The attention projections reuse
+ * wq/wk/wv/wo and q/k/v_bias; the two FFN matrices reuse up_proj
+ * (intermediate.dense) and down_proj (output.dense); the two block
+ * LayerNorm weights reuse input_norm (post-attention) and post_attn_norm
+ * (post-FFN). These fields add the biases those reused slots lack. */
+ const float *o_bias; /* attention output dense bias [hidden] */
+ const float *attn_ln_bias; /* post-attention LayerNorm bias [hidden] */
+ const float *ffn_inter_bias; /* intermediate.dense bias [intermediate] */
+ const float *ffn_out_bias; /* output.dense bias [hidden] */
+ const float *ffn_ln_bias; /* post-FFN LayerNorm bias [hidden] */
+} embed_layer_t;
+
+typedef struct {
+ embed_weight_ref_t embed_tokens; /* [vocab_size, hidden] */
+ embed_layer_t *layers; /* [n_layers] heap-allocated */
+ const float *norm; /* [hidden]; NULL for BERT (no final norm) */
+ /* BERT family (NULL for Qwen3): learned absolute position embeddings,
+ * token-type (segment) embeddings, and the embedding LayerNorm. */
+ const float *position_embeddings; /* [max_position_embeddings, hidden] */
+ const float *token_type_embeddings; /* [2, hidden] */
+ const float *embed_ln_w; /* embedding LayerNorm weight [hidden] */
+ const float *embed_ln_b; /* embedding LayerNorm bias [hidden] */
+} embed_weights_t;
+
+typedef void (*embed_attention_fn)(float *out,
+ const float *Q,
+ const float *K,
+ const float *V,
+ const int *offsets,
+ int batch,
+ int n_heads,
+ int n_kv_heads,
+ int head_dim,
+ float scale,
+ float *scratch,
+ size_t scratch_bytes);
+
+struct embed_model {
+ embed_config_t config;
+ embed_weights_t weights;
+ void *safetensors; /* multi_safetensors_t*, keeps mmap alive */
+ int layer_start; /* loaded transformer range, inclusive */
+ int layer_end; /* loaded transformer range, exclusive */
+ embed_attention_fn attention;
+};
+
+struct embed_workspace {
+ const embed_model_t *model; /* immutable model this workspace belongs to */
+ int buf_seq_cap;
+ float *x; /* [seq, hidden] */
+ float *x_norm; /* [seq, hidden] */
+ float *q; /* [seq, q_dim] */
+ float *k; /* [seq, kv_dim] */
+ float *v; /* [seq, kv_dim] */
+ float *attn_out; /* [seq, q_dim] */
+ float *proj_out; /* [seq, hidden] */
+ float *ffn_gate; /* [seq, intermediate] */
+ float *ffn_up; /* [seq, intermediate] */
+ float *attn_scores; /* reusable BLAS attention score tiles */
+ size_t attn_scores_bytes;
+
+ int *offsets; /* [batch + 1] packed sequence offsets */
+ int offsets_cap;
+
+ /* RoPE cosine/sine cache [n_pos, head_dim], grown lazily. */
+ float *rope_cos;
+ float *rope_sin;
+ int rope_cache_cap;
+
+ /* F32 view of one BF16 weight matrix for SGEMM dispatch, grown to the
+ * largest projection. Workspace-owned so concurrent workspaces on one
+ * model never share conversion scratch. */
+ float *bf16_widen;
+ size_t bf16_widen_count;
+};
+
+/* Internal accessors for the late-interaction model. GPU backends build a device
+ * context from an already-loaded CPU late model because the model dir is a late
+ * snapshot that the pooled loader rejects; these expose the base model and the
+ * projection weight without making struct embed_late_model public. */
+embed_model_t *embed_late_model_base(const embed_late_model_t *model);
+const embed_weight_ref_t *embed_late_model_projection(const embed_late_model_t *model);
+
+#endif /* EMBED_INTERNAL_H */
diff --git a/src/kernels.c b/src/kernels.c
new file mode 100644
index 0000000..226da45
--- /dev/null
+++ b/src/kernels.c
@@ -0,0 +1,1469 @@
+#include "kernels.h"
+#include "kernels_impl.h"
+#include <math.h>
+#include <string.h>
+#include <stdlib.h>
+#include <stdio.h>
+#include <pthread.h>
+#if (defined(__AVX512F__) || defined(__AVX2__)) && \
+ (defined(__x86_64__) || defined(__i386__) || defined(_M_X64) || defined(_M_IX86))
+#include <immintrin.h>
+#endif
+#if defined(__ARM_NEON) || defined(__ARM_NEON__)
+#include <arm_neon.h>
+#endif
+#ifdef __APPLE__
+#include <sys/sysctl.h>
+#else
+#include <unistd.h>
+#endif
+
+#ifdef USE_BLAS
+#ifdef __APPLE__
+#include <Accelerate/Accelerate.h>
+#else
+#include <cblas.h>
+#endif
+#endif
+
+#if defined(USE_OPENBLAS)
+void openblas_set_num_threads(int num_threads);
+#endif
+
+#ifndef M_PI
+#define M_PI 3.14159265358979323846
+#endif
+
+/* ========================================================================
+ * Thread Pool
+ * ======================================================================== */
+
+#define EMBED_MAX_THREADS 16
+
+typedef void (*parallel_fn_t)(int tid, int n_threads, void *arg);
+
+static struct {
+ pthread_t threads[EMBED_MAX_THREADS - 1];
+ int tids[EMBED_MAX_THREADS - 1];
+ int n_threads;
+ int shutdown;
+
+ parallel_fn_t fn;
+ void *arg;
+ int generation;
+
+ pthread_mutex_t mutex;
+ pthread_cond_t cond_work;
+ pthread_cond_t cond_done;
+ int n_done;
+} tp = {
+ .n_threads = 1,
+ .shutdown = 0,
+ .generation = 0,
+ .mutex = PTHREAD_MUTEX_INITIALIZER,
+ .cond_work = PTHREAD_COND_INITIALIZER,
+ .cond_done = PTHREAD_COND_INITIALIZER,
+};
+
+static void *worker_loop(void *arg) {
+ int tid = *(int *)arg;
+ int my_gen = 0;
+
+ for (;;) {
+ pthread_mutex_lock(&tp.mutex);
+ while (tp.generation == my_gen && !tp.shutdown)
+ pthread_cond_wait(&tp.cond_work, &tp.mutex);
+ if (tp.shutdown) {
+ pthread_mutex_unlock(&tp.mutex);
+ return NULL;
+ }
+ my_gen = tp.generation;
+ parallel_fn_t fn = tp.fn;
+ void *a = tp.arg;
+ int nt = tp.n_threads;
+ pthread_mutex_unlock(&tp.mutex);
+
+ fn(tid, nt, a);
+
+ pthread_mutex_lock(&tp.mutex);
+ if (++tp.n_done >= tp.n_threads - 1)
+ pthread_cond_signal(&tp.cond_done);
+ pthread_mutex_unlock(&tp.mutex);
+ }
+}
+
+void embed_set_threads(int n) {
+ if (n < 1)
+ n = 1;
+ if (n > EMBED_MAX_THREADS)
+ n = EMBED_MAX_THREADS;
+
+#if defined(USE_OPENBLAS)
+ /* OpenBLAS owns the heavy F32 GEMM parallelism on Linux. Keep the
+ * auxiliary pool serial to avoid nested thread contention. */
+ int blas_threads = n;
+ openblas_set_num_threads(blas_threads);
+ n = 1;
+#endif
+
+ /* Shutdown existing workers */
+ if (tp.n_threads > 1) {
+ pthread_mutex_lock(&tp.mutex);
+ tp.shutdown = 1;
+ pthread_cond_broadcast(&tp.cond_work);
+ pthread_mutex_unlock(&tp.mutex);
+ for (int i = 0; i < tp.n_threads - 1; i++)
+ pthread_join(tp.threads[i], NULL);
+ tp.shutdown = 0;
+ tp.generation = 0;
+ }
+
+ tp.n_threads = n;
+ if (n <= 1) {
+ if (embed_verbose >= 2) {
+#if defined(USE_OPENBLAS)
+ fprintf(stderr, "Thread pool: %d threads, OpenBLAS: %d threads\n", n, blas_threads);
+#else
+ fprintf(stderr, "Thread pool: %d threads\n", n);
+#endif
+ }
+ return;
+ }
+
+ for (int i = 0; i < n - 1; i++) {
+ tp.tids[i] = i + 1;
+ pthread_create(&tp.threads[i], NULL, worker_loop, &tp.tids[i]);
+ }
+
+ if (embed_verbose >= 2) {
+#if defined(USE_OPENBLAS)
+ fprintf(stderr, "Thread pool: %d threads, OpenBLAS: %d threads\n", n, blas_threads);
+#else
+ fprintf(stderr, "Thread pool: %d threads\n", n);
+#endif
+ }
+}
+
+#ifndef __APPLE__
+/* CPU bandwidth this process may actually use, in whole cores, or 0 if there
+ * is no cgroup limit. Containers (Docker --cpus, Kubernetes, RunPod) expose
+ * every host CPU through sysconf()/cpuset, but the CFS quota caps the CPU time
+ * the process really gets. Sizing the BLAS/thread pool to the host count then
+ * oversubscribes that quota: the threads spend the period's budget early and
+ * the scheduler throttles them for the rest of each period, which adds large,
+ * bursty stalls (e.g. a 16-thread default against a 5.1-core quota ran the
+ * 0.6B model ~2x slower than a 5-thread pool). Floor, not ceil, so a fully
+ * busy pool stays under the quota and never trips throttling. */
+static int cgroup_cpu_quota(void) {
+ /* cgroup v2: "/sys/fs/cgroup/cpu.max" is "<quota> <period>", or
+ * "max <period>" when unlimited. */
+ FILE *f = fopen("/sys/fs/cgroup/cpu.max", "r");
+ if (f) {
+ char quota[32];
+ long period = 0;
+ int got = fscanf(f, "%31s %ld", quota, &period);
+ fclose(f);
+ if (got == 2 && period > 0 && strcmp(quota, "max") != 0) {
+ long q = atol(quota);
+ if (q > 0)
+ return q / period < 1 ? 1 : (int)(q / period);
+ }
+ }
+ /* cgroup v1: separate files; quota -1 means unlimited. */
+ long q = -1, period = 0;
+ f = fopen("/sys/fs/cgroup/cpu/cpu.cfs_quota_us", "r");
+ if (f) {
+ if (fscanf(f, "%ld", &q) != 1)
+ q = -1;
+ fclose(f);
+ }
+ f = fopen("/sys/fs/cgroup/cpu/cpu.cfs_period_us", "r");
+ if (f) {
+ if (fscanf(f, "%ld", &period) != 1)
+ period = 0;
+ fclose(f);
+ }
+ if (q > 0 && period > 0)
+ return q / period < 1 ? 1 : (int)(q / period);
+ return 0;
+}
+#endif
+
+int embed_get_num_cpus(void) {
+#ifdef __APPLE__
+ int n = 0;
+ size_t len = sizeof(n);
+ sysctlbyname("hw.ncpu", &n, &len, NULL, 0);
+ return n > 0 ? n : 1;
+#else
+ int online = (int)sysconf(_SC_NPROCESSORS_ONLN);
+ if (online < 1)
+ online = 1;
+ /* Honor a cgroup CPU quota when it is tighter than the visible core count,
+ * so the default thread pool does not oversubscribe a CPU-limited
+ * container and get throttled. */
+ int quota = cgroup_cpu_quota();
+ if (quota >= 1 && quota < online)
+ return quota;
+ return online;
+#endif
+}
+
+/* Dispatch work to all threads; main thread is tid=0 */
+static void parallel_for(parallel_fn_t fn, void *arg) {
+ if (tp.n_threads <= 1) {
+ fn(0, 1, arg);
+ return;
+ }
+
+ pthread_mutex_lock(&tp.mutex);
+ tp.fn = fn;
+ tp.arg = arg;
+ tp.n_done = 0;
+ tp.generation++;
+ pthread_cond_broadcast(&tp.cond_work);
+ pthread_mutex_unlock(&tp.mutex);
+
+ fn(0, tp.n_threads, arg);
+
+ pthread_mutex_lock(&tp.mutex);
+ while (tp.n_done < tp.n_threads - 1)
+ pthread_cond_wait(&tp.cond_done, &tp.mutex);
+ pthread_mutex_unlock(&tp.mutex);
+}
+
+/* ========================================================================
+ * Basic Element-wise Operations
+ * ======================================================================== */
+
+void embed_add_inplace(float *a, const float *b, int n) {
+ for (int i = 0; i < n; i++)
+ a[i] += b[i];
+}
+
+/* ========================================================================
+ * Matrix Operations
+ * ======================================================================== */
+
+void embed_matmul_t(float *C, const float *A, const float *B, int M, int K, int N) {
+#ifdef USE_BLAS
+ cblas_sgemm(CblasRowMajor, CblasNoTrans, CblasTrans, M, N, K, 1.0f, A, K, B, K, 0.0f, C, N);
+#else
+ for (int m = 0; m < M; m++) {
+ for (int n = 0; n < N; n++) {
+ float sum = 0.0f;
+ for (int k = 0; k < K; k++) {
+ sum += A[m * K + k] * B[n * K + k];
+ }
+ C[m * N + n] = sum;
+ }
+ }
+#endif
+}
+
+void embed_linear(float *y,
+ const float *x,
+ const float *W,
+ const float *b,
+ int seq_len,
+ int in_dim,
+ int out_dim) {
+#ifdef USE_BLAS
+ if (seq_len == 1) {
+ cblas_sgemv(CblasRowMajor, CblasNoTrans, out_dim, in_dim, 1.0f, W, in_dim, x, 1, 0.0f, y,
+ 1);
+ } else {
+ cblas_sgemm(CblasRowMajor, CblasNoTrans, CblasTrans, seq_len, out_dim, in_dim, 1.0f, x,
+ in_dim, W, in_dim, 0.0f, y, out_dim);
+ }
+ if (b != NULL) {
+ for (int s = 0; s < seq_len; s++) {
+ for (int o = 0; o < out_dim; o++) {
+ y[s * out_dim + o] += b[o];
+ }
+ }
+ }
+#else
+ for (int s = 0; s < seq_len; s++) {
+ const float *x_row = x + s * in_dim;
+ float *y_row = y + s * out_dim;
+ for (int o = 0; o < out_dim; o++) {
+ const float *w_row = W + o * in_dim;
+ float sum = (b != NULL) ? b[o] : 0.0f;
+ for (int i = 0; i < in_dim; i++) {
+ sum += x_row[i] * w_row[i];
+ }
+ y_row[o] = sum;
+ }
+ }
+#endif
+}
+
+void embed_linear_nobias(
+ float *y, const float *x, const float *W, int seq_len, int in_dim, int out_dim) {
+ embed_linear(y, x, W, NULL, seq_len, in_dim, out_dim);
+}
+
+/* Convert bf16 buffer to f32 buffer */
+void embed_bf16_to_f32_buf(float *dst, const uint16_t *src, size_t n) {
+#if defined(__ARM_NEON) || defined(__ARM_NEON__)
+ size_t i = 0;
+ uint32_t *d = (uint32_t *)(void *)dst;
+ for (; i + 8 <= n; i += 8) {
+ uint16x8_t v = vld1q_u16(src + i);
+ uint32x4_t lo = vshlq_n_u32(vmovl_u16(vget_low_u16(v)), 16);
+ uint32x4_t hi = vshlq_n_u32(vmovl_u16(vget_high_u16(v)), 16);
+ vst1q_u32(d + i, lo);
+ vst1q_u32(d + i + 4, hi);
+ }
+ for (; i < n; i++)
+ d[i] = ((uint32_t)src[i]) << 16;
+#else
+ uint32_t *d = (uint32_t *)(void *)dst;
+ for (size_t i = 0; i < n; i++)
+ d[i] = ((uint32_t)src[i]) << 16;
+#endif
+}
+
+/*
+ * Fused BF16 matvec: y[out_dim] = W_bf16[out_dim, in_dim] @ x[in_dim] + bias
+ * Processes 2 output rows at a time to amortize x vector loads.
+ */
+static void bf16_matvec_fused(
+ float *y, const float *x, const uint16_t *W_bf16, const float *bias, int in_dim, int out_dim) {
+ embed_bf16_matvec_fused_impl(y, x, W_bf16, bias, in_dim, out_dim);
+}
+
+/* Threaded matvec: split output rows across threads */
+typedef struct {
+ float *y;
+ const float *x;
+ const uint16_t *W_bf16;
+ const float *bias;
+ int in_dim;
+ int out_dim;
+} matvec_task_t;
+
+static void matvec_worker(int tid, int n_threads, void *arg) {
+ matvec_task_t *t = (matvec_task_t *)arg;
+ int chunk = (t->out_dim + n_threads - 1) / n_threads;
+ int start = tid * chunk;
+ int end = start + chunk;
+ if (end > t->out_dim)
+ end = t->out_dim;
+ if (start >= end)
+ return;
+
+ bf16_matvec_fused(t->y + start, t->x, t->W_bf16 + (size_t)start * t->in_dim,
+ t->bias ? t->bias + start : NULL, t->in_dim, end - start);
+}
+
+static void bf16_matvec_threaded(
+ float *y, const float *x, const uint16_t *W_bf16, const float *bias, int in_dim, int out_dim) {
+ if (tp.n_threads <= 1) {
+ bf16_matvec_fused(y, x, W_bf16, bias, in_dim, out_dim);
+ return;
+ }
+ matvec_task_t task = {y, x, W_bf16, bias, in_dim, out_dim};
+ parallel_for(matvec_worker, &task);
+}
+
+typedef struct {
+ float *y;
+ const float *x;
+ const uint16_t *W_bf16;
+ const float *bias;
+ int seq_len;
+ int in_dim;
+ int out_dim;
+} bf16_linear_rows_task_t;
+
+static void bf16_linear_rows_worker(int tid, int n_threads, void *arg) {
+ bf16_linear_rows_task_t *t = (bf16_linear_rows_task_t *)arg;
+ int chunk = (t->seq_len + n_threads - 1) / n_threads;
+ int start = tid * chunk;
+ int end = start + chunk;
+ if (end > t->seq_len)
+ end = t->seq_len;
+ if (start >= end)
+ return;
+
+ for (int s = start; s < end; s++) {
+ bf16_matvec_fused(t->y + (size_t)s * t->out_dim, t->x + (size_t)s * t->in_dim, t->W_bf16,
+ t->bias, t->in_dim, t->out_dim);
+ }
+}
+
+static void bf16_linear_rows(float *y,
+ const float *x,
+ const uint16_t *W_bf16,
+ const float *bias,
+ int seq_len,
+ int in_dim,
+ int out_dim) {
+ bf16_linear_rows_task_t task = {
+ .y = y,
+ .x = x,
+ .W_bf16 = W_bf16,
+ .bias = bias,
+ .seq_len = seq_len,
+ .in_dim = in_dim,
+ .out_dim = out_dim,
+ };
+
+ if (tp.n_threads > 1 && seq_len >= 2)
+ parallel_for(bf16_linear_rows_worker, &task);
+ else
+ bf16_linear_rows_worker(0, 1, &task);
+}
+
+typedef struct {
+ float *a;
+ float *b;
+ const float *x;
+ const uint16_t *Wa_bf16;
+ const uint16_t *Wb_bf16;
+ int seq_len;
+ int in_dim;
+ int a_dim;
+ int b_dim;
+ int total_dim;
+} pair_matvec_task_t;
+
+static void pair_matvec_range(const pair_matvec_task_t *t, int row, int start, int end) {
+ const float *x_row = t->x + (size_t)row * t->in_dim;
+ int a_end = t->a_dim;
+ int b_end = a_end + t->b_dim;
+
+ if (start < a_end) {
+ int s = start;
+ int e = end < a_end ? end : a_end;
+ if (s < e) {
+ bf16_matvec_fused(t->a + (size_t)row * t->a_dim + s, x_row,
+ t->Wa_bf16 + (size_t)s * t->in_dim, NULL, t->in_dim, e - s);
+ }
+ }
+
+ if (end > a_end && start < b_end) {
+ int s = start > a_end ? start - a_end : 0;
+ int e_abs = end < b_end ? end : b_end;
+ int e = e_abs - a_end;
+ if (s < e) {
+ bf16_matvec_fused(t->b + (size_t)row * t->b_dim + s, x_row,
+ t->Wb_bf16 + (size_t)s * t->in_dim, NULL, t->in_dim, e - s);
+ }
+ }
+}
+
+static void pair_matvec_worker(int tid, int n_threads, void *arg) {
+ pair_matvec_task_t *t = (pair_matvec_task_t *)arg;
+ int total_work = t->seq_len * t->total_dim;
+ int chunk = (total_work + n_threads - 1) / n_threads;
+ int start = tid * chunk;
+ int end = start + chunk;
+ if (end > total_work)
+ end = total_work;
+ if (start >= end)
+ return;
+
+ while (start < end) {
+ int row = start / t->total_dim;
+ int pos = start - row * t->total_dim;
+ int row_end = (row + 1) * t->total_dim;
+ int stop = end < row_end ? end : row_end;
+ pair_matvec_range(t, row, pos, stop - row * t->total_dim);
+ start = stop;
+ }
+}
+
+void embed_linear_nobias_bf16_pair(float *a,
+ float *b,
+ const float *x,
+ const uint16_t *Wa_bf16,
+ const uint16_t *Wb_bf16,
+ int seq_len,
+ int in_dim,
+ int a_dim,
+ int b_dim) {
+ if (seq_len <= 0)
+ return;
+
+ if (tp.n_threads <= 1) {
+ for (int s = 0; s < seq_len; s++) {
+ const float *x_row = x + (size_t)s * in_dim;
+ bf16_matvec_fused(a + (size_t)s * a_dim, x_row, Wa_bf16, NULL, in_dim, a_dim);
+ bf16_matvec_fused(b + (size_t)s * b_dim, x_row, Wb_bf16, NULL, in_dim, b_dim);
+ }
+ return;
+ }
+
+ pair_matvec_task_t task = {
+ .a = a,
+ .b = b,
+ .x = x,
+ .Wa_bf16 = Wa_bf16,
+ .Wb_bf16 = Wb_bf16,
+ .seq_len = seq_len,
+ .in_dim = in_dim,
+ .a_dim = a_dim,
+ .b_dim = b_dim,
+ .total_dim = a_dim + b_dim,
+ };
+ parallel_for(pair_matvec_worker, &task);
+}
+
+typedef struct {
+ float *q;
+ float *k;
+ float *v;
+ const float *x;
+ const uint16_t *Wq_bf16;
+ const uint16_t *Wk_bf16;
+ const uint16_t *Wv_bf16;
+ int in_dim;
+ int q_dim;
+ int kv_dim;
+ int seq_len;
+ int total_dim;
+} qkv_matvec_task_t;
+
+static void qkv_matvec_range(const qkv_matvec_task_t *t, int row, int start, int end) {
+ const float *x_row = t->x + (size_t)row * t->in_dim;
+ int q_end = t->q_dim;
+ int k_end = q_end + t->kv_dim;
+ int v_end = k_end + t->kv_dim;
+
+ if (start < q_end) {
+ int s = start;
+ int e = end < q_end ? end : q_end;
+ if (s < e) {
+ bf16_matvec_fused(t->q + (size_t)row * t->q_dim + s, x_row,
+ t->Wq_bf16 + (size_t)s * t->in_dim, NULL, t->in_dim, e - s);
+ }
+ }
+
+ if (end > q_end && start < k_end) {
+ int s = start > q_end ? start - q_end : 0;
+ int e_abs = end < k_end ? end : k_end;
+ int e = e_abs - q_end;
+ if (s < e) {
+ bf16_matvec_fused(t->k + (size_t)row * t->kv_dim + s, x_row,
+ t->Wk_bf16 + (size_t)s * t->in_dim, NULL, t->in_dim, e - s);
+ }
+ }
+
+ if (end > k_end && start < v_end) {
+ int s = start > k_end ? start - k_end : 0;
+ int e_abs = end < v_end ? end : v_end;
+ int e = e_abs - k_end;
+ if (s < e) {
+ bf16_matvec_fused(t->v + (size_t)row * t->kv_dim + s, x_row,
+ t->Wv_bf16 + (size_t)s * t->in_dim, NULL, t->in_dim, e - s);
+ }
+ }
+}
+
+static void qkv_matvec_worker(int tid, int n_threads, void *arg) {
+ qkv_matvec_task_t *t = (qkv_matvec_task_t *)arg;
+ int total_work = t->seq_len * t->total_dim;
+ int chunk = (total_work + n_threads - 1) / n_threads;
+ int start = tid * chunk;
+ int end = start + chunk;
+ if (end > total_work)
+ end = total_work;
+ if (start >= end)
+ return;
+
+ while (start < end) {
+ int row = start / t->total_dim;
+ int pos = start - row * t->total_dim;
+ int row_end = (row + 1) * t->total_dim;
+ int stop = end < row_end ? end : row_end;
+ qkv_matvec_range(t, row, pos, stop - row * t->total_dim);
+ start = stop;
+ }
+}
+
+void embed_linear_nobias_bf16_qkv(float *q,
+ float *k,
+ float *v,
+ const float *x,
+ const uint16_t *Wq_bf16,
+ const uint16_t *Wk_bf16,
+ const uint16_t *Wv_bf16,
+ int seq_len,
+ int in_dim,
+ int q_dim,
+ int kv_dim) {
+ if (seq_len <= 0)
+ return;
+
+ if (tp.n_threads <= 1) {
+ for (int s = 0; s < seq_len; s++) {
+ const float *x_row = x + (size_t)s * in_dim;
+ bf16_matvec_fused(q + (size_t)s * q_dim, x_row, Wq_bf16, NULL, in_dim, q_dim);
+ bf16_matvec_fused(k + (size_t)s * kv_dim, x_row, Wk_bf16, NULL, in_dim, kv_dim);
+ bf16_matvec_fused(v + (size_t)s * kv_dim, x_row, Wv_bf16, NULL, in_dim, kv_dim);
+ }
+ return;
+ }
+
+ qkv_matvec_task_t task = {
+ .q = q,
+ .k = k,
+ .v = v,
+ .x = x,
+ .Wq_bf16 = Wq_bf16,
+ .Wk_bf16 = Wk_bf16,
+ .Wv_bf16 = Wv_bf16,
+ .in_dim = in_dim,
+ .q_dim = q_dim,
+ .kv_dim = kv_dim,
+ .seq_len = seq_len,
+ .total_dim = q_dim + 2 * kv_dim,
+ };
+ parallel_for(qkv_matvec_worker, &task);
+}
+
+void embed_linear_nobias_bf16(
+ float *y, const float *x, const uint16_t *W_bf16, int seq_len, int in_dim, int out_dim) {
+ if (seq_len == 1) {
+ bf16_matvec_threaded(y, x, W_bf16, NULL, in_dim, out_dim);
+ return;
+ }
+ /* Callers route longer sequences through an F32-widened weight matrix in
+ * caller-owned scratch (see embed.c); this per-row path stays correct for
+ * any length. */
+ bf16_linear_rows(y, x, W_bf16, NULL, seq_len, in_dim, out_dim);
+}
+
+/* ========================================================================
+ * Normalization
+ * ======================================================================== */
+
+/* Rows split across the pool only when the tensor is big enough to pay
+ * for the dispatch. */
+#define EMBED_RMS_NORM_PARALLEL_ELEMS 262144
+
+static void embed_rms_norm_range(
+ float *out, const float *x, const float *weight, int start, int end, int hidden, float eps) {
+ for (int s = start; s < end; s++) {
+ const float *x_row = x + (size_t)s * hidden;
+ float *out_row = out + (size_t)s * hidden;
+
+#if defined(__AVX512F__) && defined(__FMA__)
+ __m512 accv = _mm512_setzero_ps();
+ int i = 0;
+ for (; i + 16 <= hidden; i += 16) {
+ __m512 v = _mm512_loadu_ps(x_row + i);
+ accv = _mm512_fmadd_ps(v, v, accv);
+ }
+ float sum_sq = _mm512_reduce_add_ps(accv);
+ for (; i < hidden; i++)
+ sum_sq += x_row[i] * x_row[i];
+#elif defined(__AVX2__) && defined(__FMA__)
+ __m256 accv = _mm256_setzero_ps();
+ int i = 0;
+ for (; i + 8 <= hidden; i += 8) {
+ __m256 v = _mm256_loadu_ps(x_row + i);
+ accv = _mm256_fmadd_ps(v, v, accv);
+ }
+ __m128 acc128 = _mm_add_ps(_mm256_castps256_ps128(accv), _mm256_extractf128_ps(accv, 1));
+ acc128 = _mm_hadd_ps(acc128, acc128);
+ acc128 = _mm_hadd_ps(acc128, acc128);
+ float sum_sq = _mm_cvtss_f32(acc128);
+ for (; i < hidden; i++)
+ sum_sq += x_row[i] * x_row[i];
+#else
+ float sum_sq = 0.0f;
+ for (int i = 0; i < hidden; i++) {
+ sum_sq += x_row[i] * x_row[i];
+ }
+#endif
+ float rms_inv = 1.0f / sqrtf(sum_sq / hidden + eps);
+
+#if defined(__AVX512F__)
+ __m512 scale = _mm512_set1_ps(rms_inv);
+ int j = 0;
+ for (; j + 16 <= hidden; j += 16) {
+ __m512 vx = _mm512_loadu_ps(x_row + j);
+ __m512 vw = _mm512_loadu_ps(weight + j);
+ _mm512_storeu_ps(out_row + j, _mm512_mul_ps(_mm512_mul_ps(vx, vw), scale));
+ }
+ for (; j < hidden; j++)
+ out_row[j] = x_row[j] * rms_inv * weight[j];
+#elif defined(__AVX2__)
+ __m256 scale = _mm256_set1_ps(rms_inv);
+ int j = 0;
+ for (; j + 8 <= hidden; j += 8) {
+ __m256 vx = _mm256_loadu_ps(x_row + j);
+ __m256 vw = _mm256_loadu_ps(weight + j);
+ _mm256_storeu_ps(out_row + j, _mm256_mul_ps(_mm256_mul_ps(vx, vw), scale));
+ }
+ for (; j < hidden; j++)
+ out_row[j] = x_row[j] * rms_inv * weight[j];
+#else
+ for (int i = 0; i < hidden; i++) {
+ out_row[i] = x_row[i] * rms_inv * weight[i];
+ }
+#endif
+ }
+}
+
+typedef struct {
+ float *out;
+ const float *x;
+ const float *weight;
+ int seq_len;
+ int hidden;
+ float eps;
+} rms_norm_task_t;
+
+static void rms_norm_worker(int tid, int n_threads, void *arg) {
+ rms_norm_task_t *t = (rms_norm_task_t *)arg;
+ int chunk = (t->seq_len + n_threads - 1) / n_threads;
+ int start = tid * chunk;
+ int end = start + chunk;
+ if (end > t->seq_len)
+ end = t->seq_len;
+ if (start >= end)
+ return;
+ embed_rms_norm_range(t->out, t->x, t->weight, start, end, t->hidden, t->eps);
+}
+
+void embed_rms_norm(
+ float *out, const float *x, const float *weight, int seq_len, int hidden, float eps) {
+ if (seq_len <= 0 || hidden <= 0)
+ return;
+
+ long long elems = (long long)seq_len * hidden;
+ if (tp.n_threads > 1 && elems >= EMBED_RMS_NORM_PARALLEL_ELEMS) {
+ rms_norm_task_t task = {
+ .out = out,
+ .x = x,
+ .weight = weight,
+ .seq_len = seq_len,
+ .hidden = hidden,
+ .eps = eps,
+ };
+ parallel_for(rms_norm_worker, &task);
+ } else {
+ embed_rms_norm_range(out, x, weight, 0, seq_len, hidden, eps);
+ }
+}
+
+void embed_rms_norm_per_head(
+ float *x, const float *weight, int seq_len, int n_heads, int head_dim, float eps) {
+ /* x is [seq, n_heads * head_dim] - normalize each [head_dim] segment */
+ int hidden = n_heads * head_dim;
+ for (int s = 0; s < seq_len; s++) {
+ for (int h = 0; h < n_heads; h++) {
+ float *vec = x + s * hidden + h * head_dim;
+
+#if defined(__AVX512F__) && defined(__FMA__)
+ __m512 accv = _mm512_setzero_ps();
+ int d = 0;
+ for (; d + 16 <= head_dim; d += 16) {
+ __m512 v = _mm512_loadu_ps(vec + d);
+ accv = _mm512_fmadd_ps(v, v, accv);
+ }
+ float sum_sq = _mm512_reduce_add_ps(accv);
+ for (; d < head_dim; d++)
+ sum_sq += vec[d] * vec[d];
+#elif defined(__AVX2__) && defined(__FMA__)
+ __m256 accv = _mm256_setzero_ps();
+ int d = 0;
+ for (; d + 8 <= head_dim; d += 8) {
+ __m256 v = _mm256_loadu_ps(vec + d);
+ accv = _mm256_fmadd_ps(v, v, accv);
+ }
+ __m128 acc128 =
+ _mm_add_ps(_mm256_castps256_ps128(accv), _mm256_extractf128_ps(accv, 1));
+ acc128 = _mm_hadd_ps(acc128, acc128);
+ acc128 = _mm_hadd_ps(acc128, acc128);
+ float sum_sq = _mm_cvtss_f32(acc128);
+ for (; d < head_dim; d++)
+ sum_sq += vec[d] * vec[d];
+#else
+ float sum_sq = 0.0f;
+ for (int d = 0; d < head_dim; d++) {
+ sum_sq += vec[d] * vec[d];
+ }
+#endif
+ float rms_inv = 1.0f / sqrtf(sum_sq / head_dim + eps);
+
+#if defined(__AVX512F__)
+ __m512 scale = _mm512_set1_ps(rms_inv);
+ int j = 0;
+ for (; j + 16 <= head_dim; j += 16) {
+ __m512 v = _mm512_loadu_ps(vec + j);
+ __m512 w = _mm512_loadu_ps(weight + j);
+ _mm512_storeu_ps(vec + j, _mm512_mul_ps(_mm512_mul_ps(v, w), scale));
+ }
+ for (; j < head_dim; j++)
+ vec[j] = vec[j] * rms_inv * weight[j];
+#elif defined(__AVX2__)
+ __m256 scale = _mm256_set1_ps(rms_inv);
+ int j = 0;
+ for (; j + 8 <= head_dim; j += 8) {
+ __m256 v = _mm256_loadu_ps(vec + j);
+ __m256 w = _mm256_loadu_ps(weight + j);
+ _mm256_storeu_ps(vec + j, _mm256_mul_ps(_mm256_mul_ps(v, w), scale));
+ }
+ for (; j < head_dim; j++)
+ vec[j] = vec[j] * rms_inv * weight[j];
+#else
+ for (int d = 0; d < head_dim; d++) {
+ vec[d] = vec[d] * rms_inv * weight[d];
+ }
+#endif
+ }
+ }
+}
+
+/* Mean-subtracting LayerNorm with bias. Safe in place (out may alias x): each
+ * row's mean and variance are reduced before the row is rewritten. Scalar for
+ * now; LayerNorm is not GEMM-bound, so SIMD/threading is a later perf step. */
+void embed_layer_norm(float *out,
+ const float *x,
+ const float *gamma,
+ const float *beta,
+ int seq_len,
+ int hidden,
+ float eps) {
+ if (seq_len <= 0 || hidden <= 0)
+ return;
+ float inv_h = 1.0f / (float)hidden;
+ for (int s = 0; s < seq_len; s++) {
+ const float *row = x + (size_t)s * hidden;
+ float *dst = out + (size_t)s * hidden;
+ float mean = 0.0f;
+ for (int d = 0; d < hidden; d++)
+ mean += row[d];
+ mean *= inv_h;
+ float var = 0.0f;
+ for (int d = 0; d < hidden; d++) {
+ float diff = row[d] - mean;
+ var += diff * diff;
+ }
+ var *= inv_h;
+ float inv_std = 1.0f / sqrtf(var + eps);
+ for (int d = 0; d < hidden; d++)
+ dst[d] = gamma[d] * (row[d] - mean) * inv_std + beta[d];
+ }
+}
+
+/* ========================================================================
+ * Activation Functions
+ * ======================================================================== */
+
+void embed_silu_mul_inplace(float *gate, const float *up, int n) {
+#if defined(__APPLE__) && defined(USE_BLAS)
+ enum { CHUNK = 4096 };
+ float exp_neg[CHUNK];
+
+ for (int base = 0; base < n; base += CHUNK) {
+ int len = n - base;
+ if (len > CHUNK)
+ len = CHUNK;
+
+ for (int i = 0; i < len; i++)
+ exp_neg[i] = -gate[base + i];
+ vvexpf(exp_neg, exp_neg, &len);
+
+ for (int i = 0; i < len; i++) {
+ float g = gate[base + i];
+ gate[base + i] = (g / (1.0f + exp_neg[i])) * up[base + i];
+ }
+ }
+#else
+ for (int i = 0; i < n; i++) {
+ float g = gate[i];
+ gate[i] = (g / (1.0f + expf(-g))) * up[i];
+ }
+#endif
+}
+
+void embed_gelu_inplace(float *x, int n) {
+ /* Exact erf GeLU; 0.70710678... = 1/sqrt(2). */
+ for (int i = 0; i < n; i++)
+ x[i] = 0.5f * x[i] * (1.0f + erff(x[i] * 0.70710678118654752f));
+}
+
+void embed_gelu_tanh_inplace(float *x, int n) {
+ /* Tanh-approximation GeLU; 0.79788456... = sqrt(2/pi). */
+ for (int i = 0; i < n; i++) {
+ float v = x[i];
+ float inner = 0.79788456080286536f * (v + 0.044715f * v * v * v);
+ x[i] = 0.5f * v * (1.0f + tanhf(inner));
+ }
+}
+
+void embed_softmax(float *x, int rows, int cols) {
+ for (int r = 0; r < rows; r++) {
+ float *row = x + r * cols;
+ float max_val = row[0];
+ for (int c = 1; c < cols; c++) {
+ if (row[c] > max_val)
+ max_val = row[c];
+ }
+ float sum = 0.0f;
+ for (int c = 0; c < cols; c++) {
+ row[c] = expf(row[c] - max_val);
+ sum += row[c];
+ }
+ float inv_sum = 1.0f / sum;
+ for (int c = 0; c < cols; c++) {
+ row[c] *= inv_sum;
+ }
+ }
+}
+
+/* ========================================================================
+ * Attention Operations
+ * ======================================================================== */
+
+float embed_dot_f32(const float *a, const float *b, int n) { return embed_dot_f32_impl(a, b, n); }
+
+static inline float embed_dot_f32_fast(const float *a, const float *b, int n) {
+ return embed_dot_f32_impl(a, b, n);
+}
+
+/* dst = dst * scale */
+static inline void embed_vec_scale_inplace(float *dst, float scale, int n) {
+ embed_vec_scale_inplace_impl(dst, scale, n);
+}
+
+/* dst += alpha * src */
+static inline void embed_vec_axpy_inplace(float *dst, const float *src, float alpha, int n) {
+ embed_vec_axpy_inplace_impl(dst, src, alpha, n);
+}
+
+/* dst = dst * correction + src */
+static inline void embed_vec_scale_add(float *dst, const float *src, float correction, int n) {
+ embed_vec_scale_add_impl(dst, src, correction, n);
+}
+
+#define EMBED_PACKED_ATTN_QUERY_TILE 32
+#define EMBED_PACKED_ATTN_BLAS_MIN_SEQ 128
+
+static void embed_bidirectional_gqa_attention_packed_online_rows(float *out,
+ const float *Q,
+ const float *K,
+ const float *V,
+ int start,
+ int end,
+ int n_heads,
+ int n_kv_heads,
+ int head_dim,
+ float scale,
+ int h,
+ int query_start,
+ int query_end) {
+ int heads_per_kv = n_heads / n_kv_heads;
+ int q_hidden = n_heads * head_dim;
+ int kv_hidden = n_kv_heads * head_dim;
+ int kv_h = h / heads_per_kv;
+
+ for (int i = query_start; i < query_end; i++) {
+ const float *q_row = Q + (size_t)i * q_hidden + h * head_dim;
+ float *o_row = out + (size_t)i * q_hidden + h * head_dim;
+
+ float max_score = -1e30f;
+ float sum_exp = 0.0f;
+ for (int d = 0; d < head_dim; d++)
+ o_row[d] = 0.0f;
+
+ for (int j = start; j < end; j++) {
+ const float *k_row = K + (size_t)j * kv_hidden + kv_h * head_dim;
+ const float *v_row = V + (size_t)j * kv_hidden + kv_h * head_dim;
+
+ float score = embed_dot_f32_fast(q_row, k_row, head_dim) * scale;
+
+ if (score > max_score) {
+ float correction = expf(max_score - score);
+ sum_exp = sum_exp * correction + 1.0f;
+ embed_vec_scale_add(o_row, v_row, correction, head_dim);
+ max_score = score;
+ } else {
+ float wt = expf(score - max_score);
+ sum_exp += wt;
+ embed_vec_axpy_inplace(o_row, v_row, wt, head_dim);
+ }
+ }
+
+ if (sum_exp > 0.0f) {
+ float inv_sum = 1.0f / sum_exp;
+ embed_vec_scale_inplace(o_row, inv_sum, head_dim);
+ }
+ }
+}
+
+#ifdef USE_BLAS
+static void embed_bidirectional_gqa_attention_packed_blas_rows(float *out,
+ const float *Q,
+ const float *K,
+ const float *V,
+ int start,
+ int end,
+ int n_heads,
+ int n_kv_heads,
+ int head_dim,
+ float scale,
+ int h,
+ int query_start,
+ int query_end,
+ float *scores) {
+ int heads_per_kv = n_heads / n_kv_heads;
+ int q_hidden = n_heads * head_dim;
+ int kv_hidden = n_kv_heads * head_dim;
+ int kv_h = h / heads_per_kv;
+ int rows = query_end - query_start;
+ int keys = end - start;
+
+ const float *q = Q + (size_t)query_start * q_hidden + h * head_dim;
+ const float *k = K + (size_t)start * kv_hidden + kv_h * head_dim;
+ const float *v = V + (size_t)start * kv_hidden + kv_h * head_dim;
+ float *o = out + (size_t)query_start * q_hidden + h * head_dim;
+
+ cblas_sgemm(CblasRowMajor, CblasNoTrans, CblasTrans, rows, keys, head_dim, scale, q, q_hidden,
+ k, kv_hidden, 0.0f, scores, keys);
+ embed_softmax(scores, rows, keys);
+ cblas_sgemm(CblasRowMajor, CblasNoTrans, CblasNoTrans, rows, head_dim, keys, 1.0f, scores, keys,
+ v, kv_hidden, 0.0f, o, q_hidden);
+}
+#endif
+
+typedef struct {
+ float *out;
+ const float *Q;
+ const float *K;
+ const float *V;
+ const int *offsets;
+ int batch;
+ int n_heads, n_kv_heads;
+ int head_dim;
+ float scale;
+ float *scores;
+ int max_seq;
+} packed_gqa_attn_task_t;
+
+static void packed_gqa_attn_worker(int tid, int n_threads, void *arg) {
+ packed_gqa_attn_task_t *t = (packed_gqa_attn_task_t *)arg;
+ int task_id = 0;
+#ifdef USE_BLAS
+ float *scores =
+ t->scores ? t->scores + (size_t)tid * EMBED_PACKED_ATTN_QUERY_TILE * t->max_seq : NULL;
+#endif
+
+ for (int h = 0; h < t->n_heads; h++) {
+ for (int b = 0; b < t->batch; b++) {
+ int start = t->offsets[b];
+ int end = t->offsets[b + 1];
+ for (int q0 = start; q0 < end; q0 += EMBED_PACKED_ATTN_QUERY_TILE) {
+ int q1 = q0 + EMBED_PACKED_ATTN_QUERY_TILE;
+ if (q1 > end)
+ q1 = end;
+ if (task_id++ % n_threads != tid)
+ continue;
+#ifdef USE_BLAS
+ if (scores && end - start >= EMBED_PACKED_ATTN_BLAS_MIN_SEQ) {
+ embed_bidirectional_gqa_attention_packed_blas_rows(
+ t->out, t->Q, t->K, t->V, start, end, t->n_heads, t->n_kv_heads,
+ t->head_dim, t->scale, h, q0, q1, scores);
+ continue;
+ }
+#endif
+ embed_bidirectional_gqa_attention_packed_online_rows(
+ t->out, t->Q, t->K, t->V, start, end, t->n_heads, t->n_kv_heads, t->head_dim,
+ t->scale, h, q0, q1);
+ }
+ }
+ }
+}
+
+size_t embed_bidirectional_gqa_attention_packed_scratch_bytes(const int *offsets, int batch) {
+#ifdef USE_BLAS
+ if (!offsets || batch <= 0)
+ return 0;
+
+ int max_seq = 0;
+ for (int b = 0; b < batch; b++) {
+ int len = offsets[b + 1] - offsets[b];
+ if (len > max_seq)
+ max_seq = len;
+ }
+ if (max_seq < EMBED_PACKED_ATTN_BLAS_MIN_SEQ)
+ return 0;
+ if ((size_t)max_seq >
+ SIZE_MAX / (sizeof(float) * EMBED_PACKED_ATTN_QUERY_TILE * (size_t)tp.n_threads))
+ return 0;
+ return (size_t)tp.n_threads * EMBED_PACKED_ATTN_QUERY_TILE * (size_t)max_seq * sizeof(float);
+#else
+ (void)offsets;
+ (void)batch;
+ return 0;
+#endif
+}
+
+void embed_bidirectional_gqa_attention_packed_with_scratch(float *out,
+ const float *Q,
+ const float *K,
+ const float *V,
+ const int *offsets,
+ int batch,
+ int n_heads,
+ int n_kv_heads,
+ int head_dim,
+ float scale,
+ float *scratch,
+ size_t scratch_bytes) {
+ long long qk_work = 0;
+ int max_seq = 0;
+ for (int b = 0; b < batch; b++) {
+ int len = offsets[b + 1] - offsets[b];
+ qk_work += (long long)len * len * n_heads;
+ if (len > max_seq)
+ max_seq = len;
+ }
+
+ float *scores = NULL;
+#ifdef USE_BLAS
+ size_t required = embed_bidirectional_gqa_attention_packed_scratch_bytes(offsets, batch);
+ if (required != 0 && scratch && scratch_bytes >= required)
+ scores = scratch;
+#else
+ (void)scratch;
+ (void)scratch_bytes;
+#endif
+ packed_gqa_attn_task_t task = {.out = out,
+ .Q = Q,
+ .K = K,
+ .V = V,
+ .offsets = offsets,
+ .batch = batch,
+ .n_heads = n_heads,
+ .n_kv_heads = n_kv_heads,
+ .head_dim = head_dim,
+ .scale = scale,
+ .scores = scores,
+ .max_seq = max_seq};
+ if (tp.n_threads > 1 && n_heads >= 2 && qk_work >= 4096) {
+ parallel_for(packed_gqa_attn_worker, &task);
+ } else {
+ packed_gqa_attn_worker(0, 1, &task);
+ }
+}
+
+void embed_bidirectional_gqa_attention_packed(float *out,
+ const float *Q,
+ const float *K,
+ const float *V,
+ const int *offsets,
+ int batch,
+ int n_heads,
+ int n_kv_heads,
+ int head_dim,
+ float scale) {
+ size_t scratch_bytes = embed_bidirectional_gqa_attention_packed_scratch_bytes(offsets, batch);
+ float *scores = scratch_bytes ? malloc(scratch_bytes) : NULL;
+ embed_bidirectional_gqa_attention_packed_with_scratch(
+ out, Q, K, V, offsets, batch, n_heads, n_kv_heads, head_dim, scale, scores, scratch_bytes);
+ free(scores);
+}
+
+static void embed_causal_gqa_attention_packed_online_rows(float *out,
+ const float *Q,
+ const float *K,
+ const float *V,
+ int start,
+ int n_heads,
+ int n_kv_heads,
+ int head_dim,
+ float scale,
+ int h,
+ int query_start,
+ int query_end) {
+ int heads_per_kv = n_heads / n_kv_heads;
+ int q_hidden = n_heads * head_dim;
+ int kv_hidden = n_kv_heads * head_dim;
+ int kv_h = h / heads_per_kv;
+
+ for (int i = query_start; i < query_end; i++) {
+ const float *q_row = Q + (size_t)i * q_hidden + h * head_dim;
+ float *o_row = out + (size_t)i * q_hidden + h * head_dim;
+
+ float max_score = -1e30f;
+ float sum_exp = 0.0f;
+ for (int d = 0; d < head_dim; d++)
+ o_row[d] = 0.0f;
+
+ for (int j = start; j <= i; j++) {
+ const float *k_row = K + (size_t)j * kv_hidden + kv_h * head_dim;
+ const float *v_row = V + (size_t)j * kv_hidden + kv_h * head_dim;
+ float score = embed_dot_f32_fast(q_row, k_row, head_dim) * scale;
+
+ if (score > max_score) {
+ float correction = expf(max_score - score);
+ sum_exp = sum_exp * correction + 1.0f;
+ embed_vec_scale_add(o_row, v_row, correction, head_dim);
+ max_score = score;
+ } else {
+ float wt = expf(score - max_score);
+ sum_exp += wt;
+ embed_vec_axpy_inplace(o_row, v_row, wt, head_dim);
+ }
+ }
+
+ if (sum_exp > 0.0f)
+ embed_vec_scale_inplace(o_row, 1.0f / sum_exp, head_dim);
+ }
+}
+
+#ifdef USE_BLAS
+static void embed_causal_gqa_attention_packed_blas_rows(float *out,
+ const float *Q,
+ const float *K,
+ const float *V,
+ int start,
+ int n_heads,
+ int n_kv_heads,
+ int head_dim,
+ float scale,
+ int h,
+ int query_start,
+ int query_end,
+ float *scores) {
+ int heads_per_kv = n_heads / n_kv_heads;
+ int q_hidden = n_heads * head_dim;
+ int kv_hidden = n_kv_heads * head_dim;
+ int kv_h = h / heads_per_kv;
+ int rows = query_end - query_start;
+ int keys = query_end - start;
+
+ const float *q = Q + (size_t)query_start * q_hidden + h * head_dim;
+ const float *k = K + (size_t)start * kv_hidden + kv_h * head_dim;
+ const float *v = V + (size_t)start * kv_hidden + kv_h * head_dim;
+ float *o = out + (size_t)query_start * q_hidden + h * head_dim;
+
+ cblas_sgemm(CblasRowMajor, CblasNoTrans, CblasTrans, rows, keys, head_dim, scale, q, q_hidden,
+ k, kv_hidden, 0.0f, scores, keys);
+ for (int r = 0; r < rows; r++) {
+ int allowed = query_start + r - start + 1;
+ float *row = scores + (size_t)r * keys;
+ for (int j = allowed; j < keys; j++)
+ row[j] = -INFINITY;
+ }
+ embed_softmax(scores, rows, keys);
+ cblas_sgemm(CblasRowMajor, CblasNoTrans, CblasNoTrans, rows, head_dim, keys, 1.0f, scores, keys,
+ v, kv_hidden, 0.0f, o, q_hidden);
+}
+#endif
+
+static void packed_causal_gqa_attn_worker(int tid, int n_threads, void *arg) {
+ packed_gqa_attn_task_t *t = (packed_gqa_attn_task_t *)arg;
+ int task_id = 0;
+#ifdef USE_BLAS
+ float *scores =
+ t->scores ? t->scores + (size_t)tid * EMBED_PACKED_ATTN_QUERY_TILE * t->max_seq : NULL;
+#endif
+
+ for (int h = 0; h < t->n_heads; h++) {
+ for (int b = 0; b < t->batch; b++) {
+ int start = t->offsets[b];
+ int end = t->offsets[b + 1];
+ for (int q0 = start; q0 < end; q0 += EMBED_PACKED_ATTN_QUERY_TILE) {
+ int q1 = q0 + EMBED_PACKED_ATTN_QUERY_TILE;
+ if (q1 > end)
+ q1 = end;
+ if (task_id++ % n_threads != tid)
+ continue;
+#ifdef USE_BLAS
+ if (scores && end - start >= EMBED_PACKED_ATTN_BLAS_MIN_SEQ) {
+ embed_causal_gqa_attention_packed_blas_rows(
+ t->out, t->Q, t->K, t->V, start, t->n_heads, t->n_kv_heads, t->head_dim,
+ t->scale, h, q0, q1, scores);
+ continue;
+ }
+#endif
+ embed_causal_gqa_attention_packed_online_rows(t->out, t->Q, t->K, t->V, start,
+ t->n_heads, t->n_kv_heads, t->head_dim,
+ t->scale, h, q0, q1);
+ }
+ }
+ }
+}
+
+void embed_causal_gqa_attention_packed_with_scratch(float *out,
+ const float *Q,
+ const float *K,
+ const float *V,
+ const int *offsets,
+ int batch,
+ int n_heads,
+ int n_kv_heads,
+ int head_dim,
+ float scale,
+ float *scratch,
+ size_t scratch_bytes) {
+ long long qk_work = 0;
+ int max_seq = 0;
+ for (int b = 0; b < batch; b++) {
+ int len = offsets[b + 1] - offsets[b];
+ qk_work += (long long)len * (len + 1) / 2 * n_heads;
+ if (len > max_seq)
+ max_seq = len;
+ }
+
+ float *scores = NULL;
+#ifdef USE_BLAS
+ size_t required = embed_bidirectional_gqa_attention_packed_scratch_bytes(offsets, batch);
+ if (required != 0 && scratch && scratch_bytes >= required)
+ scores = scratch;
+#else
+ (void)scratch;
+ (void)scratch_bytes;
+#endif
+ packed_gqa_attn_task_t task = {.out = out,
+ .Q = Q,
+ .K = K,
+ .V = V,
+ .offsets = offsets,
+ .batch = batch,
+ .n_heads = n_heads,
+ .n_kv_heads = n_kv_heads,
+ .head_dim = head_dim,
+ .scale = scale,
+ .scores = scores,
+ .max_seq = max_seq};
+ if (tp.n_threads > 1 && n_heads >= 2 && qk_work >= 4096)
+ parallel_for(packed_causal_gqa_attn_worker, &task);
+ else
+ packed_causal_gqa_attn_worker(0, 1, &task);
+}
+
+void embed_causal_gqa_attention_packed(float *out,
+ const float *Q,
+ const float *K,
+ const float *V,
+ const int *offsets,
+ int batch,
+ int n_heads,
+ int n_kv_heads,
+ int head_dim,
+ float scale) {
+ size_t scratch_bytes = embed_bidirectional_gqa_attention_packed_scratch_bytes(offsets, batch);
+ float *scores = scratch_bytes ? malloc(scratch_bytes) : NULL;
+ embed_causal_gqa_attention_packed_with_scratch(out, Q, K, V, offsets, batch, n_heads, n_kv_heads,
+ head_dim, scale, scores, scratch_bytes);
+ free(scores);
+}
+
+/* ========================================================================
+ * Position Embeddings
+ * ======================================================================== */
+
+void embed_compute_rope_neox(
+ float *cos_out, float *sin_out, const int *positions, int seq, int head_dim, float theta) {
+ int half = head_dim / 2;
+
+ for (int s = 0; s < seq; s++) {
+ float pos = (float)positions[s];
+ for (int d = 0; d < half; d++) {
+ float freq = 1.0f / powf(theta, (float)(2 * d) / (float)head_dim);
+ float angle = pos * freq;
+ float c = cosf(angle);
+ float sn = sinf(angle);
+ /* Duplicate for full head_dim */
+ cos_out[s * head_dim + d] = c;
+ cos_out[s * head_dim + half + d] = c;
+ sin_out[s * head_dim + d] = sn;
+ sin_out[s * head_dim + half + d] = sn;
+ }
+ }
+}
+
+void embed_apply_rope_neox(
+ float *x, const float *cos_vals, const float *sin_vals, int seq, int n_heads, int head_dim) {
+ /*
+ * NeoX split-half style:
+ * x1 = x[..., :half], x2 = x[..., half:]
+ * rotated = cat(-x2, x1)
+ * result = x * cos + rotated * sin
+ */
+ int half = head_dim / 2;
+ int hidden = n_heads * head_dim;
+
+ for (int s = 0; s < seq; s++) {
+ const float *c = cos_vals + s * head_dim;
+ const float *sn = sin_vals + s * head_dim;
+
+ for (int h = 0; h < n_heads; h++) {
+ float *vec = x + s * hidden + h * head_dim;
+
+#if defined(__AVX512F__) && defined(__FMA__)
+ int d = 0;
+ for (; d + 16 <= half; d += 16) {
+ __m512 x1 = _mm512_loadu_ps(vec + d);
+ __m512 x2 = _mm512_loadu_ps(vec + half + d);
+ /* RoPE cache duplicates cos/sin across halves. */
+ __m512 cc = _mm512_loadu_ps(c + d);
+ __m512 ss = _mm512_loadu_ps(sn + d);
+ __m512 new1 = _mm512_fmsub_ps(x1, cc, _mm512_mul_ps(x2, ss));
+ __m512 new2 = _mm512_fmadd_ps(x2, cc, _mm512_mul_ps(x1, ss));
+ _mm512_storeu_ps(vec + d, new1);
+ _mm512_storeu_ps(vec + half + d, new2);
+ }
+ for (; d < half; d++) {
+ float x1 = vec[d];
+ float x2 = vec[half + d];
+ vec[d] = x1 * c[d] + (-x2) * sn[d];
+ vec[half + d] = x2 * c[half + d] + x1 * sn[half + d];
+ }
+#elif defined(__AVX2__) && defined(__FMA__)
+ int d = 0;
+ for (; d + 8 <= half; d += 8) {
+ __m256 x1 = _mm256_loadu_ps(vec + d);
+ __m256 x2 = _mm256_loadu_ps(vec + half + d);
+ __m256 cc = _mm256_loadu_ps(c + d);
+ __m256 ss = _mm256_loadu_ps(sn + d);
+ __m256 new1 = _mm256_fmsub_ps(x1, cc, _mm256_mul_ps(x2, ss));
+ __m256 new2 = _mm256_fmadd_ps(x2, cc, _mm256_mul_ps(x1, ss));
+ _mm256_storeu_ps(vec + d, new1);
+ _mm256_storeu_ps(vec + half + d, new2);
+ }
+ for (; d < half; d++) {
+ float x1 = vec[d];
+ float x2 = vec[half + d];
+ vec[d] = x1 * c[d] + (-x2) * sn[d];
+ vec[half + d] = x2 * c[half + d] + x1 * sn[half + d];
+ }
+#elif defined(__ARM_NEON) || defined(__ARM_NEON__)
+ int d = 0;
+ for (; d + 4 <= half; d += 4) {
+ float32x4_t x1 = vld1q_f32(vec + d);
+ float32x4_t x2 = vld1q_f32(vec + half + d);
+ float32x4_t cc = vld1q_f32(c + d);
+ float32x4_t ss = vld1q_f32(sn + d);
+ float32x4_t new1 = vmlsq_f32(vmulq_f32(x1, cc), x2, ss);
+ float32x4_t new2 = vfmaq_f32(vmulq_f32(x2, cc), x1, ss);
+ vst1q_f32(vec + d, new1);
+ vst1q_f32(vec + half + d, new2);
+ }
+ for (; d < half; d++) {
+ float x1 = vec[d];
+ float x2 = vec[half + d];
+ vec[d] = x1 * c[d] + (-x2) * sn[d];
+ vec[half + d] = x2 * c[half + d] + x1 * sn[half + d];
+ }
+#else
+ for (int d = 0; d < half; d++) {
+ float x1 = vec[d]; /* first half */
+ float x2 = vec[half + d]; /* second half */
+ vec[d] = x1 * c[d] + (-x2) * sn[d];
+ vec[half + d] = x2 * c[half + d] + x1 * sn[half + d];
+ }
+#endif
+ }
+ }
+}
diff --git a/src/kernels.h b/src/kernels.h
new file mode 100644
index 0000000..6f180dd
--- /dev/null
+++ b/src/kernels.h
@@ -0,0 +1,219 @@
+/*
+ * embed_kernels.h - Math kernels for Qwen3-architecture inference
+ *
+ * Low-level math operations. All operate on float32 tensors in row-major order.
+ */
+
+#ifndef EMBED_KERNELS_H
+#define EMBED_KERNELS_H
+
+/* Public-API export annotation. The libraries are built with
+ * -fvisibility=hidden, so only declarations carrying EMBED_API are exported
+ * from the shared library; everything else stays internal. */
+#ifndef EMBED_API
+#if defined(__GNUC__)
+#define EMBED_API __attribute__((visibility("default")))
+#else
+#define EMBED_API
+#endif
+#endif
+
+#include <stddef.h>
+#include <stdint.h>
+
+/* ========================================================================
+ * Basic Operations
+ * ======================================================================== */
+
+void embed_add_inplace(float *a, const float *b, int n);
+
+/* ========================================================================
+ * Matrix Operations
+ * ======================================================================== */
+
+/* C = A @ B^T: A[M,K], B[N,K], C[M,N] */
+void embed_matmul_t(float *C, const float *A, const float *B, int M, int K, int N);
+
+/* y = x @ W^T + b: x[seq,in], W[out,in], b[out], y[seq,out] */
+void embed_linear(
+ float *y, const float *x, const float *W, const float *b, int seq_len, int in_dim, int out_dim);
+
+void embed_linear_nobias(
+ float *y, const float *x, const float *W, int seq_len, int in_dim, int out_dim);
+
+/* bf16 weight variants */
+
+void embed_bf16_to_f32_buf(float *dst, const uint16_t *src, size_t n);
+void embed_linear_nobias_bf16(
+ float *y, const float *x, const uint16_t *W_bf16, int seq_len, int in_dim, int out_dim);
+
+/* Small-sequence BF16 path: compute two projections with one threaded dispatch. */
+void embed_linear_nobias_bf16_pair(float *a,
+ float *b,
+ const float *x,
+ const uint16_t *Wa_bf16,
+ const uint16_t *Wb_bf16,
+ int seq_len,
+ int in_dim,
+ int a_dim,
+ int b_dim);
+
+/* Small-sequence BF16 path: compute Q/K/V matvecs with one threaded dispatch. */
+void embed_linear_nobias_bf16_qkv(float *q,
+ float *k,
+ float *v,
+ const float *x,
+ const uint16_t *Wq_bf16,
+ const uint16_t *Wk_bf16,
+ const uint16_t *Wv_bf16,
+ int seq_len,
+ int in_dim,
+ int q_dim,
+ int kv_dim);
+
+/* Dot product using the best available local SIMD implementation. */
+float embed_dot_f32(const float *a, const float *b, int n);
+
+/* ========================================================================
+ * Normalization
+ * ======================================================================== */
+
+/* RMS Normalization: out = x / rms(x) * weight */
+void embed_rms_norm(
+ float *out, const float *x, const float *weight, int seq_len, int hidden, float eps);
+
+/* Per-head RMS Normalization for Q/K norms in decoder
+ * x: [seq, n_heads, head_dim], weight: [head_dim]
+ * Normalizes each head independently */
+void embed_rms_norm_per_head(
+ float *x, const float *weight, int seq_len, int n_heads, int head_dim, float eps);
+
+/* Layer Normalization (BERT family): out = gamma * (x - mean) / sqrt(var + eps)
+ * + beta, with mean and biased (population) variance over the hidden axis per
+ * row. Unlike RMSNorm this subtracts the mean and adds a bias. */
+void embed_layer_norm(float *out,
+ const float *x,
+ const float *gamma,
+ const float *beta,
+ int seq_len,
+ int hidden,
+ float eps);
+
+/* ========================================================================
+ * Activation Functions
+ * ======================================================================== */
+
+void embed_softmax(float *x, int rows, int cols);
+/* gate = SiLU(gate) * up */
+void embed_silu_mul_inplace(float *gate, const float *up, int n);
+
+/* Exact (erf) GeLU in place: x = 0.5 * x * (1 + erf(x / sqrt(2))). This is the
+ * "gelu" activation HF BERT/BGE/MiniLM use, not the tanh approximation. */
+void embed_gelu_inplace(float *x, int n);
+
+/* Tanh-approximation GeLU in place (HF gelu_new / gelu_pytorch_tanh):
+ * x = 0.5 * x * (1 + tanh(sqrt(2/pi) * (x + 0.044715 * x^3))). */
+void embed_gelu_tanh_inplace(float *x, int n);
+
+/* ========================================================================
+ * Attention Operations
+ * ======================================================================== */
+
+/*
+ * Bidirectional GQA attention over a packed/ragged batch.
+ *
+ * Q: [total_seq, n_heads * head_dim]
+ * K,V: [total_seq, n_kv_heads * head_dim]
+ * offsets: [batch + 1], token spans for each sequence.
+ *
+ * Attention is block-diagonal: tokens only attend within their own
+ * offsets[b]..offsets[b+1] span.
+ */
+void embed_bidirectional_gqa_attention_packed(float *out,
+ const float *Q,
+ const float *K,
+ const float *V,
+ const int *offsets,
+ int batch,
+ int n_heads,
+ int n_kv_heads,
+ int head_dim,
+ float scale);
+
+/* Optional reusable scratch for the BLAS-tiled packed attention path. */
+size_t embed_bidirectional_gqa_attention_packed_scratch_bytes(const int *offsets, int batch);
+void embed_bidirectional_gqa_attention_packed_with_scratch(float *out,
+ const float *Q,
+ const float *K,
+ const float *V,
+ const int *offsets,
+ int batch,
+ int n_heads,
+ int n_kv_heads,
+ int head_dim,
+ float scale,
+ float *scratch,
+ size_t scratch_bytes);
+
+/*
+ * Causal GQA attention over a packed/ragged batch. Query position i attends
+ * only to positions at or before i within its sequence.
+ */
+void embed_causal_gqa_attention_packed(float *out,
+ const float *Q,
+ const float *K,
+ const float *V,
+ const int *offsets,
+ int batch,
+ int n_heads,
+ int n_kv_heads,
+ int head_dim,
+ float scale);
+void embed_causal_gqa_attention_packed_with_scratch(float *out,
+ const float *Q,
+ const float *K,
+ const float *V,
+ const int *offsets,
+ int batch,
+ int n_heads,
+ int n_kv_heads,
+ int head_dim,
+ float scale,
+ float *scratch,
+ size_t scratch_bytes);
+
+/* ========================================================================
+ * Position Embeddings
+ * ======================================================================== */
+
+/*
+ * NeoX-style RoPE: compute cos/sin for positions.
+ * cos_out, sin_out: [seq, head_dim]
+ * cos[d] and cos[half+d] are the same (duplicated for full head_dim).
+ */
+void embed_compute_rope_neox(
+ float *cos_out, float *sin_out, const int *positions, int seq, int head_dim, float theta);
+
+/*
+ * Apply NeoX-style RoPE to Q or K.
+ * x: [seq, n_heads * head_dim] (in-place)
+ * cos_vals, sin_vals: [seq, head_dim]
+ */
+void embed_apply_rope_neox(
+ float *x, const float *cos_vals, const float *sin_vals, int seq, int n_heads, int head_dim);
+
+/* ========================================================================
+ * Threading
+ * ======================================================================== */
+
+/* Set number of threads for parallel operations (default: 1).
+ * Creates a persistent thread pool. Call before inference. */
+EMBED_API void embed_set_threads(int n);
+
+/* Get number of available CPU cores */
+EMBED_API int embed_get_num_cpus(void);
+
+/* Global verbose flag */
+EMBED_API extern int embed_verbose;
+
+#endif /* EMBED_KERNELS_H */
diff --git a/src/kernels_avx.c b/src/kernels_avx.c
new file mode 100644
index 0000000..920fecf
--- /dev/null
+++ b/src/kernels_avx.c
@@ -0,0 +1,439 @@
+/*
+ * embed_kernels_avx.c - x86 SIMD hot kernels (AVX2+FMA, with AVX-512 when available)
+ *
+ * bf16 to f32 conversion: load 16 uint16, zero-extend to 32-bit, shift left 16.
+ * Uses AVX-512F+BW for 16-wide bf16 matvec (dominant for seq_len==1), and
+ * AVX2+FMA / AVX-512F for f32 attention helpers (which operate on cache-resident data).
+ *
+ * The bf16 matvec processes 4 output rows simultaneously to reduce instruction
+ * overhead and improve out-of-order execution on memory-bound workloads.
+ */
+
+#include "kernels_impl.h"
+
+#if defined(__AVX2__) && defined(__FMA__)
+
+#include <immintrin.h>
+#include <string.h>
+
+/* =====================================================================
+ * BF16 matvec - uses AVX-512F+BW when available, AVX2 fallback otherwise
+ * ===================================================================== */
+
+#if defined(__AVX512F__) && defined(__AVX512BW__)
+
+void embed_bf16_matvec_fused_avx(
+ float *y, const float *x, const uint16_t *W_bf16, const float *bias, int in_dim, int out_dim) {
+ int o = 0;
+
+ /* Process 4 output rows at a time */
+ for (; o + 3 < out_dim; o += 4) {
+ const uint16_t *w0 = W_bf16 + (size_t)o * in_dim;
+ const uint16_t *w1 = w0 + in_dim;
+ const uint16_t *w2 = w1 + in_dim;
+ const uint16_t *w3 = w2 + in_dim;
+
+ __m512 a0 = _mm512_setzero_ps(), a1 = _mm512_setzero_ps();
+ __m512 a2 = _mm512_setzero_ps(), a3 = _mm512_setzero_ps();
+ __m512 a4 = _mm512_setzero_ps(), a5 = _mm512_setzero_ps();
+ __m512 a6 = _mm512_setzero_ps(), a7 = _mm512_setzero_ps();
+ int k = 0;
+
+ for (; k + 32 <= in_dim; k += 32) {
+ __m512 xv0 = _mm512_loadu_ps(x + k);
+ __m512 xv1 = _mm512_loadu_ps(x + k + 16);
+
+ /* Row 0 */
+ __m256i r0a = _mm256_loadu_si256((const __m256i *)(w0 + k));
+ __m256i r0b = _mm256_loadu_si256((const __m256i *)(w0 + k + 16));
+ a0 = _mm512_fmadd_ps(
+ _mm512_castsi512_ps(_mm512_slli_epi32(_mm512_cvtepu16_epi32(r0a), 16)), xv0, a0);
+ a1 = _mm512_fmadd_ps(
+ _mm512_castsi512_ps(_mm512_slli_epi32(_mm512_cvtepu16_epi32(r0b), 16)), xv1, a1);
+
+ /* Row 1 */
+ __m256i r1a = _mm256_loadu_si256((const __m256i *)(w1 + k));
+ __m256i r1b = _mm256_loadu_si256((const __m256i *)(w1 + k + 16));
+ a2 = _mm512_fmadd_ps(
+ _mm512_castsi512_ps(_mm512_slli_epi32(_mm512_cvtepu16_epi32(r1a), 16)), xv0, a2);
+ a3 = _mm512_fmadd_ps(
+ _mm512_castsi512_ps(_mm512_slli_epi32(_mm512_cvtepu16_epi32(r1b), 16)), xv1, a3);
+
+ /* Row 2 */
+ __m256i r2a = _mm256_loadu_si256((const __m256i *)(w2 + k));
+ __m256i r2b = _mm256_loadu_si256((const __m256i *)(w2 + k + 16));
+ a4 = _mm512_fmadd_ps(
+ _mm512_castsi512_ps(_mm512_slli_epi32(_mm512_cvtepu16_epi32(r2a), 16)), xv0, a4);
+ a5 = _mm512_fmadd_ps(
+ _mm512_castsi512_ps(_mm512_slli_epi32(_mm512_cvtepu16_epi32(r2b), 16)), xv1, a5);
+
+ /* Row 3 */
+ __m256i r3a = _mm256_loadu_si256((const __m256i *)(w3 + k));
+ __m256i r3b = _mm256_loadu_si256((const __m256i *)(w3 + k + 16));
+ a6 = _mm512_fmadd_ps(
+ _mm512_castsi512_ps(_mm512_slli_epi32(_mm512_cvtepu16_epi32(r3a), 16)), xv0, a6);
+ a7 = _mm512_fmadd_ps(
+ _mm512_castsi512_ps(_mm512_slli_epi32(_mm512_cvtepu16_epi32(r3b), 16)), xv1, a7);
+ }
+
+ for (; k + 16 <= in_dim; k += 16) {
+ __m512 xv = _mm512_loadu_ps(x + k);
+ __m256i r0 = _mm256_loadu_si256((const __m256i *)(w0 + k));
+ __m256i r1 = _mm256_loadu_si256((const __m256i *)(w1 + k));
+ __m256i r2 = _mm256_loadu_si256((const __m256i *)(w2 + k));
+ __m256i r3 = _mm256_loadu_si256((const __m256i *)(w3 + k));
+ a0 = _mm512_fmadd_ps(
+ _mm512_castsi512_ps(_mm512_slli_epi32(_mm512_cvtepu16_epi32(r0), 16)), xv, a0);
+ a2 = _mm512_fmadd_ps(
+ _mm512_castsi512_ps(_mm512_slli_epi32(_mm512_cvtepu16_epi32(r1), 16)), xv, a2);
+ a4 = _mm512_fmadd_ps(
+ _mm512_castsi512_ps(_mm512_slli_epi32(_mm512_cvtepu16_epi32(r2), 16)), xv, a4);
+ a6 = _mm512_fmadd_ps(
+ _mm512_castsi512_ps(_mm512_slli_epi32(_mm512_cvtepu16_epi32(r3), 16)), xv, a6);
+ }
+
+ float s0 = _mm512_reduce_add_ps(_mm512_add_ps(a0, a1)) + (bias ? bias[o] : 0.0f);
+ float s1 = _mm512_reduce_add_ps(_mm512_add_ps(a2, a3)) + (bias ? bias[o + 1] : 0.0f);
+ float s2 = _mm512_reduce_add_ps(_mm512_add_ps(a4, a5)) + (bias ? bias[o + 2] : 0.0f);
+ float s3 = _mm512_reduce_add_ps(_mm512_add_ps(a6, a7)) + (bias ? bias[o + 3] : 0.0f);
+
+ for (; k < in_dim; k++) {
+ float xk = x[k];
+ uint32_t b0 = ((uint32_t)w0[k]) << 16, b1 = ((uint32_t)w1[k]) << 16;
+ uint32_t b2 = ((uint32_t)w2[k]) << 16, b3 = ((uint32_t)w3[k]) << 16;
+ float v0, v1, v2, v3;
+ memcpy(&v0, &b0, 4);
+ memcpy(&v1, &b1, 4);
+ memcpy(&v2, &b2, 4);
+ memcpy(&v3, &b3, 4);
+ s0 += v0 * xk;
+ s1 += v1 * xk;
+ s2 += v2 * xk;
+ s3 += v3 * xk;
+ }
+ y[o] = s0;
+ y[o + 1] = s1;
+ y[o + 2] = s2;
+ y[o + 3] = s3;
+ }
+
+ /* Handle 2-row remainder */
+ for (; o + 1 < out_dim; o += 2) {
+ const uint16_t *w0 = W_bf16 + (size_t)o * in_dim;
+ const uint16_t *w1 = w0 + in_dim;
+ __m512 a0 = _mm512_setzero_ps(), a1 = _mm512_setzero_ps();
+ __m512 a2 = _mm512_setzero_ps(), a3 = _mm512_setzero_ps();
+ int k = 0;
+
+ for (; k + 32 <= in_dim; k += 32) {
+ __m512 xv0 = _mm512_loadu_ps(x + k);
+ __m512 xv1 = _mm512_loadu_ps(x + k + 16);
+ __m256i r0a = _mm256_loadu_si256((const __m256i *)(w0 + k));
+ __m256i r0b = _mm256_loadu_si256((const __m256i *)(w0 + k + 16));
+ __m256i r1a = _mm256_loadu_si256((const __m256i *)(w1 + k));
+ __m256i r1b = _mm256_loadu_si256((const __m256i *)(w1 + k + 16));
+ a0 = _mm512_fmadd_ps(
+ _mm512_castsi512_ps(_mm512_slli_epi32(_mm512_cvtepu16_epi32(r0a), 16)), xv0, a0);
+ a1 = _mm512_fmadd_ps(
+ _mm512_castsi512_ps(_mm512_slli_epi32(_mm512_cvtepu16_epi32(r0b), 16)), xv1, a1);
+ a2 = _mm512_fmadd_ps(
+ _mm512_castsi512_ps(_mm512_slli_epi32(_mm512_cvtepu16_epi32(r1a), 16)), xv0, a2);
+ a3 = _mm512_fmadd_ps(
+ _mm512_castsi512_ps(_mm512_slli_epi32(_mm512_cvtepu16_epi32(r1b), 16)), xv1, a3);
+ }
+ for (; k + 16 <= in_dim; k += 16) {
+ __m512 xv = _mm512_loadu_ps(x + k);
+ __m256i r0 = _mm256_loadu_si256((const __m256i *)(w0 + k));
+ __m256i r1 = _mm256_loadu_si256((const __m256i *)(w1 + k));
+ a0 = _mm512_fmadd_ps(
+ _mm512_castsi512_ps(_mm512_slli_epi32(_mm512_cvtepu16_epi32(r0), 16)), xv, a0);
+ a2 = _mm512_fmadd_ps(
+ _mm512_castsi512_ps(_mm512_slli_epi32(_mm512_cvtepu16_epi32(r1), 16)), xv, a2);
+ }
+
+ float s0 = _mm512_reduce_add_ps(_mm512_add_ps(a0, a1)) + (bias ? bias[o] : 0.0f);
+ float s1 = _mm512_reduce_add_ps(_mm512_add_ps(a2, a3)) + (bias ? bias[o + 1] : 0.0f);
+
+ for (; k < in_dim; k++) {
+ uint32_t b0 = ((uint32_t)w0[k]) << 16, b1 = ((uint32_t)w1[k]) << 16;
+ float v0, v1;
+ memcpy(&v0, &b0, 4);
+ memcpy(&v1, &b1, 4);
+ s0 += v0 * x[k];
+ s1 += v1 * x[k];
+ }
+ y[o] = s0;
+ y[o + 1] = s1;
+ }
+
+ /* Single remaining row */
+ for (; o < out_dim; o++) {
+ const uint16_t *w = W_bf16 + (size_t)o * in_dim;
+ __m512 acc = _mm512_setzero_ps();
+ int k = 0;
+ for (; k + 16 <= in_dim; k += 16) {
+ __m256i raw = _mm256_loadu_si256((const __m256i *)(w + k));
+ acc = _mm512_fmadd_ps(
+ _mm512_castsi512_ps(_mm512_slli_epi32(_mm512_cvtepu16_epi32(raw), 16)),
+ _mm512_loadu_ps(x + k), acc);
+ }
+ float sum = _mm512_reduce_add_ps(acc) + (bias ? bias[o] : 0.0f);
+ for (; k < in_dim; k++) {
+ uint32_t bits = ((uint32_t)w[k]) << 16;
+ float wv;
+ memcpy(&wv, &bits, 4);
+ sum += wv * x[k];
+ }
+ y[o] = sum;
+ }
+}
+
+#else /* AVX2 only (or AVX-512F without BW) */
+
+/* Helper: bf16 to f32 for 8 elements */
+static inline __m256 bf16x8_to_f32(__m128i raw) {
+ return _mm256_castsi256_ps(_mm256_slli_epi32(_mm256_cvtepu16_epi32(raw), 16));
+}
+
+static inline void bf16x16_to_f32(const uint16_t *src, __m256 *lo, __m256 *hi) {
+ __m256i raw = _mm256_loadu_si256((const __m256i *)src);
+ *lo = bf16x8_to_f32(_mm256_castsi256_si128(raw));
+ *hi = bf16x8_to_f32(_mm256_extracti128_si256(raw, 1));
+}
+
+void embed_bf16_matvec_fused_avx(
+ float *y, const float *x, const uint16_t *W_bf16, const float *bias, int in_dim, int out_dim) {
+ int o = 0;
+
+ for (; o + 1 < out_dim; o += 2) {
+ const uint16_t *w0 = W_bf16 + (size_t)o * in_dim;
+ const uint16_t *w1 = w0 + in_dim;
+ __m256 a0 = _mm256_setzero_ps(), a1 = _mm256_setzero_ps();
+ __m256 a2 = _mm256_setzero_ps(), a3 = _mm256_setzero_ps();
+ int k = 0;
+ for (; k + 16 <= in_dim; k += 16) {
+ __m256 xlo = _mm256_loadu_ps(x + k);
+ __m256 xhi = _mm256_loadu_ps(x + k + 8);
+ __m256 wlo, whi;
+ bf16x16_to_f32(w0 + k, &wlo, &whi);
+ a0 = _mm256_fmadd_ps(wlo, xlo, a0);
+ a1 = _mm256_fmadd_ps(whi, xhi, a1);
+ bf16x16_to_f32(w1 + k, &wlo, &whi);
+ a2 = _mm256_fmadd_ps(wlo, xlo, a2);
+ a3 = _mm256_fmadd_ps(whi, xhi, a3);
+ }
+ a0 = _mm256_add_ps(a0, a1);
+ a2 = _mm256_add_ps(a2, a3);
+ __m128 r0 = _mm_add_ps(_mm256_castps256_ps128(a0), _mm256_extractf128_ps(a0, 1));
+ __m128 r1 = _mm_add_ps(_mm256_castps256_ps128(a2), _mm256_extractf128_ps(a2, 1));
+ r0 = _mm_hadd_ps(r0, r1);
+ r0 = _mm_hadd_ps(r0, r0);
+ float s0 = _mm_cvtss_f32(r0) + (bias ? bias[o] : 0.0f);
+ float s1 = _mm_cvtss_f32(_mm_shuffle_ps(r0, r0, 1)) + (bias ? bias[o + 1] : 0.0f);
+ for (; k < in_dim; k++) {
+ uint32_t b0 = ((uint32_t)w0[k]) << 16, b1 = ((uint32_t)w1[k]) << 16;
+ float v0, v1;
+ memcpy(&v0, &b0, 4);
+ memcpy(&v1, &b1, 4);
+ s0 += v0 * x[k];
+ s1 += v1 * x[k];
+ }
+ y[o] = s0;
+ y[o + 1] = s1;
+ }
+ for (; o < out_dim; o++) {
+ const uint16_t *w = W_bf16 + (size_t)o * in_dim;
+ __m256 a0 = _mm256_setzero_ps(), a1 = _mm256_setzero_ps();
+ int k = 0;
+ for (; k + 16 <= in_dim; k += 16) {
+ __m256 wlo, whi;
+ bf16x16_to_f32(w + k, &wlo, &whi);
+ a0 = _mm256_fmadd_ps(wlo, _mm256_loadu_ps(x + k), a0);
+ a1 = _mm256_fmadd_ps(whi, _mm256_loadu_ps(x + k + 8), a1);
+ }
+ a0 = _mm256_add_ps(a0, a1);
+ __m128 r = _mm_add_ps(_mm256_castps256_ps128(a0), _mm256_extractf128_ps(a0, 1));
+ r = _mm_hadd_ps(r, r);
+ r = _mm_hadd_ps(r, r);
+ float sum = _mm_cvtss_f32(r) + (bias ? bias[o] : 0.0f);
+ for (; k < in_dim; k++) {
+ uint32_t bits = ((uint32_t)w[k]) << 16;
+ float wv;
+ memcpy(&wv, &bits, 4);
+ sum += wv * x[k];
+ }
+ y[o] = sum;
+ }
+}
+
+#endif /* AVX-512F+BW vs AVX2 for bf16 */
+
+/* =====================================================================
+ * f32 attention helpers - AVX2+FMA, with AVX-512F when available
+ * (operates on L1-resident head vectors)
+ * ===================================================================== */
+
+float embed_dot_f32_avx(const float *a, const float *b, int n) {
+#if defined(__AVX512F__)
+ int i = 0;
+ __m512 acc0 = _mm512_setzero_ps();
+ __m512 acc1 = _mm512_setzero_ps();
+ __m512 acc2 = _mm512_setzero_ps();
+ __m512 acc3 = _mm512_setzero_ps();
+ for (; i + 64 <= n; i += 64) {
+ acc0 = _mm512_fmadd_ps(_mm512_loadu_ps(a + i), _mm512_loadu_ps(b + i), acc0);
+ acc1 = _mm512_fmadd_ps(_mm512_loadu_ps(a + i + 16), _mm512_loadu_ps(b + i + 16), acc1);
+ acc2 = _mm512_fmadd_ps(_mm512_loadu_ps(a + i + 32), _mm512_loadu_ps(b + i + 32), acc2);
+ acc3 = _mm512_fmadd_ps(_mm512_loadu_ps(a + i + 48), _mm512_loadu_ps(b + i + 48), acc3);
+ }
+ __m512 acc = _mm512_add_ps(_mm512_add_ps(acc0, acc1), _mm512_add_ps(acc2, acc3));
+ for (; i + 16 <= n; i += 16) {
+ acc = _mm512_fmadd_ps(_mm512_loadu_ps(a + i), _mm512_loadu_ps(b + i), acc);
+ }
+ float sum = _mm512_reduce_add_ps(acc);
+ for (; i < n; i++)
+ sum += a[i] * b[i];
+ return sum;
+#else
+ int i = 0;
+ __m256 acc0 = _mm256_setzero_ps();
+ __m256 acc1 = _mm256_setzero_ps();
+ __m256 acc2 = _mm256_setzero_ps();
+ __m256 acc3 = _mm256_setzero_ps();
+ for (; i + 32 <= n; i += 32) {
+ acc0 = _mm256_fmadd_ps(_mm256_loadu_ps(a + i), _mm256_loadu_ps(b + i), acc0);
+ acc1 = _mm256_fmadd_ps(_mm256_loadu_ps(a + i + 8), _mm256_loadu_ps(b + i + 8), acc1);
+ acc2 = _mm256_fmadd_ps(_mm256_loadu_ps(a + i + 16), _mm256_loadu_ps(b + i + 16), acc2);
+ acc3 = _mm256_fmadd_ps(_mm256_loadu_ps(a + i + 24), _mm256_loadu_ps(b + i + 24), acc3);
+ }
+ acc0 = _mm256_add_ps(_mm256_add_ps(acc0, acc1), _mm256_add_ps(acc2, acc3));
+ for (; i + 8 <= n; i += 8) {
+ acc0 = _mm256_fmadd_ps(_mm256_loadu_ps(a + i), _mm256_loadu_ps(b + i), acc0);
+ }
+ __m128 r = _mm_add_ps(_mm256_castps256_ps128(acc0), _mm256_extractf128_ps(acc0, 1));
+ r = _mm_hadd_ps(r, r);
+ r = _mm_hadd_ps(r, r);
+ float sum = _mm_cvtss_f32(r);
+ for (; i < n; i++)
+ sum += a[i] * b[i];
+ return sum;
+#endif
+}
+
+void embed_vec_scale_inplace_avx(float *dst, float scale, int n) {
+#if defined(__AVX512F__)
+ int i = 0;
+ __m512 s = _mm512_set1_ps(scale);
+ for (; i + 64 <= n; i += 64) {
+ _mm512_storeu_ps(dst + i, _mm512_mul_ps(_mm512_loadu_ps(dst + i), s));
+ _mm512_storeu_ps(dst + i + 16, _mm512_mul_ps(_mm512_loadu_ps(dst + i + 16), s));
+ _mm512_storeu_ps(dst + i + 32, _mm512_mul_ps(_mm512_loadu_ps(dst + i + 32), s));
+ _mm512_storeu_ps(dst + i + 48, _mm512_mul_ps(_mm512_loadu_ps(dst + i + 48), s));
+ }
+ for (; i + 16 <= n; i += 16) {
+ _mm512_storeu_ps(dst + i, _mm512_mul_ps(_mm512_loadu_ps(dst + i), s));
+ }
+ for (; i < n; i++)
+ dst[i] *= scale;
+#else
+ int i = 0;
+ __m256 s = _mm256_set1_ps(scale);
+ for (; i + 32 <= n; i += 32) {
+ _mm256_storeu_ps(dst + i, _mm256_mul_ps(_mm256_loadu_ps(dst + i), s));
+ _mm256_storeu_ps(dst + i + 8, _mm256_mul_ps(_mm256_loadu_ps(dst + i + 8), s));
+ _mm256_storeu_ps(dst + i + 16, _mm256_mul_ps(_mm256_loadu_ps(dst + i + 16), s));
+ _mm256_storeu_ps(dst + i + 24, _mm256_mul_ps(_mm256_loadu_ps(dst + i + 24), s));
+ }
+ for (; i + 8 <= n; i += 8) {
+ _mm256_storeu_ps(dst + i, _mm256_mul_ps(_mm256_loadu_ps(dst + i), s));
+ }
+ for (; i < n; i++)
+ dst[i] *= scale;
+#endif
+}
+
+void embed_vec_axpy_inplace_avx(float *dst, const float *src, float alpha, int n) {
+#if defined(__AVX512F__)
+ int i = 0;
+ __m512 a = _mm512_set1_ps(alpha);
+ for (; i + 64 <= n; i += 64) {
+ _mm512_storeu_ps(dst + i,
+ _mm512_fmadd_ps(_mm512_loadu_ps(src + i), a, _mm512_loadu_ps(dst + i)));
+ _mm512_storeu_ps(dst + i + 16, _mm512_fmadd_ps(_mm512_loadu_ps(src + i + 16), a,
+ _mm512_loadu_ps(dst + i + 16)));
+ _mm512_storeu_ps(dst + i + 32, _mm512_fmadd_ps(_mm512_loadu_ps(src + i + 32), a,
+ _mm512_loadu_ps(dst + i + 32)));
+ _mm512_storeu_ps(dst + i + 48, _mm512_fmadd_ps(_mm512_loadu_ps(src + i + 48), a,
+ _mm512_loadu_ps(dst + i + 48)));
+ }
+ for (; i + 16 <= n; i += 16) {
+ _mm512_storeu_ps(dst + i,
+ _mm512_fmadd_ps(_mm512_loadu_ps(src + i), a, _mm512_loadu_ps(dst + i)));
+ }
+ for (; i < n; i++)
+ dst[i] += alpha * src[i];
+#else
+ int i = 0;
+ __m256 a = _mm256_set1_ps(alpha);
+ for (; i + 32 <= n; i += 32) {
+ _mm256_storeu_ps(dst + i,
+ _mm256_fmadd_ps(_mm256_loadu_ps(src + i), a, _mm256_loadu_ps(dst + i)));
+ _mm256_storeu_ps(dst + i + 8, _mm256_fmadd_ps(_mm256_loadu_ps(src + i + 8), a,
+ _mm256_loadu_ps(dst + i + 8)));
+ _mm256_storeu_ps(dst + i + 16, _mm256_fmadd_ps(_mm256_loadu_ps(src + i + 16), a,
+ _mm256_loadu_ps(dst + i + 16)));
+ _mm256_storeu_ps(dst + i + 24, _mm256_fmadd_ps(_mm256_loadu_ps(src + i + 24), a,
+ _mm256_loadu_ps(dst + i + 24)));
+ }
+ for (; i + 8 <= n; i += 8) {
+ _mm256_storeu_ps(dst + i,
+ _mm256_fmadd_ps(_mm256_loadu_ps(src + i), a, _mm256_loadu_ps(dst + i)));
+ }
+ for (; i < n; i++)
+ dst[i] += alpha * src[i];
+#endif
+}
+
+void embed_vec_scale_add_avx(float *dst, const float *src, float correction, int n) {
+#if defined(__AVX512F__)
+ int i = 0;
+ __m512 c = _mm512_set1_ps(correction);
+ for (; i + 64 <= n; i += 64) {
+ _mm512_storeu_ps(dst + i,
+ _mm512_fmadd_ps(_mm512_loadu_ps(dst + i), c, _mm512_loadu_ps(src + i)));
+ _mm512_storeu_ps(dst + i + 16, _mm512_fmadd_ps(_mm512_loadu_ps(dst + i + 16), c,
+ _mm512_loadu_ps(src + i + 16)));
+ _mm512_storeu_ps(dst + i + 32, _mm512_fmadd_ps(_mm512_loadu_ps(dst + i + 32), c,
+ _mm512_loadu_ps(src + i + 32)));
+ _mm512_storeu_ps(dst + i + 48, _mm512_fmadd_ps(_mm512_loadu_ps(dst + i + 48), c,
+ _mm512_loadu_ps(src + i + 48)));
+ }
+ for (; i + 16 <= n; i += 16) {
+ _mm512_storeu_ps(dst + i,
+ _mm512_fmadd_ps(_mm512_loadu_ps(dst + i), c, _mm512_loadu_ps(src + i)));
+ }
+ for (; i < n; i++)
+ dst[i] = dst[i] * correction + src[i];
+#else
+ int i = 0;
+ __m256 c = _mm256_set1_ps(correction);
+ for (; i + 32 <= n; i += 32) {
+ _mm256_storeu_ps(dst + i,
+ _mm256_fmadd_ps(_mm256_loadu_ps(dst + i), c, _mm256_loadu_ps(src + i)));
+ _mm256_storeu_ps(dst + i + 8, _mm256_fmadd_ps(_mm256_loadu_ps(dst + i + 8), c,
+ _mm256_loadu_ps(src + i + 8)));
+ _mm256_storeu_ps(dst + i + 16, _mm256_fmadd_ps(_mm256_loadu_ps(dst + i + 16), c,
+ _mm256_loadu_ps(src + i + 16)));
+ _mm256_storeu_ps(dst + i + 24, _mm256_fmadd_ps(_mm256_loadu_ps(dst + i + 24), c,
+ _mm256_loadu_ps(src + i + 24)));
+ }
+ for (; i + 8 <= n; i += 8) {
+ _mm256_storeu_ps(dst + i,
+ _mm256_fmadd_ps(_mm256_loadu_ps(dst + i), c, _mm256_loadu_ps(src + i)));
+ }
+ for (; i < n; i++)
+ dst[i] = dst[i] * correction + src[i];
+#endif
+}
+
+#endif /* __AVX2__ && __FMA__ */
diff --git a/src/kernels_generic.c b/src/kernels_generic.c
new file mode 100644
index 0000000..7e85298
--- /dev/null
+++ b/src/kernels_generic.c
@@ -0,0 +1,44 @@
+/*
+ * embed_kernels_generic.c - architecture-generic hot kernels
+ */
+
+#include "kernels_impl.h"
+
+#include <string.h>
+
+void embed_bf16_matvec_fused_generic(
+ float *y, const float *x, const uint16_t *W_bf16, const float *bias, int in_dim, int out_dim) {
+ for (int o = 0; o < out_dim; o++) {
+ const uint16_t *w_row = W_bf16 + (size_t)o * in_dim;
+ float sum = bias ? bias[o] : 0.0f;
+ for (int k = 0; k < in_dim; k++) {
+ uint32_t f32_bits = ((uint32_t)w_row[k]) << 16;
+ float w_val;
+ memcpy(&w_val, &f32_bits, sizeof(float));
+ sum += w_val * x[k];
+ }
+ y[o] = sum;
+ }
+}
+
+float embed_dot_f32_generic(const float *a, const float *b, int n) {
+ float sum = 0.0f;
+ for (int i = 0; i < n; i++)
+ sum += a[i] * b[i];
+ return sum;
+}
+
+void embed_vec_scale_inplace_generic(float *dst, float scale, int n) {
+ for (int i = 0; i < n; i++)
+ dst[i] *= scale;
+}
+
+void embed_vec_axpy_inplace_generic(float *dst, const float *src, float alpha, int n) {
+ for (int i = 0; i < n; i++)
+ dst[i] += alpha * src[i];
+}
+
+void embed_vec_scale_add_generic(float *dst, const float *src, float correction, int n) {
+ for (int i = 0; i < n; i++)
+ dst[i] = dst[i] * correction + src[i];
+}
diff --git a/src/kernels_impl.h b/src/kernels_impl.h
new file mode 100644
index 0000000..4ee7d74
--- /dev/null
+++ b/src/kernels_impl.h
@@ -0,0 +1,53 @@
+/*
+ * embed_kernels_impl.h - internal architecture dispatch for hot kernels
+ */
+
+#ifndef EMBED_KERNELS_IMPL_H
+#define EMBED_KERNELS_IMPL_H
+
+#include <stdint.h>
+
+void embed_bf16_matvec_fused_generic(
+ float *y, const float *x, const uint16_t *W_bf16, const float *bias, int in_dim, int out_dim);
+float embed_dot_f32_generic(const float *a, const float *b, int n);
+void embed_vec_scale_inplace_generic(float *dst, float scale, int n);
+void embed_vec_axpy_inplace_generic(float *dst, const float *src, float alpha, int n);
+void embed_vec_scale_add_generic(float *dst, const float *src, float correction, int n);
+
+#ifdef __ARM_NEON
+void embed_bf16_matvec_fused_neon(
+ float *y, const float *x, const uint16_t *W_bf16, const float *bias, int in_dim, int out_dim);
+float embed_dot_f32_neon(const float *a, const float *b, int n);
+void embed_vec_scale_inplace_neon(float *dst, float scale, int n);
+void embed_vec_axpy_inplace_neon(float *dst, const float *src, float alpha, int n);
+void embed_vec_scale_add_neon(float *dst, const float *src, float correction, int n);
+
+#define embed_bf16_matvec_fused_impl embed_bf16_matvec_fused_neon
+#define embed_dot_f32_impl embed_dot_f32_neon
+#define embed_vec_scale_inplace_impl embed_vec_scale_inplace_neon
+#define embed_vec_axpy_inplace_impl embed_vec_axpy_inplace_neon
+#define embed_vec_scale_add_impl embed_vec_scale_add_neon
+
+#elif defined(__AVX2__) && defined(__FMA__)
+void embed_bf16_matvec_fused_avx(
+ float *y, const float *x, const uint16_t *W_bf16, const float *bias, int in_dim, int out_dim);
+float embed_dot_f32_avx(const float *a, const float *b, int n);
+void embed_vec_scale_inplace_avx(float *dst, float scale, int n);
+void embed_vec_axpy_inplace_avx(float *dst, const float *src, float alpha, int n);
+void embed_vec_scale_add_avx(float *dst, const float *src, float correction, int n);
+
+#define embed_bf16_matvec_fused_impl embed_bf16_matvec_fused_avx
+#define embed_dot_f32_impl embed_dot_f32_avx
+#define embed_vec_scale_inplace_impl embed_vec_scale_inplace_avx
+#define embed_vec_axpy_inplace_impl embed_vec_axpy_inplace_avx
+#define embed_vec_scale_add_impl embed_vec_scale_add_avx
+
+#else
+#define embed_bf16_matvec_fused_impl embed_bf16_matvec_fused_generic
+#define embed_dot_f32_impl embed_dot_f32_generic
+#define embed_vec_scale_inplace_impl embed_vec_scale_inplace_generic
+#define embed_vec_axpy_inplace_impl embed_vec_axpy_inplace_generic
+#define embed_vec_scale_add_impl embed_vec_scale_add_generic
+#endif
+
+#endif /* EMBED_KERNELS_IMPL_H */
diff --git a/src/kernels_neon.c b/src/kernels_neon.c
new file mode 100644
index 0000000..3e2a423
--- /dev/null
+++ b/src/kernels_neon.c
@@ -0,0 +1,179 @@
+/*
+ * embed_kernels_neon.c - ARM NEON hot kernels
+ */
+
+#include "kernels_impl.h"
+
+#ifdef __ARM_NEON
+
+#include <arm_neon.h>
+#include <string.h>
+
+void embed_bf16_matvec_fused_neon(
+ float *y, const float *x, const uint16_t *W_bf16, const float *bias, int in_dim, int out_dim) {
+ int o = 0;
+
+ /* Process 2 output rows at a time, 32 elements/iter, 8 accumulators */
+ for (; o + 1 < out_dim; o += 2) {
+ const uint16_t *w0 = W_bf16 + (size_t)o * in_dim;
+ const uint16_t *w1 = W_bf16 + (size_t)(o + 1) * in_dim;
+ float s0 = bias ? bias[o] : 0.0f;
+ float s1 = bias ? bias[o + 1] : 0.0f;
+
+ float32x4_t a0 = vdupq_n_f32(0.0f), a1 = vdupq_n_f32(0.0f);
+ float32x4_t a2 = vdupq_n_f32(0.0f), a3 = vdupq_n_f32(0.0f);
+ float32x4_t b0 = vdupq_n_f32(0.0f), b1 = vdupq_n_f32(0.0f);
+ float32x4_t b2 = vdupq_n_f32(0.0f), b3 = vdupq_n_f32(0.0f);
+ int k = 0;
+
+ for (; k + 32 <= in_dim; k += 32) {
+ float32x4_t x0 = vld1q_f32(x + k);
+ float32x4_t x1 = vld1q_f32(x + k + 4);
+ float32x4_t x2 = vld1q_f32(x + k + 8);
+ float32x4_t x3 = vld1q_f32(x + k + 12);
+ float32x4_t x4 = vld1q_f32(x + k + 16);
+ float32x4_t x5 = vld1q_f32(x + k + 20);
+ float32x4_t x6 = vld1q_f32(x + k + 24);
+ float32x4_t x7 = vld1q_f32(x + k + 28);
+
+ uint16x8_t r0a = vld1q_u16(w0 + k);
+ uint16x8_t r0b = vld1q_u16(w0 + k + 8);
+ uint16x8_t r0c = vld1q_u16(w0 + k + 16);
+ uint16x8_t r0d = vld1q_u16(w0 + k + 24);
+ a0 = vfmaq_f32(a0, vreinterpretq_f32_u32(vshll_n_u16(vget_low_u16(r0a), 16)), x0);
+ a1 = vfmaq_f32(a1, vreinterpretq_f32_u32(vshll_n_u16(vget_high_u16(r0a), 16)), x1);
+ a2 = vfmaq_f32(a2, vreinterpretq_f32_u32(vshll_n_u16(vget_low_u16(r0b), 16)), x2);
+ a3 = vfmaq_f32(a3, vreinterpretq_f32_u32(vshll_n_u16(vget_high_u16(r0b), 16)), x3);
+ a0 = vfmaq_f32(a0, vreinterpretq_f32_u32(vshll_n_u16(vget_low_u16(r0c), 16)), x4);
+ a1 = vfmaq_f32(a1, vreinterpretq_f32_u32(vshll_n_u16(vget_high_u16(r0c), 16)), x5);
+ a2 = vfmaq_f32(a2, vreinterpretq_f32_u32(vshll_n_u16(vget_low_u16(r0d), 16)), x6);
+ a3 = vfmaq_f32(a3, vreinterpretq_f32_u32(vshll_n_u16(vget_high_u16(r0d), 16)), x7);
+
+ uint16x8_t r1a = vld1q_u16(w1 + k);
+ uint16x8_t r1b = vld1q_u16(w1 + k + 8);
+ uint16x8_t r1c = vld1q_u16(w1 + k + 16);
+ uint16x8_t r1d = vld1q_u16(w1 + k + 24);
+ b0 = vfmaq_f32(b0, vreinterpretq_f32_u32(vshll_n_u16(vget_low_u16(r1a), 16)), x0);
+ b1 = vfmaq_f32(b1, vreinterpretq_f32_u32(vshll_n_u16(vget_high_u16(r1a), 16)), x1);
+ b2 = vfmaq_f32(b2, vreinterpretq_f32_u32(vshll_n_u16(vget_low_u16(r1b), 16)), x2);
+ b3 = vfmaq_f32(b3, vreinterpretq_f32_u32(vshll_n_u16(vget_high_u16(r1b), 16)), x3);
+ b0 = vfmaq_f32(b0, vreinterpretq_f32_u32(vshll_n_u16(vget_low_u16(r1c), 16)), x4);
+ b1 = vfmaq_f32(b1, vreinterpretq_f32_u32(vshll_n_u16(vget_high_u16(r1c), 16)), x5);
+ b2 = vfmaq_f32(b2, vreinterpretq_f32_u32(vshll_n_u16(vget_low_u16(r1d), 16)), x6);
+ b3 = vfmaq_f32(b3, vreinterpretq_f32_u32(vshll_n_u16(vget_high_u16(r1d), 16)), x7);
+ }
+ for (; k + 8 <= in_dim; k += 8) {
+ float32x4_t x0 = vld1q_f32(x + k);
+ float32x4_t x1 = vld1q_f32(x + k + 4);
+ uint16x8_t r0 = vld1q_u16(w0 + k);
+ uint16x8_t r1 = vld1q_u16(w1 + k);
+ a0 = vfmaq_f32(a0, vreinterpretq_f32_u32(vshll_n_u16(vget_low_u16(r0), 16)), x0);
+ a1 = vfmaq_f32(a1, vreinterpretq_f32_u32(vshll_n_u16(vget_high_u16(r0), 16)), x1);
+ b0 = vfmaq_f32(b0, vreinterpretq_f32_u32(vshll_n_u16(vget_low_u16(r1), 16)), x0);
+ b1 = vfmaq_f32(b1, vreinterpretq_f32_u32(vshll_n_u16(vget_high_u16(r1), 16)), x1);
+ }
+ s0 += vaddvq_f32(vaddq_f32(vaddq_f32(a0, a2), vaddq_f32(a1, a3)));
+ s1 += vaddvq_f32(vaddq_f32(vaddq_f32(b0, b2), vaddq_f32(b1, b3)));
+
+ for (; k < in_dim; k++) {
+ uint32_t bits0 = ((uint32_t)w0[k]) << 16;
+ uint32_t bits1 = ((uint32_t)w1[k]) << 16;
+ float wv0, wv1;
+ memcpy(&wv0, &bits0, sizeof(float));
+ memcpy(&wv1, &bits1, sizeof(float));
+ s0 += wv0 * x[k];
+ s1 += wv1 * x[k];
+ }
+ y[o] = s0;
+ y[o + 1] = s1;
+ }
+
+ /* Handle remaining odd row */
+ for (; o < out_dim; o++) {
+ const uint16_t *w_row = W_bf16 + (size_t)o * in_dim;
+ float sum = bias ? bias[o] : 0.0f;
+ int k = 0;
+
+ float32x4_t acc0 = vdupq_n_f32(0.0f);
+ float32x4_t acc1 = vdupq_n_f32(0.0f);
+ for (; k + 8 <= in_dim; k += 8) {
+ uint16x8_t bf = vld1q_u16(w_row + k);
+ acc0 = vfmaq_f32(acc0, vreinterpretq_f32_u32(vshll_n_u16(vget_low_u16(bf), 16)),
+ vld1q_f32(x + k));
+ acc1 = vfmaq_f32(acc1, vreinterpretq_f32_u32(vshll_n_u16(vget_high_u16(bf), 16)),
+ vld1q_f32(x + k + 4));
+ }
+ sum += vaddvq_f32(vaddq_f32(acc0, acc1));
+
+ for (; k < in_dim; k++) {
+ uint32_t f32_bits = ((uint32_t)w_row[k]) << 16;
+ float w_val;
+ memcpy(&w_val, &f32_bits, sizeof(float));
+ sum += w_val * x[k];
+ }
+ y[o] = sum;
+ }
+}
+
+float embed_dot_f32_neon(const float *a, const float *b, int n) {
+ int i = 0;
+ float32x4_t acc0 = vdupq_n_f32(0.0f);
+ float32x4_t acc1 = vdupq_n_f32(0.0f);
+ for (; i + 8 <= n; i += 8) {
+ float32x4_t a0 = vld1q_f32(a + i);
+ float32x4_t b0 = vld1q_f32(b + i);
+ float32x4_t a1 = vld1q_f32(a + i + 4);
+ float32x4_t b1 = vld1q_f32(b + i + 4);
+ acc0 = vfmaq_f32(acc0, a0, b0);
+ acc1 = vfmaq_f32(acc1, a1, b1);
+ }
+ float sum = vaddvq_f32(vaddq_f32(acc0, acc1));
+ for (; i < n; i++)
+ sum += a[i] * b[i];
+ return sum;
+}
+
+void embed_vec_scale_inplace_neon(float *dst, float scale, int n) {
+ int i = 0;
+ float32x4_t s = vdupq_n_f32(scale);
+ for (; i + 8 <= n; i += 8) {
+ float32x4_t d0 = vld1q_f32(dst + i);
+ float32x4_t d1 = vld1q_f32(dst + i + 4);
+ vst1q_f32(dst + i, vfmaq_f32(vdupq_n_f32(0.0f), d0, s));
+ vst1q_f32(dst + i + 4, vfmaq_f32(vdupq_n_f32(0.0f), d1, s));
+ }
+ for (; i < n; i++)
+ dst[i] *= scale;
+}
+
+void embed_vec_axpy_inplace_neon(float *dst, const float *src, float alpha, int n) {
+ int i = 0;
+ float32x4_t a = vdupq_n_f32(alpha);
+ for (; i + 8 <= n; i += 8) {
+ float32x4_t d0 = vld1q_f32(dst + i);
+ float32x4_t s0 = vld1q_f32(src + i);
+ float32x4_t d1 = vld1q_f32(dst + i + 4);
+ float32x4_t s1 = vld1q_f32(src + i + 4);
+ vst1q_f32(dst + i, vfmaq_f32(d0, s0, a));
+ vst1q_f32(dst + i + 4, vfmaq_f32(d1, s1, a));
+ }
+ for (; i < n; i++)
+ dst[i] += alpha * src[i];
+}
+
+void embed_vec_scale_add_neon(float *dst, const float *src, float correction, int n) {
+ int i = 0;
+ float32x4_t c = vdupq_n_f32(correction);
+ for (; i + 8 <= n; i += 8) {
+ float32x4_t d0 = vld1q_f32(dst + i);
+ float32x4_t s0 = vld1q_f32(src + i);
+ float32x4_t d1 = vld1q_f32(dst + i + 4);
+ float32x4_t s1 = vld1q_f32(src + i + 4);
+ vst1q_f32(dst + i, vfmaq_f32(s0, d0, c));
+ vst1q_f32(dst + i + 4, vfmaq_f32(s1, d1, c));
+ }
+ for (; i < n; i++)
+ dst[i] = dst[i] * correction + src[i];
+}
+
+#endif /* __ARM_NEON */
diff --git a/src/mlx.c b/src/mlx.c
new file mode 100644
index 0000000..bfa466c
--- /dev/null
+++ b/src/mlx.c
@@ -0,0 +1,2752 @@
+#include "mlx.h"
+#include "config.h"
+#include "embed.h"
+#include "safetensors.h"
+
+#include <mlx/c/mlx.h>
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <math.h>
+#include <limits.h>
+#include <float.h>
+
+/* ========================================================================
+ * Per-layer MLX weight arrays
+ * ======================================================================== */
+
+typedef struct {
+ mlx_array w;
+ mlx_array wt;
+ mlx_array scales;
+ mlx_array biases;
+ int quantized;
+ int bits;
+ int group_size;
+} mlx_linear_t;
+
+typedef struct {
+ mlx_linear_t wq, wk, wv, wo;
+ mlx_array q_bias, k_bias, v_bias;
+ mlx_array q_norm, k_norm;
+ mlx_array input_norm, post_attn_norm;
+ mlx_linear_t gate_proj, up_proj, down_proj;
+ /* BERT family (unset for Qwen3; see embed_internal.h). wo/up_proj/down_proj
+ * and input_norm/post_attn_norm are reused as the BERT attention output,
+ * FFN matrices, and the two block LayerNorm weights. */
+ mlx_array o_bias, attn_ln_bias, ffn_inter_bias, ffn_out_bias, ffn_ln_bias;
+} mlx_layer_t;
+
+struct embed_mlx_ctx {
+ embed_config_t config;
+ mlx_array embed_tokens;
+ mlx_layer_t *layers; /* heap-allocated [n_layers] */
+ mlx_array norm;
+ /* BERT family (unset for Qwen3): learned positions, token-type, embed LN. */
+ mlx_array position_embeddings, token_type_embeddings, embed_ln_w, embed_ln_b;
+ mlx_stream stream;
+ multi_safetensors_t *ms;
+ int layer_start; /* loaded transformer range, inclusive */
+ int layer_end; /* loaded transformer range, exclusive */
+ int quantize_bits;
+ int quantize_group_size;
+ mlx_dtype weight_dtype;
+};
+
+struct embed_mlx_late_ctx {
+ embed_mlx_ctx_t *base;
+ multi_safetensors_t *dense_ms;
+ mlx_linear_t projection;
+ int token_dim;
+};
+
+struct embed_mlx_late_vectors {
+ embed_mlx_late_ctx_t *owner;
+ mlx_array vectors; /* [tokens, dim] */
+ int tokens;
+ int dim;
+};
+
+/* ========================================================================
+ * Helpers
+ * ======================================================================== */
+
+static int arr_ok(mlx_array a) { return a.ctx != NULL; }
+
+static int mlx_mul_size(size_t a, size_t b, size_t *out) {
+ if (a != 0 && b > SIZE_MAX / a)
+ return -1;
+ *out = a * b;
+ return 0;
+}
+
+static mlx_dtype mlx_weight_dtype(const embed_mlx_ctx_t *ctx) { return ctx->weight_dtype; }
+
+static size_t safetensor_dtype_size(safetensor_dtype_t dtype) {
+ switch (dtype) {
+ case DTYPE_F32:
+ return sizeof(float);
+ case DTYPE_BF16:
+ return sizeof(uint16_t);
+ default:
+ return 0;
+ }
+}
+
+static int mlx_tensor_has_supported_shape(const safetensors_file_t *sf,
+ const safetensor_t *t,
+ const char *name,
+ const int *shape,
+ int ndim) {
+ size_t elem_size = safetensor_dtype_size(t->dtype);
+ if (elem_size == 0) {
+ fprintf(stderr, "mlx: expected F32 or BF16 for %s\n", name);
+ return 0;
+ }
+ if (t->ndim != ndim) {
+ fprintf(stderr, "mlx: bad rank for %s: got %d, expected %d\n", name, t->ndim, ndim);
+ return 0;
+ }
+
+ size_t numel = 1;
+ for (int i = 0; i < ndim; i++) {
+ if (shape[i] <= 0 || t->shape[i] != shape[i]) {
+ fprintf(stderr,
+ "mlx: bad shape for %s at dim %d: "
+ "got %lld, expected %d\n",
+ name, i, (long long)t->shape[i], shape[i]);
+ return 0;
+ }
+ if (mlx_mul_size(numel, (size_t)shape[i], &numel) != 0) {
+ fprintf(stderr, "mlx: shape too large for %s\n", name);
+ return 0;
+ }
+ }
+
+ size_t bytes;
+ if (mlx_mul_size(numel, elem_size, &bytes) != 0) {
+ fprintf(stderr, "mlx: tensor data too large for %s\n", name);
+ return 0;
+ }
+ if (t->data_size != bytes) {
+ fprintf(stderr, "mlx: bad data size for %s: got %zu, expected %zu\n", name, t->data_size,
+ bytes);
+ return 0;
+ }
+
+ if (sf->header_size > SIZE_MAX - 8)
+ return 0;
+ size_t data_start = 8 + sf->header_size;
+ if (data_start > sf->file_size || t->data_offset > sf->file_size - data_start ||
+ t->data_size > sf->file_size - data_start - t->data_offset) {
+ fprintf(stderr, "mlx: tensor data out of bounds for %s\n", name);
+ return 0;
+ }
+ return 1;
+}
+
+static mlx_array
+load_tensor(multi_safetensors_t *ms, const char *name, const int *shape, int ndim) {
+ safetensors_file_t *sf = NULL;
+ const safetensor_t *t = multi_safetensors_find(ms, name, &sf);
+ if (!t) {
+ fprintf(stderr, "mlx: tensor not found: %s\n", name);
+ return (mlx_array){0};
+ }
+ if (!mlx_tensor_has_supported_shape(sf, t, name, shape, ndim))
+ return (mlx_array){0};
+ mlx_dtype dtype;
+ if (t->dtype == DTYPE_F32) {
+ dtype = MLX_FLOAT32;
+ } else if (t->dtype == DTYPE_BF16) {
+ dtype = MLX_BFLOAT16;
+ } else {
+ fprintf(stderr, "mlx: expected F32 or BF16 for %s\n", name);
+ return (mlx_array){0};
+ }
+ return mlx_array_new_data(safetensors_data(sf, t), shape, ndim, dtype);
+}
+
+static mlx_linear_t
+load_linear_tensor(multi_safetensors_t *ms, const char *name, const int *shape, int ndim) {
+ mlx_linear_t l = {0};
+ l.w = load_tensor(ms, name, shape, ndim);
+ return l;
+}
+
+static int linear_ok(mlx_linear_t l) { return arr_ok(l.w) || arr_ok(l.wt); }
+
+static void free_linear(mlx_linear_t *l) {
+ mlx_array_free(l->w);
+ mlx_array_free(l->wt);
+ mlx_array_free(l->scales);
+ mlx_array_free(l->biases);
+ memset(l, 0, sizeof(*l));
+}
+
+static int prepare_linear_transpose(mlx_linear_t *l, mlx_stream s) {
+ if (!l || l->quantized || !arr_ok(l->w) || arr_ok(l->wt))
+ return 0;
+
+ mlx_array transposed = mlx_array_new();
+ mlx_transpose(&transposed, l->w, s);
+ if (!arr_ok(transposed)) {
+ mlx_array_free(transposed);
+ fprintf(stderr, "mlx: failed to prepare transposed linear weight\n");
+ return -1;
+ }
+
+ l->wt = mlx_array_new();
+ mlx_contiguous(&l->wt, transposed, false, s);
+ mlx_array_free(transposed);
+ if (!arr_ok(l->wt)) {
+ mlx_array_free(l->wt);
+ l->wt = (mlx_array){0};
+ fprintf(stderr, "mlx: failed to materialize transposed linear weight\n");
+ return -1;
+ }
+ mlx_array_eval(l->wt);
+ mlx_synchronize(s);
+ mlx_array_free(l->w);
+ l->w = (mlx_array){0};
+ return 0;
+}
+
+static int quantize_linear(mlx_linear_t *l, int bits, int group_size, mlx_stream s) {
+ if (!l || !arr_ok(l->w) || bits == 0)
+ return 0;
+ if (bits != 8) {
+ fprintf(stderr, "mlx: quantized weights support only 8 bits\n");
+ return -1;
+ }
+ if (group_size <= 0)
+ group_size = 64;
+
+ mlx_optional_int gs = {.value = group_size, .has_value = true};
+ mlx_optional_int qb = {.value = bits, .has_value = true};
+ mlx_array null_arr = (mlx_array){0};
+ mlx_vector_array q = mlx_vector_array_new();
+ mlx_quantize(&q, l->w, gs, qb, "affine", null_arr, s);
+ if (!q.ctx || mlx_vector_array_size(q) < 2) {
+ mlx_vector_array_free(q);
+ fprintf(stderr, "mlx: quantize failed\n");
+ return -1;
+ }
+
+ mlx_array qw = (mlx_array){0};
+ mlx_array scales = (mlx_array){0};
+ mlx_array biases = (mlx_array){0};
+ mlx_vector_array_get(&qw, q, 0);
+ mlx_vector_array_get(&scales, q, 1);
+ if (mlx_vector_array_size(q) >= 3)
+ mlx_vector_array_get(&biases, q, 2);
+ mlx_vector_array_free(q);
+
+ if (!arr_ok(qw) || !arr_ok(scales)) {
+ mlx_array_free(qw);
+ mlx_array_free(scales);
+ mlx_array_free(biases);
+ fprintf(stderr, "mlx: quantize returned invalid arrays\n");
+ return -1;
+ }
+ mlx_array_eval(qw);
+ mlx_array_eval(scales);
+ if (arr_ok(biases))
+ mlx_array_eval(biases);
+ mlx_synchronize(s);
+
+ mlx_array_free(l->w);
+ mlx_array_free(l->wt);
+ l->w = qw;
+ l->wt = (mlx_array){0};
+ l->scales = scales;
+ l->biases = biases;
+ l->quantized = 1;
+ l->bits = bits;
+ l->group_size = group_size;
+ return 0;
+}
+
+/* y = x @ W^T */
+static mlx_array linear(mlx_array x, const mlx_linear_t *W, mlx_stream s) {
+ if (W->quantized) {
+ if (!arr_ok(W->w))
+ return (mlx_array){0};
+ mlx_array res = mlx_array_new();
+ mlx_optional_int gs = {.value = W->group_size, .has_value = true};
+ mlx_optional_int bits = {.value = W->bits, .has_value = true};
+ mlx_array null_arr = (mlx_array){0};
+ mlx_quantized_matmul(&res, x, W->w, W->scales, arr_ok(W->biases) ? W->biases : null_arr,
+ true, gs, bits, "affine", s);
+ return res;
+ }
+ mlx_array Wt;
+ int free_wt = 0;
+ if (arr_ok(W->wt)) {
+ Wt = W->wt;
+ } else if (arr_ok(W->w)) {
+ Wt = mlx_array_new();
+ mlx_transpose(&Wt, W->w, s);
+ free_wt = 1;
+ } else {
+ return (mlx_array){0};
+ }
+ mlx_array res = mlx_array_new();
+ if (mlx_array_dtype(Wt) == MLX_BFLOAT16 && mlx_array_dtype(x) == MLX_FLOAT32) {
+ /* F32 activations with BF16 weights: upcast the weight operand and run
+ * the matmul in F32 (so accumulation is F32). Only the weights are
+ * BF16-rounded; the residual stream stays F32 (see mlx_forward_layers),
+ * matching the CPU/CUDA accuracy while keeping BF16 weight storage. */
+ mlx_array Wf = mlx_array_new();
+ mlx_astype(&Wf, Wt, MLX_FLOAT32, s);
+ mlx_matmul(&res, x, Wf, s);
+ mlx_array_free(Wf);
+ } else {
+ mlx_matmul(&res, x, Wt, s);
+ }
+ if (free_wt)
+ mlx_array_free(Wt);
+ return res;
+}
+
+const embed_config_t *embed_mlx_config(const embed_mlx_ctx_t *ctx) {
+ return ctx ? &ctx->config : NULL;
+}
+
+/* Upcast a tensor to F32 in place (no-op if already F32 or empty). Used for the
+ * tiny RMSNorm vectors so non-quantized BF16 models can run norms and the
+ * residual stream in F32 while keeping the large matmul weights in BF16. */
+static void upcast_f32_inplace(mlx_array *a, mlx_stream s) {
+ if (!a || !arr_ok(*a) || mlx_array_dtype(*a) == MLX_FLOAT32)
+ return;
+ mlx_array f = mlx_array_new();
+ mlx_astype(&f, *a, MLX_FLOAT32, s);
+ mlx_array_free(*a);
+ *a = f;
+}
+
+/* ========================================================================
+ * Load
+ * ======================================================================== */
+
+static int mlx_model_dir_has_file(const char *model_dir, const char *rel) {
+ char path[1024];
+ int n = snprintf(path, sizeof(path), "%s/%s", model_dir, rel);
+ if (n < 0 || (size_t)n >= sizeof(path))
+ return 0;
+ FILE *f = fopen(path, "rb");
+ if (!f)
+ return 0;
+ fclose(f);
+ return 1;
+}
+
+static int mlx_model_dir_has_late_projection(const char *model_dir) {
+ return mlx_model_dir_has_file(model_dir, "1_Dense/config.json") &&
+ mlx_model_dir_has_file(model_dir, "1_Dense/model.safetensors");
+}
+
+static embed_mlx_options_t normalize_mlx_options(const embed_mlx_options_t *opts) {
+ embed_mlx_options_t out = {0};
+ if (opts)
+ out = *opts;
+ if (out.quantize_bits != 0 && out.quantize_bits != 8) {
+ fprintf(stderr, "mlx: --mlx-quantize-bits supports only 8\n");
+ out.quantize_bits = -1;
+ }
+ if (out.quantize_bits && out.quantize_group_size <= 0)
+ out.quantize_group_size = 64;
+ return out;
+}
+
+static int quantize_layer(mlx_layer_t *l, int bits, int group_size, mlx_stream s) {
+ if (bits == 0)
+ return 0;
+ return quantize_linear(&l->wq, bits, group_size, s) ||
+ quantize_linear(&l->wk, bits, group_size, s) ||
+ quantize_linear(&l->wv, bits, group_size, s) ||
+ quantize_linear(&l->wo, bits, group_size, s) ||
+ quantize_linear(&l->gate_proj, bits, group_size, s) ||
+ quantize_linear(&l->up_proj, bits, group_size, s) ||
+ quantize_linear(&l->down_proj, bits, group_size, s);
+}
+
+static int prepare_layer_transposes(mlx_layer_t *l, mlx_stream s) {
+ return prepare_linear_transpose(&l->wq, s) || prepare_linear_transpose(&l->wk, s) ||
+ prepare_linear_transpose(&l->wv, s) || prepare_linear_transpose(&l->wo, s) ||
+ prepare_linear_transpose(&l->gate_proj, s) || prepare_linear_transpose(&l->up_proj, s) ||
+ prepare_linear_transpose(&l->down_proj, s);
+}
+
+/* BERT-family MLX loader, mirroring load_bert_weights on the CPU side. The
+ * shared post-load below (stream, transposes, optional BF16 upcast) runs after
+ * either family fills ctx->layers. */
+static int load_mlx_bert_weights(embed_mlx_ctx_t *ctx, int layer_start, int layer_end) {
+ const embed_config_t *c = &ctx->config;
+ int h = c->hidden_size, inter = c->intermediate_size;
+ char name[256];
+
+ const char *p;
+ if (multi_safetensors_find(ctx->ms, "embeddings.word_embeddings.weight", NULL))
+ p = "";
+ else if (multi_safetensors_find(ctx->ms, "bert.embeddings.word_embeddings.weight", NULL))
+ p = "bert.";
+ else {
+ fprintf(stderr, "mlx: BERT word embeddings not found\n");
+ return -1;
+ }
+
+ if (layer_start == 0) {
+ int emb_shape[] = {c->vocab_size, h};
+ snprintf(name, sizeof(name), "%sembeddings.word_embeddings.weight", p);
+ ctx->embed_tokens = load_tensor(ctx->ms, name, emb_shape, 2);
+ int pos_shape[] = {c->max_position_embeddings, h};
+ snprintf(name, sizeof(name), "%sembeddings.position_embeddings.weight", p);
+ ctx->position_embeddings = load_tensor(ctx->ms, name, pos_shape, 2);
+ int type_shape[] = {2, h};
+ snprintf(name, sizeof(name), "%sembeddings.token_type_embeddings.weight", p);
+ ctx->token_type_embeddings = load_tensor(ctx->ms, name, type_shape, 2);
+ int ln_shape[] = {h};
+ snprintf(name, sizeof(name), "%sembeddings.LayerNorm.weight", p);
+ ctx->embed_ln_w = load_tensor(ctx->ms, name, ln_shape, 1);
+ snprintf(name, sizeof(name), "%sembeddings.LayerNorm.bias", p);
+ ctx->embed_ln_b = load_tensor(ctx->ms, name, ln_shape, 1);
+ if (!arr_ok(ctx->embed_tokens) || !arr_ok(ctx->position_embeddings) ||
+ !arr_ok(ctx->token_type_embeddings) || !arr_ok(ctx->embed_ln_w) ||
+ !arr_ok(ctx->embed_ln_b))
+ return -1;
+ }
+
+ ctx->layers = calloc(c->n_layers, sizeof(mlx_layer_t));
+ if (!ctx->layers)
+ return -1;
+
+ for (int i = layer_start; i < layer_end; i++) {
+ mlx_layer_t *l = &ctx->layers[i];
+#define LDL(fld, suffix, ...) \
+ do { \
+ snprintf(name, sizeof(name), "%sencoder.layer.%d." suffix, p, i); \
+ int sh[] = {__VA_ARGS__}; \
+ l->fld = load_linear_tensor(ctx->ms, name, sh, sizeof(sh) / sizeof(sh[0])); \
+ if (!linear_ok(l->fld)) \
+ return -1; \
+ } while (0)
+#define LDV(fld, suffix, ...) \
+ do { \
+ snprintf(name, sizeof(name), "%sencoder.layer.%d." suffix, p, i); \
+ int sh[] = {__VA_ARGS__}; \
+ l->fld = load_tensor(ctx->ms, name, sh, sizeof(sh) / sizeof(sh[0])); \
+ if (!arr_ok(l->fld)) \
+ return -1; \
+ } while (0)
+
+ LDL(wq, "attention.self.query.weight", h, h);
+ LDV(q_bias, "attention.self.query.bias", h);
+ LDL(wk, "attention.self.key.weight", h, h);
+ LDV(k_bias, "attention.self.key.bias", h);
+ LDL(wv, "attention.self.value.weight", h, h);
+ LDV(v_bias, "attention.self.value.bias", h);
+ LDL(wo, "attention.output.dense.weight", h, h);
+ LDV(o_bias, "attention.output.dense.bias", h);
+ LDV(input_norm, "attention.output.LayerNorm.weight", h);
+ LDV(attn_ln_bias, "attention.output.LayerNorm.bias", h);
+ LDL(up_proj, "intermediate.dense.weight", inter, h);
+ LDV(ffn_inter_bias, "intermediate.dense.bias", inter);
+ LDL(down_proj, "output.dense.weight", h, inter);
+ LDV(ffn_out_bias, "output.dense.bias", h);
+ LDV(post_attn_norm, "output.LayerNorm.weight", h);
+ LDV(ffn_ln_bias, "output.LayerNorm.bias", h);
+#undef LDL
+#undef LDV
+ }
+ return 0;
+}
+
+static embed_mlx_ctx_t *mlx_load_range_ex(const char *model_dir,
+ int layer_start,
+ int layer_end,
+ const embed_mlx_options_t *opts,
+ int allow_late) {
+ embed_mlx_options_t options = normalize_mlx_options(opts);
+ if (options.quantize_bits < 0)
+ return NULL;
+ if (!allow_late && mlx_model_dir_has_late_projection(model_dir)) {
+ fprintf(stderr, "mlx: late-interaction models require token-level "
+ "MaxSim support and are not valid pooled embedding models "
+ "yet\n");
+ return NULL;
+ }
+
+ embed_mlx_ctx_t *ctx = calloc(1, sizeof(embed_mlx_ctx_t));
+ if (!ctx)
+ return NULL;
+ ctx->quantize_bits = options.quantize_bits;
+ ctx->quantize_group_size = options.quantize_group_size;
+
+ if (embed_config_parse(&ctx->config, model_dir) != 0) {
+ free(ctx);
+ return NULL;
+ }
+
+ const embed_config_t *c = &ctx->config;
+ if (layer_end == -1)
+ layer_end = c->n_layers;
+ if (layer_start < 0 || layer_start >= layer_end || layer_end > c->n_layers) {
+ fprintf(stderr, "mlx: invalid layer range [%d, %d) for %d-layer model\n", layer_start,
+ layer_end, c->n_layers);
+ free(ctx);
+ return NULL;
+ }
+ ctx->layer_start = layer_start;
+ ctx->layer_end = layer_end;
+
+ ctx->ms = multi_safetensors_open(model_dir);
+ if (!ctx->ms) {
+ fprintf(stderr, "mlx: failed to open safetensors in %s\n", model_dir);
+ free(ctx);
+ return NULL;
+ }
+
+ if (c->family == EMBED_FAMILY_BERT) {
+ if (load_mlx_bert_weights(ctx, layer_start, layer_end) != 0)
+ goto fail;
+ goto loaded;
+ }
+
+ const char *weight_prefix = multi_safetensors_weight_prefix(ctx->ms, "embed_tokens.weight");
+ if (!weight_prefix) {
+ fprintf(stderr, "mlx: neither embed_tokens.weight nor "
+ "model.embed_tokens.weight was found\n");
+ goto fail;
+ }
+
+ int h = c->hidden_size, qd = c->q_dim, kvd = c->kv_dim;
+ int inter = c->intermediate_size, hd = c->head_dim;
+ char name[256];
+
+ /* Only the first stage needs token embeddings. */
+ if (layer_start == 0) {
+ int emb_shape[] = {c->vocab_size, h};
+ snprintf(name, sizeof(name), "%sembed_tokens.weight", weight_prefix);
+ ctx->embed_tokens = load_tensor(ctx->ms, name, emb_shape, 2);
+ if (!arr_ok(ctx->embed_tokens))
+ goto fail;
+ }
+
+ /* Layers */
+ ctx->layers = calloc(c->n_layers, sizeof(mlx_layer_t));
+ if (!ctx->layers)
+ goto fail;
+
+ for (int i = layer_start; i < layer_end; i++) {
+ mlx_layer_t *l = &ctx->layers[i];
+
+#define LD(fld, fmt, ...) \
+ do { \
+ snprintf(name, sizeof(name), fmt, weight_prefix, i); \
+ int sh[] = {__VA_ARGS__}; \
+ l->fld = load_linear_tensor(ctx->ms, name, sh, sizeof(sh) / sizeof(sh[0])); \
+ if (!linear_ok(l->fld)) \
+ goto fail; \
+ } while (0)
+
+ LD(wq, "%slayers.%d.self_attn.q_proj.weight", qd, h);
+ LD(wk, "%slayers.%d.self_attn.k_proj.weight", kvd, h);
+ LD(wv, "%slayers.%d.self_attn.v_proj.weight", kvd, h);
+ LD(wo, "%slayers.%d.self_attn.o_proj.weight", h, qd);
+#undef LD
+
+#define LD(fld, fmt, ...) \
+ do { \
+ snprintf(name, sizeof(name), fmt, weight_prefix, i); \
+ int sh[] = {__VA_ARGS__}; \
+ l->fld = load_tensor(ctx->ms, name, sh, sizeof(sh) / sizeof(sh[0])); \
+ if (!arr_ok(l->fld)) \
+ goto fail; \
+ } while (0)
+
+ if (c->qkv_bias) {
+ LD(q_bias, "%slayers.%d.self_attn.q_proj.bias", qd);
+ LD(k_bias, "%slayers.%d.self_attn.k_proj.bias", kvd);
+ LD(v_bias, "%slayers.%d.self_attn.v_proj.bias", kvd);
+ }
+ if (c->qk_norm) {
+ LD(q_norm, "%slayers.%d.self_attn.q_norm.weight", hd);
+ LD(k_norm, "%slayers.%d.self_attn.k_norm.weight", hd);
+ }
+ LD(input_norm, "%slayers.%d.input_layernorm.weight", h);
+ LD(post_attn_norm, "%slayers.%d.post_attention_layernorm.weight", h);
+#undef LD
+
+#define LD(fld, fmt, ...) \
+ do { \
+ snprintf(name, sizeof(name), fmt, weight_prefix, i); \
+ int sh[] = {__VA_ARGS__}; \
+ l->fld = load_linear_tensor(ctx->ms, name, sh, sizeof(sh) / sizeof(sh[0])); \
+ if (!linear_ok(l->fld)) \
+ goto fail; \
+ } while (0)
+
+ LD(gate_proj, "%slayers.%d.mlp.gate_proj.weight", inter, h);
+ LD(up_proj, "%slayers.%d.mlp.up_proj.weight", inter, h);
+ LD(down_proj, "%slayers.%d.mlp.down_proj.weight", h, inter);
+#undef LD
+
+ if (embed_verbose >= 2)
+ fprintf(stderr, " mlx layer %d loaded\n", i);
+ }
+
+ if (layer_end == c->n_layers) {
+ int ns[] = {h};
+ snprintf(name, sizeof(name), "%snorm.weight", weight_prefix);
+ ctx->norm = load_tensor(ctx->ms, name, ns, 1);
+ if (!arr_ok(ctx->norm))
+ goto fail;
+ }
+
+loaded:
+ ctx->stream = mlx_default_gpu_stream_new();
+ ctx->weight_dtype = mlx_array_dtype(ctx->layers[layer_start].wq.w);
+ /* Non-quantized BF16: run RMSNorm and the residual stream in F32. Upcast the
+ * tiny norm vectors so they match the F32 activations in mlx_forward_layers;
+ * the large matmul weights stay BF16. Q8 keeps its existing BF16 norms. */
+ if (ctx->weight_dtype == MLX_BFLOAT16 && !ctx->quantize_bits) {
+ for (int i = layer_start; i < layer_end; i++) {
+ mlx_layer_t *l = &ctx->layers[i];
+ upcast_f32_inplace(&l->q_bias, ctx->stream);
+ upcast_f32_inplace(&l->k_bias, ctx->stream);
+ upcast_f32_inplace(&l->v_bias, ctx->stream);
+ upcast_f32_inplace(&l->q_norm, ctx->stream);
+ upcast_f32_inplace(&l->k_norm, ctx->stream);
+ upcast_f32_inplace(&l->input_norm, ctx->stream);
+ upcast_f32_inplace(&l->post_attn_norm, ctx->stream);
+ /* BERT block biases (no-ops for Qwen, whose arrays are unset); the
+ * two BERT LayerNorm weights reuse input_norm/post_attn_norm above. */
+ upcast_f32_inplace(&l->o_bias, ctx->stream);
+ upcast_f32_inplace(&l->attn_ln_bias, ctx->stream);
+ upcast_f32_inplace(&l->ffn_inter_bias, ctx->stream);
+ upcast_f32_inplace(&l->ffn_out_bias, ctx->stream);
+ upcast_f32_inplace(&l->ffn_ln_bias, ctx->stream);
+ }
+ upcast_f32_inplace(&ctx->norm, ctx->stream);
+ /* BERT embedding stage (no-ops for Qwen): learned position and token-type
+ * embeddings and the embedding LayerNorm all feed the F32 residual. */
+ upcast_f32_inplace(&ctx->position_embeddings, ctx->stream);
+ upcast_f32_inplace(&ctx->token_type_embeddings, ctx->stream);
+ upcast_f32_inplace(&ctx->embed_ln_w, ctx->stream);
+ upcast_f32_inplace(&ctx->embed_ln_b, ctx->stream);
+ }
+ if (ctx->quantize_bits) {
+ for (int i = layer_start; i < layer_end; i++) {
+ if (quantize_layer(&ctx->layers[i], ctx->quantize_bits, ctx->quantize_group_size,
+ ctx->stream) != 0)
+ goto fail;
+ }
+ mlx_clear_cache();
+ if (embed_verbose >= 1)
+ fprintf(stderr,
+ "mlx: quantized linear weights to %d-bit "
+ "(group_size=%d)\n",
+ ctx->quantize_bits, ctx->quantize_group_size);
+ } else {
+ for (int i = layer_start; i < layer_end; i++) {
+ if (prepare_layer_transposes(&ctx->layers[i], ctx->stream) != 0)
+ goto fail;
+ }
+ }
+
+ if (embed_verbose >= 2) {
+ size_t active = 0, cache = 0, peak = 0;
+ mlx_get_active_memory(&active);
+ mlx_get_cache_memory(&cache);
+ mlx_get_peak_memory(&peak);
+ fprintf(stderr,
+ "mlx: memory active=%.2f GiB cache=%.2f GiB "
+ "peak=%.2f GiB\n",
+ (double)active / (1024.0 * 1024.0 * 1024.0),
+ (double)cache / (1024.0 * 1024.0 * 1024.0),
+ (double)peak / (1024.0 * 1024.0 * 1024.0));
+ }
+
+ if (embed_verbose >= 1)
+ fprintf(stderr, "mlx: layers [%d, %d) loaded (%d-dim)\n", layer_start, layer_end, h);
+
+ return ctx;
+
+fail:
+ embed_mlx_free(ctx);
+ return NULL;
+}
+
+embed_mlx_ctx_t *embed_mlx_load(const char *model_dir) {
+ return mlx_load_range_ex(model_dir, 0, -1, NULL, 0);
+}
+
+embed_mlx_ctx_t *embed_mlx_load_with_options(const char *model_dir,
+ const embed_mlx_options_t *opts) {
+ return mlx_load_range_ex(model_dir, 0, -1, opts, 0);
+}
+
+/* ========================================================================
+ * Free
+ * ======================================================================== */
+
+static void free_mlx_layer(mlx_layer_t *l) {
+ free_linear(&l->wq);
+ free_linear(&l->wk);
+ free_linear(&l->wv);
+ free_linear(&l->wo);
+ mlx_array_free(l->q_bias);
+ mlx_array_free(l->k_bias);
+ mlx_array_free(l->v_bias);
+ mlx_array_free(l->q_norm);
+ mlx_array_free(l->k_norm);
+ mlx_array_free(l->input_norm);
+ mlx_array_free(l->post_attn_norm);
+ free_linear(&l->gate_proj);
+ free_linear(&l->up_proj);
+ free_linear(&l->down_proj);
+ mlx_array_free(l->o_bias);
+ mlx_array_free(l->attn_ln_bias);
+ mlx_array_free(l->ffn_inter_bias);
+ mlx_array_free(l->ffn_out_bias);
+ mlx_array_free(l->ffn_ln_bias);
+}
+
+void embed_mlx_free(embed_mlx_ctx_t *ctx) {
+ if (!ctx)
+ return;
+ mlx_array_free(ctx->embed_tokens);
+ if (ctx->layers) {
+ for (int i = 0; i < ctx->config.n_layers; i++)
+ free_mlx_layer(&ctx->layers[i]);
+ free(ctx->layers);
+ }
+ mlx_array_free(ctx->norm);
+ mlx_array_free(ctx->position_embeddings);
+ mlx_array_free(ctx->token_type_embeddings);
+ mlx_array_free(ctx->embed_ln_w);
+ mlx_array_free(ctx->embed_ln_b);
+ if (ctx->stream.ctx)
+ mlx_stream_free(ctx->stream);
+ if (ctx->ms)
+ multi_safetensors_close(ctx->ms);
+ free(ctx);
+}
+
+embed_mlx_late_ctx_t *embed_mlx_late_load_with_options(const char *model_dir,
+ const embed_mlx_options_t *opts) {
+ if (!mlx_model_dir_has_late_projection(model_dir)) {
+ fprintf(stderr, "mlx late: missing 1_Dense projection\n");
+ return NULL;
+ }
+
+ embed_mlx_late_ctx_t *late = calloc(1, sizeof(*late));
+ if (!late)
+ return NULL;
+
+ late->base = mlx_load_range_ex(model_dir, 0, -1, opts, 1);
+ if (!late->base)
+ goto fail;
+
+ char dense_dir[1024];
+ int n = snprintf(dense_dir, sizeof(dense_dir), "%s/1_Dense", model_dir);
+ if (n < 0 || (size_t)n >= sizeof(dense_dir)) {
+ fprintf(stderr, "mlx late: model path too long\n");
+ goto fail;
+ }
+
+ late->dense_ms = multi_safetensors_open(dense_dir);
+ if (!late->dense_ms) {
+ fprintf(stderr, "mlx late: failed to open safetensors in %s\n", dense_dir);
+ goto fail;
+ }
+
+ const safetensor_t *t = multi_safetensors_find(late->dense_ms, "linear.weight", NULL);
+ if (!t) {
+ fprintf(stderr, "mlx late: missing linear.weight\n");
+ goto fail;
+ }
+ if (t->ndim != 2 || t->shape[0] <= 0 || t->shape[0] > INT_MAX ||
+ t->shape[1] != late->base->config.hidden_size) {
+ fprintf(stderr, "mlx late: bad projection shape\n");
+ goto fail;
+ }
+
+ int shape[] = {(int)t->shape[0], late->base->config.hidden_size};
+ late->projection = load_linear_tensor(late->dense_ms, "linear.weight", shape, 2);
+ if (!linear_ok(late->projection))
+ goto fail;
+ if (prepare_linear_transpose(&late->projection, late->base->stream) != 0)
+ goto fail;
+ late->token_dim = shape[0];
+
+ if (embed_verbose >= 1)
+ fprintf(stderr, "mlx late: token projection loaded (%d-dim)\n", late->token_dim);
+ return late;
+
+fail:
+ embed_mlx_late_free(late);
+ return NULL;
+}
+
+embed_mlx_late_ctx_t *embed_mlx_late_load(const char *model_dir) {
+ return embed_mlx_late_load_with_options(model_dir, NULL);
+}
+
+void embed_mlx_late_free(embed_mlx_late_ctx_t *ctx) {
+ if (!ctx)
+ return;
+ free_linear(&ctx->projection);
+ if (ctx->dense_ms)
+ multi_safetensors_close(ctx->dense_ms);
+ embed_mlx_free(ctx->base);
+ free(ctx);
+}
+
+const embed_config_t *embed_mlx_late_config(const embed_mlx_late_ctx_t *ctx) {
+ return ctx && ctx->base ? &ctx->base->config : NULL;
+}
+
+int embed_mlx_late_token_dim(const embed_mlx_late_ctx_t *ctx) { return ctx ? ctx->token_dim : 0; }
+
+/* ========================================================================
+ * Forward pass
+ * ======================================================================== */
+
+/* Exact erf GeLU: 0.5 * x * (1 + erf(x / sqrt(2))). Frees nothing it is given. */
+static mlx_array mlx_gelu_erf(mlx_array x, mlx_stream S) {
+ mlx_array c = mlx_array_new_float32(0.70710678118654752f);
+ mlx_array scaled = mlx_array_new();
+ mlx_multiply(&scaled, x, c, S);
+ mlx_array_free(c);
+ mlx_array e = mlx_array_new();
+ mlx_erf(&e, scaled, S);
+ mlx_array_free(scaled);
+ mlx_array one = mlx_array_new_float32(1.0f);
+ mlx_array e1 = mlx_array_new();
+ mlx_add(&e1, e, one, S);
+ mlx_array_free(e);
+ mlx_array_free(one);
+ mlx_array half = mlx_array_new_float32(0.5f);
+ mlx_array xh = mlx_array_new();
+ mlx_multiply(&xh, x, half, S);
+ mlx_array_free(half);
+ mlx_array g = mlx_array_new();
+ mlx_multiply(&g, xh, e1, S);
+ mlx_array_free(xh);
+ mlx_array_free(e1);
+ return g;
+}
+
+/* Tanh-approximation GeLU (gelu_new / gelu_pytorch_tanh):
+ * 0.5 * x * (1 + tanh(sqrt(2/pi) * (x + 0.044715 * x^3))). Frees nothing given. */
+static mlx_array mlx_gelu_tanh(mlx_array x, mlx_stream S) {
+ mlx_array x2 = mlx_array_new();
+ mlx_multiply(&x2, x, x, S);
+ mlx_array x3 = mlx_array_new();
+ mlx_multiply(&x3, x2, x, S);
+ mlx_array_free(x2);
+ mlx_array c = mlx_array_new_float32(0.044715f);
+ mlx_array cx3 = mlx_array_new();
+ mlx_multiply(&cx3, x3, c, S);
+ mlx_array_free(x3);
+ mlx_array_free(c);
+ mlx_array sum = mlx_array_new();
+ mlx_add(&sum, x, cx3, S);
+ mlx_array_free(cx3);
+ mlx_array s2pi = mlx_array_new_float32(0.79788456080286536f);
+ mlx_array inner = mlx_array_new();
+ mlx_multiply(&inner, sum, s2pi, S);
+ mlx_array_free(sum);
+ mlx_array_free(s2pi);
+ mlx_array t = mlx_array_new();
+ mlx_tanh(&t, inner, S);
+ mlx_array_free(inner);
+ mlx_array one = mlx_array_new_float32(1.0f);
+ mlx_array t1 = mlx_array_new();
+ mlx_add(&t1, t, one, S);
+ mlx_array_free(t);
+ mlx_array_free(one);
+ mlx_array half = mlx_array_new_float32(0.5f);
+ mlx_array xh = mlx_array_new();
+ mlx_multiply(&xh, x, half, S);
+ mlx_array_free(half);
+ mlx_array g = mlx_array_new();
+ mlx_multiply(&g, xh, t1, S);
+ mlx_array_free(xh);
+ mlx_array_free(t1);
+ return g;
+}
+
+/* BERT-family forward: post-norm encoder layers (bias on every projection, GeLU
+ * feed-forward, no RoPE, no per-head norm) over an already-embedded x. Frees the
+ * x it is given and returns the new hidden states. */
+static mlx_array mlx_forward_bert(embed_mlx_ctx_t *ctx,
+ mlx_array x,
+ int batch,
+ int max_seq,
+ int has_padding,
+ mlx_array attn_mask,
+ int layer_start,
+ int layer_end) {
+ const embed_config_t *c = &ctx->config;
+ mlx_stream S = ctx->stream;
+ int n_heads = c->n_heads, head_dim = c->head_dim, q_dim = c->q_dim;
+ float scale = 1.0f / sqrtf((float)head_dim);
+ float eps = c->layer_norm_eps;
+ mlx_array null_arr = (mlx_array){0};
+
+ for (int layer = layer_start; layer < layer_end; layer++) {
+ mlx_layer_t *l = &ctx->layers[layer];
+
+ /* Self-attention reads x directly (post-norm). */
+ mlx_array q_flat = linear(x, &l->wq, S);
+ mlx_array k_flat = linear(x, &l->wk, S);
+ mlx_array v_flat = linear(x, &l->wv, S);
+ mlx_array t = mlx_array_new();
+ mlx_add(&t, q_flat, l->q_bias, S);
+ mlx_array_free(q_flat);
+ q_flat = t;
+ t = mlx_array_new();
+ mlx_add(&t, k_flat, l->k_bias, S);
+ mlx_array_free(k_flat);
+ k_flat = t;
+ t = mlx_array_new();
+ mlx_add(&t, v_flat, l->v_bias, S);
+ mlx_array_free(v_flat);
+ v_flat = t;
+
+ int s4[] = {batch, max_seq, n_heads, head_dim};
+ mlx_array q = mlx_array_new(), k = mlx_array_new(), v = mlx_array_new();
+ mlx_reshape(&q, q_flat, s4, 4, S);
+ mlx_reshape(&k, k_flat, s4, 4, S);
+ mlx_reshape(&v, v_flat, s4, 4, S);
+ mlx_array_free(q_flat);
+ mlx_array_free(k_flat);
+ mlx_array_free(v_flat);
+
+ int perm[] = {0, 2, 1, 3};
+ mlx_array qt = mlx_array_new(), kt = mlx_array_new(), vt = mlx_array_new();
+ mlx_transpose_axes(&qt, q, perm, 4, S);
+ mlx_transpose_axes(&kt, k, perm, 4, S);
+ mlx_transpose_axes(&vt, v, perm, 4, S);
+ mlx_array_free(q);
+ mlx_array_free(k);
+ mlx_array_free(v);
+
+ mlx_array attn = mlx_array_new();
+ mlx_fast_scaled_dot_product_attention(&attn, qt, kt, vt, scale, "",
+ has_padding ? attn_mask : null_arr, null_arr, S);
+ mlx_array_free(qt);
+ mlx_array_free(kt);
+ mlx_array_free(vt);
+
+ mlx_array attn_t = mlx_array_new();
+ mlx_transpose_axes(&attn_t, attn, perm, 4, S);
+ mlx_array_free(attn);
+ int s3[] = {batch, max_seq, q_dim};
+ mlx_array attn_flat = mlx_array_new();
+ mlx_reshape(&attn_flat, attn_t, s3, 3, S);
+ mlx_array_free(attn_t);
+
+ mlx_array proj = linear(attn_flat, &l->wo, S);
+ mlx_array_free(attn_flat);
+ mlx_array proj_b = mlx_array_new();
+ mlx_add(&proj_b, proj, l->o_bias, S);
+ mlx_array_free(proj);
+ mlx_array res = mlx_array_new();
+ mlx_add(&res, x, proj_b, S);
+ mlx_array_free(x);
+ mlx_array_free(proj_b);
+ x = mlx_array_new();
+ mlx_fast_layer_norm(&x, res, l->input_norm, l->attn_ln_bias, eps, S);
+ mlx_array_free(res);
+
+ /* Feed-forward: dense -> GeLU -> dense. */
+ mlx_array mid = linear(x, &l->up_proj, S);
+ mlx_array mid_b = mlx_array_new();
+ mlx_add(&mid_b, mid, l->ffn_inter_bias, S);
+ mlx_array_free(mid);
+ mlx_array g = ctx->config.ffn_act == EMBED_ACT_GELU_TANH ? mlx_gelu_tanh(mid_b, S)
+ : mlx_gelu_erf(mid_b, S);
+ mlx_array_free(mid_b);
+ mlx_array out = linear(g, &l->down_proj, S);
+ mlx_array_free(g);
+ mlx_array out_b = mlx_array_new();
+ mlx_add(&out_b, out, l->ffn_out_bias, S);
+ mlx_array_free(out);
+ mlx_array res2 = mlx_array_new();
+ mlx_add(&res2, x, out_b, S);
+ mlx_array_free(x);
+ mlx_array_free(out_b);
+ x = mlx_array_new();
+ mlx_fast_layer_norm(&x, res2, l->post_attn_norm, l->ffn_ln_bias, eps, S);
+ mlx_array_free(res2);
+ }
+ return x;
+}
+
+static mlx_array mlx_forward_layers(embed_mlx_ctx_t *ctx,
+ mlx_array x,
+ int batch,
+ int max_seq,
+ int has_padding,
+ mlx_array attn_mask,
+ int layer_start,
+ int layer_end) {
+ const embed_config_t *c = &ctx->config;
+ mlx_stream S = ctx->stream;
+ int n_heads = c->n_heads;
+ int n_kv_heads = c->n_kv_heads;
+ int head_dim = c->head_dim;
+ int q_dim = c->q_dim;
+ float scale = 1.0f / sqrtf((float)head_dim);
+ mlx_array null_arr = (mlx_array){0};
+ const char *mask_mode = c->attention_mode == EMBED_ATTENTION_CAUSAL ? "causal" : "";
+
+ /* For non-quantized BF16 weights, run the residual stream, norms, and
+ * attention in F32; matmuls downcast their operands to BF16 internally
+ * (see linear). This keeps weight storage at BF16 while avoiding the
+ * cross-layer accumulation error of a fully BF16 forward. F32 and quantized
+ * models are unaffected. */
+ mlx_array local_mask = attn_mask;
+ int free_mask = 0;
+ int mixed_bf16 =
+ mlx_weight_dtype(ctx) == MLX_BFLOAT16 && !ctx->layers[layer_start].wq.quantized;
+ if (mixed_bf16) {
+ if (mlx_array_dtype(x) != MLX_FLOAT32) {
+ mlx_array xf = mlx_array_new();
+ mlx_astype(&xf, x, MLX_FLOAT32, S);
+ mlx_array_free(x);
+ x = xf;
+ }
+ if (has_padding && arr_ok(attn_mask) && mlx_array_dtype(attn_mask) != MLX_FLOAT32) {
+ local_mask = mlx_array_new();
+ mlx_astype(&local_mask, attn_mask, MLX_FLOAT32, S);
+ free_mask = 1;
+ }
+ }
+
+ for (int layer = layer_start; layer < layer_end; layer++) {
+ mlx_layer_t *l = &ctx->layers[layer];
+
+ mlx_array xn = mlx_array_new();
+ mlx_fast_rms_norm(&xn, x, l->input_norm, c->rms_norm_eps, S);
+
+ mlx_array q_flat = linear(xn, &l->wq, S);
+ mlx_array k_flat = linear(xn, &l->wk, S);
+ mlx_array v_flat = linear(xn, &l->wv, S);
+ mlx_array_free(xn);
+ if (c->qkv_bias) {
+ mlx_array biased = mlx_array_new();
+ mlx_add(&biased, q_flat, l->q_bias, S);
+ mlx_array_free(q_flat);
+ q_flat = biased;
+ biased = mlx_array_new();
+ mlx_add(&biased, k_flat, l->k_bias, S);
+ mlx_array_free(k_flat);
+ k_flat = biased;
+ biased = mlx_array_new();
+ mlx_add(&biased, v_flat, l->v_bias, S);
+ mlx_array_free(v_flat);
+ v_flat = biased;
+ }
+
+ int q_shape[] = {batch, max_seq, n_heads, head_dim};
+ int k_shape[] = {batch, max_seq, n_kv_heads, head_dim};
+ mlx_array q = mlx_array_new();
+ mlx_array k = mlx_array_new();
+ mlx_array v = mlx_array_new();
+ mlx_reshape(&q, q_flat, q_shape, 4, S);
+ mlx_reshape(&k, k_flat, k_shape, 4, S);
+ mlx_reshape(&v, v_flat, k_shape, 4, S);
+ mlx_array_free(q_flat);
+ mlx_array_free(k_flat);
+ mlx_array_free(v_flat);
+
+ mlx_array qn = q;
+ mlx_array kn = k;
+ if (c->qk_norm) {
+ qn = mlx_array_new();
+ kn = mlx_array_new();
+ mlx_fast_rms_norm(&qn, q, l->q_norm, c->rms_norm_eps, S);
+ mlx_fast_rms_norm(&kn, k, l->k_norm, c->rms_norm_eps, S);
+ mlx_array_free(q);
+ mlx_array_free(k);
+ }
+
+ /* [B, T, heads, D] -> [B, heads, T, D] for RoPE + SDPA. */
+ int perm[] = {0, 2, 1, 3};
+ mlx_array qt = mlx_array_new(), kt = mlx_array_new(), vt = mlx_array_new();
+ mlx_transpose_axes(&qt, qn, perm, 4, S);
+ mlx_transpose_axes(&kt, kn, perm, 4, S);
+ mlx_transpose_axes(&vt, v, perm, 4, S);
+ mlx_array_free(qn);
+ mlx_array_free(kn);
+ mlx_array_free(v);
+
+ mlx_optional_float base = {.value = c->rope_theta, .has_value = true};
+ mlx_array qr = mlx_array_new(), kr = mlx_array_new();
+ mlx_fast_rope(&qr, qt, head_dim, false, base, 1.0f, 0, null_arr, S);
+ mlx_fast_rope(&kr, kt, head_dim, false, base, 1.0f, 0, null_arr, S);
+ mlx_array_free(qt);
+ mlx_array_free(kt);
+
+ mlx_array attn = mlx_array_new();
+ mlx_fast_scaled_dot_product_attention(&attn, qr, kr, vt, scale, mask_mode,
+ has_padding ? local_mask : null_arr, null_arr, S);
+ mlx_array_free(qr);
+ mlx_array_free(kr);
+ mlx_array_free(vt);
+
+ mlx_array attn_t = mlx_array_new();
+ mlx_transpose_axes(&attn_t, attn, perm, 4, S);
+ mlx_array_free(attn);
+
+ int flat_shape[] = {batch, max_seq, q_dim};
+ mlx_array attn_flat = mlx_array_new();
+ mlx_reshape(&attn_flat, attn_t, flat_shape, 3, S);
+ mlx_array_free(attn_t);
+
+ mlx_array proj = linear(attn_flat, &l->wo, S);
+ mlx_array_free(attn_flat);
+ mlx_array x2 = mlx_array_new();
+ mlx_add(&x2, x, proj, S);
+ mlx_array_free(x);
+ mlx_array_free(proj);
+ x = x2;
+
+ mlx_array xn2 = mlx_array_new();
+ mlx_fast_rms_norm(&xn2, x, l->post_attn_norm, c->rms_norm_eps, S);
+
+ mlx_array gate = linear(xn2, &l->gate_proj, S);
+ mlx_array up = linear(xn2, &l->up_proj, S);
+ mlx_array_free(xn2);
+
+ mlx_array gate_sig = mlx_array_new();
+ mlx_sigmoid(&gate_sig, gate, S);
+ mlx_array silu_gate = mlx_array_new();
+ mlx_multiply(&silu_gate, gate, gate_sig, S);
+ mlx_array_free(gate);
+ mlx_array_free(gate_sig);
+
+ mlx_array mid = mlx_array_new();
+ mlx_multiply(&mid, silu_gate, up, S);
+ mlx_array_free(silu_gate);
+ mlx_array_free(up);
+
+ mlx_array ffn = linear(mid, &l->down_proj, S);
+ mlx_array_free(mid);
+
+ mlx_array x3 = mlx_array_new();
+ mlx_add(&x3, x, ffn, S);
+ mlx_array_free(x);
+ mlx_array_free(ffn);
+ x = x3;
+ }
+ if (free_mask)
+ mlx_array_free(local_mask);
+ return x;
+}
+
+embed_mlx_late_vectors_t *embed_mlx_late_encode_tokens_device(embed_mlx_late_ctx_t *ctx,
+ const int *token_ids,
+ int n_tokens,
+ int normalize) {
+ if (!ctx || !ctx->base || !token_ids || n_tokens <= 0 || ctx->token_dim <= 0 ||
+ !linear_ok(ctx->projection))
+ return NULL;
+
+ embed_mlx_ctx_t *base = ctx->base;
+ if (base->layer_start != 0 || base->layer_end != base->config.n_layers ||
+ !arr_ok(base->embed_tokens) || !arr_ok(base->norm))
+ return NULL;
+
+ const embed_config_t *c = &base->config;
+ mlx_stream S = base->stream;
+ for (int i = 0; i < n_tokens; i++) {
+ if (token_ids[i] < 0 || token_ids[i] >= c->vocab_size) {
+ fprintf(stderr, "mlx late: invalid token id %d at position %d\n", token_ids[i], i);
+ return NULL;
+ }
+ }
+
+ size_t id_bytes;
+ if (mlx_mul_size((size_t)n_tokens, sizeof(int), &id_bytes) != 0)
+ return NULL;
+
+ int *ids_data = (int *)malloc(id_bytes);
+ if (!ids_data)
+ return NULL;
+ memcpy(ids_data, token_ids, id_bytes);
+
+ int ids_shape[] = {1, n_tokens};
+ mlx_array ids = mlx_array_new_data(ids_data, ids_shape, 2, MLX_INT32);
+ free(ids_data);
+ if (!arr_ok(ids))
+ return NULL;
+
+ embed_mlx_late_vectors_t *result = NULL;
+ mlx_array x = mlx_array_new();
+ mlx_array x_normed = (mlx_array){0};
+ mlx_array projected = (mlx_array){0};
+ mlx_array reshaped = (mlx_array){0};
+
+ mlx_take_axis(&x, base->embed_tokens, ids, 0, S);
+ mlx_array_free(ids);
+ if (!arr_ok(x))
+ goto cleanup;
+
+ x = mlx_forward_layers(base, x, 1, n_tokens, 0, (mlx_array){0}, 0, c->n_layers);
+ if (!arr_ok(x))
+ goto cleanup;
+
+ x_normed = mlx_array_new();
+ mlx_fast_rms_norm(&x_normed, x, base->norm, c->rms_norm_eps, S);
+ mlx_array_free(x);
+ x = (mlx_array){0};
+ if (!arr_ok(x_normed))
+ goto cleanup;
+
+ projected = linear(x_normed, &ctx->projection, S);
+ mlx_array_free(x_normed);
+ x_normed = (mlx_array){0};
+ if (!arr_ok(projected))
+ goto cleanup;
+
+ if (normalize) {
+ mlx_array sq = mlx_array_new();
+ mlx_square(&sq, projected, S);
+ if (!arr_ok(sq)) {
+ mlx_array_free(sq);
+ goto cleanup;
+ }
+
+ mlx_array norm2 = mlx_array_new();
+ mlx_sum_axis(&norm2, sq, 2, true, S);
+ mlx_array_free(sq);
+ if (!arr_ok(norm2)) {
+ mlx_array_free(norm2);
+ goto cleanup;
+ }
+
+ mlx_array inv_norm = mlx_array_new();
+ mlx_rsqrt(&inv_norm, norm2, S);
+ mlx_array_free(norm2);
+ if (!arr_ok(inv_norm)) {
+ mlx_array_free(inv_norm);
+ goto cleanup;
+ }
+
+ mlx_array normalized = mlx_array_new();
+ mlx_multiply(&normalized, projected, inv_norm, S);
+ mlx_array_free(inv_norm);
+ mlx_array_free(projected);
+ projected = normalized;
+ if (!arr_ok(projected))
+ goto cleanup;
+ }
+
+ int vec_shape[] = {n_tokens, ctx->token_dim};
+ reshaped = mlx_array_new();
+ mlx_reshape(&reshaped, projected, vec_shape, 2, S);
+ if (!arr_ok(reshaped))
+ goto cleanup;
+
+ result = (embed_mlx_late_vectors_t *)calloc(1, sizeof(*result));
+ if (!result)
+ goto cleanup;
+ result->owner = ctx;
+ result->vectors = reshaped;
+ result->tokens = n_tokens;
+ result->dim = ctx->token_dim;
+ reshaped = (mlx_array){0};
+
+cleanup:
+ mlx_array_free(reshaped);
+ mlx_array_free(projected);
+ mlx_array_free(x_normed);
+ mlx_array_free(x);
+ return result;
+}
+
+void embed_mlx_late_vectors_free(embed_mlx_late_vectors_t *vecs) {
+ if (!vecs)
+ return;
+ mlx_array_free(vecs->vectors);
+ free(vecs);
+}
+
+int embed_mlx_late_vectors_token_count(const embed_mlx_late_vectors_t *vecs) {
+ return vecs ? vecs->tokens : 0;
+}
+
+int embed_mlx_late_vectors_dim(const embed_mlx_late_vectors_t *vecs) {
+ return vecs ? vecs->dim : 0;
+}
+
+int embed_mlx_late_vectors_copy(const embed_mlx_late_vectors_t *vecs, float *out_vectors) {
+ if (!vecs || !out_vectors || !arr_ok(vecs->vectors) || vecs->tokens <= 0 || vecs->dim <= 0)
+ return -1;
+
+ size_t values, bytes;
+ if (mlx_mul_size((size_t)vecs->tokens, (size_t)vecs->dim, &values) != 0 ||
+ mlx_mul_size(values, sizeof(float), &bytes) != 0)
+ return -1;
+
+ mlx_stream S = vecs->owner->base->stream;
+ mlx_array out_f32 = mlx_array_new();
+ mlx_astype(&out_f32, vecs->vectors, MLX_FLOAT32, S);
+ if (!arr_ok(out_f32)) {
+ mlx_array_free(out_f32);
+ return -1;
+ }
+
+ int rc = -1;
+ mlx_array_eval(out_f32);
+ const float *data = mlx_array_data_float32(out_f32);
+ if (data) {
+ memcpy(out_vectors, data, bytes);
+ rc = 0;
+ }
+ mlx_array_free(out_f32);
+ return rc;
+}
+
+/*
+ * Batched late-interaction document encoder.
+ *
+ * Encodes every candidate in one padded transformer pass, then gathers each
+ * document's kept token vectors into a single packed [total_keep, token_dim]
+ * array in document order. out_offsets receives the prefix sum of kept counts
+ * (out_offsets[i + 1] - out_offsets[i] == n_keep[i]), the exact layout
+ * embed_mlx_late_maxsim_batch_device consumes. This collapses N per-candidate
+ * transformer calls into one forward.
+ *
+ * Right-padding keeps real tokens at positions 0..n_tokens[d]-1 so RoPE
+ * positions are unchanged; a bidirectional model gets a padding attention mask
+ * so real tokens never attend to pad slots (the same masking the dense pooled
+ * batch path uses). Kept-token vectors therefore match per-document encoding to
+ * within MLX's batched-GEMM rounding.
+ */
+embed_mlx_late_vectors_t *embed_mlx_late_encode_docs_device(embed_mlx_late_ctx_t *ctx,
+ const int *const *doc_ids,
+ const int *n_tokens,
+ const int *const *keep,
+ const int *n_keep,
+ int n_docs,
+ int normalize,
+ int *out_offsets) {
+ if (!ctx || !ctx->base || !doc_ids || !n_tokens || !keep || !n_keep || !out_offsets ||
+ n_docs <= 0 || ctx->token_dim <= 0 || !linear_ok(ctx->projection))
+ return NULL;
+
+ embed_mlx_ctx_t *base = ctx->base;
+ if (base->layer_start != 0 || base->layer_end != base->config.n_layers ||
+ !arr_ok(base->embed_tokens) || !arr_ok(base->norm))
+ return NULL;
+
+ const embed_config_t *c = &base->config;
+ mlx_stream S = base->stream;
+ int causal = c->attention_mode == EMBED_ATTENTION_CAUSAL;
+
+ /* Validate inputs and size the batch: longest sequence and total kept
+ * tokens. out_offsets is the running prefix sum of kept counts. */
+ int max_seq = 0;
+ int total_keep = 0;
+ out_offsets[0] = 0;
+ for (int d = 0; d < n_docs; d++) {
+ if (!doc_ids[d] || n_tokens[d] <= 0 || !keep[d] || n_keep[d] <= 0 ||
+ n_keep[d] > n_tokens[d] || total_keep > INT_MAX - n_keep[d])
+ return NULL;
+ if (n_tokens[d] > max_seq)
+ max_seq = n_tokens[d];
+ for (int k = 0; k < n_keep[d]; k++) {
+ if (keep[d][k] < 0 || keep[d][k] >= n_tokens[d])
+ return NULL;
+ }
+ total_keep += n_keep[d];
+ out_offsets[d + 1] = total_keep;
+ }
+
+ /* The gather index lives in an MLX int32 array, so the flattened
+ * [n_docs * max_seq, dim] row count must stay within int range. */
+ size_t elems, ids_bytes, mask_bytes, gather_bytes;
+ if (mlx_mul_size((size_t)n_docs, (size_t)max_seq, &elems) != 0 || elems > INT_MAX ||
+ mlx_mul_size(elems, sizeof(int), &ids_bytes) != 0 ||
+ mlx_mul_size(elems, sizeof(float), &mask_bytes) != 0 ||
+ mlx_mul_size((size_t)total_keep, sizeof(int), &gather_bytes) != 0)
+ return NULL;
+
+ int has_padding = 0;
+ for (int d = 0; d < n_docs; d++)
+ if (n_tokens[d] != max_seq)
+ has_padding = 1;
+ int needs_attn_mask = has_padding && !causal;
+ if (ids_bytes == 0 || gather_bytes == 0 || (needs_attn_mask && mask_bytes == 0))
+ return NULL;
+
+ int *padded_ids = (int *)malloc(ids_bytes);
+ float *attn_mask_data = needs_attn_mask ? (float *)malloc(mask_bytes) : NULL;
+ int *gather_idx = (int *)malloc(gather_bytes);
+ if (!padded_ids || (needs_attn_mask && !attn_mask_data) || !gather_idx) {
+ free(padded_ids);
+ free(attn_mask_data);
+ free(gather_idx);
+ return NULL;
+ }
+
+ int gpos = 0;
+ for (int d = 0; d < n_docs; d++) {
+ for (int t = 0; t < max_seq; t++) {
+ size_t idx = (size_t)d * max_seq + t;
+ if (t < n_tokens[d]) {
+ int id = doc_ids[d][t];
+ if (id < 0 || id >= c->vocab_size) {
+ fprintf(stderr, "mlx late: invalid token id %d at doc %d position %d\n", id, d,
+ t);
+ free(padded_ids);
+ free(attn_mask_data);
+ free(gather_idx);
+ return NULL;
+ }
+ padded_ids[idx] = id;
+ if (needs_attn_mask)
+ attn_mask_data[idx] = 0.0f;
+ } else {
+ padded_ids[idx] = 0;
+ if (needs_attn_mask)
+ attn_mask_data[idx] = -1.0e9f;
+ }
+ }
+ /* Map each kept token to its row in the flattened projection. */
+ for (int k = 0; k < n_keep[d]; k++)
+ gather_idx[gpos++] = d * max_seq + keep[d][k];
+ }
+
+ int ids_shape[] = {n_docs, max_seq};
+ int attn_mask_shape[] = {n_docs, 1, 1, max_seq};
+ int gather_shape[] = {total_keep};
+ mlx_array ids = mlx_array_new_data(padded_ids, ids_shape, 2, MLX_INT32);
+ mlx_array attn_mask = needs_attn_mask
+ ? mlx_array_new_data(attn_mask_data, attn_mask_shape, 4, MLX_FLOAT32)
+ : (mlx_array){0};
+ mlx_array gather = mlx_array_new_data(gather_idx, gather_shape, 1, MLX_INT32);
+ free(padded_ids);
+ free(attn_mask_data);
+ free(gather_idx);
+ if (!arr_ok(ids) || (needs_attn_mask && !arr_ok(attn_mask)) || !arr_ok(gather)) {
+ mlx_array_free(ids);
+ mlx_array_free(attn_mask);
+ mlx_array_free(gather);
+ return NULL;
+ }
+ if (needs_attn_mask && mlx_weight_dtype(base) == MLX_BFLOAT16) {
+ mlx_array attn_mask_bf16 = mlx_array_new();
+ mlx_astype(&attn_mask_bf16, attn_mask, MLX_BFLOAT16, S);
+ mlx_array_free(attn_mask);
+ attn_mask = attn_mask_bf16;
+ if (!arr_ok(attn_mask)) {
+ mlx_array_free(ids);
+ mlx_array_free(gather);
+ return NULL;
+ }
+ }
+
+ embed_mlx_late_vectors_t *result = NULL;
+ mlx_array x = mlx_array_new();
+ mlx_array x_normed = (mlx_array){0};
+ mlx_array projected = (mlx_array){0};
+ mlx_array flat = (mlx_array){0};
+ mlx_array gathered = (mlx_array){0};
+
+ mlx_take_axis(&x, base->embed_tokens, ids, 0, S);
+ mlx_array_free(ids);
+ if (!arr_ok(x))
+ goto cleanup;
+
+ x = mlx_forward_layers(base, x, n_docs, max_seq, needs_attn_mask, attn_mask, 0, c->n_layers);
+ if (!arr_ok(x))
+ goto cleanup;
+
+ x_normed = mlx_array_new();
+ mlx_fast_rms_norm(&x_normed, x, base->norm, c->rms_norm_eps, S);
+ mlx_array_free(x);
+ x = (mlx_array){0};
+ if (!arr_ok(x_normed))
+ goto cleanup;
+
+ projected = linear(x_normed, &ctx->projection, S);
+ mlx_array_free(x_normed);
+ x_normed = (mlx_array){0};
+ if (!arr_ok(projected))
+ goto cleanup;
+
+ /* Flatten [n_docs, max_seq, dim] -> [n_docs * max_seq, dim] and gather the
+ * kept tokens in document order into one packed [total_keep, dim] array. */
+ int flat_shape[] = {(int)elems, ctx->token_dim};
+ flat = mlx_array_new();
+ mlx_reshape(&flat, projected, flat_shape, 2, S);
+ mlx_array_free(projected);
+ projected = (mlx_array){0};
+ if (!arr_ok(flat))
+ goto cleanup;
+
+ gathered = mlx_array_new();
+ mlx_take_axis(&gathered, flat, gather, 0, S);
+ mlx_array_free(flat);
+ flat = (mlx_array){0};
+ if (!arr_ok(gathered))
+ goto cleanup;
+
+ /* Normalize after gathering: per-token L2 is row-independent, so this is
+ * identical to normalizing the full batch but skips the dropped and padded
+ * rows entirely. */
+ if (normalize) {
+ mlx_array sq = mlx_array_new();
+ mlx_square(&sq, gathered, S);
+ if (!arr_ok(sq)) {
+ mlx_array_free(sq);
+ goto cleanup;
+ }
+ mlx_array norm2 = mlx_array_new();
+ mlx_sum_axis(&norm2, sq, 1, true, S);
+ mlx_array_free(sq);
+ if (!arr_ok(norm2)) {
+ mlx_array_free(norm2);
+ goto cleanup;
+ }
+ mlx_array inv_norm = mlx_array_new();
+ mlx_rsqrt(&inv_norm, norm2, S);
+ mlx_array_free(norm2);
+ if (!arr_ok(inv_norm)) {
+ mlx_array_free(inv_norm);
+ goto cleanup;
+ }
+ mlx_array normalized = mlx_array_new();
+ mlx_multiply(&normalized, gathered, inv_norm, S);
+ mlx_array_free(inv_norm);
+ mlx_array_free(gathered);
+ gathered = normalized;
+ if (!arr_ok(gathered))
+ goto cleanup;
+ }
+
+ result = (embed_mlx_late_vectors_t *)calloc(1, sizeof(*result));
+ if (!result)
+ goto cleanup;
+ result->owner = ctx;
+ result->vectors = gathered;
+ result->tokens = total_keep;
+ result->dim = ctx->token_dim;
+ gathered = (mlx_array){0};
+
+cleanup:
+ mlx_array_free(gathered);
+ mlx_array_free(flat);
+ mlx_array_free(projected);
+ mlx_array_free(x_normed);
+ mlx_array_free(x);
+ mlx_array_free(gather);
+ mlx_array_free(attn_mask);
+ return result;
+}
+
+/* Device-resident select/concat primitives. The server rerank path batches
+ * candidates through embed_mlx_late_encode_docs_device, but the late-interaction
+ * verification harness (scripts/check_late_interaction.py) drives these directly
+ * to validate per-document gather and concat against the CPU MaxSim reference. */
+embed_mlx_late_vectors_t *embed_mlx_late_vectors_concat(
+ embed_mlx_late_ctx_t *ctx, const embed_mlx_late_vectors_t *const *items, int count) {
+ if (!ctx || !ctx->base || !items || count <= 0)
+ return NULL;
+ int dim = 0;
+ int total = 0;
+ for (int i = 0; i < count; i++) {
+ const embed_mlx_late_vectors_t *v = items[i];
+ if (!v || v->owner != ctx || !arr_ok(v->vectors) || v->tokens <= 0 || v->dim <= 0)
+ return NULL;
+ if (i == 0)
+ dim = v->dim;
+ if (v->dim != dim || total > INT_MAX - v->tokens)
+ return NULL;
+ total += v->tokens;
+ }
+
+ mlx_array *parts = (mlx_array *)malloc((size_t)count * sizeof(*parts));
+ if (!parts)
+ return NULL;
+ for (int i = 0; i < count; i++)
+ parts[i] = items[i]->vectors;
+
+ mlx_stream S = ctx->base->stream;
+ mlx_vector_array vec = mlx_vector_array_new_data(parts, (size_t)count);
+ free(parts);
+ if (!vec.ctx)
+ return NULL;
+
+ mlx_array joined = mlx_array_new();
+ mlx_concatenate_axis(&joined, vec, 0, S);
+ mlx_vector_array_free(vec);
+ if (!arr_ok(joined)) {
+ mlx_array_free(joined);
+ return NULL;
+ }
+
+ embed_mlx_late_vectors_t *out = (embed_mlx_late_vectors_t *)calloc(1, sizeof(*out));
+ if (!out) {
+ mlx_array_free(joined);
+ return NULL;
+ }
+ out->owner = ctx;
+ out->vectors = joined;
+ out->tokens = total;
+ out->dim = dim;
+ return out;
+}
+
+embed_mlx_late_vectors_t *embed_mlx_late_vectors_select(embed_mlx_late_ctx_t *ctx,
+ const embed_mlx_late_vectors_t *vecs,
+ const int *token_indices,
+ int count) {
+ if (!ctx || !ctx->base || !vecs || vecs->owner != ctx || !arr_ok(vecs->vectors) ||
+ !token_indices || count <= 0 || vecs->tokens <= 0 || vecs->dim <= 0)
+ return NULL;
+
+ for (int i = 0; i < count; i++) {
+ if (token_indices[i] < 0 || token_indices[i] >= vecs->tokens)
+ return NULL;
+ }
+
+ size_t idx_bytes;
+ if (mlx_mul_size((size_t)count, sizeof(int), &idx_bytes) != 0)
+ return NULL;
+ int *idx_data = (int *)malloc(idx_bytes);
+ if (!idx_data)
+ return NULL;
+ memcpy(idx_data, token_indices, idx_bytes);
+
+ int idx_shape[] = {count};
+ mlx_array idx = mlx_array_new_data(idx_data, idx_shape, 1, MLX_INT32);
+ free(idx_data);
+ if (!arr_ok(idx))
+ return NULL;
+
+ mlx_stream S = ctx->base->stream;
+ mlx_array selected = mlx_array_new();
+ mlx_take_axis(&selected, vecs->vectors, idx, 0, S);
+ mlx_array_free(idx);
+ if (!arr_ok(selected)) {
+ mlx_array_free(selected);
+ return NULL;
+ }
+
+ embed_mlx_late_vectors_t *out = (embed_mlx_late_vectors_t *)calloc(1, sizeof(*out));
+ if (!out) {
+ mlx_array_free(selected);
+ return NULL;
+ }
+ out->owner = ctx;
+ out->vectors = selected;
+ out->tokens = count;
+ out->dim = vecs->dim;
+ return out;
+}
+
+int embed_mlx_late_maxsim_batch_device(embed_mlx_late_ctx_t *ctx,
+ const embed_mlx_late_vectors_t *query,
+ const embed_mlx_late_vectors_t *docs,
+ const int *doc_offsets,
+ int docs_count,
+ float *scores) {
+ if (!ctx || !query || !docs || !doc_offsets || docs_count <= 0 || !scores ||
+ query->owner != ctx || docs->owner != ctx || query->dim <= 0 || query->dim != docs->dim ||
+ query->tokens <= 0 || docs->tokens <= 0 || !arr_ok(query->vectors) ||
+ !arr_ok(docs->vectors) || doc_offsets[0] != 0)
+ return -1;
+
+ int *lengths = (int *)malloc((size_t)docs_count * sizeof(*lengths));
+ if (!lengths)
+ return -1;
+ int max_doc_tokens = 0;
+ for (int i = 0; i < docs_count; i++) {
+ if (doc_offsets[i] < 0 || doc_offsets[i] >= doc_offsets[i + 1] ||
+ doc_offsets[i + 1] > docs->tokens) {
+ free(lengths);
+ return -1;
+ }
+ int n = doc_offsets[i + 1] - doc_offsets[i];
+ lengths[i] = n;
+ if (n > max_doc_tokens)
+ max_doc_tokens = n;
+ }
+ if (max_doc_tokens <= 0) {
+ free(lengths);
+ return -1;
+ }
+
+ mlx_stream S = ctx->base->stream;
+ int dim = query->dim;
+ int rc = -1;
+ mlx_array *doc_rows = (mlx_array *)calloc((size_t)docs_count, sizeof(*doc_rows));
+ if (!doc_rows) {
+ free(lengths);
+ return -1;
+ }
+
+ mlx_vector_array doc_vec = (mlx_vector_array){0};
+ mlx_array pad_value = mlx_array_new_float32(0.0f);
+ mlx_array doc_batch = (mlx_array){0};
+ mlx_array query_3d = (mlx_array){0};
+ mlx_array query_batched = (mlx_array){0};
+ mlx_array docs_t = (mlx_array){0};
+ mlx_array sims = (mlx_array){0};
+ mlx_array lengths_arr = (mlx_array){0};
+ mlx_array positions = (mlx_array){0};
+ mlx_array lengths_2d = (mlx_array){0};
+ mlx_array positions_2d = (mlx_array){0};
+ mlx_array valid = (mlx_array){0};
+ mlx_array valid_3d = (mlx_array){0};
+ mlx_array invalid_value = mlx_array_new_float32(-FLT_MAX);
+ mlx_array masked_sims = (mlx_array){0};
+ mlx_array maxes = (mlx_array){0};
+ mlx_array sums = (mlx_array){0};
+ mlx_array sums_f32 = (mlx_array){0};
+
+ for (int i = 0; i < docs_count; i++) {
+ int n = lengths[i];
+ int start[] = {doc_offsets[i], 0};
+ int stop[] = {doc_offsets[i + 1], dim};
+ int strides[] = {1, 1};
+
+ mlx_array doc = mlx_array_new();
+ mlx_array padded = (mlx_array){0};
+
+ mlx_slice(&doc, docs->vectors, start, 2, stop, 2, strides, 2, S);
+ if (!arr_ok(doc))
+ goto cleanup;
+
+ if (n < max_doc_tokens) {
+ int axes[] = {0};
+ int low[] = {0};
+ int high[] = {max_doc_tokens - n};
+ padded = mlx_array_new();
+ mlx_pad(&padded, doc, axes, 1, low, 1, high, 1, pad_value, "constant", S);
+ mlx_array_free(doc);
+ doc = padded;
+ padded = (mlx_array){0};
+ if (!arr_ok(doc))
+ goto cleanup;
+ }
+
+ doc_rows[i] = mlx_array_new();
+ mlx_expand_dims(&doc_rows[i], doc, 0, S);
+ mlx_array_free(doc);
+ if (!arr_ok(doc_rows[i]))
+ goto cleanup;
+ }
+
+ doc_vec = mlx_vector_array_new_data(doc_rows, (size_t)docs_count);
+ if (!doc_vec.ctx)
+ goto cleanup;
+
+ doc_batch = mlx_array_new();
+ mlx_concatenate_axis(&doc_batch, doc_vec, 0, S);
+ if (!arr_ok(doc_batch))
+ goto cleanup;
+
+ query_3d = mlx_array_new();
+ mlx_expand_dims(&query_3d, query->vectors, 0, S);
+ if (!arr_ok(query_3d))
+ goto cleanup;
+
+ int q_shape[] = {docs_count, query->tokens, dim};
+ query_batched = mlx_array_new();
+ mlx_broadcast_to(&query_batched, query_3d, q_shape, 3, S);
+ if (!arr_ok(query_batched))
+ goto cleanup;
+
+ int perm[] = {0, 2, 1};
+ docs_t = mlx_array_new();
+ mlx_transpose_axes(&docs_t, doc_batch, perm, 3, S);
+ if (!arr_ok(docs_t))
+ goto cleanup;
+
+ sims = mlx_array_new();
+ mlx_matmul(&sims, query_batched, docs_t, S);
+ if (!arr_ok(sims))
+ goto cleanup;
+
+ int len_shape[] = {docs_count};
+ lengths_arr = mlx_array_new_data(lengths, len_shape, 1, MLX_INT32);
+ if (!arr_ok(lengths_arr))
+ goto cleanup;
+
+ positions = mlx_array_new();
+ mlx_arange(&positions, 0.0, (double)max_doc_tokens, 1.0, MLX_INT32, S);
+ if (!arr_ok(positions))
+ goto cleanup;
+
+ lengths_2d = mlx_array_new();
+ mlx_expand_dims(&lengths_2d, lengths_arr, 1, S);
+ if (!arr_ok(lengths_2d))
+ goto cleanup;
+
+ positions_2d = mlx_array_new();
+ mlx_expand_dims(&positions_2d, positions, 0, S);
+ if (!arr_ok(positions_2d))
+ goto cleanup;
+
+ valid = mlx_array_new();
+ mlx_less(&valid, positions_2d, lengths_2d, S);
+ if (!arr_ok(valid))
+ goto cleanup;
+
+ valid_3d = mlx_array_new();
+ mlx_expand_dims(&valid_3d, valid, 1, S);
+ if (!arr_ok(valid_3d))
+ goto cleanup;
+
+ masked_sims = mlx_array_new();
+ mlx_where(&masked_sims, valid_3d, sims, invalid_value, S);
+ if (!arr_ok(masked_sims))
+ goto cleanup;
+
+ maxes = mlx_array_new();
+ mlx_max_axis(&maxes, masked_sims, 2, false, S);
+ if (!arr_ok(maxes))
+ goto cleanup;
+
+ sums = mlx_array_new();
+ mlx_sum_axis(&sums, maxes, 1, false, S);
+ if (!arr_ok(sums))
+ goto cleanup;
+
+ sums_f32 = mlx_array_new();
+ mlx_astype(&sums_f32, sums, MLX_FLOAT32, S);
+ if (!arr_ok(sums_f32))
+ goto cleanup;
+
+ mlx_array_eval(sums_f32);
+ const float *data = mlx_array_data_float32(sums_f32);
+ if (!data)
+ goto cleanup;
+ memcpy(scores, data, (size_t)docs_count * sizeof(float));
+ rc = 0;
+
+cleanup:
+ mlx_array_free(sums_f32);
+ mlx_array_free(sums);
+ mlx_array_free(maxes);
+ mlx_array_free(masked_sims);
+ mlx_array_free(invalid_value);
+ mlx_array_free(valid_3d);
+ mlx_array_free(valid);
+ mlx_array_free(positions_2d);
+ mlx_array_free(lengths_2d);
+ mlx_array_free(positions);
+ mlx_array_free(lengths_arr);
+ mlx_array_free(sims);
+ mlx_array_free(docs_t);
+ mlx_array_free(query_batched);
+ mlx_array_free(query_3d);
+ mlx_array_free(doc_batch);
+ if (doc_vec.ctx)
+ mlx_vector_array_free(doc_vec);
+ mlx_array_free(pad_value);
+ for (int i = 0; i < docs_count; i++)
+ mlx_array_free(doc_rows[i]);
+ free(doc_rows);
+ free(lengths);
+ return rc;
+}
+
+int embed_mlx_late_encode_tokens(embed_mlx_late_ctx_t *ctx,
+ const int *token_ids,
+ int n_tokens,
+ int normalize,
+ float *out_vectors) {
+ embed_mlx_late_vectors_t *vecs =
+ embed_mlx_late_encode_tokens_device(ctx, token_ids, n_tokens, normalize);
+ if (!vecs)
+ return -1;
+ int rc = embed_mlx_late_vectors_copy(vecs, out_vectors);
+ embed_mlx_late_vectors_free(vecs);
+ return rc;
+}
+
+static int embed_mlx_encode_batch_dense(embed_mlx_ctx_t *ctx,
+ const embed_input_t *inputs,
+ int batch,
+ float *out_embeddings) {
+ if (!ctx || !inputs || batch <= 0 || !out_embeddings || ctx->layer_start != 0 ||
+ ctx->layer_end != ctx->config.n_layers)
+ return -1;
+
+ const embed_config_t *c = &ctx->config;
+ mlx_stream S = ctx->stream;
+
+ int hidden = c->hidden_size;
+ int max_seq = 0;
+ int has_padding = 0;
+ int causal = c->attention_mode == EMBED_ATTENTION_CAUSAL;
+ int cls_pool = c->pooling_mode == EMBED_POOL_CLS;
+ /* CLS and last-token are both single-token pooling: gather one row per
+ * sequence (the first for CLS, the last otherwise) rather than mean-pool. */
+ int single_token_pool = c->pooling_mode == EMBED_POOL_LAST_TOKEN || cls_pool;
+ if (hidden <= 0 || c->vocab_size <= 0)
+ return -1;
+
+ for (int b = 0; b < batch; b++) {
+ if (!inputs[b].ids || inputs[b].n_tokens <= 0)
+ return -1;
+ if (inputs[b].n_tokens > max_seq)
+ max_seq = inputs[b].n_tokens;
+ }
+ if (max_seq <= 0)
+ return -1;
+
+ for (int b = 0; b < batch; b++) {
+ if (inputs[b].n_tokens != max_seq)
+ has_padding = 1;
+ }
+ int needs_pool_mask = has_padding && !single_token_pool;
+ int needs_attn_mask = has_padding && !causal;
+
+ size_t elems, ids_bytes, mask_bytes, len_bytes, out_values, out_bytes;
+ size_t last_index_bytes = 0;
+ if (mlx_mul_size((size_t)batch, (size_t)max_seq, &elems) != 0 ||
+ mlx_mul_size(elems, sizeof(int), &ids_bytes) != 0 ||
+ mlx_mul_size(elems, sizeof(float), &mask_bytes) != 0 ||
+ mlx_mul_size((size_t)batch, sizeof(float), &len_bytes) != 0 ||
+ mlx_mul_size((size_t)batch, (size_t)hidden, &out_values) != 0 ||
+ mlx_mul_size(out_values, sizeof(float), &out_bytes) != 0 ||
+ (single_token_pool && mlx_mul_size(out_values, sizeof(int), &last_index_bytes) != 0))
+ return -1;
+ if (ids_bytes == 0 || out_bytes == 0 ||
+ (needs_pool_mask && (mask_bytes == 0 || len_bytes == 0)) ||
+ (needs_attn_mask && mask_bytes == 0) || (single_token_pool && last_index_bytes == 0))
+ return -1;
+ int *padded_ids = (int *)malloc(ids_bytes);
+ float *pool_mask_data = needs_pool_mask ? (float *)malloc(mask_bytes) : NULL;
+ float *attn_mask_data = needs_attn_mask ? (float *)malloc(mask_bytes) : NULL;
+ float *len_data = needs_pool_mask ? (float *)malloc(len_bytes) : NULL;
+ int *last_index_data = single_token_pool ? (int *)malloc(last_index_bytes) : NULL;
+ if (!padded_ids || (needs_pool_mask && (!pool_mask_data || !len_data)) ||
+ (needs_attn_mask && !attn_mask_data)) {
+ free(padded_ids);
+ free(pool_mask_data);
+ free(attn_mask_data);
+ free(len_data);
+ free(last_index_data);
+ return -1;
+ }
+ if (single_token_pool && !last_index_data) {
+ free(padded_ids);
+ free(pool_mask_data);
+ free(attn_mask_data);
+ free(len_data);
+ return -1;
+ }
+
+ for (int b = 0; b < batch; b++) {
+ if (needs_pool_mask)
+ len_data[b] = (float)inputs[b].n_tokens;
+ if (single_token_pool) {
+ int index = cls_pool ? 0 : inputs[b].n_tokens - 1;
+ for (int d = 0; d < hidden; d++)
+ last_index_data[(size_t)b * hidden + d] = index;
+ }
+ for (int t = 0; t < max_seq; t++) {
+ size_t idx = (size_t)b * max_seq + t;
+ if (t < inputs[b].n_tokens) {
+ int id = inputs[b].ids[t];
+ if (id < 0 || id >= c->vocab_size) {
+ fprintf(stderr, "mlx: invalid token id %d at input %d position %d\n", id, b, t);
+ free(padded_ids);
+ free(pool_mask_data);
+ free(attn_mask_data);
+ free(len_data);
+ free(last_index_data);
+ return -1;
+ }
+ padded_ids[idx] = id;
+ if (needs_pool_mask)
+ pool_mask_data[idx] = 1.0f;
+ if (needs_attn_mask)
+ attn_mask_data[idx] = 0.0f;
+ } else {
+ padded_ids[idx] = 0;
+ if (needs_pool_mask)
+ pool_mask_data[idx] = 0.0f;
+ if (needs_attn_mask)
+ attn_mask_data[idx] = -1.0e9f;
+ }
+ }
+ }
+
+ int ids_shape[] = {batch, max_seq};
+ int pool_mask_shape[] = {batch, max_seq, 1};
+ int attn_mask_shape[] = {batch, 1, 1, max_seq};
+ int len_shape[] = {batch, 1};
+ int last_index_shape[] = {batch, 1, hidden};
+
+ mlx_array ids = mlx_array_new_data(padded_ids, ids_shape, 2, MLX_INT32);
+ mlx_array pool_mask = needs_pool_mask
+ ? mlx_array_new_data(pool_mask_data, pool_mask_shape, 3, MLX_FLOAT32)
+ : (mlx_array){0};
+ mlx_array attn_mask = needs_attn_mask
+ ? mlx_array_new_data(attn_mask_data, attn_mask_shape, 4, MLX_FLOAT32)
+ : (mlx_array){0};
+ mlx_array lengths =
+ needs_pool_mask ? mlx_array_new_data(len_data, len_shape, 2, MLX_FLOAT32) : (mlx_array){0};
+ mlx_array last_indices =
+ single_token_pool ? mlx_array_new_data(last_index_data, last_index_shape, 3, MLX_INT32)
+ : (mlx_array){0};
+ free(padded_ids);
+ free(pool_mask_data);
+ free(attn_mask_data);
+ free(len_data);
+ free(last_index_data);
+
+ if (!arr_ok(ids) || (needs_pool_mask && (!arr_ok(pool_mask) || !arr_ok(lengths))) ||
+ (needs_attn_mask && !arr_ok(attn_mask)) || (single_token_pool && !arr_ok(last_indices))) {
+ mlx_array_free(ids);
+ mlx_array_free(pool_mask);
+ mlx_array_free(attn_mask);
+ mlx_array_free(lengths);
+ mlx_array_free(last_indices);
+ return -1;
+ }
+ if (needs_attn_mask && mlx_weight_dtype(ctx) == MLX_BFLOAT16) {
+ mlx_array attn_mask_bf16 = mlx_array_new();
+ mlx_astype(&attn_mask_bf16, attn_mask, MLX_BFLOAT16, S);
+ mlx_array_free(attn_mask);
+ attn_mask = attn_mask_bf16;
+ if (!arr_ok(attn_mask)) {
+ mlx_array_free(ids);
+ mlx_array_free(pool_mask);
+ mlx_array_free(lengths);
+ mlx_array_free(last_indices);
+ return -1;
+ }
+ }
+
+ /* 1. Embedding lookup: [B, T] -> [B, T, hidden]. */
+ mlx_array x = mlx_array_new();
+ mlx_take_axis(&x, ctx->embed_tokens, ids, 0, S);
+ mlx_array_free(ids);
+
+ /* 2. Family forward. BERT adds learned positions + token-type[0] and an
+ * embedding LayerNorm, then runs post-norm encoder layers; its states are
+ * already final, so pooling uses them directly. Qwen runs the decoder block
+ * and applies the final RMSNorm here. */
+ mlx_array x_normed;
+ if (c->family == EMBED_FAMILY_BERT) {
+ int start2[] = {0, 0}, stride2[] = {1, 1};
+ int pos_stop[] = {max_seq, hidden}, type_stop[] = {1, hidden};
+ mlx_array pos = mlx_array_new();
+ mlx_slice(&pos, ctx->position_embeddings, start2, 2, pos_stop, 2, stride2, 2, S);
+ mlx_array xp = mlx_array_new();
+ mlx_add(&xp, x, pos, S);
+ mlx_array_free(x);
+ mlx_array_free(pos);
+ mlx_array tt = mlx_array_new();
+ mlx_slice(&tt, ctx->token_type_embeddings, start2, 2, type_stop, 2, stride2, 2, S);
+ mlx_array xt = mlx_array_new();
+ mlx_add(&xt, xp, tt, S);
+ mlx_array_free(xp);
+ mlx_array_free(tt);
+ mlx_array xe = mlx_array_new();
+ mlx_fast_layer_norm(&xe, xt, ctx->embed_ln_w, ctx->embed_ln_b, c->layer_norm_eps, S);
+ mlx_array_free(xt);
+ x_normed =
+ mlx_forward_bert(ctx, xe, batch, max_seq, needs_attn_mask, attn_mask, 0, c->n_layers);
+ } else {
+ x = mlx_forward_layers(ctx, x, batch, max_seq, needs_attn_mask, attn_mask, 0, c->n_layers);
+ x_normed = mlx_array_new();
+ mlx_fast_rms_norm(&x_normed, x, ctx->norm, c->rms_norm_eps, S);
+ mlx_array_free(x);
+ }
+
+ mlx_array emb = mlx_array_new();
+ if (single_token_pool) {
+ mlx_array selected = mlx_array_new();
+ mlx_take_along_axis(&selected, x_normed, last_indices, 1, S);
+ mlx_array_free(x_normed);
+ mlx_array_free(last_indices);
+ int emb_shape[] = {batch, hidden};
+ mlx_reshape(&emb, selected, emb_shape, 2, S);
+ mlx_array_free(selected);
+ mlx_array_free(pool_mask);
+ mlx_array_free(attn_mask);
+ mlx_array_free(lengths);
+ } else if (has_padding) {
+ /* 4. Masked mean pool over T. */
+ mlx_array masked = mlx_array_new();
+ mlx_multiply(&masked, x_normed, pool_mask, S);
+ mlx_array_free(x_normed);
+ mlx_array_free(pool_mask);
+
+ mlx_array emb_sum = mlx_array_new();
+ mlx_sum_axis(&emb_sum, masked, 1, false, S);
+ mlx_array_free(masked);
+
+ mlx_divide(&emb, emb_sum, lengths, S);
+ mlx_array_free(emb_sum);
+ mlx_array_free(lengths);
+ mlx_array_free(attn_mask);
+ } else {
+ /* Equal-length batches do not need masks or a separate divide. */
+ mlx_mean_axis(&emb, x_normed, 1, false, S);
+ mlx_array_free(x_normed);
+ }
+
+ /* 5. Eval and copy [B, hidden] to CPU. Perplexity embeddings are
+ * intentionally unnormalized; callers should use cosine similarity. */
+ mlx_array emb_f32 = mlx_array_new();
+ mlx_astype(&emb_f32, emb, MLX_FLOAT32, S);
+ mlx_array_free(emb);
+
+ mlx_array_eval(emb_f32);
+ const float *data = mlx_array_data_float32(emb_f32);
+ int rc = -1;
+ if (data) {
+ memcpy(out_embeddings, data, out_bytes);
+ if (c->normalize_embeddings) {
+ rc = 0;
+ for (int b = 0; b < batch; b++) {
+ if (embed_l2_normalize(out_embeddings + (size_t)b * hidden, hidden) != 0) {
+ rc = -1;
+ break;
+ }
+ }
+ } else {
+ rc = 0;
+ }
+ }
+ mlx_array_free(emb_f32);
+ return rc;
+}
+
+typedef struct {
+ int index;
+ const embed_input_t *input;
+} mlx_batch_item_t;
+
+static int mlx_batch_item_cmp(const void *a, const void *b) {
+ const mlx_batch_item_t *ia = (const mlx_batch_item_t *)a;
+ const mlx_batch_item_t *ib = (const mlx_batch_item_t *)b;
+ int da = ia->input->n_tokens;
+ int db = ib->input->n_tokens;
+ return (da > db) - (da < db);
+}
+
+static int mlx_padding_exceeds_limit(size_t padded, size_t tokens) {
+ if (tokens > SIZE_MAX / 11 || padded > SIZE_MAX / 5)
+ return 1;
+ return padded * 5 > tokens * 11;
+}
+
+static int mlx_batch_should_split(const embed_input_t *inputs,
+ int batch,
+ int *out_total_tokens,
+ int *out_max_seq) {
+ int max_seq = 0;
+ int total_tokens = 0;
+ for (int b = 0; b < batch; b++) {
+ if (!inputs[b].ids || inputs[b].n_tokens <= 0)
+ return 0;
+ if (inputs[b].n_tokens > max_seq)
+ max_seq = inputs[b].n_tokens;
+ if (total_tokens > INT_MAX - inputs[b].n_tokens)
+ return 0;
+ total_tokens += inputs[b].n_tokens;
+ }
+ if (out_total_tokens)
+ *out_total_tokens = total_tokens;
+ if (out_max_seq)
+ *out_max_seq = max_seq;
+ if (batch < 4 || max_seq < 64 || total_tokens <= 0)
+ return 0;
+
+ size_t padded;
+ if (mlx_mul_size((size_t)batch, (size_t)max_seq, &padded) != 0)
+ return 0;
+
+ return mlx_padding_exceeds_limit(padded, (size_t)total_tokens);
+}
+
+static int mlx_should_add_to_group(const embed_mlx_ctx_t *ctx,
+ int group_count,
+ int group_max,
+ int next_tokens) {
+ if (!ctx || ctx->config.hidden_size < 2048 || group_count <= 0)
+ return 1;
+
+ int next_count = group_count + 1;
+ int next_max = next_tokens > group_max ? next_tokens : group_max;
+ size_t merged, split_left, split_total;
+ if (mlx_mul_size((size_t)next_count, (size_t)next_max, &merged) != 0 ||
+ mlx_mul_size((size_t)group_count, (size_t)group_max, &split_left) != 0)
+ return 0;
+ /* Treat one extra MLX launch as roughly 256 padded token rows for 4B.
+ * This preserves small mixed groups while splitting larger padded tails. */
+ if (split_left > SIZE_MAX - (size_t)next_tokens ||
+ split_left + (size_t)next_tokens > SIZE_MAX - 256)
+ return 0;
+ split_total = split_left + (size_t)next_tokens + 256;
+ return merged <= split_total;
+}
+
+int embed_mlx_encode_batch(embed_mlx_ctx_t *ctx,
+ const embed_input_t *inputs,
+ int batch,
+ float *out_embeddings) {
+ if (!ctx || !inputs || batch <= 0 || !out_embeddings)
+ return -1;
+
+ if (!mlx_batch_should_split(inputs, batch, NULL, NULL))
+ return embed_mlx_encode_batch_dense(ctx, inputs, batch, out_embeddings);
+
+ const int hidden = ctx->config.hidden_size;
+ mlx_batch_item_t *items = (mlx_batch_item_t *)malloc((size_t)batch * sizeof(*items));
+ embed_input_t *group_inputs = (embed_input_t *)malloc((size_t)batch * sizeof(*group_inputs));
+ size_t group_values, group_bytes;
+ if (mlx_mul_size((size_t)batch, (size_t)hidden, &group_values) != 0 ||
+ mlx_mul_size(group_values, sizeof(float), &group_bytes) != 0) {
+ free(items);
+ free(group_inputs);
+ return -1;
+ }
+ float *group_out = (float *)malloc(group_bytes);
+ if (!items || !group_inputs || !group_out) {
+ free(items);
+ free(group_inputs);
+ free(group_out);
+ return -1;
+ }
+ for (int i = 0; i < batch; i++) {
+ items[i].index = i;
+ items[i].input = &inputs[i];
+ }
+ qsort(items, (size_t)batch, sizeof(*items), mlx_batch_item_cmp);
+
+ int rc = 0;
+ for (int start = 0; start < batch && rc == 0;) {
+ int group_max = 0;
+ int group_tokens = 0;
+ int end = start;
+ while (end < batch) {
+ int next_tokens = items[end].input->n_tokens;
+ int next_count = end - start + 1;
+ int next_max = next_tokens > group_max ? next_tokens : group_max;
+ int next_total = group_tokens + next_tokens;
+ if (end > start) {
+ size_t next_padded;
+ if (mlx_mul_size((size_t)next_count, (size_t)next_max, &next_padded) != 0 ||
+ mlx_padding_exceeds_limit(next_padded, (size_t)next_total) ||
+ !mlx_should_add_to_group(ctx, end - start, group_max, next_tokens))
+ break;
+ }
+ group_max = next_max;
+ group_tokens = next_total;
+ end++;
+ }
+
+ int group_count = end - start;
+ for (int i = 0; i < group_count; i++)
+ group_inputs[i] = *items[start + i].input;
+ rc = embed_mlx_encode_batch_dense(ctx, group_inputs, group_count, group_out);
+ if (rc != 0)
+ break;
+ for (int i = 0; i < group_count; i++) {
+ int dst = items[start + i].index;
+ memcpy(out_embeddings + (size_t)dst * hidden, group_out + (size_t)i * hidden,
+ (size_t)hidden * sizeof(float));
+ }
+ start = end;
+ }
+
+ free(items);
+ free(group_inputs);
+ free(group_out);
+ return rc;
+}
+
+int embed_mlx_encode_into(embed_mlx_ctx_t *ctx,
+ const int *token_ids,
+ int n_tokens,
+ float *out_embedding) {
+ embed_input_t input = {token_ids, n_tokens};
+ return embed_mlx_encode_batch(ctx, &input, 1, out_embedding);
+}
+
+typedef struct {
+ int index;
+ int span_offset;
+ const embed_context_input_t *input;
+} mlx_context_batch_item_t;
+
+static int mlx_context_batch_item_cmp(const void *a, const void *b) {
+ const mlx_context_batch_item_t *ia = (const mlx_context_batch_item_t *)a;
+ const mlx_context_batch_item_t *ib = (const mlx_context_batch_item_t *)b;
+ int da = ia->input->input.n_tokens;
+ int db = ib->input->input.n_tokens;
+ return (da > db) - (da < db);
+}
+
+static int mlx_context_padding_exceeds_limit(size_t padded, size_t tokens) {
+ if (tokens > SIZE_MAX / 5 || padded > SIZE_MAX / 4)
+ return 1;
+ return padded * 4 > tokens * 5;
+}
+
+static int mlx_context_batch_should_split(const embed_context_input_t *inputs,
+ int batch,
+ int *out_total_spans) {
+ int max_seq = 0;
+ int total_tokens = 0;
+ int total_spans = 0;
+ for (int b = 0; b < batch; b++) {
+ int n_tokens = inputs[b].input.n_tokens;
+ if (!inputs[b].input.ids || n_tokens <= 0 || !inputs[b].spans || inputs[b].n_spans <= 0)
+ return 0;
+ if (n_tokens > max_seq)
+ max_seq = n_tokens;
+ if (total_tokens > INT_MAX - n_tokens || total_spans > INT_MAX - inputs[b].n_spans)
+ return 0;
+ total_tokens += n_tokens;
+ total_spans += inputs[b].n_spans;
+ }
+ if (out_total_spans)
+ *out_total_spans = total_spans;
+ if (batch < 2 || max_seq < 64 || total_tokens <= 0)
+ return 0;
+
+ size_t padded;
+ if (mlx_mul_size((size_t)batch, (size_t)max_seq, &padded) != 0)
+ return 0;
+ return mlx_context_padding_exceeds_limit(padded, (size_t)total_tokens);
+}
+
+static int embed_mlx_encode_spans_batch_dense(embed_mlx_ctx_t *ctx,
+ const embed_context_input_t *inputs,
+ int batch,
+ float *out_embeddings) {
+ if (!ctx || !inputs || batch <= 0 || !out_embeddings || ctx->layer_start != 0 ||
+ ctx->layer_end != ctx->config.n_layers || !arr_ok(ctx->embed_tokens) || !arr_ok(ctx->norm))
+ return -1;
+
+ const embed_config_t *c = &ctx->config;
+ mlx_stream S = ctx->stream;
+ int hidden = c->hidden_size;
+ int max_seq = 0;
+ int total_spans = 0;
+ int has_padding = 0;
+ for (int b = 0; b < batch; b++) {
+ const embed_context_input_t *input = &inputs[b];
+ int n_tokens = input->input.n_tokens;
+ if (!input->input.ids || n_tokens <= 0 || !input->spans || input->n_spans <= 0 ||
+ total_spans > INT_MAX - input->n_spans)
+ return -1;
+ total_spans += input->n_spans;
+ if (n_tokens > max_seq)
+ max_seq = n_tokens;
+ for (int t = 0; t < n_tokens; t++) {
+ if (input->input.ids[t] < 0 || input->input.ids[t] >= c->vocab_size) {
+ fprintf(stderr, "mlx: invalid token id %d at input %d position %d\n",
+ input->input.ids[t], b, t);
+ return -1;
+ }
+ }
+ for (int s = 0; s < input->n_spans; s++) {
+ if (input->spans[s].start < 0 || input->spans[s].start > n_tokens ||
+ input->spans[s].n_tokens <= 0 ||
+ input->spans[s].n_tokens > n_tokens - input->spans[s].start)
+ return -1;
+ }
+ }
+ for (int b = 0; b < batch; b++)
+ if (inputs[b].input.n_tokens != max_seq)
+ has_padding = 1;
+
+ size_t rows, ids_bytes, mask_bytes, index_bytes;
+ size_t span_float_bytes, out_values, out_bytes;
+ if (mlx_mul_size((size_t)batch, (size_t)max_seq, &rows) != 0 ||
+ mlx_mul_size(rows, sizeof(int), &ids_bytes) != 0 ||
+ mlx_mul_size(rows, sizeof(float), &mask_bytes) != 0 ||
+ mlx_mul_size((size_t)total_spans, sizeof(int), &index_bytes) != 0 ||
+ mlx_mul_size((size_t)total_spans, sizeof(float), &span_float_bytes) != 0 ||
+ mlx_mul_size((size_t)total_spans, (size_t)hidden, &out_values) != 0 ||
+ mlx_mul_size(out_values, sizeof(float), &out_bytes) != 0)
+ return -1;
+ if (rows > INT_MAX)
+ return -1;
+ int *padded_ids = (int *)malloc(ids_bytes);
+ float *attn_mask_data = has_padding ? (float *)malloc(mask_bytes) : NULL;
+ if (!padded_ids || (has_padding && !attn_mask_data)) {
+ free(padded_ids);
+ free(attn_mask_data);
+ return -1;
+ }
+ for (int b = 0; b < batch; b++) {
+ const embed_input_t *input = &inputs[b].input;
+ for (int t = 0; t < max_seq; t++) {
+ size_t row = (size_t)b * max_seq + t;
+ if (t < input->n_tokens) {
+ padded_ids[row] = input->ids[t];
+ if (has_padding)
+ attn_mask_data[row] = 0.0f;
+ } else {
+ padded_ids[row] = 0;
+ if (has_padding)
+ attn_mask_data[row] = -1.0e9f;
+ }
+ }
+ }
+
+ mlx_array ids = (mlx_array){0};
+ mlx_array attn_mask = (mlx_array){0};
+ mlx_array x = (mlx_array){0};
+ mlx_array x_normed = (mlx_array){0};
+ mlx_array prefix = (mlx_array){0};
+ mlx_array flat_prefix = (mlx_array){0};
+ mlx_array end_idx = (mlx_array){0};
+ mlx_array start_idx = (mlx_array){0};
+ mlx_array lengths = (mlx_array){0};
+ mlx_array start_mask = (mlx_array){0};
+ mlx_array end_values = (mlx_array){0};
+ mlx_array start_values = (mlx_array){0};
+ mlx_array masked_start = (mlx_array){0};
+ mlx_array span_sums = (mlx_array){0};
+ mlx_array embeddings = (mlx_array){0};
+ mlx_array embeddings_f32 = (mlx_array){0};
+ mlx_array *pooled = NULL;
+ mlx_vector_array pooled_vec = (mlx_vector_array){0};
+ int *end_idx_data = NULL;
+ int *start_idx_data = NULL;
+ float *lengths_data = NULL;
+ float *start_mask_data = NULL;
+ int rc = -1;
+
+ int ids_shape[] = {batch, max_seq};
+ int attn_mask_shape[] = {batch, 1, 1, max_seq};
+ ids = mlx_array_new_data(padded_ids, ids_shape, 2, MLX_INT32);
+ attn_mask = has_padding ? mlx_array_new_data(attn_mask_data, attn_mask_shape, 4, MLX_FLOAT32)
+ : (mlx_array){0};
+ free(padded_ids);
+ free(attn_mask_data);
+ if (!arr_ok(ids))
+ goto cleanup;
+ if (has_padding && !arr_ok(attn_mask))
+ goto cleanup;
+ if (has_padding && mlx_weight_dtype(ctx) == MLX_BFLOAT16) {
+ mlx_array attn_mask_bf16 = mlx_array_new();
+ mlx_astype(&attn_mask_bf16, attn_mask, MLX_BFLOAT16, S);
+ mlx_array_free(attn_mask);
+ attn_mask = attn_mask_bf16;
+ if (!arr_ok(attn_mask))
+ goto cleanup;
+ }
+
+ x = mlx_array_new();
+ mlx_take_axis(&x, ctx->embed_tokens, ids, 0, S);
+ mlx_array_free(ids);
+ ids = (mlx_array){0};
+ if (!arr_ok(x))
+ goto cleanup;
+
+ x = mlx_forward_layers(ctx, x, batch, max_seq, has_padding, attn_mask, 0, c->n_layers);
+ if (has_padding) {
+ mlx_array_free(attn_mask);
+ attn_mask = (mlx_array){0};
+ }
+ if (!arr_ok(x))
+ goto cleanup;
+
+ x_normed = mlx_array_new();
+ mlx_fast_rms_norm(&x_normed, x, ctx->norm, c->rms_norm_eps, S);
+ mlx_array_free(x);
+ x = (mlx_array){0};
+ if (!arr_ok(x_normed))
+ goto cleanup;
+
+ if (mlx_weight_dtype(ctx) == MLX_BFLOAT16) {
+ pooled = (mlx_array *)calloc((size_t)total_spans, sizeof(*pooled));
+ if (!pooled)
+ goto cleanup;
+
+ int pooled_count = 0;
+ for (int b = 0; b < batch; b++) {
+ for (int s = 0; s < inputs[b].n_spans; s++) {
+ const embed_span_t *span = &inputs[b].spans[s];
+ int start[] = {b, span->start, 0};
+ int stop[] = {b + 1, span->start + span->n_tokens, hidden};
+ int strides[] = {1, 1, 1};
+ mlx_array slice = mlx_array_new();
+ mlx_slice(&slice, x_normed, start, 3, stop, 3, strides, 3, S);
+ if (!arr_ok(slice)) {
+ mlx_array_free(slice);
+ goto cleanup;
+ }
+
+ pooled[pooled_count] = mlx_array_new();
+ mlx_mean_axis(&pooled[pooled_count], slice, 1, false, S);
+ mlx_array_free(slice);
+ if (!arr_ok(pooled[pooled_count]))
+ goto cleanup;
+ pooled_count++;
+ }
+ }
+
+ pooled_vec = mlx_vector_array_new_data(pooled, (size_t)total_spans);
+ if (!pooled_vec.ctx)
+ goto cleanup;
+ embeddings = mlx_array_new();
+ mlx_concatenate_axis(&embeddings, pooled_vec, 0, S);
+ if (!arr_ok(embeddings))
+ goto cleanup;
+ } else {
+ end_idx_data = (int *)malloc(index_bytes);
+ start_idx_data = (int *)malloc(index_bytes);
+ lengths_data = (float *)malloc(span_float_bytes);
+ start_mask_data = (float *)malloc(span_float_bytes);
+ if (!end_idx_data || !start_idx_data || !lengths_data || !start_mask_data)
+ goto cleanup;
+
+ int span_count = 0;
+ for (int b = 0; b < batch; b++) {
+ for (int s = 0; s < inputs[b].n_spans; s++) {
+ const embed_span_t *span = &inputs[b].spans[s];
+ int base = b * max_seq;
+ int start = span->start;
+ int stop = span->start + span->n_tokens;
+ end_idx_data[span_count] = base + stop - 1;
+ start_idx_data[span_count] = start > 0 ? base + start - 1 : base;
+ lengths_data[span_count] = (float)span->n_tokens;
+ start_mask_data[span_count] = start > 0 ? 1.0f : 0.0f;
+ span_count++;
+ }
+ }
+
+ int index_shape[] = {total_spans};
+ int scale_shape[] = {total_spans, 1};
+ end_idx = mlx_array_new_data(end_idx_data, index_shape, 1, MLX_INT32);
+ start_idx = mlx_array_new_data(start_idx_data, index_shape, 1, MLX_INT32);
+ lengths = mlx_array_new_data(lengths_data, scale_shape, 2, MLX_FLOAT32);
+ start_mask = mlx_array_new_data(start_mask_data, scale_shape, 2, MLX_FLOAT32);
+ free(end_idx_data);
+ end_idx_data = NULL;
+ free(start_idx_data);
+ start_idx_data = NULL;
+ free(lengths_data);
+ lengths_data = NULL;
+ free(start_mask_data);
+ start_mask_data = NULL;
+ if (!arr_ok(end_idx) || !arr_ok(start_idx) || !arr_ok(lengths) || !arr_ok(start_mask))
+ goto cleanup;
+
+ prefix = mlx_array_new();
+ mlx_cumsum(&prefix, x_normed, 1, false, true, S);
+ mlx_array_free(x_normed);
+ x_normed = (mlx_array){0};
+ if (!arr_ok(prefix))
+ goto cleanup;
+
+ int flat_shape[] = {(int)rows, hidden};
+ flat_prefix = mlx_array_new();
+ mlx_reshape(&flat_prefix, prefix, flat_shape, 2, S);
+ mlx_array_free(prefix);
+ prefix = (mlx_array){0};
+ if (!arr_ok(flat_prefix))
+ goto cleanup;
+
+ end_values = mlx_array_new();
+ mlx_take_axis(&end_values, flat_prefix, end_idx, 0, S);
+ if (!arr_ok(end_values))
+ goto cleanup;
+
+ start_values = mlx_array_new();
+ mlx_take_axis(&start_values, flat_prefix, start_idx, 0, S);
+ if (!arr_ok(start_values))
+ goto cleanup;
+
+ masked_start = mlx_array_new();
+ mlx_multiply(&masked_start, start_values, start_mask, S);
+ if (!arr_ok(masked_start))
+ goto cleanup;
+
+ span_sums = mlx_array_new();
+ mlx_subtract(&span_sums, end_values, masked_start, S);
+ if (!arr_ok(span_sums))
+ goto cleanup;
+
+ embeddings = mlx_array_new();
+ mlx_divide(&embeddings, span_sums, lengths, S);
+ if (!arr_ok(embeddings))
+ goto cleanup;
+ }
+
+ embeddings_f32 = mlx_array_new();
+ mlx_astype(&embeddings_f32, embeddings, MLX_FLOAT32, S);
+ if (!arr_ok(embeddings_f32))
+ goto cleanup;
+
+ mlx_array_eval(embeddings_f32);
+ const float *data = mlx_array_data_float32(embeddings_f32);
+ if (data) {
+ memcpy(out_embeddings, data, out_bytes);
+ rc = 0;
+ }
+
+cleanup:
+ free(start_mask_data);
+ free(lengths_data);
+ free(start_idx_data);
+ free(end_idx_data);
+ mlx_array_free(embeddings_f32);
+ mlx_array_free(embeddings);
+ if (pooled_vec.ctx)
+ mlx_vector_array_free(pooled_vec);
+ if (pooled) {
+ for (int s = 0; s < total_spans; s++)
+ mlx_array_free(pooled[s]);
+ free(pooled);
+ }
+ mlx_array_free(span_sums);
+ mlx_array_free(masked_start);
+ mlx_array_free(start_values);
+ mlx_array_free(end_values);
+ mlx_array_free(start_mask);
+ mlx_array_free(lengths);
+ mlx_array_free(start_idx);
+ mlx_array_free(end_idx);
+ mlx_array_free(flat_prefix);
+ mlx_array_free(prefix);
+ mlx_array_free(x_normed);
+ mlx_array_free(x);
+ mlx_array_free(attn_mask);
+ mlx_array_free(ids);
+ return rc;
+}
+
+int embed_mlx_encode_spans_batch(embed_mlx_ctx_t *ctx,
+ const embed_context_input_t *inputs,
+ int batch,
+ float *out_embeddings) {
+ if (!ctx || !inputs || batch <= 0 || !out_embeddings)
+ return -1;
+
+ int total_spans = 0;
+ if (!mlx_context_batch_should_split(inputs, batch, &total_spans))
+ return embed_mlx_encode_spans_batch_dense(ctx, inputs, batch, out_embeddings);
+
+ const int hidden = ctx->config.hidden_size;
+ mlx_context_batch_item_t *items =
+ (mlx_context_batch_item_t *)malloc((size_t)batch * sizeof(*items));
+ embed_context_input_t *group_inputs =
+ (embed_context_input_t *)malloc((size_t)batch * sizeof(*group_inputs));
+ size_t group_values, group_bytes;
+ if (mlx_mul_size((size_t)total_spans, (size_t)hidden, &group_values) != 0 ||
+ mlx_mul_size(group_values, sizeof(float), &group_bytes) != 0) {
+ free(items);
+ free(group_inputs);
+ return -1;
+ }
+ float *group_out = (float *)malloc(group_bytes);
+ if (!items || !group_inputs || !group_out) {
+ free(items);
+ free(group_inputs);
+ free(group_out);
+ return -1;
+ }
+
+ int span_offset = 0;
+ for (int i = 0; i < batch; i++) {
+ items[i].index = i;
+ items[i].span_offset = span_offset;
+ items[i].input = &inputs[i];
+ span_offset += inputs[i].n_spans;
+ }
+ qsort(items, (size_t)batch, sizeof(*items), mlx_context_batch_item_cmp);
+
+ int rc = 0;
+ for (int start = 0; start < batch && rc == 0;) {
+ int group_max = 0;
+ int group_tokens = 0;
+ int end = start;
+ while (end < batch) {
+ int next_tokens = items[end].input->input.n_tokens;
+ int next_count = end - start + 1;
+ int next_max = next_tokens > group_max ? next_tokens : group_max;
+ int next_total = group_tokens + next_tokens;
+ if (end > start) {
+ size_t next_padded;
+ if (mlx_mul_size((size_t)next_count, (size_t)next_max, &next_padded) != 0 ||
+ mlx_context_padding_exceeds_limit(next_padded, (size_t)next_total) ||
+ !mlx_should_add_to_group(ctx, end - start, group_max, next_tokens))
+ break;
+ }
+ group_max = next_max;
+ group_tokens = next_total;
+ end++;
+ }
+
+ int group_count = end - start;
+ for (int i = 0; i < group_count; i++)
+ group_inputs[i] = *items[start + i].input;
+ rc = embed_mlx_encode_spans_batch_dense(ctx, group_inputs, group_count, group_out);
+ if (rc != 0)
+ break;
+ int src_span = 0;
+ for (int i = 0; i < group_count; i++) {
+ int n_spans = group_inputs[i].n_spans;
+ int dst_span = items[start + i].span_offset;
+ memcpy(out_embeddings + (size_t)dst_span * hidden,
+ group_out + (size_t)src_span * hidden, (size_t)n_spans * hidden * sizeof(float));
+ src_span += n_spans;
+ }
+ start = end;
+ }
+
+ free(items);
+ free(group_inputs);
+ free(group_out);
+ return rc;
+}
+
+int embed_mlx_encode_spans(embed_mlx_ctx_t *ctx,
+ const int *token_ids,
+ int n_tokens,
+ const embed_span_t *spans,
+ int n_spans,
+ float *out_embeddings) {
+ embed_context_input_t input = {
+ .input = {token_ids, n_tokens},
+ .spans = spans,
+ .n_spans = n_spans,
+ };
+ return embed_mlx_encode_spans_batch(ctx, &input, 1, out_embeddings);
+}
+
+float *embed_mlx_encode(embed_mlx_ctx_t *ctx, const int *token_ids, int n_tokens) {
+ if (!ctx || !token_ids || n_tokens <= 0)
+ return NULL;
+
+ int hidden = ctx->config.hidden_size;
+ size_t out_bytes;
+ if (mlx_mul_size((size_t)hidden, sizeof(float), &out_bytes) != 0)
+ return NULL;
+ float *out = (float *)malloc(out_bytes);
+ if (!out)
+ return NULL;
+
+ if (embed_mlx_encode_into(ctx, token_ids, n_tokens, out) != 0) {
+ free(out);
+ return NULL;
+ }
+ return out;
+}
diff --git a/src/mlx.h b/src/mlx.h
new file mode 100644
index 0000000..55f5666
--- /dev/null
+++ b/src/mlx.h
@@ -0,0 +1,167 @@
+/*
+ * embed_mlx.h - MLX GPU backend for Apple Silicon
+ *
+ * Uses Apple's mlx-c to run the transformer on Metal.
+ */
+
+#ifndef EMBED_MLX_H
+#define EMBED_MLX_H
+
+/* Public-API export annotation. The libraries are built with
+ * -fvisibility=hidden, so only declarations carrying EMBED_API are exported
+ * from the shared library; everything else stays internal. */
+#ifndef EMBED_API
+#if defined(__GNUC__)
+#define EMBED_API __attribute__((visibility("default")))
+#else
+#define EMBED_API
+#endif
+#endif
+
+#include <stddef.h>
+#include <stdint.h>
+#include "embed.h"
+
+/* Opaque MLX model context */
+typedef struct embed_mlx_ctx embed_mlx_ctx_t;
+typedef struct embed_mlx_late_ctx embed_mlx_late_ctx_t;
+typedef struct embed_mlx_late_vectors embed_mlx_late_vectors_t;
+
+typedef struct {
+ int quantize_bits; /* 0 disables; currently 8 */
+ int quantize_group_size; /* default 64 when quantize_bits is set */
+} embed_mlx_options_t;
+
+/*
+ * Load model into MLX arrays from safetensors + config.json.
+ * Returns NULL on error.
+ */
+EMBED_API embed_mlx_ctx_t *embed_mlx_load(const char *model_dir);
+EMBED_API embed_mlx_ctx_t *embed_mlx_load_with_options(const char *model_dir,
+ const embed_mlx_options_t *opts);
+
+EMBED_API void embed_mlx_free(embed_mlx_ctx_t *ctx);
+
+/*
+ * Late-interaction MLX path. This is separate from pooled embeddings because
+ * late snapshots produce one projected token vector per input token for MaxSim
+ * scoring, not one pooled document vector.
+ */
+EMBED_API embed_mlx_late_ctx_t *embed_mlx_late_load(const char *model_dir);
+EMBED_API embed_mlx_late_ctx_t *embed_mlx_late_load_with_options(const char *model_dir,
+ const embed_mlx_options_t *opts);
+EMBED_API void embed_mlx_late_free(embed_mlx_late_ctx_t *ctx);
+
+EMBED_API const embed_config_t *embed_mlx_late_config(const embed_mlx_late_ctx_t *ctx);
+EMBED_API int embed_mlx_late_token_dim(const embed_mlx_late_ctx_t *ctx);
+
+/*
+ * Encode token_ids into out_vectors[n_tokens, token_dim].
+ *
+ * If normalize is non-zero, every token vector is L2-normalized on device
+ * before copying back to CPU memory.
+ */
+EMBED_API int embed_mlx_late_encode_tokens(embed_mlx_late_ctx_t *ctx,
+ const int *token_ids,
+ int n_tokens,
+ int normalize,
+ float *out_vectors);
+
+/*
+ * Device-resident late-interaction token vectors.
+ *
+ * The model context owns the MLX stream; the returned vector handle must not
+ * outlive ctx. Copying is optional: MaxSim can consume these handles directly
+ * and copy back only final candidate scores.
+ */
+EMBED_API embed_mlx_late_vectors_t *embed_mlx_late_encode_tokens_device(embed_mlx_late_ctx_t *ctx,
+ const int *token_ids,
+ int n_tokens,
+ int normalize);
+EMBED_API void embed_mlx_late_vectors_free(embed_mlx_late_vectors_t *vecs);
+EMBED_API int embed_mlx_late_vectors_token_count(const embed_mlx_late_vectors_t *vecs);
+EMBED_API int embed_mlx_late_vectors_dim(const embed_mlx_late_vectors_t *vecs);
+EMBED_API int embed_mlx_late_vectors_copy(const embed_mlx_late_vectors_t *vecs, float *out_vectors);
+/*
+ * Encode n_docs documents in one padded transformer pass and pack each
+ * document's kept token vectors back-to-back into [total_keep, token_dim] in
+ * document order. out_offsets[n_docs + 1] receives the prefix sum of kept
+ * counts, so the result feeds embed_mlx_late_maxsim_batch_device directly.
+ * Returns NULL on error; the handle must not outlive ctx.
+ */
+EMBED_API embed_mlx_late_vectors_t *embed_mlx_late_encode_docs_device(embed_mlx_late_ctx_t *ctx,
+ const int *const *doc_ids,
+ const int *n_tokens,
+ const int *const *keep,
+ const int *n_keep,
+ int n_docs,
+ int normalize,
+ int *out_offsets);
+/* Device-resident select/concat primitives, retained for the late-interaction
+ * verification harness (scripts/check_late_interaction.py); the server rerank
+ * path uses embed_mlx_late_encode_docs_device. */
+EMBED_API embed_mlx_late_vectors_t *embed_mlx_late_vectors_concat(
+ embed_mlx_late_ctx_t *ctx, const embed_mlx_late_vectors_t *const *items, int count);
+EMBED_API embed_mlx_late_vectors_t *
+embed_mlx_late_vectors_select(embed_mlx_late_ctx_t *ctx,
+ const embed_mlx_late_vectors_t *vecs,
+ const int *token_indices,
+ int count);
+EMBED_API int embed_mlx_late_maxsim_batch_device(embed_mlx_late_ctx_t *ctx,
+ const embed_mlx_late_vectors_t *query,
+ const embed_mlx_late_vectors_t *docs,
+ const int *doc_offsets,
+ int docs_count,
+ float *scores);
+
+/*
+ * Compute embedding for token_ids[0..n_tokens-1].
+ * Returns malloc'd float[hidden_size] (caller frees). NULL on error.
+ */
+EMBED_API float *embed_mlx_encode(embed_mlx_ctx_t *ctx, const int *token_ids, int n_tokens);
+
+/*
+ * Compute one embedding into caller-provided out[hidden_size].
+ * Returns 0 on success, -1 on error.
+ */
+EMBED_API int embed_mlx_encode_into(embed_mlx_ctx_t *ctx,
+ const int *token_ids,
+ int n_tokens,
+ float *out_embedding);
+
+/*
+ * Compute a true padded dense batch on MLX.
+ *
+ * out_embeddings is caller-provided [batch, hidden_size].
+ * Pooling and attention masking follow the loaded model configuration.
+ * Returns 0 on success, -1 on error.
+ */
+EMBED_API int embed_mlx_encode_batch(embed_mlx_ctx_t *ctx,
+ const embed_input_t *inputs,
+ int batch,
+ float *out_embeddings);
+
+/*
+ * Run one contextual sequence and pool selected token spans.
+ * Returns 0 on success, -1 on error.
+ */
+EMBED_API int embed_mlx_encode_spans(embed_mlx_ctx_t *ctx,
+ const int *token_ids,
+ int n_tokens,
+ const embed_span_t *spans,
+ int n_spans,
+ float *out_embeddings);
+
+/*
+ * Run a padded dense contextual document batch and pool every selected span.
+ * out_embeddings contains spans in document order.
+ */
+EMBED_API int embed_mlx_encode_spans_batch(embed_mlx_ctx_t *ctx,
+ const embed_context_input_t *inputs,
+ int batch,
+ float *out_embeddings);
+
+/* Get the config (so embed_cli.c can read hidden_size etc.) */
+EMBED_API const embed_config_t *embed_mlx_config(const embed_mlx_ctx_t *ctx);
+
+#endif /* EMBED_MLX_H */
diff --git a/src/safetensors.c b/src/safetensors.c
new file mode 100644
index 0000000..f12549c
--- /dev/null
+++ b/src/safetensors.c
@@ -0,0 +1,559 @@
+#include "safetensors.h"
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <fcntl.h>
+#include <unistd.h>
+#include <sys/mman.h>
+#include <sys/stat.h>
+#include <dirent.h>
+
+/* ========================================================================
+ * Minimal JSON parser for safetensors header
+ * ======================================================================== */
+
+static void skip_whitespace(const char **p) {
+ while (**p == ' ' || **p == '\n' || **p == '\r' || **p == '\t')
+ (*p)++;
+}
+
+static int parse_string(const char **p, char *out, size_t max_len) {
+ skip_whitespace(p);
+ if (**p != '"')
+ return -1;
+ (*p)++;
+ size_t i = 0;
+ while (**p && **p != '"' && i < max_len - 1) {
+ if (**p == '\\') {
+ (*p)++;
+ if (**p == 'n')
+ out[i++] = '\n';
+ else if (**p == 't')
+ out[i++] = '\t';
+ else if (**p == '"')
+ out[i++] = '"';
+ else if (**p == '\\')
+ out[i++] = '\\';
+ else
+ out[i++] = **p;
+ } else {
+ out[i++] = **p;
+ }
+ (*p)++;
+ }
+ out[i] = '\0';
+ if (**p != '"')
+ return -1;
+ (*p)++;
+ return 0;
+}
+
+static int parse_int(const char **p, int64_t *out) {
+ skip_whitespace(p);
+ int64_t val = 0;
+ int neg = 0;
+ if (**p == '-') {
+ neg = 1;
+ (*p)++;
+ }
+ if (**p < '0' || **p > '9')
+ return -1;
+ while (**p >= '0' && **p <= '9') {
+ val = val * 10 + (**p - '0');
+ (*p)++;
+ }
+ *out = neg ? -val : val;
+ return 0;
+}
+
+static safetensor_dtype_t parse_dtype(const char *s) {
+ if (strcmp(s, "F32") == 0)
+ return DTYPE_F32;
+ if (strcmp(s, "F16") == 0)
+ return DTYPE_F16;
+ if (strcmp(s, "BF16") == 0)
+ return DTYPE_BF16;
+ if (strcmp(s, "I32") == 0)
+ return DTYPE_I32;
+ if (strcmp(s, "I64") == 0)
+ return DTYPE_I64;
+ if (strcmp(s, "BOOL") == 0)
+ return DTYPE_BOOL;
+ return DTYPE_UNKNOWN;
+}
+
+static int parse_tensor_entry(const char **p, safetensor_t *t) {
+ skip_whitespace(p);
+ if (**p != '{')
+ return -1;
+ (*p)++;
+
+ t->dtype = DTYPE_UNKNOWN;
+ t->ndim = 0;
+ t->data_offset = 0;
+ t->data_size = 0;
+
+ while (**p && **p != '}') {
+ skip_whitespace(p);
+ if (**p == ',') {
+ (*p)++;
+ continue;
+ }
+
+ char key[64];
+ if (parse_string(p, key, sizeof(key)) != 0)
+ return -1;
+ skip_whitespace(p);
+ if (**p != ':')
+ return -1;
+ (*p)++;
+ skip_whitespace(p);
+
+ if (strcmp(key, "dtype") == 0) {
+ char dtype_str[32];
+ if (parse_string(p, dtype_str, sizeof(dtype_str)) != 0)
+ return -1;
+ t->dtype = parse_dtype(dtype_str);
+ } else if (strcmp(key, "shape") == 0) {
+ if (**p != '[')
+ return -1;
+ (*p)++;
+ t->ndim = 0;
+ while (**p && **p != ']') {
+ skip_whitespace(p);
+ if (**p == ',') {
+ (*p)++;
+ continue;
+ }
+ if (t->ndim >= 8)
+ return -1;
+ if (parse_int(p, &t->shape[t->ndim]) != 0)
+ return -1;
+ t->ndim++;
+ }
+ if (**p != ']')
+ return -1;
+ (*p)++;
+ } else if (strcmp(key, "data_offsets") == 0) {
+ if (**p != '[')
+ return -1;
+ (*p)++;
+ skip_whitespace(p);
+ int64_t start_i;
+ if (parse_int(p, &start_i) != 0)
+ return -1;
+ skip_whitespace(p);
+ if (**p != ',')
+ return -1;
+ (*p)++;
+ skip_whitespace(p);
+ int64_t end_i;
+ if (parse_int(p, &end_i) != 0)
+ return -1;
+ if (start_i < 0 || end_i < start_i)
+ return -1;
+ t->data_offset = (size_t)start_i;
+ t->data_size = (size_t)(end_i - start_i);
+ skip_whitespace(p);
+ if (**p != ']')
+ return -1;
+ (*p)++;
+ } else {
+ /* Skip unknown value */
+ if (**p == '"') {
+ (*p)++;
+ while (**p && **p != '"') {
+ if (**p == '\\')
+ (*p)++;
+ if (**p)
+ (*p)++;
+ }
+ if (**p == '"')
+ (*p)++;
+ } else if (**p == '[') {
+ int depth = 1;
+ (*p)++;
+ while (**p && depth > 0) {
+ if (**p == '[')
+ depth++;
+ else if (**p == ']')
+ depth--;
+ (*p)++;
+ }
+ } else if (**p == '{') {
+ int depth = 1;
+ (*p)++;
+ while (**p && depth > 0) {
+ if (**p == '{')
+ depth++;
+ else if (**p == '}')
+ depth--;
+ (*p)++;
+ }
+ } else {
+ while (**p && **p != ',' && **p != '}')
+ (*p)++;
+ }
+ }
+ }
+ if (**p != '}')
+ return -1;
+ (*p)++;
+ return 0;
+}
+
+static int parse_header(safetensors_file_t *sf) {
+ const char *p = sf->header_json;
+ skip_whitespace(&p);
+ if (*p != '{')
+ return -1;
+ p++;
+
+ sf->num_tensors = 0;
+
+ while (*p && *p != '}') {
+ skip_whitespace(&p);
+ if (*p == ',') {
+ p++;
+ continue;
+ }
+ if (*p == '}')
+ break;
+
+ char name[256];
+ if (parse_string(&p, name, sizeof(name)) != 0)
+ return -1;
+ skip_whitespace(&p);
+ if (*p != ':')
+ return -1;
+ p++;
+
+ if (strcmp(name, "__metadata__") == 0) {
+ skip_whitespace(&p);
+ if (*p == '{') {
+ int depth = 1;
+ p++;
+ while (*p && depth > 0) {
+ if (*p == '{')
+ depth++;
+ else if (*p == '}')
+ depth--;
+ p++;
+ }
+ }
+ continue;
+ }
+
+ if (sf->num_tensors >= SAFETENSORS_MAX_TENSORS) {
+ fprintf(stderr, "safetensors: too many tensors in %s (max %d)\n",
+ sf->path ? sf->path : "<unknown>", SAFETENSORS_MAX_TENSORS);
+ return -1;
+ }
+
+ safetensor_t *t = &sf->tensors[sf->num_tensors];
+ snprintf(t->name, sizeof(t->name), "%s", name);
+ if (parse_tensor_entry(&p, t) != 0)
+ return -1;
+ sf->num_tensors++;
+ }
+ if (*p != '}')
+ return -1;
+ return 0;
+}
+
+/* ========================================================================
+ * Single file operations
+ * ======================================================================== */
+
+safetensors_file_t *safetensors_open(const char *path) {
+ int fd = open(path, O_RDONLY);
+ if (fd < 0)
+ return NULL;
+
+ struct stat st;
+ if (fstat(fd, &st) < 0) {
+ close(fd);
+ return NULL;
+ }
+
+ size_t file_size = (size_t)st.st_size;
+ if (file_size < 8) {
+ close(fd);
+ return NULL;
+ }
+
+ void *data = mmap(NULL, file_size, PROT_READ, MAP_PRIVATE, fd, 0);
+ close(fd);
+ if (data == MAP_FAILED)
+ return NULL;
+
+ uint64_t header_size = 0;
+ memcpy(&header_size, data, 8);
+ if (header_size > file_size - 8) {
+ munmap(data, file_size);
+ return NULL;
+ }
+
+ safetensors_file_t *sf = calloc(1, sizeof(safetensors_file_t));
+ if (!sf) {
+ munmap(data, file_size);
+ return NULL;
+ }
+
+ sf->path = strdup(path);
+ sf->data = data;
+ sf->file_size = file_size;
+ sf->header_size = (size_t)header_size;
+
+ sf->header_json = malloc(header_size + 1);
+ if (!sf->header_json) {
+ safetensors_close(sf);
+ return NULL;
+ }
+ memcpy(sf->header_json, (char *)data + 8, header_size);
+ sf->header_json[header_size] = '\0';
+
+ if (parse_header(sf) != 0) {
+ safetensors_close(sf);
+ return NULL;
+ }
+
+ return sf;
+}
+
+void safetensors_close(safetensors_file_t *sf) {
+ if (!sf)
+ return;
+ if (sf->data)
+ munmap(sf->data, sf->file_size);
+ free(sf->path);
+ free(sf->header_json);
+ free(sf);
+}
+
+const void *safetensors_data(const safetensors_file_t *sf, const safetensor_t *t) {
+ return (const char *)sf->data + 8 + sf->header_size + t->data_offset;
+}
+
+int64_t safetensor_numel(const safetensor_t *t) {
+ int64_t n = 1;
+ for (int i = 0; i < t->ndim; i++)
+ n *= t->shape[i];
+ return n;
+}
+
+static float bf16_to_f32(uint16_t bf16) {
+ uint32_t f32 = ((uint32_t)bf16) << 16;
+ float result;
+ memcpy(&result, &f32, sizeof(float));
+ return result;
+}
+
+float *safetensors_get_f32(const safetensors_file_t *sf, const safetensor_t *t) {
+ int64_t n = safetensor_numel(t);
+ if (n <= 0)
+ return NULL;
+
+ float *out = malloc(n * sizeof(float));
+ if (!out)
+ return NULL;
+
+ const void *data = safetensors_data(sf, t);
+
+ switch (t->dtype) {
+ case DTYPE_F32:
+ memcpy(out, data, n * sizeof(float));
+ break;
+ case DTYPE_BF16: {
+ const uint16_t *src = (const uint16_t *)data;
+ for (int64_t i = 0; i < n; i++)
+ out[i] = bf16_to_f32(src[i]);
+ break;
+ }
+ default:
+ free(out);
+ return NULL;
+ }
+ return out;
+}
+
+/* ========================================================================
+ * Multi-shard operations
+ * ======================================================================== */
+
+static int cmp_shard_names(const void *a, const void *b) {
+ const char *sa = (const char *)a;
+ const char *sb = (const char *)b;
+ return strcmp(sa, sb);
+}
+
+static int parse_shard_name(const char *name, int *idx, int *total) {
+ int i = 0, n = 0, consumed = 0;
+ if (sscanf(name, "model-%d-of-%d.safetensors%n", &i, &n, &consumed) != 2)
+ return -1;
+ if (name[consumed] != '\0' || i <= 0 || n <= 0 || i > n)
+ return -1;
+ *idx = i;
+ *total = n;
+ return 0;
+}
+
+multi_safetensors_t *multi_safetensors_open(const char *model_dir) {
+ multi_safetensors_t *ms = calloc(1, sizeof(multi_safetensors_t));
+ if (!ms)
+ return NULL;
+
+ char path[4096];
+
+ /* Try single file first */
+ snprintf(path, sizeof(path), "%s/model.safetensors", model_dir);
+ safetensors_file_t *sf = safetensors_open(path);
+ if (sf) {
+ ms->shards[0] = sf;
+ ms->num_shards = 1;
+ return ms;
+ }
+
+ /* Scan directory for shard files */
+ DIR *dir = opendir(model_dir);
+ if (!dir) {
+ free(ms);
+ return NULL;
+ }
+
+ struct dirent *entry;
+ char shard_names[SAFETENSORS_MAX_SHARDS][256];
+ int seen[SAFETENSORS_MAX_SHARDS] = {0};
+ int n_shards = 0;
+ int expected_total = 0;
+
+ while ((entry = readdir(dir)) != NULL) {
+ if (strncmp(entry->d_name, "model-", 6) == 0 &&
+ strstr(entry->d_name, ".safetensors") != NULL) {
+ int shard_idx = 0, shard_total = 0;
+ if (parse_shard_name(entry->d_name, &shard_idx, &shard_total) != 0) {
+ fprintf(stderr, "multi_safetensors_open: bad shard name: %s\n", entry->d_name);
+ closedir(dir);
+ free(ms);
+ return NULL;
+ }
+ if (shard_total > SAFETENSORS_MAX_SHARDS) {
+ fprintf(stderr, "multi_safetensors_open: too many shards (%d > %d)\n", shard_total,
+ SAFETENSORS_MAX_SHARDS);
+ closedir(dir);
+ free(ms);
+ return NULL;
+ }
+ if (expected_total == 0) {
+ expected_total = shard_total;
+ } else if (expected_total != shard_total) {
+ fprintf(stderr, "multi_safetensors_open: inconsistent shard total in %s\n",
+ entry->d_name);
+ closedir(dir);
+ free(ms);
+ return NULL;
+ }
+ if (seen[shard_idx - 1]) {
+ fprintf(stderr, "multi_safetensors_open: duplicate shard index %d\n", shard_idx);
+ closedir(dir);
+ free(ms);
+ return NULL;
+ }
+ seen[shard_idx - 1] = 1;
+
+ snprintf(shard_names[n_shards], sizeof(shard_names[n_shards]), "%s", entry->d_name);
+ n_shards++;
+ }
+ }
+ closedir(dir);
+
+ if (n_shards == 0) {
+ fprintf(stderr, "multi_safetensors_open: no safetensors files in %s\n", model_dir);
+ free(ms);
+ return NULL;
+ }
+ if (expected_total != n_shards) {
+ fprintf(stderr, "multi_safetensors_open: expected %d shard(s), found %d in %s\n",
+ expected_total, n_shards, model_dir);
+ free(ms);
+ return NULL;
+ }
+ for (int i = 0; i < expected_total; i++) {
+ if (!seen[i]) {
+ fprintf(stderr, "multi_safetensors_open: missing shard %d of %d in %s\n", i + 1,
+ expected_total, model_dir);
+ free(ms);
+ return NULL;
+ }
+ }
+
+ /* Sort shard names to ensure consistent ordering */
+ qsort(shard_names, n_shards, sizeof(shard_names[0]), cmp_shard_names);
+
+ /* Open each shard */
+ for (int i = 0; i < n_shards; i++) {
+ snprintf(path, sizeof(path), "%s/%s", model_dir, shard_names[i]);
+ ms->shards[i] = safetensors_open(path);
+ if (!ms->shards[i]) {
+ fprintf(stderr, "multi_safetensors_open: failed to open %s\n", path);
+ multi_safetensors_close(ms);
+ return NULL;
+ }
+ }
+ ms->num_shards = n_shards;
+ return ms;
+}
+
+void multi_safetensors_close(multi_safetensors_t *ms) {
+ if (!ms)
+ return;
+ for (int i = 0; i < ms->num_shards; i++) {
+ safetensors_close(ms->shards[i]);
+ }
+ free(ms);
+}
+
+int multi_safetensors_data_nbytes(const multi_safetensors_t *ms, size_t *out_nbytes) {
+ if (!ms || !out_nbytes)
+ return -1;
+ size_t total = 0;
+ for (int s = 0; s < ms->num_shards; s++) {
+ const safetensors_file_t *sf = ms->shards[s];
+ for (int i = 0; i < sf->num_tensors; i++) {
+ size_t n = sf->tensors[i].data_size;
+ if (n > SIZE_MAX - total)
+ return -1;
+ total += n;
+ }
+ }
+ *out_nbytes = total;
+ return 0;
+}
+
+const safetensor_t *multi_safetensors_find(const multi_safetensors_t *ms,
+ const char *name,
+ safetensors_file_t **out_sf) {
+ for (int s = 0; s < ms->num_shards; s++) {
+ safetensors_file_t *sf = ms->shards[s];
+ for (int i = 0; i < sf->num_tensors; i++) {
+ if (strcmp(sf->tensors[i].name, name) == 0) {
+ if (out_sf)
+ *out_sf = sf;
+ return &sf->tensors[i];
+ }
+ }
+ }
+ return NULL;
+}
+
+const char *multi_safetensors_weight_prefix(const multi_safetensors_t *ms,
+ const char *tensor_name) {
+ if (multi_safetensors_find(ms, tensor_name, NULL))
+ return "";
+
+ char prefixed[sizeof(((safetensor_t *)0)->name)];
+ int n = snprintf(prefixed, sizeof(prefixed), "model.%s", tensor_name);
+ if (n < 0 || (size_t)n >= sizeof(prefixed))
+ return NULL;
+ return multi_safetensors_find(ms, prefixed, NULL) ? "model." : NULL;
+}
diff --git a/src/safetensors.h b/src/safetensors.h
new file mode 100644
index 0000000..8c9b33f
--- /dev/null
+++ b/src/safetensors.h
@@ -0,0 +1,76 @@
+/*
+ * embed_safetensors.h - Safetensors file format reader (multi-shard support)
+ * Adapted from voxtral-realtime project.
+ */
+
+#ifndef EMBED_SAFETENSORS_H
+#define EMBED_SAFETENSORS_H
+
+#include <stddef.h>
+#include <stdint.h>
+
+#define SAFETENSORS_MAX_TENSORS 1024
+#define SAFETENSORS_MAX_SHARDS 8
+
+typedef enum {
+ DTYPE_F32 = 0,
+ DTYPE_F16 = 1,
+ DTYPE_BF16 = 2,
+ DTYPE_I32 = 3,
+ DTYPE_I64 = 4,
+ DTYPE_BOOL = 5,
+ DTYPE_UNKNOWN = -1
+} safetensor_dtype_t;
+
+typedef struct {
+ char name[256];
+ safetensor_dtype_t dtype;
+ int ndim;
+ int64_t shape[8];
+ size_t data_offset;
+ size_t data_size;
+} safetensor_t;
+
+typedef struct {
+ char *path;
+ void *data;
+ size_t file_size;
+ size_t header_size;
+ char *header_json;
+ int num_tensors;
+ safetensor_t tensors[SAFETENSORS_MAX_TENSORS];
+} safetensors_file_t;
+
+/* Multi-shard wrapper: opens all shard files and provides unified tensor lookup */
+typedef struct {
+ safetensors_file_t *shards[SAFETENSORS_MAX_SHARDS];
+ int num_shards;
+} multi_safetensors_t;
+
+/* Open a single safetensors file (memory-mapped) */
+safetensors_file_t *safetensors_open(const char *path);
+void safetensors_close(safetensors_file_t *sf);
+
+/* Open model from directory (auto-detects single file or multi-shard) */
+multi_safetensors_t *multi_safetensors_open(const char *model_dir);
+void multi_safetensors_close(multi_safetensors_t *ms);
+int multi_safetensors_data_nbytes(const multi_safetensors_t *ms, size_t *out_nbytes);
+
+/* Find a tensor by name across all shards */
+const safetensor_t *multi_safetensors_find(const multi_safetensors_t *ms,
+ const char *name,
+ safetensors_file_t **out_sf);
+
+/* Resolve an optional Hugging Face "model." namespace for a backbone tensor.
+ * Returns "", "model.", or NULL when neither form exists. */
+const char *multi_safetensors_weight_prefix(const multi_safetensors_t *ms, const char *tensor_name);
+
+/* Get raw pointer to tensor data (within mmap'd region) */
+const void *safetensors_data(const safetensors_file_t *sf, const safetensor_t *t);
+
+/* Get tensor data as float32 (allocates, caller must free) */
+float *safetensors_get_f32(const safetensors_file_t *sf, const safetensor_t *t);
+
+int64_t safetensor_numel(const safetensor_t *t);
+
+#endif /* EMBED_SAFETENSORS_H */
diff --git a/src/server.c b/src/server.c
new file mode 100644
index 0000000..c3abbac
--- /dev/null
+++ b/src/server.c
@@ -0,0 +1,3724 @@
+#ifndef _GNU_SOURCE
+#define _GNU_SOURCE
+#endif
+
+#include "build.h"
+#include "server.h"
+#include "embed.h"
+#include "safetensors.h"
+#include "kernels.h"
+#include "tokenizer_bpe.h"
+#include "tokenizer_wordpiece.h"
+
+#ifdef USE_MLX
+#include "mlx.h"
+#endif
+#ifdef USE_CUDA
+#include "cuda.h"
+#endif
+
+#include "deps/ae/ae.h"
+#include "deps/ae/anet.h"
+
+#include <arpa/inet.h>
+#include <ctype.h>
+#include <errno.h>
+#include <fcntl.h>
+#include <limits.h>
+#include <math.h>
+#include <netinet/in.h>
+#include <pthread.h>
+#include <signal.h>
+#include <stdbool.h>
+#include <stdint.h>
+#include <stdarg.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <strings.h>
+#include <sys/socket.h>
+#include <sys/time.h>
+#include <sys/types.h>
+#include <time.h>
+#include <unistd.h>
+
+#ifdef __APPLE__
+#include <sys/sysctl.h>
+#endif
+
+#include <cjson/cJSON.h>
+
+#define EMBED_HTTP_IO_BUF 8192
+#define EMBED_HTTP_MAX_HEADER (64u * 1024u)
+#define EMBED_HTTP_MAX_BODY (64u * 1024u * 1024u)
+#define EMBED_HTTP_MAX_PATH 255u
+#define EMBED_HTTP_BACKLOG 128
+#define EMBED_HTTP_SETSIZE 10240
+#define EMBED_HTTP_CLIENT_TIMEOUT_MS 30000
+#define EMBED_HTTP_SWEEP_MS 1000
+
+#define EMBED_API_MAX_STANDARD_INPUTS 512
+#define EMBED_API_MAX_CONTEXT_DOCS 512
+#define EMBED_API_MAX_CONTEXT_CHUNKS 16000
+#define EMBED_API_MAX_RERANK_DOCUMENTS 1000
+#define EMBED_API_MAX_ITEM_TOKENS 32768
+#define EMBED_API_MAX_TOTAL_TOKENS 120000
+#define EMBED_LATE_QUERY_TOKENS 32
+#define EMBED_LATE_MASK_TOKEN_ID 151642
+#define EMBED_LATE_QUERY_PREFIX_ID 151669
+#define EMBED_LATE_DOCUMENT_PREFIX_ID 151670
+/* `text_type: query` prepends the model's published retrieval instruction.
+ * Documents and the default pass through unchanged. Callers needing a custom
+ * instruction prepend it themselves and leave text_type at "document". */
+#define EMBED_QWEN3_QUERY_INSTRUCT \
+ "Instruct: Given a web search query, retrieve relevant passages that answer the query\nQuery:"
+#define EMBED_GTE_QWEN2_QUERY_INSTRUCT \
+ "Instruct: Given a web search query, retrieve relevant passages that answer the " \
+ "query\nQuery: "
+/* Chosen from the L4 scheduler sweep: -b 32 gained ~24% concurrent
+ * short-request throughput over 8 with no long-document penalty, while 128
+ * was no faster and inflated long-document tail latency. */
+#define EMBED_SERVER_DEFAULT_BATCH_SIZE 32
+#define EMBED_SERVER_DEFAULT_MAX_BATCH_TOKENS 16384
+/* Microseconds the worker waits for more requests before dispatching a batch.
+ * CUDA uses a 1 ms window so arrivals group into one launch and keep the GPU
+ * busy; MLX and CPU dispatch immediately, where waiting only adds latency.
+ * Override with --batch-wait-us. */
+#define EMBED_SERVER_BATCH_WAIT_US 0
+#define EMBED_SERVER_CUDA_BATCH_WAIT_US 1000
+#define EMBED_SERVER_MICROBATCH_MAX_JOBS 128
+#define EMBED_MLX_MEMORY_BUDGET_PERCENT 90
+#define EMBED_MLX_RESIDENT_MULTIPLIER 2
+
+typedef struct {
+ char *ptr;
+ size_t len;
+ size_t cap;
+} sbuf;
+
+static void die_oom(void) {
+ fprintf(stderr, "embed-server: out of memory\n");
+ exit(1);
+}
+
+static void *xmalloc(size_t n) {
+ void *p = malloc(n ? n : 1);
+ if (!p)
+ die_oom();
+ return p;
+}
+
+static void *xcalloc(size_t n, size_t sz) {
+ void *p = calloc(n ? n : 1, sz ? sz : 1);
+ if (!p)
+ die_oom();
+ return p;
+}
+
+static void *xrealloc(void *p, size_t n) {
+ p = realloc(p, n ? n : 1);
+ if (!p)
+ die_oom();
+ return p;
+}
+
+static char *xstrdup(const char *s) {
+ size_t n = strlen(s);
+ char *p = xmalloc(n + 1);
+ memcpy(p, s, n + 1);
+ return p;
+}
+
+static char *xstrndup(const char *s, size_t n) {
+ char *p = xmalloc(n + 1);
+ memcpy(p, s, n);
+ p[n] = '\0';
+ return p;
+}
+
+static uint64_t mstime(void) {
+ struct timespec ts;
+ if (clock_gettime(CLOCK_MONOTONIC, &ts) == 0)
+ return (uint64_t)ts.tv_sec * 1000u + (uint64_t)ts.tv_nsec / 1000000u;
+ struct timeval tv;
+ gettimeofday(&tv, NULL);
+ return (uint64_t)tv.tv_sec * 1000u + (uint64_t)tv.tv_usec / 1000u;
+}
+
+static uint64_t nstime(void) {
+ struct timespec ts;
+ if (clock_gettime(CLOCK_MONOTONIC, &ts) == 0)
+ return (uint64_t)ts.tv_sec * 1000000000u + (uint64_t)ts.tv_nsec;
+ struct timeval tv;
+ gettimeofday(&tv, NULL);
+ return (uint64_t)tv.tv_sec * 1000000000u + (uint64_t)tv.tv_usec * 1000u;
+}
+
+static double ns_to_ms(uint64_t ns) { return (double)ns / 1000000.0; }
+
+static void server_log(const char *fmt, ...) {
+ char ts[32];
+ time_t now = time(NULL);
+ struct tm tmv;
+ localtime_r(&now, &tmv);
+ strftime(ts, sizeof(ts), "%m%d %H:%M:%S", &tmv);
+ fprintf(stderr, "%s ", ts);
+ va_list ap;
+ va_start(ap, fmt);
+ vfprintf(stderr, fmt, ap);
+ va_end(ap);
+ fputc('\n', stderr);
+}
+
+static void sbuf_reserve(sbuf *b, size_t add) {
+ if (add > SIZE_MAX - b->len - 1)
+ die_oom();
+ size_t need = b->len + add + 1;
+ if (need <= b->cap)
+ return;
+ size_t cap = b->cap ? b->cap * 2 : 256;
+ while (cap < need) {
+ if (cap > SIZE_MAX / 2)
+ die_oom();
+ cap *= 2;
+ }
+ b->ptr = xrealloc(b->ptr, cap);
+ b->cap = cap;
+}
+
+static void sbuf_append(sbuf *b, const void *p, size_t n) {
+ sbuf_reserve(b, n);
+ memcpy(b->ptr + b->len, p, n);
+ b->len += n;
+ b->ptr[b->len] = '\0';
+}
+
+static void sbuf_putc(sbuf *b, char c) { sbuf_append(b, &c, 1); }
+static void sbuf_puts(sbuf *b, const char *s) { sbuf_append(b, s, strlen(s)); }
+
+static void sbuf_clear(sbuf *b) {
+ b->len = 0;
+ if (b->ptr)
+ b->ptr[0] = '\0';
+}
+
+static void sbuf_printf(sbuf *b, const char *fmt, ...) {
+ va_list ap, ap2;
+ va_start(ap, fmt);
+ va_copy(ap2, ap);
+ int n = vsnprintf(NULL, 0, fmt, ap);
+ va_end(ap);
+ if (n < 0)
+ die_oom();
+ sbuf_reserve(b, (size_t)n);
+ int n2 = vsnprintf(b->ptr + b->len, b->cap - b->len, fmt, ap2);
+ va_end(ap2);
+ if (n2 < 0 || n2 != n)
+ die_oom();
+ b->len += (size_t)n;
+}
+
+static void sbuf_free(sbuf *b) {
+ free(b->ptr);
+ memset(b, 0, sizeof(*b));
+}
+
+typedef enum {
+ MODEL_STD_06,
+ MODEL_STD_4,
+ MODEL_QWEN3_06,
+ MODEL_QWEN3_4,
+ MODEL_QWEN3_8,
+ MODEL_GTE_QWEN2_15,
+ MODEL_MINILM_L6,
+ MODEL_BGE_SMALL,
+ MODEL_BGE_BASE,
+ MODEL_BGE_LARGE,
+ MODEL_CTX_06,
+ MODEL_CTX_4,
+ MODEL_LATE_06,
+ MODEL_COUNT,
+ MODEL_UNKNOWN
+} model_slot;
+
+typedef enum { MODEL_KIND_STANDARD, MODEL_KIND_CONTEXTUAL, MODEL_KIND_LATE } model_kind;
+
+/* Which embedding API a model speaks. pplx-embed models follow the Perplexity
+ * API: the canonical output is the tanh int8 quantization, so the default
+ * encoding is base64_int8 and "float" is the int8-decoded view (int8/128).
+ * Instruction embedding models follow the OpenAI-compatible API: "float" is
+ * the true float32 vector and "base64" is base64 of little-endian float32.
+ * int8 quantization underuses the range of L2-normalized vectors, so it is not
+ * used for these models. */
+typedef enum {
+ EMBED_API_PERPLEXITY = 0,
+ EMBED_API_OPENAI = 1,
+} embedding_api_t;
+
+typedef struct {
+ const char *id;
+ model_kind kind;
+ int dim;
+ int min_dim;
+ int token_dim;
+ embed_attention_mode_t attention_mode;
+ embed_pooling_mode_t pooling_mode;
+ int normalize_embeddings;
+ embedding_api_t api;
+ const char *query_instruct;
+} model_info;
+
+static const model_info k_models[] = {
+ {"pplx-embed-v1-0.6b", MODEL_KIND_STANDARD, 1024, 128, 0, EMBED_ATTENTION_BIDIRECTIONAL,
+ EMBED_POOL_MEAN, 0, EMBED_API_PERPLEXITY, NULL},
+ {"pplx-embed-v1-4b", MODEL_KIND_STANDARD, 2560, 128, 0, EMBED_ATTENTION_BIDIRECTIONAL,
+ EMBED_POOL_MEAN, 0, EMBED_API_PERPLEXITY, NULL},
+ {"Qwen3-Embedding-0.6B", MODEL_KIND_STANDARD, 1024, 32, 0, EMBED_ATTENTION_CAUSAL,
+ EMBED_POOL_LAST_TOKEN, 1, EMBED_API_OPENAI, EMBED_QWEN3_QUERY_INSTRUCT},
+ {"Qwen3-Embedding-4B", MODEL_KIND_STANDARD, 2560, 32, 0, EMBED_ATTENTION_CAUSAL,
+ EMBED_POOL_LAST_TOKEN, 1, EMBED_API_OPENAI, EMBED_QWEN3_QUERY_INSTRUCT},
+ {"Qwen3-Embedding-8B", MODEL_KIND_STANDARD, 4096, 32, 0, EMBED_ATTENTION_CAUSAL,
+ EMBED_POOL_LAST_TOKEN, 1, EMBED_API_OPENAI, EMBED_QWEN3_QUERY_INSTRUCT},
+ {"gte-Qwen2-1.5B-instruct", MODEL_KIND_STANDARD, 1536, 1536, 0, EMBED_ATTENTION_BIDIRECTIONAL,
+ EMBED_POOL_LAST_TOKEN, 1, EMBED_API_OPENAI, EMBED_GTE_QWEN2_QUERY_INSTRUCT},
+ /* BERT encoders: WordPiece tokenizer, learned positions, no instruction
+ * prefix. all-MiniLM-L6-v2 mean-pools; bge-small-en-v1.5 pools the [CLS]
+ * token. Both emit L2-normalized float32, so they speak the OpenAI API. */
+ {"all-MiniLM-L6-v2", MODEL_KIND_STANDARD, 384, 384, 0, EMBED_ATTENTION_BIDIRECTIONAL,
+ EMBED_POOL_MEAN, 1, EMBED_API_OPENAI, NULL},
+ {"bge-small-en-v1.5", MODEL_KIND_STANDARD, 384, 384, 0, EMBED_ATTENTION_BIDIRECTIONAL,
+ EMBED_POOL_CLS, 1, EMBED_API_OPENAI, NULL},
+ {"bge-base-en-v1.5", MODEL_KIND_STANDARD, 768, 768, 0, EMBED_ATTENTION_BIDIRECTIONAL,
+ EMBED_POOL_CLS, 1, EMBED_API_OPENAI, NULL},
+ {"bge-large-en-v1.5", MODEL_KIND_STANDARD, 1024, 1024, 0, EMBED_ATTENTION_BIDIRECTIONAL,
+ EMBED_POOL_CLS, 1, EMBED_API_OPENAI, NULL},
+ {"pplx-embed-context-v1-0.6b", MODEL_KIND_CONTEXTUAL, 1024, 128, 0,
+ EMBED_ATTENTION_BIDIRECTIONAL, EMBED_POOL_MEAN, 0, EMBED_API_PERPLEXITY, NULL},
+ {"pplx-embed-context-v1-4b", MODEL_KIND_CONTEXTUAL, 2560, 128, 0, EMBED_ATTENTION_BIDIRECTIONAL,
+ EMBED_POOL_MEAN, 0, EMBED_API_PERPLEXITY, NULL},
+ {"pplx-embed-v1-late-0.6b", MODEL_KIND_LATE, 1024, 128, 128, EMBED_ATTENTION_BIDIRECTIONAL,
+ EMBED_POOL_MEAN, 0, EMBED_API_PERPLEXITY, NULL},
+};
+
+static model_slot model_slot_for_id(const char *id) {
+ if (!id)
+ return MODEL_UNKNOWN;
+ for (int i = 0; i < MODEL_COUNT; i++) {
+ if (!strcmp(id, k_models[i].id))
+ return (model_slot)i;
+ }
+ return MODEL_UNKNOWN;
+}
+
+typedef struct {
+ const model_info *info;
+ char *path;
+ embed_tokenizer_t *tok;
+ embed_tokenizer_workspace_t *tok_ws;
+ /* BERT-family WordPiece tokenizer, selected by file probe in load_one_model.
+ * When wp_tok is set, tokenize_one wraps the ids with [CLS]/[SEP] and the
+ * Qwen byte-level BPE fields above stay NULL. */
+ wordpiece_tokenizer_t *wp_tok;
+ wordpiece_workspace_t *wp_tok_ws;
+ int cls_id;
+ int sep_id;
+ int context_separator_id;
+ int late_mask_id;
+ int late_query_prefix_id;
+ int late_document_prefix_id;
+ int late_skip_ids[64];
+ int n_late_skip_ids;
+ int append_terminal_token;
+ int terminal_token_id;
+ int renormalize_truncated;
+ embed_model_t *cpu_model;
+ embed_workspace_t *cpu_ws;
+ embed_late_model_t *cpu_late_model;
+ embed_late_workspace_t *cpu_late_ws;
+#ifdef USE_MLX
+ embed_mlx_ctx_t *mlx_ctx;
+ embed_mlx_late_ctx_t *mlx_late_ctx;
+#endif
+#ifdef USE_CUDA
+ embed_cuda_ctx_t *cuda_ctx;
+ embed_cuda_late_ctx_t *cuda_late_ctx;
+#endif
+} loaded_model;
+
+typedef struct client client;
+typedef struct job job;
+
+typedef struct {
+ aeEventLoop *loop;
+ int listen_fd;
+ int completion_pipe[2];
+ int signal_pipe[2];
+ const char *host;
+ int port;
+ int batch_size;
+ int max_batch_tokens;
+ int batch_wait_us;
+ char *api_key;
+ loaded_model models[MODEL_COUNT];
+ int use_mlx;
+ int use_cuda;
+ int mlx_quantize_bits;
+ int mlx_quantize_group_size;
+
+ pthread_t worker;
+ pthread_mutex_t mu;
+ pthread_cond_t cv;
+ int stopping;
+ int worker_ready;
+ int worker_init_rc;
+ job *job_head;
+ job *job_tail;
+ job *done_head;
+ job *done_tail;
+
+ client *clients;
+ int n_clients;
+} http_server;
+
+typedef struct {
+ char method[8];
+ char path[EMBED_HTTP_MAX_PATH + 1];
+ char version[16];
+ char *body;
+ size_t body_len;
+ char *auth;
+} http_request;
+
+struct client {
+ http_server *srv;
+ int fd;
+ int refcount;
+ int cancelled;
+ int linked;
+ uint64_t last_active_ms;
+ sbuf in;
+ sbuf out;
+ size_t sent;
+ int header_done;
+ size_t header_len;
+ size_t content_length;
+ int close_after_write;
+ http_request req;
+ client *prev;
+ client *next;
+};
+
+struct job {
+ http_server *srv;
+ client *c;
+ char method[8];
+ char path[EMBED_HTTP_MAX_PATH + 1];
+ char *body;
+ size_t body_len;
+ char *auth;
+ int status;
+ char *content_type;
+ char *extra_headers;
+ char *response;
+ size_t response_len;
+ uint64_t created_ns;
+ uint64_t started_ns;
+ uint64_t parse_ns;
+ uint64_t tokenize_ns;
+ uint64_t infer_ns;
+ uint64_t encode_ns;
+ job *next;
+};
+
+static int queue_write(client *c);
+static void dispatch_request(client *c);
+static void read_cb(aeEventLoop *loop, int fd, void *clientData, int mask);
+
+static volatile sig_atomic_t g_stop_requested = 0;
+static volatile sig_atomic_t g_signal_wfd = -1;
+
+static void stop_signal_handler(int sig) {
+ (void)sig;
+ if (g_stop_requested)
+ _exit(130);
+ int saved = errno;
+ g_stop_requested = 1;
+ int fd = (int)g_signal_wfd;
+ if (fd >= 0) {
+ const unsigned char byte = 1;
+ if (write(fd, &byte, 1) < 0) {
+ /* best-effort stop wakeup; a failed self-pipe write is ignored */
+ }
+ }
+ errno = saved;
+}
+
+static int set_nonblock(int fd) {
+ int flags = fcntl(fd, F_GETFL, 0);
+ if (flags < 0)
+ return -1;
+ return fcntl(fd, F_SETFL, flags | O_NONBLOCK);
+}
+
+static void http_request_free(http_request *r) {
+ free(r->body);
+ free(r->auth);
+ memset(r, 0, sizeof(*r));
+}
+
+static void client_free(client *c) {
+ if (!c)
+ return;
+ http_request_free(&c->req);
+ sbuf_free(&c->in);
+ sbuf_free(&c->out);
+ free(c);
+}
+
+static void client_incref(client *c) {
+ pthread_mutex_lock(&c->srv->mu);
+ c->refcount++;
+ pthread_mutex_unlock(&c->srv->mu);
+}
+
+static void client_decref(client *c) {
+ int free_now = 0;
+ pthread_mutex_lock(&c->srv->mu);
+ if (--c->refcount == 0)
+ free_now = 1;
+ pthread_mutex_unlock(&c->srv->mu);
+ if (free_now)
+ client_free(c);
+}
+
+static void client_decref_n(client *c, int n) {
+ int free_now = 0;
+ if (n <= 0)
+ return;
+ pthread_mutex_lock(&c->srv->mu);
+ c->refcount -= n;
+ if (c->refcount <= 0)
+ free_now = 1;
+ pthread_mutex_unlock(&c->srv->mu);
+ if (free_now)
+ client_free(c);
+}
+
+static void client_unlink(client *c) {
+ http_server *s = c->srv;
+ if (!c->linked)
+ return;
+ if (c->prev)
+ c->prev->next = c->next;
+ else
+ s->clients = c->next;
+ if (c->next)
+ c->next->prev = c->prev;
+ c->prev = c->next = NULL;
+ c->linked = 0;
+ if (s->n_clients > 0)
+ s->n_clients--;
+}
+
+static int close_client_unlink(client *c) {
+ if (!c || c->cancelled)
+ return 0;
+ c->cancelled = 1;
+ if (c->fd >= 0) {
+ aeDeleteFileEvent(c->srv->loop, c->fd, AE_READABLE);
+ aeDeleteFileEvent(c->srv->loop, c->fd, AE_WRITABLE);
+ close(c->fd);
+ c->fd = -1;
+ }
+ client_unlink(c);
+ return 1;
+}
+
+static void close_client(client *c) {
+ if (!close_client_unlink(c))
+ return;
+ client_decref(c);
+}
+
+static void append_http_response_ex(client *c,
+ int status,
+ const char *ctype,
+ const char *extra_headers,
+ const char *body,
+ size_t body_len) {
+ const char *reason = "OK";
+ if (status == 204)
+ reason = "No Content";
+ else if (status == 400)
+ reason = "Bad Request";
+ else if (status == 401)
+ reason = "Unauthorized";
+ else if (status == 404)
+ reason = "Not Found";
+ else if (status == 405)
+ reason = "Method Not Allowed";
+ else if (status == 422)
+ reason = "Unprocessable Entity";
+ else if (status == 503)
+ reason = "Service Unavailable";
+ else if (status >= 500)
+ reason = "Internal Server Error";
+
+ sbuf_printf(&c->out,
+ "HTTP/1.1 %d %s\r\n"
+ "Content-Length: %zu\r\n"
+ "Connection: %s\r\n",
+ status, reason, body_len, c->close_after_write ? "close" : "keep-alive");
+ if (ctype)
+ sbuf_printf(&c->out, "Content-Type: %s\r\n", ctype);
+
+ if (extra_headers)
+ sbuf_puts(&c->out, extra_headers);
+ sbuf_puts(&c->out, "\r\n");
+ if (body_len)
+ sbuf_append(&c->out, body, body_len);
+}
+
+static void
+append_http_response(client *c, int status, const char *ctype, const char *body, size_t body_len) {
+ append_http_response_ex(c, status, ctype, NULL, body, body_len);
+}
+
+static void append_json_error(sbuf *b, const char *message, const char *type) {
+ sbuf_puts(b, "{\"error\":{\"message\":\"");
+ for (const char *p = message ? message : ""; *p; p++) {
+ if (*p == '"' || *p == '\\') {
+ sbuf_putc(b, '\\');
+ sbuf_putc(b, *p);
+ } else {
+ sbuf_putc(b, *p);
+ }
+ }
+ sbuf_puts(b, "\",\"type\":\"");
+ sbuf_puts(b, type ? type : "server_error");
+ sbuf_puts(b, "\"}}");
+}
+
+static void append_json_string(sbuf *b, const char *s) {
+ sbuf_putc(b, '"');
+ for (const unsigned char *p = (const unsigned char *)(s ? s : ""); *p; p++) {
+ switch (*p) {
+ case '"':
+ sbuf_puts(b, "\\\"");
+ break;
+ case '\\':
+ sbuf_puts(b, "\\\\");
+ break;
+ case '\b':
+ sbuf_puts(b, "\\b");
+ break;
+ case '\f':
+ sbuf_puts(b, "\\f");
+ break;
+ case '\n':
+ sbuf_puts(b, "\\n");
+ break;
+ case '\r':
+ sbuf_puts(b, "\\r");
+ break;
+ case '\t':
+ sbuf_puts(b, "\\t");
+ break;
+ default:
+ if (*p < 0x20)
+ sbuf_printf(b, "\\u%04x", (unsigned)*p);
+ else
+ sbuf_putc(b, (char)*p);
+ }
+ }
+ sbuf_putc(b, '"');
+}
+
+static char *json_error_body(const char *message, const char *type, size_t *len) {
+ sbuf b = {0};
+ append_json_error(&b, message, type);
+ *len = b.len;
+ return b.ptr;
+}
+
+static void job_set_error(job *j, int status, const char *message, const char *type) {
+ free(j->response);
+ j->status = status;
+ j->content_type = "application/json";
+ j->response = json_error_body(message, type, &j->response_len);
+}
+
+static bool auth_ok(http_server *s, const char *auth) {
+ if (!s->api_key || !s->api_key[0])
+ return true;
+ if (!auth)
+ return false;
+ const char prefix[] = "Bearer ";
+ return !strncmp(auth, prefix, sizeof(prefix) - 1) &&
+ !strcmp(auth + sizeof(prefix) - 1, s->api_key);
+}
+
+static ssize_t find_header_end(const char *p, size_t n) {
+ for (size_t i = 3; i < n; i++) {
+ if (p[i - 3] == '\r' && p[i - 2] == '\n' && p[i - 1] == '\r' && p[i] == '\n')
+ return (ssize_t)(i + 1);
+ }
+ for (size_t i = 1; i < n; i++) {
+ if (p[i - 1] == '\n' && p[i] == '\n')
+ return (ssize_t)(i + 1);
+ }
+ return -1;
+}
+
+static char *header_value_dup(const char *h, size_t n, const char *name) {
+ size_t name_len = strlen(name);
+ const char *p = h, *end = h + n;
+ while (p < end) {
+ const char *line = p;
+ while (p < end && *p != '\n')
+ p++;
+ size_t len = (size_t)(p - line);
+ if (len && line[len - 1] == '\r')
+ len--;
+ if (len > name_len && !strncasecmp(line, name, name_len) && line[name_len] == ':') {
+ const char *v = line + name_len + 1;
+ while (v < line + len && isspace((unsigned char)*v))
+ v++;
+ const char *e = line + len;
+ while (e > v && isspace((unsigned char)e[-1]))
+ e--;
+ return xstrndup(v, (size_t)(e - v));
+ }
+ if (p < end)
+ p++;
+ }
+ return NULL;
+}
+
+static int header_has_token(const char *value, const char *token) {
+ size_t token_len = strlen(token);
+ const char *p = value;
+ while (p && *p) {
+ while (*p == ',' || isspace((unsigned char)*p))
+ p++;
+ const char *start = p;
+ while (*p && *p != ',')
+ p++;
+ const char *end = p;
+ while (end > start && isspace((unsigned char)end[-1]))
+ end--;
+ if ((size_t)(end - start) == token_len && !strncasecmp(start, token, token_len))
+ return 1;
+ }
+ return 0;
+}
+
+static int parse_request_headers(client *c) {
+ char line[512];
+ size_t i = 0;
+ while (i < c->header_len && c->in.ptr[i] != '\n' && i + 1 < sizeof(line)) {
+ line[i] = c->in.ptr[i];
+ i++;
+ }
+ line[i] = '\0';
+ int fields = sscanf(line, "%7s %255s %15s", c->req.method, c->req.path, c->req.version);
+ if (fields < 2)
+ return -1;
+ if (fields < 3)
+ snprintf(c->req.version, sizeof(c->req.version), "HTTP/1.0");
+ char *q = strchr(c->req.path, '?');
+ if (q)
+ *q = '\0';
+
+ c->close_after_write = strcasecmp(c->req.version, "HTTP/1.1") != 0;
+ char *conn = header_value_dup(c->in.ptr, c->header_len, "Connection");
+ if (conn) {
+ if (header_has_token(conn, "close"))
+ c->close_after_write = 1;
+ else if (header_has_token(conn, "keep-alive"))
+ c->close_after_write = 0;
+ free(conn);
+ }
+
+ char *cl = header_value_dup(c->in.ptr, c->header_len, "Content-Length");
+ if (cl) {
+ char *end = NULL;
+ errno = 0;
+ unsigned long long v = strtoull(cl, &end, 10);
+ if (errno || !end || *end || v > EMBED_HTTP_MAX_BODY) {
+ free(cl);
+ return -1;
+ }
+ c->content_length = (size_t)v;
+ free(cl);
+ }
+ c->req.auth = header_value_dup(c->in.ptr, c->header_len, "Authorization");
+ return 0;
+}
+
+static int complete_request(client *c) {
+ if (!c->header_done) {
+ ssize_t hend = find_header_end(c->in.ptr, c->in.len);
+ if (hend < 0) {
+ if (c->in.len > EMBED_HTTP_MAX_HEADER)
+ return -1;
+ return 0;
+ }
+ c->header_done = 1;
+ c->header_len = (size_t)hend;
+ if (parse_request_headers(c) != 0)
+ return -1;
+ }
+ if (c->content_length > EMBED_HTTP_MAX_BODY)
+ return -1;
+ if (c->in.len < c->header_len + c->content_length)
+ return 0;
+ c->req.body_len = c->content_length;
+ c->req.body = xmalloc(c->content_length + 1);
+ memcpy(c->req.body, c->in.ptr + c->header_len, c->content_length);
+ c->req.body[c->content_length] = '\0';
+ return 1;
+}
+
+static void send_bad_http_request(client *c) {
+ size_t len;
+ char *body = json_error_body("bad HTTP request", "invalid_request_error", &len);
+ c->close_after_write = 1;
+ append_http_response(c, 400, "application/json", body, len);
+ free(body);
+ aeDeleteFileEvent(c->srv->loop, c->fd, AE_READABLE);
+ if (queue_write(c) != AE_OK)
+ close_client(c);
+}
+
+static void reset_client_for_next_request(client *c) {
+ size_t consumed = c->header_len + c->content_length;
+ if (consumed > c->in.len)
+ consumed = c->in.len;
+ size_t remain = c->in.len - consumed;
+ if (remain)
+ memmove(c->in.ptr, c->in.ptr + consumed, remain);
+ c->in.len = remain;
+ if (c->in.ptr)
+ c->in.ptr[remain] = '\0';
+
+ http_request_free(&c->req);
+ sbuf_clear(&c->out);
+ c->sent = 0;
+ c->header_done = 0;
+ c->header_len = 0;
+ c->content_length = 0;
+ c->close_after_write = 0;
+}
+
+static void arm_next_request(client *c) {
+ reset_client_for_next_request(c);
+ if (c->cancelled || c->fd < 0)
+ return;
+
+ if (c->in.len) {
+ int done = complete_request(c);
+ if (done < 0) {
+ send_bad_http_request(c);
+ return;
+ }
+ if (done > 0) {
+ dispatch_request(c);
+ return;
+ }
+ }
+
+ if (aeCreateFileEvent(c->srv->loop, c->fd, AE_READABLE, read_cb, c) != AE_OK)
+ close_client(c);
+}
+
+static void write_cb(aeEventLoop *loop, int fd, void *clientData, int mask) {
+ (void)loop;
+ (void)mask;
+ client *c = clientData;
+ while (c->sent < c->out.len) {
+ ssize_t n = write(fd, c->out.ptr + c->sent, c->out.len - c->sent);
+ if (n > 0) {
+ c->sent += (size_t)n;
+ c->last_active_ms = mstime();
+ continue;
+ }
+ if (n < 0 && errno == EINTR)
+ continue;
+ if (n < 0 && (errno == EAGAIN || errno == EWOULDBLOCK))
+ return;
+ close_client(c);
+ return;
+ }
+ aeDeleteFileEvent(c->srv->loop, fd, AE_WRITABLE);
+ if (c->close_after_write)
+ close_client(c);
+ else
+ arm_next_request(c);
+}
+
+static int queue_write(client *c) {
+ if (!c || c->cancelled || c->fd < 0)
+ return -1;
+ return aeCreateFileEvent(c->srv->loop, c->fd, AE_WRITABLE, write_cb, c);
+}
+
+static void enqueue_done(job *j) {
+ http_server *s = j->srv;
+ pthread_mutex_lock(&s->mu);
+ if (s->done_tail)
+ s->done_tail->next = j;
+ else
+ s->done_head = j;
+ s->done_tail = j;
+ pthread_mutex_unlock(&s->mu);
+ const unsigned char byte = 1;
+ if (write(s->completion_pipe[1], &byte, 1) < 0) {
+ /* best-effort wakeup; the event loop also drains the done queue */
+ }
+}
+
+static job *pop_job_locked(http_server *s) {
+ job *j = s->job_head;
+ if (j) {
+ s->job_head = j->next;
+ if (!s->job_head)
+ s->job_tail = NULL;
+ j->next = NULL;
+ }
+ return j;
+}
+
+static int cond_wait_until_ns(pthread_cond_t *cv, pthread_mutex_t *mu, uint64_t deadline_ns) {
+ uint64_t now_ns = nstime();
+ if (now_ns >= deadline_ns)
+ return ETIMEDOUT;
+
+ uint64_t remaining_ns = deadline_ns - now_ns;
+ struct timespec abs;
+ if (clock_gettime(CLOCK_REALTIME, &abs) != 0) {
+ struct timeval tv;
+ gettimeofday(&tv, NULL);
+ abs.tv_sec = tv.tv_sec;
+ abs.tv_nsec = (long)tv.tv_usec * 1000L;
+ }
+ abs.tv_sec += (time_t)(remaining_ns / 1000000000u);
+ abs.tv_nsec += (long)(remaining_ns % 1000000000u);
+ if (abs.tv_nsec >= 1000000000L) {
+ abs.tv_sec++;
+ abs.tv_nsec -= 1000000000L;
+ }
+ return pthread_cond_timedwait(cv, mu, &abs);
+}
+
+static int collect_job_batch(http_server *s, job **jobs, int max_jobs) {
+ if (max_jobs <= 0)
+ return 0;
+
+ pthread_mutex_lock(&s->mu);
+ while (!s->job_head && !s->stopping)
+ pthread_cond_wait(&s->cv, &s->mu);
+
+ job *first = pop_job_locked(s);
+ if (!first) {
+ pthread_mutex_unlock(&s->mu);
+ return 0;
+ }
+
+ int n = 1;
+ jobs[0] = first;
+ int batchable = s->batch_size > 1 && (!strcmp(first->path, "/v1/embeddings") ||
+ !strcmp(first->path, "/v1/contextualizedembeddings"));
+ if (!batchable) {
+ pthread_mutex_unlock(&s->mu);
+ return n;
+ }
+
+ /* Exact item and token budgets are applied after worker-side tokenization;
+ * this queue stage only defines which arrival window may be grouped. */
+ uint64_t wait_ns = (uint64_t)s->batch_wait_us * 1000u;
+ uint64_t deadline_ns =
+ first->created_ns > UINT64_MAX - wait_ns ? UINT64_MAX : first->created_ns + wait_ns;
+ while (n < max_jobs) {
+ while (!s->job_head && !s->stopping && wait_ns > 0) {
+ int rc = cond_wait_until_ns(&s->cv, &s->mu, deadline_ns);
+ if (rc == ETIMEDOUT)
+ break;
+ }
+ if (!s->job_head)
+ break;
+ if (wait_ns > 0 && s->job_head->created_ns > deadline_ns)
+ break;
+ jobs[n++] = pop_job_locked(s);
+ if (wait_ns == 0 && !s->job_head)
+ break;
+ }
+ pthread_mutex_unlock(&s->mu);
+ return n;
+}
+
+static void enqueue_job(job *j) {
+ http_server *s = j->srv;
+ pthread_mutex_lock(&s->mu);
+ if (s->job_tail)
+ s->job_tail->next = j;
+ else
+ s->job_head = j;
+ s->job_tail = j;
+ pthread_cond_signal(&s->cv);
+ pthread_mutex_unlock(&s->mu);
+}
+
+static job *pop_done(http_server *s) {
+ pthread_mutex_lock(&s->mu);
+ job *j = s->done_head;
+ if (j) {
+ s->done_head = j->next;
+ if (!s->done_head)
+ s->done_tail = NULL;
+ j->next = NULL;
+ }
+ pthread_mutex_unlock(&s->mu);
+ return j;
+}
+
+static void job_free(job *j) {
+ if (!j)
+ return;
+ free(j->body);
+ free(j->auth);
+ free(j->extra_headers);
+ free(j->response);
+ free(j);
+}
+
+static void completion_cb(aeEventLoop *loop, int fd, void *clientData, int mask) {
+ (void)loop;
+ (void)mask;
+ http_server *s = clientData;
+ unsigned char tmp[128];
+ while (read(fd, tmp, sizeof(tmp)) > 0) {
+ }
+
+ job *j;
+ while ((j = pop_done(s)) != NULL) {
+ client *c = j->c;
+ int refs_to_drop = 1; /* job reference */
+ if (!c->cancelled) {
+ append_http_response_ex(c, j->status, j->content_type, j->extra_headers,
+ j->response ? j->response : "",
+ j->response ? j->response_len : 0);
+ if (queue_write(c) != AE_OK)
+ refs_to_drop += close_client_unlink(c);
+ }
+ client_decref_n(c, refs_to_drop);
+ job_free(j);
+ }
+}
+
+static bool route_is_inference(const char *method, const char *path) {
+ return !strcmp(method, "POST") &&
+ (!strcmp(path, "/v1/embeddings") || !strcmp(path, "/v1/contextualizedembeddings") ||
+ !strcmp(path, "/v1/rerank"));
+}
+
+static void dispatch_request(client *c) {
+ aeDeleteFileEvent(c->srv->loop, c->fd, AE_READABLE);
+
+ if (!strcmp(c->req.method, "OPTIONS")) {
+ append_http_response(c, 204, NULL, "", 0);
+ if (queue_write(c) != AE_OK)
+ close_client(c);
+ return;
+ }
+
+ if (!route_is_inference(c->req.method, c->req.path)) {
+ size_t len;
+ char *body = json_error_body("unknown endpoint", "invalid_request_error", &len);
+ append_http_response(c, 404, "application/json", body, len);
+ free(body);
+ if (queue_write(c) != AE_OK)
+ close_client(c);
+ return;
+ }
+
+ if (!auth_ok(c->srv, c->req.auth)) {
+ size_t len;
+ char *body =
+ json_error_body("missing or invalid bearer token", "authentication_error", &len);
+ append_http_response(c, 401, "application/json", body, len);
+ free(body);
+ if (queue_write(c) != AE_OK)
+ close_client(c);
+ return;
+ }
+
+ job *j = xcalloc(1, sizeof(*j));
+ j->srv = c->srv;
+ j->c = c;
+ snprintf(j->method, sizeof(j->method), "%s", c->req.method);
+ snprintf(j->path, sizeof(j->path), "%s", c->req.path);
+ j->body = xstrndup(c->req.body ? c->req.body : "", c->req.body_len);
+ j->body_len = c->req.body_len;
+ j->auth = c->req.auth ? xstrdup(c->req.auth) : NULL;
+ j->created_ns = nstime();
+ client_incref(c);
+ enqueue_job(j);
+}
+
+static void read_cb(aeEventLoop *loop, int fd, void *clientData, int mask) {
+ (void)loop;
+ (void)mask;
+ client *c = clientData;
+ char tmp[EMBED_HTTP_IO_BUF];
+ for (;;) {
+ ssize_t n = read(fd, tmp, sizeof(tmp));
+ if (n > 0) {
+ sbuf_append(&c->in, tmp, (size_t)n);
+ c->last_active_ms = mstime();
+ int done = complete_request(c);
+ if (done < 0) {
+ send_bad_http_request(c);
+ return;
+ }
+ if (done > 0) {
+ dispatch_request(c);
+ return;
+ }
+ continue;
+ }
+ if (n == 0) {
+ close_client(c);
+ return;
+ }
+ if (errno == EINTR)
+ continue;
+ if (errno == EAGAIN || errno == EWOULDBLOCK)
+ return;
+ close_client(c);
+ return;
+ }
+}
+
+static void accept_cb(aeEventLoop *loop, int fd, void *clientData, int mask) {
+ (void)loop;
+ (void)mask;
+ http_server *s = clientData;
+ char cip[64];
+ int cport = 0;
+ for (;;) {
+ int cfd = anetTcpAccept(NULL, fd, cip, sizeof(cip), &cport);
+ if (cfd == ANET_ERR) {
+ if (errno == EAGAIN || errno == EWOULDBLOCK)
+ return;
+ if (errno == EINTR)
+ continue;
+ return;
+ }
+ set_nonblock(cfd);
+ client *c = xcalloc(1, sizeof(*c));
+ c->srv = s;
+ c->fd = cfd;
+ c->refcount = 1;
+ c->last_active_ms = mstime();
+ c->linked = 1;
+ c->next = s->clients;
+ if (s->clients)
+ s->clients->prev = c;
+ s->clients = c;
+ s->n_clients++;
+ if (aeCreateFileEvent(s->loop, cfd, AE_READABLE, read_cb, c) != AE_OK)
+ close_client(c);
+ }
+}
+
+static int timeout_cb(aeEventLoop *loop, long long id, void *clientData) {
+ (void)loop;
+ (void)id;
+ http_server *s = clientData;
+ uint64_t now = mstime();
+ client *c = s->clients;
+ while (c) {
+ client *next = c->next;
+ /* refcount > 1 means a request from this client is queued or being
+ * processed by the worker; long batch queues (e.g. 4B long-document
+ * batches) must not be reaped as idle. */
+ if (!c->cancelled && c->refcount <= 1 &&
+ now - c->last_active_ms > EMBED_HTTP_CLIENT_TIMEOUT_MS)
+ close_client(c);
+ c = next;
+ }
+ return EMBED_HTTP_SWEEP_MS;
+}
+
+static void signal_cb(aeEventLoop *loop, int fd, void *clientData, int mask) {
+ (void)fd;
+ (void)mask;
+ http_server *s = clientData;
+ unsigned char tmp[128];
+ while (read(s->signal_pipe[0], tmp, sizeof(tmp)) > 0) {
+ }
+ aeStop(loop);
+}
+
+static bool ve_add(cJSON *detail, const char *loc_json, const char *msg, const char *type) {
+ cJSON *obj = cJSON_CreateObject();
+ cJSON *loc = cJSON_Parse(loc_json);
+ if (!obj || !loc) {
+ cJSON_Delete(obj);
+ cJSON_Delete(loc);
+ return false;
+ }
+ cJSON_AddItemToObject(obj, "loc", loc);
+ cJSON_AddStringToObject(obj, "msg", msg ? msg : "");
+ cJSON_AddStringToObject(obj, "type", type ? type : "");
+ cJSON_AddItemToArray(detail, obj);
+ return true;
+}
+
+static void job_set_422(job *j, cJSON *detail) {
+ cJSON *root = cJSON_CreateObject();
+ cJSON_AddItemToObject(root, "detail", cJSON_Duplicate(detail, 1));
+ char *s = cJSON_PrintUnformatted(root);
+ cJSON_Delete(root);
+ if (!s) {
+ job_set_error(j, 500, "failed to render validation error", "server_error");
+ return;
+ }
+ j->status = 422;
+ j->content_type = "application/json";
+ j->response = xstrdup(s);
+ j->response_len = strlen(j->response);
+ cJSON_free(s);
+}
+
+static void job_set_timing_header(job *j) {
+ if (!j || j->extra_headers || !j->created_ns)
+ return;
+ uint64_t done_ns = nstime();
+ uint64_t queue_ns = j->started_ns > j->created_ns ? j->started_ns - j->created_ns : 0;
+ uint64_t worker_ns = j->started_ns && done_ns > j->started_ns ? done_ns - j->started_ns : 0;
+
+ char buf[384];
+ int n = snprintf(buf, sizeof(buf),
+ "Server-Timing: queue;dur=%.3f, parse;dur=%.3f, "
+ "tokenize;dur=%.3f, infer;dur=%.3f, encode;dur=%.3f, "
+ "worker;dur=%.3f\r\n",
+ ns_to_ms(queue_ns), ns_to_ms(j->parse_ns), ns_to_ms(j->tokenize_ns),
+ ns_to_ms(j->infer_ns), ns_to_ms(j->encode_ns), ns_to_ms(worker_ns));
+ if (n > 0 && (size_t)n < sizeof(buf))
+ j->extra_headers = xstrdup(buf);
+}
+
+static cJSON *parse_json_body(job *j, cJSON *detail) {
+ if (!j->body || j->body_len == 0) {
+ ve_add(detail, "[\"body\"]", "body required", "missing");
+ return NULL;
+ }
+ const char *end = NULL;
+ cJSON *root = cJSON_ParseWithLengthOpts(j->body, j->body_len, &end, false);
+ if (!root) {
+ ve_add(detail, "[\"body\"]", "invalid JSON", "json_invalid");
+ return NULL;
+ }
+ const char *body_end = j->body + j->body_len;
+ while (end && end < body_end && isspace((unsigned char)*end))
+ end++;
+ if (!end || end != body_end) {
+ ve_add(detail, "[\"body\"]", "invalid JSON", "json_invalid");
+ cJSON_Delete(root);
+ return NULL;
+ }
+ if (!cJSON_IsObject(root)) {
+ ve_add(detail, "[\"body\"]", "body must be a JSON object", "type_error.object");
+ cJSON_Delete(root);
+ return NULL;
+ }
+ return root;
+}
+
+static bool cjson_is_integer(cJSON *item) {
+ if (!cJSON_IsNumber(item))
+ return false;
+ double d = item->valuedouble;
+ int i = item->valueint;
+ return d >= (double)INT_MIN && d <= (double)INT_MAX && d == (double)i;
+}
+
+static const char *encoding_from_root(cJSON *root, cJSON *detail, embedding_api_t api) {
+ /* Default and accepted encodings follow the model's API family: Perplexity
+ * defaults to base64_int8 and accepts {base64_int8, base64_binary, float};
+ * OpenAI/DashScope (Qwen3) defaults to float and accepts {float, base64}. */
+ const char *dflt = api == EMBED_API_OPENAI ? "float" : "base64_int8";
+ cJSON *encoding = cJSON_GetObjectItemCaseSensitive(root, "encoding_format");
+ if (!encoding)
+ return dflt;
+ if (!cJSON_IsString(encoding) || !encoding->valuestring) {
+ ve_add(detail, "[\"body\",\"encoding_format\"]", "encoding_format must be a string",
+ "type_error.string");
+ return dflt;
+ }
+ const char *v = encoding->valuestring;
+ int ok = api == EMBED_API_OPENAI ? (!strcmp(v, "float") || !strcmp(v, "base64"))
+ : (!strcmp(v, "base64_int8") || !strcmp(v, "base64_binary") ||
+ !strcmp(v, "float"));
+ if (!ok) {
+ ve_add(detail, "[\"body\",\"encoding_format\"]",
+ api == EMBED_API_OPENAI
+ ? "value is not a valid enum member; permitted: 'float', 'base64'"
+ : "value is not a valid enum member; permitted: "
+ "'base64_int8', 'base64_binary', 'float'",
+ "enum");
+ return dflt;
+ }
+ return v;
+}
+
+/* Parse the `text_type` hint. Returns 1 when the model's query instruction
+ * should be prepended, 0 otherwise (document / absent). Models without a
+ * published query instruction reject the field. */
+static int text_type_is_query(cJSON *root, cJSON *detail, const char *query_instruct) {
+ cJSON *tt = cJSON_GetObjectItemCaseSensitive(root, "text_type");
+ if (!tt)
+ return 0;
+ if (!query_instruct) {
+ ve_add(detail, "[\"body\",\"text_type\"]",
+ "text_type is only supported for instruction embedding models", "extra_fields");
+ return 0;
+ }
+ if (!cJSON_IsString(tt) || !tt->valuestring) {
+ ve_add(detail, "[\"body\",\"text_type\"]", "text_type must be a string",
+ "type_error.string");
+ return 0;
+ }
+ const char *v = tt->valuestring;
+ if (!strcmp(v, "query"))
+ return 1;
+ if (!strcmp(v, "document"))
+ return 0;
+ ve_add(detail, "[\"body\",\"text_type\"]",
+ "value is not a valid enum member; permitted: 'query', 'document'", "enum");
+ return 0;
+}
+
+static int
+dimensions_from_root(cJSON *root, cJSON *detail, int min_dim, int max_dim, const char *encoding) {
+ int dims = max_dim;
+ cJSON *dimensions = cJSON_GetObjectItemCaseSensitive(root, "dimensions");
+ if (dimensions) {
+ if (!cjson_is_integer(dimensions)) {
+ ve_add(detail, "[\"body\",\"dimensions\"]", "dimensions must be an integer",
+ "type_error.integer");
+ } else {
+ dims = dimensions->valueint;
+ if (dims < min_dim || dims > max_dim) {
+ char msg[96];
+ snprintf(msg, sizeof(msg), "dimensions must be between %d and %d", min_dim,
+ max_dim);
+ ve_add(detail, "[\"body\",\"dimensions\"]", msg, "value_error.range");
+ }
+ }
+ }
+ if (!strcmp(encoding, "base64_binary") && dims % 8 != 0)
+ ve_add(detail, "[\"body\",\"dimensions\"]",
+ "dimensions must be divisible by 8 for base64_binary", "value_error.divisible");
+ return dims;
+}
+
+static char *base64_encode(const unsigned char *src, size_t n) {
+ static const char tbl[] = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+ size_t out_len = ((n + 2) / 3) * 4;
+ char *out = xmalloc(out_len + 1);
+ size_t o = 0;
+ for (size_t i = 0; i < n; i += 3) {
+ unsigned v = (unsigned)src[i] << 16;
+ int remain = (int)(n - i);
+ if (remain > 1)
+ v |= (unsigned)src[i + 1] << 8;
+ if (remain > 2)
+ v |= (unsigned)src[i + 2];
+ out[o++] = tbl[(v >> 18) & 63];
+ out[o++] = tbl[(v >> 12) & 63];
+ out[o++] = remain > 1 ? tbl[(v >> 6) & 63] : '=';
+ out[o++] = remain > 2 ? tbl[v & 63] : '=';
+ }
+ out[o] = '\0';
+ return out;
+}
+
+static signed char quantize_int8_tanh(float x) {
+ int v = (int)lrintf(tanhf(x) * 127.0f);
+ if (v > 127)
+ v = 127;
+ if (v < -128)
+ v = -128;
+ return (signed char)v;
+}
+
+static char *encode_embedding(const float *emb, int dims, const char *encoding) {
+ if (!strcmp(encoding, "base64")) {
+ /* OpenAI/DashScope (Qwen3): base64 of the raw little-endian float32
+ * vector. Copy through a byte buffer instead of reinterpret-casting the
+ * float pointer; x86_64 and aarch64 are little-endian, so the bytes
+ * match the wire format with no swap. */
+ size_t nbytes = (size_t)dims * sizeof(float);
+ unsigned char *buf = xmalloc(nbytes);
+ memcpy(buf, emb, nbytes);
+ char *out = base64_encode(buf, nbytes);
+ free(buf);
+ return out;
+ }
+ if (!strcmp(encoding, "base64_binary")) {
+ size_t bytes = (size_t)dims / 8;
+ unsigned char *bits = xcalloc(bytes, 1);
+ for (int i = 0; i < dims; i++) {
+ if (emb[i] >= 0.0f)
+ bits[(size_t)i >> 3] |= (unsigned char)(1u << (i & 7));
+ }
+ char *out = base64_encode(bits, bytes);
+ free(bits);
+ return out;
+ }
+
+ signed char *q = xmalloc((size_t)dims);
+ for (int i = 0; i < dims; i++)
+ q[i] = quantize_int8_tanh(emb[i]);
+ char *out = base64_encode((const unsigned char *)q, (size_t)dims);
+ free(q);
+ return out;
+}
+
+typedef struct {
+ int *ids;
+ int n_tokens;
+} token_buf;
+
+typedef struct {
+ job *j;
+ cJSON *root;
+ loaded_model *model;
+ int dims;
+ const char *encoding;
+ int n_inputs;
+ token_buf *tokens;
+ embed_input_t *inputs;
+ int total_tokens;
+ int ready;
+} embedding_request;
+
+typedef struct {
+ int *ids;
+ int n_tokens;
+ embed_span_t *spans;
+ int n_spans;
+} contextual_doc;
+
+typedef struct {
+ job *j;
+ cJSON *root;
+ loaded_model *model;
+ int dims;
+ const char *encoding;
+ contextual_doc *docs;
+ int n_docs;
+ int total_chunks;
+ int total_tokens;
+ int ready;
+} contextual_request;
+
+typedef struct {
+ int *ids;
+ int n_tokens;
+ int *keep;
+ int n_keep;
+} late_tokens;
+
+typedef struct {
+ job *j;
+ cJSON *root;
+ loaded_model *model;
+ late_tokens query;
+ late_tokens *documents;
+ int n_documents;
+ int top_n;
+ int return_documents;
+ int query_tokens;
+ int document_tokens;
+ int ready;
+} rerank_request;
+
+static void free_token_bufs(token_buf *t, int n) {
+ if (!t)
+ return;
+ for (int i = 0; i < n; i++)
+ free(t[i].ids);
+}
+
+static void embedding_request_free(embedding_request *r) {
+ if (!r)
+ return;
+ free_token_bufs(r->tokens, r->n_inputs);
+ free(r->tokens);
+ free(r->inputs);
+ if (r->root)
+ cJSON_Delete(r->root);
+ memset(r, 0, sizeof(*r));
+}
+
+static void contextual_request_free(contextual_request *r) {
+ if (!r)
+ return;
+ for (int i = 0; i < r->n_docs; i++) {
+ free(r->docs[i].ids);
+ free(r->docs[i].spans);
+ }
+ free(r->docs);
+ if (r->root)
+ cJSON_Delete(r->root);
+ memset(r, 0, sizeof(*r));
+}
+
+static void late_tokens_free(late_tokens *t) {
+ if (!t)
+ return;
+ free(t->ids);
+ free(t->keep);
+ memset(t, 0, sizeof(*t));
+}
+
+static void rerank_request_free(rerank_request *r) {
+ if (!r)
+ return;
+ late_tokens_free(&r->query);
+ for (int i = 0; i < r->n_documents; i++)
+ late_tokens_free(&r->documents[i]);
+ free(r->documents);
+ if (r->root)
+ cJSON_Delete(r->root);
+ memset(r, 0, sizeof(*r));
+}
+
+static int tokenize_one(loaded_model *m, job *j, const char *text, token_buf *out) {
+ memset(out, 0, sizeof(*out));
+ uint64_t t0 = nstime();
+ if (m->wp_tok) {
+ int n = 0;
+ int *core = wordpiece_tokenizer_encode_with_workspace(m->wp_tok, m->wp_tok_ws, text, &n);
+ if (j)
+ j->tokenize_ns += nstime() - t0;
+ /* BERT wraps the WordPiece ids with [CLS] ... [SEP], exactly as the BPE
+ * branch below appends its terminal token. A whitespace-only input
+ * cleans to zero core tokens (core == NULL, n == 0); the bare
+ * [CLS][SEP] pair is what Hugging Face produces for it too. Grow the
+ * returned buffer in place so only one allocation is touched. */
+ if (n < 0 || n > INT_MAX - 2) {
+ free(core);
+ memset(out, 0, sizeof(*out));
+ return -1;
+ }
+ int *ids = realloc(core, (size_t)(n + 2) * sizeof(*ids));
+ if (!ids) {
+ free(core);
+ memset(out, 0, sizeof(*out));
+ return -1;
+ }
+ memmove(ids + 1, ids, (size_t)n * sizeof(*ids));
+ ids[0] = m->cls_id;
+ ids[n + 1] = m->sep_id;
+ out->ids = ids;
+ out->n_tokens = n + 2;
+ return 0;
+ }
+ out->ids = embed_tokenizer_encode_with_workspace(m->tok, m->tok_ws, text, &out->n_tokens);
+ if (j)
+ j->tokenize_ns += nstime() - t0;
+ if (!out->ids || out->n_tokens <= 0) {
+ free(out->ids);
+ memset(out, 0, sizeof(*out));
+ return -1;
+ }
+ if (m->append_terminal_token) {
+ if (out->n_tokens == INT_MAX) {
+ free(out->ids);
+ memset(out, 0, sizeof(*out));
+ return -1;
+ }
+ int *ids = realloc(out->ids, (size_t)(out->n_tokens + 1) * sizeof(*out->ids));
+ if (!ids) {
+ free(out->ids);
+ memset(out, 0, sizeof(*out));
+ return -1;
+ }
+ out->ids = ids;
+ out->ids[out->n_tokens++] = m->terminal_token_id;
+ }
+ return 0;
+}
+
+/* Tokenize one embedding input, optionally prepending the model's query
+ * instruction. The instruction and input are tokenized in one pass. */
+static int tokenize_input(
+ loaded_model *m, job *j, const char *text, const char *query_instruct, token_buf *out) {
+ if (!query_instruct)
+ return tokenize_one(m, j, text, out);
+ size_t plen = strlen(query_instruct);
+ size_t tlen = strlen(text);
+ char *buf = (char *)malloc(plen + tlen + 1);
+ if (!buf) {
+ memset(out, 0, sizeof(*out));
+ return -1;
+ }
+ memcpy(buf, query_instruct, plen);
+ memcpy(buf + plen, text, tlen + 1);
+ int rc = tokenize_one(m, j, buf, out);
+ free(buf);
+ return rc;
+}
+
+static int late_id_is_skipped(const loaded_model *m, int id) {
+ for (int i = 0; i < m->n_late_skip_ids; i++) {
+ if (m->late_skip_ids[i] == id)
+ return 1;
+ }
+ return 0;
+}
+
+static int
+tokenize_late_text(loaded_model *m, job *j, const char *text, int is_query, late_tokens *out) {
+ token_buf raw = {0};
+ if (tokenize_one(m, j, text, &raw) != 0)
+ return -1;
+
+ int raw_tokens = raw.n_tokens;
+ int target = raw_tokens + 1;
+ if (is_query && target < EMBED_LATE_QUERY_TOKENS)
+ target = EMBED_LATE_QUERY_TOKENS;
+
+ out->ids = xmalloc((size_t)target * sizeof(*out->ids));
+ out->ids[0] = raw.ids[0];
+ out->ids[1] = is_query ? m->late_query_prefix_id : m->late_document_prefix_id;
+ if (raw_tokens > 1) {
+ memcpy(out->ids + 2, raw.ids + 1, (size_t)(raw_tokens - 1) * sizeof(*out->ids));
+ }
+ out->n_tokens = raw_tokens + 1;
+ if (is_query) {
+ while (out->n_tokens < EMBED_LATE_QUERY_TOKENS)
+ out->ids[out->n_tokens++] = m->late_mask_id;
+ out->n_keep = out->n_tokens;
+ } else {
+ out->keep = xmalloc((size_t)out->n_tokens * sizeof(*out->keep));
+ for (int i = 0; i < out->n_tokens; i++) {
+ if (!late_id_is_skipped(m, out->ids[i]))
+ out->keep[out->n_keep++] = i;
+ }
+ }
+ free(raw.ids);
+ return out->n_keep > 0 ? 0 : -1;
+}
+
+static int model_embed_batch(loaded_model *m, const embed_input_t *inputs, int batch, float *out) {
+#ifdef USE_MLX
+ if (m->mlx_ctx)
+ return embed_mlx_encode_batch(m->mlx_ctx, inputs, batch, out);
+#endif
+#ifdef USE_CUDA
+ if (m->cuda_ctx)
+ return embed_cuda_encode_batch(m->cuda_ctx, inputs, batch, out);
+#endif
+ return embed_model_encode_batch(m->cpu_model, m->cpu_ws, inputs, batch, out);
+}
+
+static int model_embed_spans_batch(loaded_model *m,
+ const embed_context_input_t *inputs,
+ int batch,
+ float *out) {
+#ifdef USE_MLX
+ if (m->mlx_ctx)
+ return embed_mlx_encode_spans_batch(m->mlx_ctx, inputs, batch, out);
+#endif
+#ifdef USE_CUDA
+ if (m->cuda_ctx)
+ return embed_cuda_encode_spans_batch(m->cuda_ctx, inputs, batch, out);
+#endif
+ return embed_model_encode_spans_batch(m->cpu_model, m->cpu_ws, inputs, batch, out);
+}
+
+static int model_uses_dense_batches(const loaded_model *m) {
+#ifdef USE_MLX
+ return m->mlx_ctx != NULL;
+#else
+ (void)m;
+ return 0;
+#endif
+}
+
+/* Inputs are sorted by length before chunking. CPU packs real tokens while MLX
+ * pads each dense row to the longest input in the chunk. */
+static int inference_batch_accepts_input(
+ const loaded_model *m, int batch, int packed_tokens, int next_tokens, int max_batch_tokens) {
+ if (batch == 0)
+ return 1;
+ if (model_uses_dense_batches(m))
+ return next_tokens <= max_batch_tokens / (batch + 1);
+ return next_tokens <= max_batch_tokens - packed_tokens;
+}
+
+static void append_embedding_object(sbuf *b, int index, const char *embedding) {
+ sbuf_printf(b, "{\"object\":\"embedding\",\"index\":%d,\"embedding\":\"", index);
+ sbuf_puts(b, embedding);
+ sbuf_puts(b, "\"}");
+}
+
+/* Emit one embedding into the response, following the model's API family.
+ * "float" renders a JSON array: the true float32 vector for OpenAI/DashScope
+ * (Qwen3), or the int8-decoded view (int8/128) for Perplexity (pplx). Every
+ * other encoding renders a base64 string via encode_embedding(). */
+static void append_embedding_value(
+ sbuf *b, int index, const float *emb, int dims, const char *encoding, embedding_api_t api) {
+ if (!strcmp(encoding, "float")) {
+ sbuf_printf(b, "{\"object\":\"embedding\",\"index\":%d,\"embedding\":[", index);
+ for (int i = 0; i < dims; i++) {
+ if (i)
+ sbuf_putc(b, ',');
+ float v = api == EMBED_API_OPENAI ? emb[i] : (float)quantize_int8_tanh(emb[i]) / 128.0f;
+ sbuf_printf(b, "%.9g", (double)v);
+ }
+ sbuf_puts(b, "]}");
+ return;
+ }
+ char *encoded = encode_embedding(emb, dims, encoding);
+ append_embedding_object(b, index, encoded);
+ free(encoded);
+}
+
+static void set_response_from_buf(job *j, sbuf *b) {
+ j->status = 200;
+ j->content_type = "application/json";
+ j->response = b->ptr;
+ j->response_len = b->len;
+ memset(b, 0, sizeof(*b));
+}
+
+static int render_embedding_response(embedding_request *r, const float *embs) {
+ const int full_dim = r->model->info->dim;
+ const float *render_embs = embs;
+ float *truncated = NULL;
+ if (r->model->renormalize_truncated && r->dims < full_dim) {
+ truncated = xmalloc((size_t)r->n_inputs * r->dims * sizeof(*truncated));
+ for (int i = 0; i < r->n_inputs; i++) {
+ float *dst = truncated + (size_t)i * r->dims;
+ memcpy(dst, embs + (size_t)i * full_dim, (size_t)r->dims * sizeof(*dst));
+ if (embed_l2_normalize(dst, r->dims) != 0) {
+ free(truncated);
+ return -1;
+ }
+ }
+ render_embs = truncated;
+ }
+ int render_stride = truncated ? r->dims : full_dim;
+ embedding_api_t api = r->model->info->api;
+
+ sbuf b = {0};
+ sbuf_puts(&b, "{\"object\":\"list\",\"data\":[");
+ for (int i = 0; i < r->n_inputs; i++) {
+ if (i)
+ sbuf_putc(&b, ',');
+ append_embedding_value(&b, i, render_embs + (size_t)i * render_stride, r->dims, r->encoding,
+ api);
+ }
+ sbuf_printf(&b,
+ "],\"model\":\"%s\",\"usage\":{\"prompt_tokens\":%d,"
+ "\"total_tokens\":%d}}",
+ r->model->info->id, r->total_tokens, r->total_tokens);
+ set_response_from_buf(r->j, &b);
+
+ free(truncated);
+ return 0;
+}
+
+static int embedding_request_compatible(const embedding_request *a, const embedding_request *b) {
+ return a->ready && b->ready && a->model == b->model && a->dims == b->dims &&
+ !strcmp(a->encoding, b->encoding);
+}
+
+typedef struct {
+ embed_input_t input;
+ int output_index;
+} embedding_batch_item;
+
+static int embedding_batch_item_cmp(const void *a, const void *b) {
+ const embedding_batch_item *ia = a;
+ const embedding_batch_item *ib = b;
+ if (ia->input.n_tokens < ib->input.n_tokens)
+ return -1;
+ if (ia->input.n_tokens > ib->input.n_tokens)
+ return 1;
+ return ia->output_index - ib->output_index;
+}
+
+static int embedding_request_fits_group(const embedding_request *r,
+ int group_inputs,
+ int group_tokens,
+ int max_batch,
+ int max_batch_tokens) {
+ if (group_inputs == 0)
+ return 1;
+ return r->n_inputs <= max_batch - group_inputs &&
+ r->total_tokens <= max_batch_tokens - group_tokens;
+}
+
+static void execute_embedding_request_list(embedding_request **reqs, int n_reqs) {
+ if (n_reqs <= 0)
+ return;
+ loaded_model *m = reqs[0]->model;
+ int dim = m->info->dim;
+ int total_inputs = 0;
+ for (int i = 0; i < n_reqs; i++)
+ total_inputs += reqs[i]->n_inputs;
+
+ embedding_batch_item *items = xmalloc((size_t)total_inputs * sizeof(*items));
+ float *embs = xmalloc((size_t)total_inputs * dim * sizeof(float));
+
+ int pos = 0;
+ for (int i = 0; i < n_reqs; i++) {
+ for (int k = 0; k < reqs[i]->n_inputs; k++) {
+ items[pos].input = reqs[i]->inputs[k];
+ items[pos].output_index = pos;
+ pos++;
+ }
+ }
+ qsort(items, (size_t)total_inputs, sizeof(*items), embedding_batch_item_cmp);
+
+ int max_batch = reqs[0]->j->srv->batch_size > 0 ? reqs[0]->j->srv->batch_size : total_inputs;
+ if (max_batch > total_inputs)
+ max_batch = total_inputs;
+ int max_batch_tokens = reqs[0]->j->srv->max_batch_tokens;
+ embed_input_t *inputs = xmalloc((size_t)max_batch * sizeof(*inputs));
+ float *batch_embs = xmalloc((size_t)max_batch * dim * sizeof(float));
+
+ int failed = 0;
+ uint64_t infer_ns = 0;
+ for (int start = 0; start < total_inputs;) {
+ int cur = 0;
+ int tokens = 0;
+ while (start + cur < total_inputs && cur < max_batch) {
+ int n_tokens = items[start + cur].input.n_tokens;
+ if (!inference_batch_accepts_input(m, cur, tokens, n_tokens, max_batch_tokens))
+ break;
+ inputs[cur] = items[start + cur].input;
+ tokens += n_tokens;
+ cur++;
+ }
+ uint64_t t0 = nstime();
+ int embed_rc = model_embed_batch(m, inputs, cur, batch_embs);
+ infer_ns += nstime() - t0;
+ if (embed_rc != 0) {
+ failed = 1;
+ break;
+ }
+ for (int i = 0; i < cur; i++)
+ memcpy(embs + (size_t)items[start + i].output_index * dim, batch_embs + (size_t)i * dim,
+ (size_t)dim * sizeof(float));
+ start += cur;
+ }
+
+ pos = 0;
+ for (int i = 0; i < n_reqs; i++) {
+ reqs[i]->j->infer_ns += infer_ns;
+ if (failed) {
+ job_set_error(reqs[i]->j, 500, "embedding failed", "server_error");
+ } else {
+ uint64_t t0 = nstime();
+ if (render_embedding_response(reqs[i], embs + (size_t)pos * dim) != 0)
+ job_set_error(reqs[i]->j, 500, "embedding normalization failed", "server_error");
+ reqs[i]->j->encode_ns += nstime() - t0;
+ }
+ pos += reqs[i]->n_inputs;
+ }
+
+ free(batch_embs);
+ free(inputs);
+ free(embs);
+ free(items);
+}
+
+static void render_contextual_response(contextual_request *r, const float *embs) {
+ sbuf b = {0};
+ sbuf_puts(&b, "{\"object\":\"list\",\"data\":[");
+ int span_offset = 0;
+ for (int di = 0; di < r->n_docs; di++) {
+ if (di)
+ sbuf_putc(&b, ',');
+ sbuf_printf(&b, "{\"object\":\"list\",\"index\":%d,\"data\":[", di);
+ for (int ci = 0; ci < r->docs[di].n_spans; ci++) {
+ if (ci)
+ sbuf_putc(&b, ',');
+ const float *emb = embs + (size_t)span_offset * r->model->info->dim;
+ append_embedding_value(&b, ci, emb, r->dims, r->encoding, r->model->info->api);
+ span_offset++;
+ }
+ sbuf_puts(&b, "]}");
+ }
+ sbuf_printf(&b, "],\"model\":\"%s\",\"usage\":{\"prompt_tokens\":%d,\"total_tokens\":%d}}",
+ r->model->info->id, r->total_tokens, r->total_tokens);
+ set_response_from_buf(r->j, &b);
+}
+
+static int contextual_request_compatible(const contextual_request *a, const contextual_request *b) {
+ return a->ready && b->ready && a->model == b->model && a->dims == b->dims &&
+ !strcmp(a->encoding, b->encoding);
+}
+
+static int contextual_request_fits_group(const contextual_request *r,
+ int group_docs,
+ int group_tokens,
+ int max_batch,
+ int max_batch_tokens) {
+ if (group_docs == 0)
+ return 1;
+ return r->n_docs <= max_batch - group_docs &&
+ r->total_tokens <= max_batch_tokens - group_tokens;
+}
+
+typedef struct {
+ embed_context_input_t input;
+ int output_span_index;
+ int order;
+} contextual_batch_item;
+
+static int contextual_batch_item_cmp(const void *a, const void *b) {
+ const contextual_batch_item *ia = a;
+ const contextual_batch_item *ib = b;
+ if (ia->input.input.n_tokens < ib->input.input.n_tokens)
+ return -1;
+ if (ia->input.input.n_tokens > ib->input.input.n_tokens)
+ return 1;
+ return ia->order - ib->order;
+}
+
+static void execute_contextual_request_list(contextual_request **reqs, int n_reqs) {
+ if (n_reqs <= 0)
+ return;
+ loaded_model *m = reqs[0]->model;
+ int dim = m->info->dim;
+ int total_docs = 0;
+ int total_chunks = 0;
+ for (int i = 0; i < n_reqs; i++) {
+ if (total_docs > INT_MAX - reqs[i]->n_docs ||
+ total_chunks > INT_MAX - reqs[i]->total_chunks) {
+ for (int k = 0; k < n_reqs; k++)
+ job_set_error(reqs[k]->j, 500, "contextual batch is too large", "server_error");
+ return;
+ }
+ total_docs += reqs[i]->n_docs;
+ total_chunks += reqs[i]->total_chunks;
+ }
+ if ((size_t)total_chunks > SIZE_MAX / (size_t)dim / sizeof(float)) {
+ for (int i = 0; i < n_reqs; i++)
+ job_set_error(reqs[i]->j, 500, "contextual batch is too large", "server_error");
+ return;
+ }
+
+ contextual_batch_item *items = xmalloc((size_t)total_docs * sizeof(*items));
+ float *embs = xmalloc((size_t)total_chunks * dim * sizeof(*embs));
+ int pos = 0;
+ int span_offset = 0;
+ for (int i = 0; i < n_reqs; i++) {
+ for (int d = 0; d < reqs[i]->n_docs; d++) {
+ contextual_doc *doc = &reqs[i]->docs[d];
+ items[pos].input.input.ids = doc->ids;
+ items[pos].input.input.n_tokens = doc->n_tokens;
+ items[pos].input.spans = doc->spans;
+ items[pos].input.n_spans = doc->n_spans;
+ items[pos].output_span_index = span_offset;
+ items[pos].order = pos;
+ span_offset += doc->n_spans;
+ pos++;
+ }
+ }
+ qsort(items, (size_t)total_docs, sizeof(*items), contextual_batch_item_cmp);
+
+ int max_batch = reqs[0]->j->srv->batch_size > 0 ? reqs[0]->j->srv->batch_size : total_docs;
+ if (max_batch > total_docs)
+ max_batch = total_docs;
+ int max_batch_tokens = reqs[0]->j->srv->max_batch_tokens;
+ embed_context_input_t *inputs = xmalloc((size_t)max_batch * sizeof(*inputs));
+ float *batch_embs = xmalloc(sizeof(*batch_embs));
+ size_t batch_emb_cap = 0;
+
+ int failed = 0;
+ uint64_t infer_ns = 0;
+ for (int start = 0; start < total_docs;) {
+ int cur = 0;
+ int tokens = 0;
+ int chunks = 0;
+ while (start + cur < total_docs && cur < max_batch) {
+ const embed_context_input_t *input = &items[start + cur].input;
+ if (!inference_batch_accepts_input(m, cur, tokens, input->input.n_tokens,
+ max_batch_tokens))
+ break;
+ inputs[cur] = *input;
+ tokens += input->input.n_tokens;
+ chunks += input->n_spans;
+ cur++;
+ }
+ size_t needed = (size_t)chunks * dim;
+ if (needed > batch_emb_cap) {
+ batch_embs = xrealloc(batch_embs, needed * sizeof(*batch_embs));
+ batch_emb_cap = needed;
+ }
+ uint64_t t0 = nstime();
+ int embed_rc = model_embed_spans_batch(m, inputs, cur, batch_embs);
+ infer_ns += nstime() - t0;
+ if (embed_rc != 0) {
+ failed = 1;
+ break;
+ }
+ int batch_span = 0;
+ for (int i = 0; i < cur; i++) {
+ int n_spans = inputs[i].n_spans;
+ memcpy(embs + (size_t)items[start + i].output_span_index * dim,
+ batch_embs + (size_t)batch_span * dim, (size_t)n_spans * dim * sizeof(*embs));
+ batch_span += n_spans;
+ }
+ start += cur;
+ }
+
+ span_offset = 0;
+ for (int i = 0; i < n_reqs; i++) {
+ reqs[i]->j->infer_ns += infer_ns;
+ if (failed) {
+ job_set_error(reqs[i]->j, 500, "contextual embedding failed", "server_error");
+ } else {
+ uint64_t t0 = nstime();
+ render_contextual_response(reqs[i], embs + (size_t)span_offset * dim);
+ reqs[i]->j->encode_ns += nstime() - t0;
+ }
+ span_offset += reqs[i]->total_chunks;
+ }
+
+ free(batch_embs);
+ free(inputs);
+ free(embs);
+ free(items);
+}
+
+static int validate_common(cJSON *root,
+ cJSON *detail,
+ model_kind expected_kind,
+ loaded_model **out_model,
+ int *out_dims,
+ const char **out_encoding,
+ http_server *s) {
+ cJSON *model_item = cJSON_GetObjectItemCaseSensitive(root, "model");
+ const char *model_id = NULL;
+ if (!model_item) {
+ ve_add(detail, "[\"body\",\"model\"]", "field required", "missing");
+ } else if (!cJSON_IsString(model_item) || !model_item->valuestring) {
+ ve_add(detail, "[\"body\",\"model\"]", "model must be a string", "type_error.string");
+ } else {
+ model_id = model_item->valuestring;
+ model_slot slot = model_slot_for_id(model_id);
+ if (slot == MODEL_UNKNOWN || k_models[slot].kind != expected_kind) {
+ ve_add(detail, "[\"body\",\"model\"]",
+ "value is not a valid enum member for this endpoint", "enum");
+ } else {
+ loaded_model *m = &s->models[slot];
+ if (!m->info) {
+ *out_model = NULL;
+ } else {
+ *out_model = m;
+ }
+ }
+ }
+ model_slot slot = model_id ? model_slot_for_id(model_id) : MODEL_UNKNOWN;
+ embedding_api_t api = slot != MODEL_UNKNOWN ? k_models[slot].api : EMBED_API_PERPLEXITY;
+ const char *enc = encoding_from_root(root, detail, api);
+ int min_dim = slot != MODEL_UNKNOWN ? k_models[slot].min_dim : 128;
+ int max_dim = slot != MODEL_UNKNOWN ? k_models[slot].dim : 2560;
+ int dims = dimensions_from_root(root, detail, min_dim, max_dim, enc);
+ *out_encoding = enc;
+ *out_dims = dims;
+ return model_id && model_slot_for_id(model_id) != MODEL_UNKNOWN &&
+ !s->models[model_slot_for_id(model_id)].info
+ ? 503
+ : 0;
+}
+
+static void prepare_embedding_request(job *j, cJSON *root, http_server *s, embedding_request *out) {
+ memset(out, 0, sizeof(*out));
+ out->j = j;
+ out->root = root;
+
+ cJSON *detail = cJSON_CreateArray();
+ loaded_model *m = NULL;
+ int dims = 0;
+ const char *encoding = NULL;
+ int unloaded = validate_common(root, detail, MODEL_KIND_STANDARD, &m, &dims, &encoding, s);
+ out->model = m;
+ out->dims = dims;
+ out->encoding = encoding;
+
+ /* Resolve request behavior from the model registry independent of load
+ * state. The query instruction, when requested, applies to every input. */
+ cJSON *model_item = cJSON_GetObjectItemCaseSensitive(root, "model");
+ model_slot api_slot = (model_item && cJSON_IsString(model_item) && model_item->valuestring)
+ ? model_slot_for_id(model_item->valuestring)
+ : MODEL_UNKNOWN;
+ const char *query_instruct =
+ api_slot != MODEL_UNKNOWN &&
+ text_type_is_query(root, detail, k_models[api_slot].query_instruct)
+ ? k_models[api_slot].query_instruct
+ : NULL;
+
+ cJSON *input = cJSON_GetObjectItemCaseSensitive(root, "input");
+ int n_inputs = 0;
+ if (!input) {
+ ve_add(detail, "[\"body\",\"input\"]", "field required", "missing");
+ } else if (cJSON_IsString(input)) {
+ if (!input->valuestring || input->valuestring[0] == '\0')
+ ve_add(detail, "[\"body\",\"input\"]", "input must not be empty", "value_error.empty");
+ n_inputs = 1;
+ } else if (cJSON_IsArray(input)) {
+ n_inputs = cJSON_GetArraySize(input);
+ if (n_inputs < 1)
+ ve_add(detail, "[\"body\",\"input\"]", "input must contain at least 1 item",
+ "value_error.list.min_items");
+ else if (n_inputs > EMBED_API_MAX_STANDARD_INPUTS)
+ ve_add(detail, "[\"body\",\"input\"]", "input must contain at most 512 items",
+ "value_error.list.max_items");
+ cJSON *item;
+ int i = 0;
+ cJSON_ArrayForEach(item, input) {
+ char loc[64];
+ snprintf(loc, sizeof(loc), "[\"body\",\"input\",%d]", i);
+ if (!cJSON_IsString(item)) {
+ ve_add(detail, loc, "input item must be a string", "type_error.string");
+ } else if (!item->valuestring || item->valuestring[0] == '\0') {
+ ve_add(detail, loc, "input item must not be empty", "value_error.empty");
+ }
+ i++;
+ }
+ } else {
+ ve_add(detail, "[\"body\",\"input\"]", "input must be a string or an array of strings",
+ "type_error");
+ }
+
+ if (cJSON_GetArraySize(detail) == 0 && unloaded) {
+ job_set_error(j, 503, "requested model is valid but not loaded", "model_not_loaded");
+ cJSON_Delete(detail);
+ return;
+ }
+
+ if (cJSON_GetArraySize(detail) == 0 && m && input) {
+ out->n_inputs = n_inputs;
+ out->tokens = xcalloc((size_t)n_inputs, sizeof(*out->tokens));
+ out->inputs = xmalloc((size_t)n_inputs * sizeof(*out->inputs));
+
+ int idx = 0;
+ if (input && cJSON_IsString(input) && input->valuestring) {
+ if (tokenize_input(m, j, input->valuestring, query_instruct, &out->tokens[0]) != 0) {
+ ve_add(detail, "[\"body\",\"input\"]", "tokenization failed",
+ "value_error.tokenization");
+ } else {
+ out->inputs[0].ids = out->tokens[0].ids;
+ out->inputs[0].n_tokens = out->tokens[0].n_tokens;
+ out->total_tokens = out->tokens[0].n_tokens;
+ if (out->tokens[0].n_tokens > EMBED_API_MAX_ITEM_TOKENS)
+ ve_add(detail, "[\"body\",\"input\"]", "input exceeds 32768 token limit",
+ "value_error.context_length");
+ }
+ } else {
+ cJSON *item;
+ cJSON_ArrayForEach(item, input) {
+ char loc[64];
+ snprintf(loc, sizeof(loc), "[\"body\",\"input\",%d]", idx);
+ if (!cJSON_IsString(item) || !item->valuestring) {
+ ve_add(detail, loc, "input item must be a string", "type_error.string");
+ idx++;
+ continue;
+ }
+ if (tokenize_input(m, j, item->valuestring, query_instruct, &out->tokens[idx]) !=
+ 0) {
+ ve_add(detail, loc, "tokenization failed", "value_error.tokenization");
+ } else {
+ out->inputs[idx].ids = out->tokens[idx].ids;
+ out->inputs[idx].n_tokens = out->tokens[idx].n_tokens;
+ out->total_tokens += out->tokens[idx].n_tokens;
+ if (out->tokens[idx].n_tokens > EMBED_API_MAX_ITEM_TOKENS)
+ ve_add(detail, loc, "input exceeds 32768 token limit",
+ "value_error.context_length");
+ }
+ idx++;
+ }
+ }
+
+ if (out->total_tokens > EMBED_API_MAX_TOTAL_TOKENS)
+ ve_add(detail, "[\"body\",\"input\"]", "request exceeds 120000 token limit",
+ "value_error.context_length");
+ }
+
+ if (cJSON_GetArraySize(detail) > 0) {
+ job_set_422(j, detail);
+ embedding_request_free(out);
+ out->j = j;
+ } else {
+ out->ready = 1;
+ }
+ cJSON_Delete(detail);
+}
+
+static void
+prepare_contextual_request(job *j, cJSON *root, http_server *s, contextual_request *out) {
+ memset(out, 0, sizeof(*out));
+ out->j = j;
+ out->root = root;
+
+ cJSON *detail = cJSON_CreateArray();
+ loaded_model *m = NULL;
+ int dims = 0;
+ const char *encoding = NULL;
+ int unloaded = validate_common(root, detail, MODEL_KIND_CONTEXTUAL, &m, &dims, &encoding, s);
+ out->model = m;
+ out->dims = dims;
+ out->encoding = encoding;
+
+ cJSON *input = cJSON_GetObjectItemCaseSensitive(root, "input");
+ int n_docs = 0;
+ int total_chunks = 0;
+ if (!input) {
+ ve_add(detail, "[\"body\",\"input\"]", "field required", "missing");
+ } else if (!cJSON_IsArray(input)) {
+ ve_add(detail, "[\"body\",\"input\"]", "input must be an array of document chunk arrays",
+ "type_error.array");
+ } else {
+ n_docs = cJSON_GetArraySize(input);
+ if (n_docs < 1)
+ ve_add(detail, "[\"body\",\"input\"]", "input must contain at least 1 document",
+ "value_error.list.min_items");
+ else if (n_docs > EMBED_API_MAX_CONTEXT_DOCS)
+ ve_add(detail, "[\"body\",\"input\"]", "input must contain at most 512 documents",
+ "value_error.list.max_items");
+ cJSON *doc_arr;
+ int di = 0;
+ cJSON_ArrayForEach(doc_arr, input) {
+ if (!cJSON_IsArray(doc_arr)) {
+ char loc[64];
+ snprintf(loc, sizeof(loc), "[\"body\",\"input\",%d]", di);
+ ve_add(detail, loc, "document must be an array of strings", "type_error.array");
+ di++;
+ continue;
+ }
+ int doc_chunks = cJSON_GetArraySize(doc_arr);
+ if (doc_chunks > EMBED_API_MAX_CONTEXT_CHUNKS - total_chunks)
+ total_chunks = EMBED_API_MAX_CONTEXT_CHUNKS + 1;
+ else
+ total_chunks += doc_chunks;
+ if (doc_chunks < 1) {
+ char loc[64];
+ snprintf(loc, sizeof(loc), "[\"body\",\"input\",%d]", di);
+ ve_add(detail, loc, "document must contain at least 1 chunk",
+ "value_error.list.min_items");
+ }
+ cJSON *chunk;
+ int ci = 0;
+ cJSON_ArrayForEach(chunk, doc_arr) {
+ char loc[80];
+ snprintf(loc, sizeof(loc), "[\"body\",\"input\",%d,%d]", di, ci);
+ if (!cJSON_IsString(chunk)) {
+ ve_add(detail, loc, "chunk must be a string", "type_error.string");
+ } else if (!chunk->valuestring || chunk->valuestring[0] == '\0') {
+ ve_add(detail, loc, "chunk must not be empty", "value_error.empty");
+ }
+ ci++;
+ }
+ di++;
+ }
+ if (total_chunks > EMBED_API_MAX_CONTEXT_CHUNKS)
+ ve_add(detail, "[\"body\",\"input\"]", "input must contain at most 16000 chunks",
+ "value_error.list.max_items");
+ }
+
+ if (cJSON_GetArraySize(detail) == 0 && unloaded) {
+ job_set_error(j, 503, "requested model is valid but not loaded", "model_not_loaded");
+ cJSON_Delete(detail);
+ return;
+ }
+
+ if (cJSON_GetArraySize(detail) == 0 && m) {
+ out->n_docs = n_docs;
+ out->docs = xcalloc((size_t)n_docs, sizeof(*out->docs));
+ int64_t request_tokens = 0;
+ cJSON *doc_arr;
+ int di = 0;
+ cJSON_ArrayForEach(doc_arr, input) {
+ contextual_doc *doc = &out->docs[di];
+ int n_chunks = cJSON_GetArraySize(doc_arr);
+ token_buf *chunk_tokens = xcalloc((size_t)n_chunks, sizeof(*chunk_tokens));
+ doc->spans = xcalloc((size_t)n_chunks, sizeof(*doc->spans));
+ doc->n_spans = n_chunks;
+ int64_t doc_tokens = n_chunks > 1 ? n_chunks - 1 : 0;
+ int doc_valid = 1;
+
+ cJSON *chunk;
+ int ci = 0;
+ cJSON_ArrayForEach(chunk, doc_arr) {
+ char loc[80];
+ snprintf(loc, sizeof(loc), "[\"body\",\"input\",%d,%d]", di, ci);
+ if (tokenize_one(m, j, chunk->valuestring, &chunk_tokens[ci]) != 0) {
+ ve_add(detail, loc, "tokenization failed", "value_error.tokenization");
+ doc_valid = 0;
+ } else {
+ doc_tokens += chunk_tokens[ci].n_tokens;
+ }
+ ci++;
+ }
+
+ if (doc_tokens > EMBED_API_MAX_ITEM_TOKENS) {
+ char loc[64];
+ snprintf(loc, sizeof(loc), "[\"body\",\"input\",%d]", di);
+ ve_add(detail, loc, "document exceeds 32768 token limit",
+ "value_error.context_length");
+ doc_valid = 0;
+ }
+ request_tokens += doc_tokens;
+
+ if (doc_valid) {
+ doc->n_tokens = (int)doc_tokens;
+ doc->ids = xmalloc((size_t)doc->n_tokens * sizeof(*doc->ids));
+ int pos = 0;
+ for (ci = 0; ci < n_chunks; ci++) {
+ doc->spans[ci].start = pos;
+ doc->spans[ci].n_tokens = chunk_tokens[ci].n_tokens;
+ /* n_tokens > 0 implies ids != NULL (tokenize_one sets both
+ * together), and the guard avoids a memcpy(dst, NULL, 0) for
+ * an empty chunk that the static analyzer reports as UB. */
+ if (chunk_tokens[ci].n_tokens > 0)
+ memcpy(doc->ids + pos, chunk_tokens[ci].ids,
+ (size_t)chunk_tokens[ci].n_tokens * sizeof(*doc->ids));
+ pos += chunk_tokens[ci].n_tokens;
+ if (ci + 1 < n_chunks) {
+ doc->ids[pos++] = m->context_separator_id;
+ }
+ }
+ }
+ free_token_bufs(chunk_tokens, n_chunks);
+ free(chunk_tokens);
+ di++;
+ }
+ if (request_tokens > EMBED_API_MAX_TOTAL_TOKENS) {
+ ve_add(detail, "[\"body\",\"input\"]", "request exceeds 120000 token limit",
+ "value_error.context_length");
+ } else {
+ out->total_tokens = (int)request_tokens;
+ out->total_chunks = total_chunks;
+ }
+ }
+
+ if (cJSON_GetArraySize(detail) > 0) {
+ job_set_422(j, detail);
+ contextual_request_free(out);
+ out->j = j;
+ } else {
+ out->ready = 1;
+ }
+ cJSON_Delete(detail);
+}
+
+static int
+validate_rerank_model(cJSON *root, cJSON *detail, http_server *s, loaded_model **out_model) {
+ cJSON *item = cJSON_GetObjectItemCaseSensitive(root, "model");
+ if (!item) {
+ ve_add(detail, "[\"body\",\"model\"]", "field required", "missing");
+ return 0;
+ }
+ if (!cJSON_IsString(item) || !item->valuestring) {
+ ve_add(detail, "[\"body\",\"model\"]", "model must be a string", "type_error.string");
+ return 0;
+ }
+ model_slot slot = model_slot_for_id(item->valuestring);
+ if (slot == MODEL_UNKNOWN || k_models[slot].kind != MODEL_KIND_LATE) {
+ ve_add(detail, "[\"body\",\"model\"]", "value is not a valid enum member for this endpoint",
+ "enum");
+ return 0;
+ }
+ *out_model = s->models[slot].info ? &s->models[slot] : NULL;
+ return *out_model ? 0 : 503;
+}
+
+static void prepare_rerank_request(job *j, cJSON *root, http_server *s, rerank_request *out) {
+ memset(out, 0, sizeof(*out));
+ out->j = j;
+ out->root = root;
+
+ cJSON *detail = cJSON_CreateArray();
+ int unloaded = validate_rerank_model(root, detail, s, &out->model);
+ cJSON *query = cJSON_GetObjectItemCaseSensitive(root, "query");
+ cJSON *documents = cJSON_GetObjectItemCaseSensitive(root, "documents");
+ if (!query) {
+ ve_add(detail, "[\"body\",\"query\"]", "field required", "missing");
+ } else if (!cJSON_IsString(query)) {
+ ve_add(detail, "[\"body\",\"query\"]", "query must be a string", "type_error.string");
+ } else if (!query->valuestring || !query->valuestring[0]) {
+ ve_add(detail, "[\"body\",\"query\"]", "query must not be empty", "value_error.empty");
+ }
+
+ int n_documents = 0;
+ if (!documents) {
+ ve_add(detail, "[\"body\",\"documents\"]", "field required", "missing");
+ } else if (!cJSON_IsArray(documents)) {
+ ve_add(detail, "[\"body\",\"documents\"]", "documents must be an array of strings",
+ "type_error.array");
+ } else {
+ n_documents = cJSON_GetArraySize(documents);
+ if (n_documents < 1)
+ ve_add(detail, "[\"body\",\"documents\"]", "documents must contain at least 1 item",
+ "value_error.list.min_items");
+ else if (n_documents > EMBED_API_MAX_RERANK_DOCUMENTS)
+ ve_add(detail, "[\"body\",\"documents\"]", "documents must contain at most 1000 items",
+ "value_error.list.max_items");
+ cJSON *document;
+ int i = 0;
+ cJSON_ArrayForEach(document, documents) {
+ char loc[72];
+ snprintf(loc, sizeof(loc), "[\"body\",\"documents\",%d]", i++);
+ if (!cJSON_IsString(document))
+ ve_add(detail, loc, "document must be a string", "type_error.string");
+ else if (!document->valuestring || !document->valuestring[0])
+ ve_add(detail, loc, "document must not be empty", "value_error.empty");
+ }
+ }
+
+ cJSON *top_n = cJSON_GetObjectItemCaseSensitive(root, "top_n");
+ cJSON *top_k = cJSON_GetObjectItemCaseSensitive(root, "top_k");
+ if (top_n && top_k) {
+ ve_add(detail, "[\"body\",\"top_n\"]", "top_n and top_k are aliases; provide only one",
+ "value_error.conflict");
+ }
+ cJSON *top = top_n ? top_n : top_k;
+ out->top_n = n_documents;
+ if (top) {
+ if (!cjson_is_integer(top)) {
+ ve_add(detail, top_n ? "[\"body\",\"top_n\"]" : "[\"body\",\"top_k\"]",
+ "top_n must be an integer", "type_error.integer");
+ } else {
+ out->top_n = top->valueint;
+ if (out->top_n < 1 || out->top_n > n_documents)
+ ve_add(detail, top_n ? "[\"body\",\"top_n\"]" : "[\"body\",\"top_k\"]",
+ "top_n must be between 1 and the number of documents", "value_error.range");
+ }
+ }
+
+ cJSON *return_documents = cJSON_GetObjectItemCaseSensitive(root, "return_documents");
+ if (return_documents) {
+ if (!cJSON_IsBool(return_documents))
+ ve_add(detail, "[\"body\",\"return_documents\"]", "return_documents must be a boolean",
+ "type_error.bool");
+ else
+ out->return_documents = cJSON_IsTrue(return_documents);
+ }
+
+ if (cJSON_GetArraySize(detail) == 0 && unloaded) {
+ job_set_error(j, 503, "requested model is valid but not loaded", "model_not_loaded");
+ cJSON_Delete(detail);
+ return;
+ }
+
+ if (cJSON_GetArraySize(detail) == 0 && out->model) {
+ out->n_documents = n_documents;
+ out->documents = xcalloc((size_t)n_documents, sizeof(*out->documents));
+ if (tokenize_late_text(out->model, j, query->valuestring, 1, &out->query) != 0) {
+ ve_add(detail, "[\"body\",\"query\"]", "tokenization failed",
+ "value_error.tokenization");
+ } else {
+ out->query_tokens = out->query.n_tokens;
+ if (out->query_tokens > EMBED_API_MAX_ITEM_TOKENS)
+ ve_add(detail, "[\"body\",\"query\"]", "query exceeds 32768 token limit",
+ "value_error.context_length");
+ }
+
+ cJSON *document;
+ int i = 0;
+ cJSON_ArrayForEach(document, documents) {
+ char loc[72];
+ snprintf(loc, sizeof(loc), "[\"body\",\"documents\",%d]", i);
+ if (tokenize_late_text(out->model, j, document->valuestring, 0, &out->documents[i]) !=
+ 0) {
+ ve_add(detail, loc, "tokenization failed", "value_error.tokenization");
+ } else {
+ int n = out->documents[i].n_tokens;
+ if (n > EMBED_API_MAX_ITEM_TOKENS)
+ ve_add(detail, loc, "document exceeds 32768 token limit",
+ "value_error.context_length");
+ if (out->document_tokens <= INT_MAX - n)
+ out->document_tokens += n;
+ else
+ out->document_tokens = INT_MAX;
+ }
+ i++;
+ }
+ if (out->query_tokens > EMBED_API_MAX_TOTAL_TOKENS - out->document_tokens) {
+ ve_add(detail, "[\"body\",\"documents\"]", "request exceeds 120000 token limit",
+ "value_error.context_length");
+ }
+ }
+
+ if (cJSON_GetArraySize(detail) > 0) {
+ job_set_422(j, detail);
+ rerank_request_free(out);
+ out->j = j;
+ } else {
+ out->ready = 1;
+ }
+ cJSON_Delete(detail);
+}
+
+typedef struct {
+ int index;
+ float score;
+} rerank_result;
+
+static int rerank_result_cmp(const void *a, const void *b) {
+ const rerank_result *ra = a;
+ const rerank_result *rb = b;
+ if (ra->score > rb->score)
+ return -1;
+ if (ra->score < rb->score)
+ return 1;
+ return ra->index - rb->index;
+}
+
+static int execute_rerank_cpu(rerank_request *r, float *scores) {
+ loaded_model *m = r->model;
+ int dim = m->info->token_dim;
+ int total_doc_vecs = 0;
+ for (int i = 0; i < r->n_documents; i++)
+ total_doc_vecs += r->documents[i].n_keep;
+
+ float *query = xmalloc((size_t)r->query.n_tokens * dim * sizeof(*query));
+ float *docs = xmalloc((size_t)total_doc_vecs * dim * sizeof(*docs));
+ int *offsets = xmalloc((size_t)(r->n_documents + 1) * sizeof(*offsets));
+
+ /* Encode every candidate in one block-diagonal forward. The encoder packs
+ * each document's kept token vectors back-to-back and fills offsets, so the
+ * cost of N short documents collapses to a single packed forward. */
+ const int **doc_ids = xmalloc((size_t)r->n_documents * sizeof(*doc_ids));
+ const int **keep = xmalloc((size_t)r->n_documents * sizeof(*keep));
+ int *n_tokens = xmalloc((size_t)r->n_documents * sizeof(*n_tokens));
+ int *n_keep = xmalloc((size_t)r->n_documents * sizeof(*n_keep));
+ for (int i = 0; i < r->n_documents; i++) {
+ doc_ids[i] = r->documents[i].ids;
+ keep[i] = r->documents[i].keep;
+ n_tokens[i] = r->documents[i].n_tokens;
+ n_keep[i] = r->documents[i].n_keep;
+ }
+
+ int rc = embed_late_model_encode_tokens(m->cpu_late_model, m->cpu_late_ws, r->query.ids,
+ r->query.n_tokens, 1, query);
+ if (rc == 0)
+ rc = embed_late_model_encode_docs(m->cpu_late_model, m->cpu_late_ws, doc_ids, n_tokens,
+ keep, n_keep, r->n_documents, 1, docs, offsets);
+ if (rc == 0)
+ rc = embed_late_maxsim_batch(query, r->query.n_keep, docs, offsets, r->n_documents, dim,
+ scores);
+ free(n_keep);
+ free(n_tokens);
+ free(keep);
+ free(doc_ids);
+ free(offsets);
+ free(docs);
+ free(query);
+ return rc;
+}
+
+#ifdef USE_MLX
+static int execute_rerank_mlx(rerank_request *r, float *scores) {
+ loaded_model *m = r->model;
+ embed_mlx_late_vectors_t *query =
+ embed_mlx_late_encode_tokens_device(m->mlx_late_ctx, r->query.ids, r->query.n_tokens, 1);
+
+ /* Encode every candidate in one padded transformer pass. The encoder packs
+ * each document's kept token vectors back-to-back and fills offsets, so the
+ * cost of N short documents collapses to a single batched forward. */
+ const int **doc_ids = xmalloc((size_t)r->n_documents * sizeof(*doc_ids));
+ const int **keep = xmalloc((size_t)r->n_documents * sizeof(*keep));
+ int *n_tokens = xmalloc((size_t)r->n_documents * sizeof(*n_tokens));
+ int *n_keep = xmalloc((size_t)r->n_documents * sizeof(*n_keep));
+ int *offsets = xmalloc((size_t)(r->n_documents + 1) * sizeof(*offsets));
+ for (int i = 0; i < r->n_documents; i++) {
+ doc_ids[i] = r->documents[i].ids;
+ keep[i] = r->documents[i].keep;
+ n_tokens[i] = r->documents[i].n_tokens;
+ n_keep[i] = r->documents[i].n_keep;
+ }
+ embed_mlx_late_vectors_t *packed =
+ query ? embed_mlx_late_encode_docs_device(m->mlx_late_ctx, doc_ids, n_tokens, keep, n_keep,
+ r->n_documents, 1, offsets)
+ : NULL;
+ int rc = packed ? embed_mlx_late_maxsim_batch_device(m->mlx_late_ctx, query, packed, offsets,
+ r->n_documents, scores)
+ : -1;
+ embed_mlx_late_vectors_free(packed);
+ embed_mlx_late_vectors_free(query);
+ free(offsets);
+ free(n_keep);
+ free(n_tokens);
+ free(keep);
+ free(doc_ids);
+ return rc;
+}
+#endif
+
+#ifdef USE_CUDA
+static int execute_rerank_cuda(rerank_request *r, float *scores) {
+ loaded_model *m = r->model;
+ int dim = m->info->token_dim;
+ int total_doc_vecs = 0;
+ for (int i = 0; i < r->n_documents; i++)
+ total_doc_vecs += r->documents[i].n_keep;
+
+ float *query = xmalloc((size_t)r->query.n_tokens * dim * sizeof(*query));
+ float *docs = xmalloc((size_t)total_doc_vecs * dim * sizeof(*docs));
+ int *offsets = xmalloc((size_t)(r->n_documents + 1) * sizeof(*offsets));
+
+ /* GPU encodes the query and every candidate (one packed forward); MaxSim
+ * runs on the host, where the grouped-GEMM scorer beats a device graph. */
+ const int **doc_ids = xmalloc((size_t)r->n_documents * sizeof(*doc_ids));
+ const int **keep = xmalloc((size_t)r->n_documents * sizeof(*keep));
+ int *n_tokens = xmalloc((size_t)r->n_documents * sizeof(*n_tokens));
+ int *n_keep = xmalloc((size_t)r->n_documents * sizeof(*n_keep));
+ for (int i = 0; i < r->n_documents; i++) {
+ doc_ids[i] = r->documents[i].ids;
+ keep[i] = r->documents[i].keep;
+ n_tokens[i] = r->documents[i].n_tokens;
+ n_keep[i] = r->documents[i].n_keep;
+ }
+
+ int rc =
+ embed_cuda_late_encode_tokens(m->cuda_late_ctx, r->query.ids, r->query.n_tokens, 1, query);
+ if (rc == 0)
+ rc = embed_cuda_late_encode_docs(m->cuda_late_ctx, doc_ids, n_tokens, keep, n_keep,
+ r->n_documents, 1, docs, offsets);
+ if (rc == 0)
+ rc = embed_late_maxsim_batch(query, r->query.n_keep, docs, offsets, r->n_documents, dim,
+ scores);
+ free(n_keep);
+ free(n_tokens);
+ free(keep);
+ free(doc_ids);
+ free(offsets);
+ free(docs);
+ free(query);
+ return rc;
+}
+#endif
+
+static void execute_rerank_request(rerank_request *r) {
+ if (!r || !r->model) {
+ if (r && r->j)
+ job_set_error(r->j, 500, "late-interaction model is unavailable", "server_error");
+ return;
+ }
+ float *scores = xmalloc((size_t)r->n_documents * sizeof(*scores));
+ uint64_t t0 = nstime();
+#if defined(USE_MLX)
+ int rc = r->model->mlx_late_ctx ? execute_rerank_mlx(r, scores) : execute_rerank_cpu(r, scores);
+#elif defined(USE_CUDA)
+ int rc =
+ r->model->cuda_late_ctx ? execute_rerank_cuda(r, scores) : execute_rerank_cpu(r, scores);
+#else
+ int rc = execute_rerank_cpu(r, scores);
+#endif
+ r->j->infer_ns += nstime() - t0;
+ if (rc != 0) {
+ free(scores);
+ job_set_error(r->j, 500, "late-interaction reranking failed", "server_error");
+ return;
+ }
+
+ rerank_result *ranked = xmalloc((size_t)r->n_documents * sizeof(*ranked));
+ for (int i = 0; i < r->n_documents; i++) {
+ ranked[i].index = i;
+ ranked[i].score = scores[i];
+ }
+ qsort(ranked, (size_t)r->n_documents, sizeof(*ranked), rerank_result_cmp);
+
+ t0 = nstime();
+ sbuf b = {0};
+ sbuf_printf(&b, "{\"object\":\"list\",\"model\":\"%s\",\"results\":[", r->model->info->id);
+ cJSON *documents = cJSON_GetObjectItemCaseSensitive(r->root, "documents");
+ for (int i = 0; i < r->top_n; i++) {
+ if (i)
+ sbuf_putc(&b, ',');
+ sbuf_printf(&b, "{\"index\":%d,\"relevance_score\":%.9g", ranked[i].index,
+ (double)ranked[i].score);
+ if (r->return_documents) {
+ cJSON *document = cJSON_GetArrayItem(documents, ranked[i].index);
+ sbuf_puts(&b, ",\"document\":");
+ append_json_string(&b, document->valuestring);
+ }
+ sbuf_putc(&b, '}');
+ }
+ sbuf_printf(&b,
+ "],\"usage\":{\"query_tokens\":%d,\"document_tokens\":%d,"
+ "\"total_tokens\":%d}}",
+ r->query_tokens, r->document_tokens, r->query_tokens + r->document_tokens);
+ set_response_from_buf(r->j, &b);
+ r->j->encode_ns += nstime() - t0;
+ free(ranked);
+ free(scores);
+}
+
+static int parse_job_root(job *j, cJSON **out_root) {
+ cJSON *detail = cJSON_CreateArray();
+ cJSON *root = parse_json_body(j, detail);
+ if (!root) {
+ job_set_422(j, detail);
+ cJSON_Delete(detail);
+ *out_root = NULL;
+ return -1;
+ }
+ cJSON_Delete(detail);
+ *out_root = root;
+ return 0;
+}
+
+static void process_unknown_job(job *j) {
+ cJSON *root = NULL;
+ if (!j->started_ns)
+ j->started_ns = nstime();
+ uint64_t t0 = nstime();
+ int rc = parse_job_root(j, &root);
+ j->parse_ns += nstime() - t0;
+ if (rc != 0)
+ return;
+ job_set_error(j, 404, "unknown endpoint", "invalid_request_error");
+ cJSON_Delete(root);
+}
+
+static void process_job_group(http_server *s, job **jobs, int n_jobs) {
+ embedding_request *std_reqs = xcalloc((size_t)n_jobs, sizeof(*std_reqs));
+ contextual_request *ctx_reqs = xcalloc((size_t)n_jobs, sizeof(*ctx_reqs));
+ rerank_request *rerank_reqs = xcalloc((size_t)n_jobs, sizeof(*rerank_reqs));
+ int *kind = xcalloc((size_t)n_jobs, sizeof(*kind));
+ int *done = xcalloc((size_t)n_jobs, sizeof(*done));
+ embedding_request **std_group = xmalloc((size_t)n_jobs * sizeof(*std_group));
+ contextual_request **ctx_group = xmalloc((size_t)n_jobs * sizeof(*ctx_group));
+
+ for (int i = 0; i < n_jobs; i++) {
+ cJSON *root = NULL;
+ if (!jobs[i]->started_ns)
+ jobs[i]->started_ns = nstime();
+ if (!strcmp(jobs[i]->path, "/v1/embeddings")) {
+ kind[i] = 1;
+ } else if (!strcmp(jobs[i]->path, "/v1/contextualizedembeddings")) {
+ kind[i] = 2;
+ } else if (!strcmp(jobs[i]->path, "/v1/rerank")) {
+ kind[i] = 3;
+ } else {
+ continue;
+ }
+ uint64_t t0 = nstime();
+ int parse_rc = parse_job_root(jobs[i], &root);
+ jobs[i]->parse_ns += nstime() - t0;
+ if (parse_rc != 0)
+ continue;
+ if (kind[i] == 1)
+ prepare_embedding_request(jobs[i], root, s, &std_reqs[i]);
+ else if (kind[i] == 2)
+ prepare_contextual_request(jobs[i], root, s, &ctx_reqs[i]);
+ else
+ prepare_rerank_request(jobs[i], root, s, &rerank_reqs[i]);
+ }
+
+ for (int i = 0; i < n_jobs; i++) {
+ if (done[i])
+ continue;
+
+ if (!kind[i]) {
+ process_unknown_job(jobs[i]);
+ job_set_timing_header(jobs[i]);
+ enqueue_done(jobs[i]);
+ done[i] = 1;
+ continue;
+ }
+
+ if ((kind[i] == 1 && !std_reqs[i].ready) || (kind[i] == 2 && !ctx_reqs[i].ready) ||
+ (kind[i] == 3 && !rerank_reqs[i].ready)) {
+ job_set_timing_header(jobs[i]);
+ enqueue_done(jobs[i]);
+ done[i] = 1;
+ continue;
+ }
+
+ if (kind[i] == 3) {
+ execute_rerank_request(&rerank_reqs[i]);
+ job_set_timing_header(jobs[i]);
+ enqueue_done(jobs[i]);
+ done[i] = 1;
+ } else if (kind[i] == 1) {
+ int group_n = 1;
+ int group_inputs = std_reqs[i].n_inputs;
+ int group_tokens = std_reqs[i].total_tokens;
+ std_group[0] = &std_reqs[i];
+ for (int k = i + 1; k < n_jobs; k++) {
+ if (!done[k] && kind[k] == 1 && std_reqs[k].ready &&
+ embedding_request_compatible(&std_reqs[i], &std_reqs[k]) &&
+ embedding_request_fits_group(&std_reqs[k], group_inputs, group_tokens,
+ s->batch_size, s->max_batch_tokens)) {
+ std_group[group_n++] = &std_reqs[k];
+ group_inputs += std_reqs[k].n_inputs;
+ group_tokens += std_reqs[k].total_tokens;
+ }
+ }
+ execute_embedding_request_list(std_group, group_n);
+ for (int k = 0; k < group_n; k++) {
+ int idx = (int)(std_group[k] - std_reqs);
+ job_set_timing_header(jobs[idx]);
+ enqueue_done(jobs[idx]);
+ done[idx] = 1;
+ }
+ } else {
+ int group_n = 1;
+ int group_docs = ctx_reqs[i].n_docs;
+ int group_tokens = ctx_reqs[i].total_tokens;
+ ctx_group[0] = &ctx_reqs[i];
+ for (int k = i + 1; k < n_jobs; k++) {
+ if (!done[k] && kind[k] == 2 && ctx_reqs[k].ready &&
+ contextual_request_compatible(&ctx_reqs[i], &ctx_reqs[k]) &&
+ contextual_request_fits_group(&ctx_reqs[k], group_docs, group_tokens,
+ s->batch_size, s->max_batch_tokens)) {
+ ctx_group[group_n++] = &ctx_reqs[k];
+ group_docs += ctx_reqs[k].n_docs;
+ group_tokens += ctx_reqs[k].total_tokens;
+ }
+ }
+ execute_contextual_request_list(ctx_group, group_n);
+ for (int k = 0; k < group_n; k++) {
+ int idx = (int)(ctx_group[k] - ctx_reqs);
+ job_set_timing_header(jobs[idx]);
+ enqueue_done(jobs[idx]);
+ done[idx] = 1;
+ }
+ }
+ }
+
+ for (int i = 0; i < n_jobs; i++) {
+ embedding_request_free(&std_reqs[i]);
+ contextual_request_free(&ctx_reqs[i]);
+ rerank_request_free(&rerank_reqs[i]);
+ }
+ free(ctx_group);
+ free(std_group);
+ free(done);
+ free(kind);
+ free(rerank_reqs);
+ free(ctx_reqs);
+ free(std_reqs);
+}
+
+static int configure_loaded_model(loaded_model *m, const embed_config_t *config, int token_dim) {
+ if (!m || !m->info || !config || config->hidden_size != m->info->dim ||
+ token_dim != m->info->token_dim || config->attention_mode != m->info->attention_mode ||
+ config->pooling_mode != m->info->pooling_mode ||
+ config->normalize_embeddings != m->info->normalize_embeddings) {
+ if (m && m->info && config)
+ server_log("embed-server: model %s has incompatible config", m->info->id);
+ return -1;
+ }
+ m->append_terminal_token = config->append_terminal_token;
+ /* m->terminal_token_id is resolved from the tokenizer in load_one_model. */
+ m->renormalize_truncated =
+ config->normalize_embeddings && config->pooling_mode == EMBED_POOL_LAST_TOKEN;
+ return 0;
+}
+
+static void *worker_main(void *arg) {
+ http_server *s = arg;
+#ifdef USE_MLX
+ if (s->use_mlx) {
+ int rc = 0;
+ for (int i = 0; i < MODEL_COUNT; i++) {
+ loaded_model *m = &s->models[i];
+ if (!m->info)
+ continue;
+ embed_mlx_options_t mlx_opts = {
+ .quantize_bits = s->mlx_quantize_bits,
+ .quantize_group_size = s->mlx_quantize_group_size,
+ };
+ if (m->info->kind == MODEL_KIND_LATE)
+ m->mlx_late_ctx = embed_mlx_late_load_with_options(m->path, &mlx_opts);
+ else
+ m->mlx_ctx = embed_mlx_load_with_options(m->path, &mlx_opts);
+ if ((!m->mlx_ctx && m->info->kind != MODEL_KIND_LATE) ||
+ (!m->mlx_late_ctx && m->info->kind == MODEL_KIND_LATE)) {
+ server_log("embed-server: failed to load MLX model on worker: %s", m->path);
+ rc = 1;
+ break;
+ }
+ const embed_config_t *config = m->info->kind == MODEL_KIND_LATE
+ ? embed_mlx_late_config(m->mlx_late_ctx)
+ : embed_mlx_config(m->mlx_ctx);
+ int token_dim =
+ m->info->kind == MODEL_KIND_LATE ? embed_mlx_late_token_dim(m->mlx_late_ctx) : 0;
+ if (configure_loaded_model(m, config, token_dim) != 0 ||
+ (m->info->kind == MODEL_KIND_LATE &&
+ (m->late_mask_id >= config->vocab_size ||
+ m->late_query_prefix_id >= config->vocab_size ||
+ m->late_document_prefix_id >= config->vocab_size))) {
+ rc = 1;
+ break;
+ }
+ }
+ pthread_mutex_lock(&s->mu);
+ s->worker_init_rc = rc;
+ s->worker_ready = 1;
+ if (rc)
+ s->stopping = 1;
+ pthread_cond_broadcast(&s->cv);
+ pthread_mutex_unlock(&s->mu);
+ if (rc) {
+ for (int i = 0; i < MODEL_COUNT; i++) {
+ loaded_model *m = &s->models[i];
+ if (m->mlx_ctx) {
+ embed_mlx_free(m->mlx_ctx);
+ m->mlx_ctx = NULL;
+ }
+ if (m->mlx_late_ctx) {
+ embed_mlx_late_free(m->mlx_late_ctx);
+ m->mlx_late_ctx = NULL;
+ }
+ }
+ return NULL;
+ }
+ } else
+#endif
+#ifdef USE_CUDA
+ if (s->use_cuda) {
+ int rc = 0;
+ for (int i = 0; i < MODEL_COUNT; i++) {
+ loaded_model *m = &s->models[i];
+ if (!m->info)
+ continue;
+ if (m->info->kind == MODEL_KIND_LATE)
+ m->cuda_late_ctx = embed_cuda_late_load(m->path);
+ else
+ m->cuda_ctx = embed_cuda_load(m->path);
+ if ((!m->cuda_ctx && m->info->kind != MODEL_KIND_LATE) ||
+ (!m->cuda_late_ctx && m->info->kind == MODEL_KIND_LATE)) {
+ server_log("embed-server: failed to load CUDA model on worker: %s", m->path);
+ rc = 1;
+ break;
+ }
+ const embed_config_t *config = m->info->kind == MODEL_KIND_LATE
+ ? embed_cuda_late_config(m->cuda_late_ctx)
+ : embed_cuda_config(m->cuda_ctx);
+ int token_dim =
+ m->info->kind == MODEL_KIND_LATE ? embed_cuda_late_token_dim(m->cuda_late_ctx) : 0;
+ if (configure_loaded_model(m, config, token_dim) != 0 ||
+ (m->info->kind == MODEL_KIND_LATE &&
+ (m->late_mask_id >= config->vocab_size ||
+ m->late_query_prefix_id >= config->vocab_size ||
+ m->late_document_prefix_id >= config->vocab_size))) {
+ rc = 1;
+ break;
+ }
+ }
+ pthread_mutex_lock(&s->mu);
+ s->worker_init_rc = rc;
+ s->worker_ready = 1;
+ if (rc)
+ s->stopping = 1;
+ pthread_cond_broadcast(&s->cv);
+ pthread_mutex_unlock(&s->mu);
+ if (rc) {
+ for (int i = 0; i < MODEL_COUNT; i++) {
+ loaded_model *m = &s->models[i];
+ if (m->cuda_ctx) {
+ embed_cuda_free(m->cuda_ctx);
+ m->cuda_ctx = NULL;
+ }
+ if (m->cuda_late_ctx) {
+ embed_cuda_late_free(m->cuda_late_ctx);
+ m->cuda_late_ctx = NULL;
+ }
+ }
+ return NULL;
+ }
+ } else
+#endif
+ {
+ pthread_mutex_lock(&s->mu);
+ s->worker_ready = 1;
+ pthread_cond_broadcast(&s->cv);
+ pthread_mutex_unlock(&s->mu);
+ }
+
+ for (;;) {
+ job *jobs[EMBED_SERVER_MICROBATCH_MAX_JOBS];
+ int n_jobs = collect_job_batch(s, jobs, EMBED_SERVER_MICROBATCH_MAX_JOBS);
+ if (n_jobs == 0)
+ break;
+ process_job_group(s, jobs, n_jobs);
+ }
+#ifdef USE_MLX
+ if (s->use_mlx) {
+ for (int i = 0; i < MODEL_COUNT; i++) {
+ loaded_model *m = &s->models[i];
+ if (m->mlx_ctx) {
+ embed_mlx_free(m->mlx_ctx);
+ m->mlx_ctx = NULL;
+ }
+ if (m->mlx_late_ctx) {
+ embed_mlx_late_free(m->mlx_late_ctx);
+ m->mlx_late_ctx = NULL;
+ }
+ }
+ }
+#endif
+#ifdef USE_CUDA
+ if (s->use_cuda) {
+ for (int i = 0; i < MODEL_COUNT; i++) {
+ loaded_model *m = &s->models[i];
+ if (m->cuda_ctx) {
+ embed_cuda_free(m->cuda_ctx);
+ m->cuda_ctx = NULL;
+ }
+ if (m->cuda_late_ctx) {
+ embed_cuda_late_free(m->cuda_late_ctx);
+ m->cuda_late_ctx = NULL;
+ }
+ }
+ }
+#endif
+ return NULL;
+}
+
+static int listen_on(const char *host, int port) {
+ char portbuf[32];
+ snprintf(portbuf, sizeof(portbuf), "%d", port);
+ char err[ANET_ERR_LEN];
+ int fd = anetTcpServer(err, port, (char *)host, EMBED_HTTP_BACKLOG);
+ (void)portbuf;
+ if (fd == ANET_ERR) {
+ server_log("embed-server: listen failed on %s:%d: %s", host, port, err);
+ return -1;
+ }
+ set_nonblock(fd);
+ return fd;
+}
+
+static int load_one_model(http_server *s, model_slot slot, const char *path) {
+ loaded_model *m = &s->models[slot];
+ m->info = &k_models[slot];
+ m->path = xstrdup(path);
+ m->terminal_token_id = -1;
+ m->cls_id = -1;
+ m->sep_id = -1;
+ /* Pick the tokenizer by the files present: a WordPiece vocab.txt marks a
+ * BERT encoder; otherwise the Qwen byte-level BPE vocab.json. The two never
+ * coexist in a model directory, so the probe is unambiguous. */
+ char wp_path[1024];
+ snprintf(wp_path, sizeof(wp_path), "%s/vocab.txt", path);
+ if (access(wp_path, R_OK) == 0) {
+ m->wp_tok = wordpiece_tokenizer_load(path);
+ if (!m->wp_tok) {
+ server_log("embed-server: failed to load WordPiece tokenizer: %s", wp_path);
+ return -1;
+ }
+ m->wp_tok_ws = wordpiece_workspace_new();
+ if (!m->wp_tok_ws) {
+ server_log("embed-server: failed to allocate WordPiece workspace: %s", path);
+ return -1;
+ }
+ /* [CLS]/[SEP] wrap every input; resolve their ids once from the vocab. */
+ m->cls_id = wordpiece_tokenizer_token_id(m->wp_tok, "[CLS]");
+ m->sep_id = wordpiece_tokenizer_token_id(m->wp_tok, "[SEP]");
+ if (m->cls_id < 0 || m->sep_id < 0) {
+ server_log("embed-server: WordPiece vocab missing [CLS]/[SEP]: %s", path);
+ return -1;
+ }
+ } else {
+ char vocab_path[1024];
+ snprintf(vocab_path, sizeof(vocab_path), "%s/vocab.json", path);
+ m->tok = embed_tokenizer_load(vocab_path);
+ if (!m->tok) {
+ server_log("embed-server: failed to load tokenizer: %s", vocab_path);
+ return -1;
+ }
+ m->tok_ws = embed_tokenizer_workspace_new();
+ if (!m->tok_ws) {
+ server_log("embed-server: failed to allocate tokenizer workspace: %s", path);
+ return -1;
+ }
+ /* The contextual chunk separator is the tokenizer's <|endoftext|>. The
+ * released models keep added special tokens out of vocab.json, so the
+ * family constant is the normal case; a vocab that does define the
+ * token (e.g. small test models) takes precedence so the id stays
+ * inside that model's embedding table. */
+ int sep_id = embed_tokenizer_token_id(m->tok, "<|endoftext|>");
+ m->context_separator_id = sep_id >= 0 ? sep_id : EMBED_CONTEXT_SEPARATOR_TOKEN_ID;
+ /* Qwen3-Embedding pools the last token, the tokenizer's <|endoftext|>
+ * suffix - the same token as the separator, not the model's chat
+ * eos_token_id (<|im_end|>). Resolve it here from the tokenizer. */
+ m->terminal_token_id = m->context_separator_id;
+ if (m->info->kind == MODEL_KIND_LATE) {
+ int id = embed_tokenizer_token_id(m->tok, "[MASK]");
+ m->late_mask_id = id >= 0 ? id : EMBED_LATE_MASK_TOKEN_ID;
+ id = embed_tokenizer_token_id(m->tok, "[Q]");
+ m->late_query_prefix_id = id >= 0 ? id : EMBED_LATE_QUERY_PREFIX_ID;
+ id = embed_tokenizer_token_id(m->tok, "[D]");
+ m->late_document_prefix_id = id >= 0 ? id : EMBED_LATE_DOCUMENT_PREFIX_ID;
+
+ const char *punct = "!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~";
+ for (const char *p = punct;
+ *p &&
+ m->n_late_skip_ids < (int)(sizeof(m->late_skip_ids) / sizeof(m->late_skip_ids[0]));
+ p++) {
+ char text[2] = {*p, '\0'};
+ int n_ids = 0;
+ int *ids = embed_tokenizer_encode(m->tok, text, &n_ids);
+ if (ids && n_ids == 1)
+ m->late_skip_ids[m->n_late_skip_ids++] = ids[0];
+ free(ids);
+ }
+ }
+ }
+#ifdef USE_MLX
+ if (s->use_mlx) {
+ /* MLX streams are thread-local. The inference worker loads the MLX
+ * model so all MLX arrays/streams are created, used, and freed by the
+ * same thread. */
+ return 0;
+ }
+#endif
+#ifdef USE_CUDA
+ if (s->use_cuda) {
+ return 0;
+ }
+#endif
+ const embed_config_t *config = NULL;
+ int token_dim = 0;
+ if (m->info->kind == MODEL_KIND_LATE) {
+ m->cpu_late_model = embed_late_model_load(path);
+ if (!m->cpu_late_model) {
+ server_log("embed-server: failed to load late model: %s", path);
+ return -1;
+ }
+ m->cpu_late_ws = embed_late_workspace_new(m->cpu_late_model);
+ if (!m->cpu_late_ws) {
+ server_log("embed-server: failed to allocate late workspace: %s", path);
+ return -1;
+ }
+ config = embed_late_model_config(m->cpu_late_model);
+ token_dim = embed_late_model_token_dim(m->cpu_late_model);
+ } else {
+ m->cpu_model = embed_model_load(path);
+ if (!m->cpu_model) {
+ server_log("embed-server: failed to load model: %s", path);
+ return -1;
+ }
+ m->cpu_ws = embed_workspace_new(m->cpu_model);
+ if (!m->cpu_ws) {
+ server_log("embed-server: failed to allocate workspace: %s", path);
+ return -1;
+ }
+ config = embed_model_config(m->cpu_model);
+ }
+ if (configure_loaded_model(m, config, token_dim) != 0) {
+ return -1;
+ }
+ if (m->info->kind == MODEL_KIND_LATE &&
+ (m->late_mask_id >= config->vocab_size || m->late_query_prefix_id >= config->vocab_size ||
+ m->late_document_prefix_id >= config->vocab_size)) {
+ server_log("embed-server: late special-token ids exceed model vocab");
+ return -1;
+ }
+ return 0;
+}
+
+static void free_models(http_server *s) {
+ for (int i = 0; i < MODEL_COUNT; i++) {
+ loaded_model *m = &s->models[i];
+ free(m->path);
+ if (m->tok_ws)
+ embed_tokenizer_workspace_free(m->tok_ws);
+ if (m->tok)
+ embed_tokenizer_free(m->tok);
+ if (m->wp_tok_ws)
+ wordpiece_workspace_free(m->wp_tok_ws);
+ if (m->wp_tok)
+ wordpiece_tokenizer_free(m->wp_tok);
+ if (m->cpu_ws)
+ embed_workspace_free(m->cpu_ws);
+ if (m->cpu_model)
+ embed_model_free(m->cpu_model);
+ if (m->cpu_late_ws)
+ embed_late_workspace_free(m->cpu_late_ws);
+ if (m->cpu_late_model)
+ embed_late_model_free(m->cpu_late_model);
+#ifdef USE_MLX
+ if (m->mlx_ctx)
+ embed_mlx_free(m->mlx_ctx);
+ if (m->mlx_late_ctx)
+ embed_mlx_late_free(m->mlx_late_ctx);
+#endif
+#ifdef USE_CUDA
+ if (m->cuda_ctx)
+ embed_cuda_free(m->cuda_ctx);
+ if (m->cuda_late_ctx)
+ embed_cuda_late_free(m->cuda_late_ctx);
+#endif
+ }
+}
+
+static uint64_t physical_memory_nbytes(void) {
+#ifdef __APPLE__
+ uint64_t bytes = 0;
+ size_t len = sizeof(bytes);
+ if (sysctlbyname("hw.memsize", &bytes, &len, NULL, 0) == 0 && len == sizeof(bytes) && bytes > 0)
+ return bytes;
+#endif
+ long pages = sysconf(_SC_PHYS_PAGES);
+ long page_size = sysconf(_SC_PAGESIZE);
+ if (pages <= 0 || page_size <= 0 || (uint64_t)pages > UINT64_MAX / (uint64_t)page_size)
+ return 0;
+ return (uint64_t)pages * (uint64_t)page_size;
+}
+
+static int validate_model_specs(const embed_server_config_t *cfg) {
+ int seen[MODEL_COUNT] = {0};
+ for (int i = 0; i < cfg->n_models; i++) {
+ const embed_server_model_spec_t *spec = &cfg->models[i];
+ model_slot slot = model_slot_for_id(spec->id);
+ if (slot == MODEL_UNKNOWN) {
+ fprintf(stderr, "embed-server: unknown model id: %s\n", spec->id ? spec->id : "<null>");
+ return -1;
+ }
+ if (!spec->path || !spec->path[0]) {
+ fprintf(stderr, "embed-server: model %s has an empty path\n", spec->id);
+ return -1;
+ }
+ if (seen[slot]) {
+ fprintf(stderr, "embed-server: duplicate model id: %s\n", spec->id);
+ return -1;
+ }
+ seen[slot] = 1;
+ }
+ return 0;
+}
+
+static int mlx_memory_preflight(const embed_server_config_t *cfg) {
+ if (!cfg->use_mlx)
+ return 0;
+
+ uint64_t payload = 0;
+ for (int i = 0; i < cfg->n_models; i++) {
+ multi_safetensors_t *ms = multi_safetensors_open(cfg->models[i].path);
+ size_t model_payload = 0;
+ if (!ms || multi_safetensors_data_nbytes(ms, &model_payload) != 0) {
+ multi_safetensors_close(ms);
+ fprintf(stderr, "embed-server: failed to inspect MLX model: %s\n", cfg->models[i].path);
+ return -1;
+ }
+ multi_safetensors_close(ms);
+ if ((uint64_t)model_payload > UINT64_MAX - payload) {
+ fprintf(stderr, "embed-server: MLX model payload size overflow\n");
+ return -1;
+ }
+ payload += (uint64_t)model_payload;
+ }
+
+ if (payload > UINT64_MAX / EMBED_MLX_RESIDENT_MULTIPLIER) {
+ fprintf(stderr, "embed-server: MLX resident-memory estimate overflow\n");
+ return -1;
+ }
+ uint64_t estimated = payload * EMBED_MLX_RESIDENT_MULTIPLIER;
+ uint64_t physical = physical_memory_nbytes();
+ if (physical == 0) {
+ server_log("embed-server: warning: could not determine physical memory; "
+ "skipping MLX memory preflight");
+ return 0;
+ }
+ double utilization = cfg->memory_utilization > 0.0 ? cfg->memory_utilization
+ : EMBED_MLX_MEMORY_BUDGET_PERCENT / 100.0;
+ uint64_t budget = (uint64_t)((double)physical * utilization);
+ const double gib = 1024.0 * 1024.0 * 1024.0;
+ server_log("embed-server: MLX memory preflight: %.1f GiB tensors, "
+ "%.1f GiB estimated resident, %.1f GiB budget "
+ "(%.2f of physical memory)",
+ (double)payload / gib, (double)estimated / gib, (double)budget / gib, utilization);
+ if (cfg->mlx_quantize_bits) {
+ server_log("embed-server: MLX %d-bit quantization enabled; preflight "
+ "uses source payload as a conservative peak estimate",
+ cfg->mlx_quantize_bits);
+ }
+ if (estimated <= budget)
+ return 0;
+ server_log("embed-server: refusing MLX model set above the host-memory "
+ "budget");
+ server_log("embed-server: use BF16 artifacts, load fewer models, or raise "
+ "--memory-utilization (values above 1.0 overcommit)");
+ return -1;
+}
+
+int embed_run_server(const embed_server_config_t *cfg) {
+ if (!cfg || !cfg->models || cfg->n_models <= 0) {
+ fprintf(stderr, "embed-server: at least one --model MODEL_ID=PATH is required\n");
+ return 1;
+ }
+ if (validate_model_specs(cfg) != 0 || mlx_memory_preflight(cfg) != 0)
+ return 1;
+
+ http_server s;
+ memset(&s, 0, sizeof(s));
+ s.host = cfg->host && cfg->host[0] ? cfg->host : "127.0.0.1";
+ s.port = cfg->port > 0 ? cfg->port : 8000;
+ s.batch_size = cfg->batch_size > 0 ? cfg->batch_size : EMBED_SERVER_DEFAULT_BATCH_SIZE;
+ s.max_batch_tokens =
+ cfg->max_batch_tokens > 0 ? cfg->max_batch_tokens : EMBED_SERVER_DEFAULT_MAX_BATCH_TOKENS;
+ s.batch_wait_us = cfg->batch_wait_us >= 0 ? cfg->batch_wait_us
+ : (cfg->use_cuda ? EMBED_SERVER_CUDA_BATCH_WAIT_US
+ : EMBED_SERVER_BATCH_WAIT_US);
+ s.use_mlx = cfg->use_mlx;
+ s.use_cuda = cfg->use_cuda;
+ s.mlx_quantize_bits = cfg->mlx_quantize_bits;
+ s.mlx_quantize_group_size =
+ cfg->mlx_quantize_group_size > 0 ? cfg->mlx_quantize_group_size : 64;
+ if (cfg->api_key && cfg->api_key[0])
+ s.api_key = xstrdup(cfg->api_key);
+ else {
+ const char *env_key = getenv("EMBED_API_KEY");
+ if (env_key && env_key[0])
+ s.api_key = xstrdup(env_key);
+ }
+
+ pthread_mutex_init(&s.mu, NULL);
+ pthread_cond_init(&s.cv, NULL);
+
+ for (int i = 0; i < cfg->n_models; i++) {
+ model_slot slot = model_slot_for_id(cfg->models[i].id);
+ if (slot == MODEL_UNKNOWN) {
+ fprintf(stderr, "embed-server: unknown model id: %s\n", cfg->models[i].id);
+ free_models(&s);
+ return 1;
+ }
+ if (load_one_model(&s, slot, cfg->models[i].path) != 0) {
+ free_models(&s);
+ return 1;
+ }
+ }
+
+ if (pipe(s.completion_pipe) != 0 || pipe(s.signal_pipe) != 0) {
+ perror("pipe");
+ free_models(&s);
+ return 1;
+ }
+ set_nonblock(s.completion_pipe[0]);
+ set_nonblock(s.completion_pipe[1]);
+ set_nonblock(s.signal_pipe[0]);
+ set_nonblock(s.signal_pipe[1]);
+
+ struct sigaction sa;
+ memset(&sa, 0, sizeof(sa));
+ sa.sa_handler = stop_signal_handler;
+ sigemptyset(&sa.sa_mask);
+ sigaction(SIGINT, &sa, NULL);
+ sigaction(SIGTERM, &sa, NULL);
+ signal(SIGPIPE, SIG_IGN);
+ g_signal_wfd = s.signal_pipe[1];
+
+ s.loop = aeCreateEventLoop(EMBED_HTTP_SETSIZE);
+ if (!s.loop) {
+ fprintf(stderr, "embed-server: failed to create event loop\n");
+ free_models(&s);
+ return 1;
+ }
+
+ if (pthread_create(&s.worker, NULL, worker_main, &s) != 0) {
+ fprintf(stderr, "embed-server: failed to start worker\n");
+ aeDeleteEventLoop(s.loop);
+ free_models(&s);
+ return 1;
+ }
+ pthread_mutex_lock(&s.mu);
+ while (!s.worker_ready)
+ pthread_cond_wait(&s.cv, &s.mu);
+ int worker_init_rc = s.worker_init_rc;
+ pthread_mutex_unlock(&s.mu);
+ if (worker_init_rc) {
+ pthread_join(s.worker, NULL);
+ aeDeleteEventLoop(s.loop);
+ free_models(&s);
+ free(s.api_key);
+ pthread_cond_destroy(&s.cv);
+ pthread_mutex_destroy(&s.mu);
+ return 1;
+ }
+
+ s.listen_fd = listen_on(s.host, s.port);
+ if (s.listen_fd < 0) {
+ pthread_mutex_lock(&s.mu);
+ s.stopping = 1;
+ pthread_cond_signal(&s.cv);
+ pthread_mutex_unlock(&s.mu);
+ pthread_join(s.worker, NULL);
+ aeDeleteEventLoop(s.loop);
+ free_models(&s);
+ return 1;
+ }
+
+ aeCreateFileEvent(s.loop, s.listen_fd, AE_READABLE, accept_cb, &s);
+ aeCreateFileEvent(s.loop, s.completion_pipe[0], AE_READABLE, completion_cb, &s);
+ aeCreateFileEvent(s.loop, s.signal_pipe[0], AE_READABLE, signal_cb, &s);
+ aeCreateTimeEvent(s.loop, EMBED_HTTP_SWEEP_MS, timeout_cb, &s, NULL);
+
+ server_log("embed-server: listening on http://%s:%d", s.host, s.port);
+ aeMain(s.loop);
+
+ server_log("embed-server: shutdown requested");
+ if (s.listen_fd >= 0)
+ close(s.listen_fd);
+ client *c = s.clients;
+ while (c) {
+ client *next = c->next;
+ close_client(c);
+ c = next;
+ }
+
+ pthread_mutex_lock(&s.mu);
+ s.stopping = 1;
+ pthread_cond_signal(&s.cv);
+ pthread_mutex_unlock(&s.mu);
+ pthread_join(s.worker, NULL);
+
+ aeDeleteEventLoop(s.loop);
+ close(s.completion_pipe[0]);
+ close(s.completion_pipe[1]);
+ close(s.signal_pipe[0]);
+ close(s.signal_pipe[1]);
+ free_models(&s);
+ free(s.api_key);
+ pthread_cond_destroy(&s.cv);
+ pthread_mutex_destroy(&s.mu);
+ return 0;
+}
+
+/* ====================================================================
+ * embed-server entry point
+ * ==================================================================== */
+#ifndef EMBED_SERVER_TEST
+
+static void print_usage(const char *prog) {
+ fprintf(stderr,
+ "Usage: %s --model ID=DIR [options]\n"
+ "\n"
+ "Options:\n"
+ " --model ID=DIR Model to serve (repeatable)\n"
+#ifdef USE_MLX
+ " --mlx Use Apple MLX GPU backend\n"
+#endif
+#ifdef USE_CUDA
+ " --cuda Use NVIDIA CUDA GPU backend\n"
+#endif
+ " --host HOST Bind host (default: 127.0.0.1)\n"
+ " --port N Bind port (default: 8000)\n"
+ " --api-key K Require Authorization: Bearer K\n"
+ " -b, --batch-size N Max texts or documents per inference batch\n"
+ " (default: 32)\n"
+ " --max-batch-tokens N Max tokens per inference batch (default: 16384)\n"
+ " --batch-wait-us N First-arrival micro-batch deadline in us\n"
+#ifdef USE_CUDA
+ " (default: CUDA 1000; CPU 0)\n"
+#else
+ " (default: 0)\n"
+#endif
+#ifdef USE_MLX
+ " --memory-utilization F Fraction of physical memory the MLX model-set\n"
+ " preflight may plan for (default: 0.90; values\n"
+ " above 1.0 overcommit)\n"
+ " --mlx-quant-bits N Quantize MLX linear weights to 8 bits at load\n"
+ " --mlx-quant-group-size N MLX quantization group size (default: 64)\n"
+#endif
+#ifdef USE_CUDA
+ " --cuda-gemm-mode MODE CUDA GEMM compute: f32, tf32, bf16, or 16f\n"
+ " (default: f32, exact)\n"
+ " --cuda-weight-dtype DTYPE CUDA weight storage: f32 or bf16 (default:\n"
+ " f32); bf16 halves weight memory\n"
+#endif
+ " -t, --threads N CPU threads (default: available cores, cgroup-aware)\n"
+ " -v, --verbose Verbose (-vv for debug)\n"
+ " -V, --version Print version and exit\n"
+ " --build-info Print build details and exit\n"
+ " -h, --help Show this help\n"
+ "\n"
+ "Examples:\n"
+ " %s --model pplx-embed-v1-0.6b=./model --port 8000\n"
+#ifdef USE_MLX
+ " %s --mlx --mlx-quant-bits 8 \\\n"
+ " --model pplx-embed-v1-4b=./model-4b-bf16\n",
+ prog, prog, prog);
+#else
+ ,
+ prog, prog);
+#endif
+}
+
+typedef struct {
+ embed_server_model_spec_t *v;
+ int n;
+ int cap;
+} model_specs_t;
+
+static int append_model_spec(model_specs_t *specs, const char *arg) {
+ const char *eq = strchr(arg, '=');
+ if (!eq || eq == arg || !eq[1]) {
+ fprintf(stderr, "--model expects MODEL_ID=DIR\n");
+ return -1;
+ }
+ if (specs->n == specs->cap) {
+ int new_cap = specs->cap ? specs->cap * 2 : 4;
+ void *p = realloc(specs->v, (size_t)new_cap * sizeof(specs->v[0]));
+ if (!p)
+ return -1;
+ specs->v = p;
+ specs->cap = new_cap;
+ }
+ size_t id_len = (size_t)(eq - arg);
+ char *id = (char *)malloc(id_len + 1);
+ char *path = strdup(eq + 1);
+ if (id) {
+ memcpy(id, arg, id_len);
+ id[id_len] = '\0';
+ }
+ specs->v[specs->n].id = id;
+ specs->v[specs->n].path = path;
+ if (!specs->v[specs->n].id || !specs->v[specs->n].path)
+ return -1;
+ specs->n++;
+ return 0;
+}
+
+static void free_model_specs(model_specs_t *specs) {
+ if (!specs)
+ return;
+ for (int i = 0; i < specs->n; i++) {
+ free((char *)specs->v[i].id);
+ free((char *)specs->v[i].path);
+ }
+ free(specs->v);
+}
+
+int main(int argc, char *argv[]) {
+ int n_threads = 0;
+ int verbose = 0;
+ int batch_size = 0;
+ int max_batch_tokens = 0;
+ int batch_wait_us = -1;
+#ifdef USE_MLX
+ int use_mlx = 0;
+ int mlx_quantize_bits = 0;
+ int mlx_quantize_group_size = 64;
+ double memory_utilization = 0.0;
+#endif
+#ifdef USE_CUDA
+ int use_cuda = 0;
+ const char *cuda_fast_gemm = NULL;
+ const char *cuda_weights = NULL;
+#endif
+ const char *host = "127.0.0.1";
+ const char *api_key = NULL;
+ int port = 8000;
+ model_specs_t model_specs = {0};
+
+ const char *prog = embed_prog_name(argv[0]);
+ int arg = 1;
+ while (arg < argc && argv[arg][0] == '-') {
+ const char *f = argv[arg];
+ if (!strcmp(f, "-V") || !strcmp(f, "--version")) {
+ embed_print_version(prog);
+ free_model_specs(&model_specs);
+ return 0;
+ } else if (!strcmp(f, "--build-info")) {
+ embed_print_build_info(prog);
+ free_model_specs(&model_specs);
+ return 0;
+ } else if (!strcmp(f, "--model")) {
+ if (append_model_spec(&model_specs, argv[++arg]) != 0) {
+ free_model_specs(&model_specs);
+ return 1;
+ }
+ }
+#ifdef USE_MLX
+ else if (!strcmp(f, "--mlx")) {
+ use_mlx = 1;
+ } else if (!strcmp(f, "--mlx-quant-bits")) {
+ mlx_quantize_bits = atoi(argv[++arg]);
+ if (mlx_quantize_bits != 0 && mlx_quantize_bits != 8) {
+ fprintf(stderr, "--mlx-quant-bits must be 0 or 8\n");
+ free_model_specs(&model_specs);
+ return 1;
+ }
+ } else if (!strcmp(f, "--mlx-quant-group-size")) {
+ mlx_quantize_group_size = atoi(argv[++arg]);
+ if (mlx_quantize_group_size <= 0) {
+ fprintf(stderr, "--mlx-quant-group-size must be > 0\n");
+ free_model_specs(&model_specs);
+ return 1;
+ }
+ } else if (!strcmp(f, "--memory-utilization")) {
+ memory_utilization = atof(argv[++arg]);
+ if (memory_utilization <= 0.0) {
+ fprintf(stderr, "--memory-utilization must be > 0\n");
+ free_model_specs(&model_specs);
+ return 1;
+ }
+ }
+#endif
+#ifdef USE_CUDA
+ else if (!strcmp(f, "--cuda")) {
+ use_cuda = 1;
+ } else if (!strcmp(f, "--cuda-gemm-mode")) {
+ cuda_fast_gemm = argv[++arg];
+ } else if (!strcmp(f, "--cuda-weight-dtype")) {
+ cuda_weights = argv[++arg];
+ }
+#endif
+ else if (!strcmp(f, "--host")) {
+ host = argv[++arg];
+ } else if (!strcmp(f, "--port")) {
+ port = atoi(argv[++arg]);
+ } else if (!strcmp(f, "--api-key")) {
+ api_key = argv[++arg];
+ } else if (!strcmp(f, "-b") || !strcmp(f, "--batch-size")) {
+ batch_size = atoi(argv[++arg]);
+ } else if (!strcmp(f, "--max-batch-tokens")) {
+ max_batch_tokens = atoi(argv[++arg]);
+ if (max_batch_tokens <= 0) {
+ fprintf(stderr, "--max-batch-tokens must be > 0\n");
+ free_model_specs(&model_specs);
+ return 1;
+ }
+ } else if (!strcmp(f, "--batch-wait-us")) {
+ batch_wait_us = atoi(argv[++arg]);
+ if (batch_wait_us < 0) {
+ fprintf(stderr, "--batch-wait-us must be >= 0\n");
+ free_model_specs(&model_specs);
+ return 1;
+ }
+ } else if (!strcmp(f, "-t") || !strcmp(f, "--threads")) {
+ n_threads = atoi(argv[++arg]);
+ } else if (!strcmp(f, "-v") || !strcmp(f, "--verbose")) {
+ verbose++;
+ } else if (!strcmp(f, "-vv")) {
+ verbose = 2;
+ } else if (!strcmp(f, "-h") || !strcmp(f, "--help")) {
+ print_usage(prog);
+ free_model_specs(&model_specs);
+ return 0;
+ } else {
+ fprintf(stderr, "unknown option: %s\n", f);
+ print_usage(prog);
+ free_model_specs(&model_specs);
+ return 1;
+ }
+ arg++;
+ }
+
+ embed_verbose = verbose;
+
+ if (arg < argc) {
+ fprintf(stderr, "unexpected argument: %s\n", argv[arg]);
+ print_usage(prog);
+ free_model_specs(&model_specs);
+ return 1;
+ }
+ if (model_specs.n == 0) {
+ fprintf(stderr, "at least one --model MODEL_ID=DIR is required\n");
+ print_usage(prog);
+ free_model_specs(&model_specs);
+ return 1;
+ }
+#ifdef USE_MLX
+ if (mlx_quantize_bits && !use_mlx) {
+ fprintf(stderr, "--mlx-quant-bits requires --mlx\n");
+ free_model_specs(&model_specs);
+ return 1;
+ }
+#endif
+#ifdef USE_CUDA
+ if (cuda_fast_gemm) {
+ if (!use_cuda) {
+ fprintf(stderr, "--cuda-gemm-mode requires --cuda\n");
+ free_model_specs(&model_specs);
+ return 1;
+ }
+ if (embed_cuda_set_fast_gemm(cuda_fast_gemm) != 0) {
+ fprintf(stderr, "--cuda-gemm-mode must be f32, tf32, bf16, or 16f\n");
+ free_model_specs(&model_specs);
+ return 1;
+ }
+ }
+ if (cuda_weights) {
+ if (!use_cuda) {
+ fprintf(stderr, "--cuda-weight-dtype requires --cuda\n");
+ free_model_specs(&model_specs);
+ return 1;
+ }
+ if (!strcmp(cuda_weights, "bf16")) {
+ embed_cuda_set_weights_bf16(1);
+ } else if (!strcmp(cuda_weights, "f32")) {
+ embed_cuda_set_weights_bf16(0);
+ } else {
+ fprintf(stderr, "--cuda-weight-dtype must be f32 or bf16\n");
+ free_model_specs(&model_specs);
+ return 1;
+ }
+ }
+#endif
+
+#ifdef USE_MLX
+ if (use_mlx) {
+ if (verbose >= 1)
+ fprintf(stderr, "Using MLX GPU backend\n");
+ } else
+#endif
+#ifdef USE_CUDA
+ if (use_cuda) {
+ if (verbose >= 1)
+ fprintf(stderr, "Using CUDA GPU backend\n");
+ } else
+#endif
+ {
+ if (n_threads <= 0)
+ n_threads = embed_get_num_cpus();
+ embed_set_threads(n_threads);
+ if (verbose >= 1)
+ fprintf(stderr, "Using %d CPU thread(s)\n", n_threads);
+ }
+
+ embed_server_config_t scfg = {
+ .models = model_specs.v,
+ .n_models = model_specs.n,
+ .host = host,
+ .port = port,
+ .batch_size = batch_size > 0 ? batch_size : EMBED_SERVER_DEFAULT_BATCH_SIZE,
+ .max_batch_tokens = max_batch_tokens,
+ .batch_wait_us = batch_wait_us,
+#ifdef USE_MLX
+ .use_mlx = use_mlx,
+ .mlx_quantize_bits = mlx_quantize_bits,
+ .mlx_quantize_group_size = mlx_quantize_group_size,
+ .memory_utilization = memory_utilization,
+#endif
+#ifdef USE_CUDA
+ .use_cuda = use_cuda,
+#endif
+ .api_key = api_key,
+ };
+ int rc = embed_run_server(&scfg);
+ free_model_specs(&model_specs);
+ return rc;
+}
+
+#endif /* EMBED_SERVER_TEST */
diff --git a/src/server.h b/src/server.h
new file mode 100644
index 0000000..2a39b94
--- /dev/null
+++ b/src/server.h
@@ -0,0 +1,42 @@
+#ifndef EMBED_SERVER_H
+#define EMBED_SERVER_H
+
+/* Public-API export annotation. The libraries are built with
+ * -fvisibility=hidden, so only declarations carrying EMBED_API are exported
+ * from the shared library; everything else stays internal. */
+#ifndef EMBED_API
+#if defined(__GNUC__)
+#define EMBED_API __attribute__((visibility("default")))
+#else
+#define EMBED_API
+#endif
+#endif
+
+#include <stdbool.h>
+
+typedef struct {
+ const char *id;
+ const char *path;
+} embed_server_model_spec_t;
+
+typedef struct {
+ const embed_server_model_spec_t *models;
+ int n_models;
+ const char *host;
+ int port;
+ int batch_size;
+ int max_batch_tokens;
+ int batch_wait_us;
+ int use_mlx;
+ int use_cuda;
+ int mlx_quantize_bits;
+ int mlx_quantize_group_size;
+ double memory_utilization; /* fraction of physical memory the MLX
+ preflight may plan for; 0 = default 0.90,
+ values above 1.0 allow overcommit */
+ const char *api_key;
+} embed_server_config_t;
+
+EMBED_API int embed_run_server(const embed_server_config_t *cfg);
+
+#endif
diff --git a/src/tokenizer_bpe.c b/src/tokenizer_bpe.c
new file mode 100644
index 0000000..511b29e
--- /dev/null
+++ b/src/tokenizer_bpe.c
@@ -0,0 +1,2018 @@
+#include "tokenizer_bpe.h"
+#include "kernels.h"
+#include <limits.h>
+#include <stdint.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+
+/* ========================================================================
+ * GPT-2 Bytes-to-Unicode Mapping
+ * ======================================================================== */
+
+static int gpt2_byte_to_unicode[256];
+static int gpt2_unicode_to_byte[512]; /* codepoints up to ~384 */
+static int gpt2_mapping_initialized = 0;
+
+static void init_gpt2_mapping(void) {
+ if (gpt2_mapping_initialized)
+ return;
+
+ memset(gpt2_unicode_to_byte, -1, sizeof(gpt2_unicode_to_byte));
+
+ int n = 0;
+ for (int b = 0; b < 256; b++) {
+ int is_normal = 0;
+ if (b >= 33 && b <= 126)
+ is_normal = 1; /* '!'..'~' */
+ if (b >= 161 && b <= 172)
+ is_normal = 1; /* '¡'..'¬' */
+ if (b >= 174 && b <= 255)
+ is_normal = 1; /* '®'..'ÿ' */
+
+ if (is_normal)
+ gpt2_byte_to_unicode[b] = b;
+ else
+ gpt2_byte_to_unicode[b] = 256 + n++;
+ }
+
+ for (int b = 0; b < 256; b++) {
+ int cp = gpt2_byte_to_unicode[b];
+ if (cp < 512)
+ gpt2_unicode_to_byte[cp] = b;
+ }
+
+ gpt2_mapping_initialized = 1;
+}
+
+/* Convert one Unicode codepoint to UTF-8 bytes. Returns bytes written. */
+static int utf8_encode_cp(int cp, char out[4]) {
+ if (cp < 0x80) {
+ out[0] = (char)cp;
+ return 1;
+ }
+ if (cp < 0x800) {
+ out[0] = (char)(0xC0 | (cp >> 6));
+ out[1] = (char)(0x80 | (cp & 0x3F));
+ return 2;
+ }
+ out[0] = (char)(0xE0 | (cp >> 12));
+ out[1] = (char)(0x80 | ((cp >> 6) & 0x3F));
+ out[2] = (char)(0x80 | (cp & 0x3F));
+ return 3;
+}
+
+/*
+ * Decode a GPT-2 encoded token string (vocab key) to raw bytes/UTF-8 text.
+ * Returns allocated string (caller must free).
+ */
+static char *decode_gpt2_token(const char *token_str) {
+ init_gpt2_mapping();
+
+ size_t len = strlen(token_str);
+ unsigned char *bytes = (unsigned char *)malloc(len + 1);
+ if (!bytes)
+ return NULL;
+
+ int byte_count = 0;
+ const unsigned char *p = (const unsigned char *)token_str;
+ const unsigned char *end = p + len;
+
+ while (p < end) {
+ int cp = 0;
+ int nbytes = 1;
+
+ if ((*p & 0x80) == 0) {
+ cp = *p;
+ nbytes = 1;
+ } else if ((*p & 0xE0) == 0xC0) {
+ cp = (*p & 0x1F) << 6;
+ if (p + 1 < end)
+ cp |= (p[1] & 0x3F);
+ nbytes = 2;
+ } else if ((*p & 0xF0) == 0xE0) {
+ cp = (*p & 0x0F) << 12;
+ if (p + 1 < end)
+ cp |= (p[1] & 0x3F) << 6;
+ if (p + 2 < end)
+ cp |= (p[2] & 0x3F);
+ nbytes = 3;
+ } else if ((*p & 0xF8) == 0xF0) {
+ cp = (*p & 0x07) << 18;
+ if (p + 1 < end)
+ cp |= (p[1] & 0x3F) << 12;
+ if (p + 2 < end)
+ cp |= (p[2] & 0x3F) << 6;
+ if (p + 3 < end)
+ cp |= (p[3] & 0x3F);
+ nbytes = 4;
+ } else {
+ cp = *p;
+ nbytes = 1;
+ }
+ p += nbytes;
+
+ if (cp < 512 && gpt2_unicode_to_byte[cp] >= 0) {
+ bytes[byte_count++] = (unsigned char)gpt2_unicode_to_byte[cp];
+ } else {
+ bytes[byte_count++] = '?';
+ }
+ }
+ bytes[byte_count] = '\0';
+ return (char *)bytes;
+}
+
+/* ========================================================================
+ * Simple JSON parser for vocab.json
+ * ======================================================================== */
+
+static void skip_ws(const char **p) {
+ while (**p == ' ' || **p == '\n' || **p == '\r' || **p == '\t')
+ (*p)++;
+}
+
+static int parse_json_string(const char **p, char *out, size_t max_len) {
+ skip_ws(p);
+ if (**p != '"')
+ return -1;
+ (*p)++;
+ size_t i = 0;
+ while (**p && **p != '"' && i < max_len - 1) {
+ if (**p == '\\') {
+ (*p)++;
+ if (**p == 'n')
+ out[i++] = '\n';
+ else if (**p == 't')
+ out[i++] = '\t';
+ else if (**p == '"')
+ out[i++] = '"';
+ else if (**p == '\\')
+ out[i++] = '\\';
+ else if (**p == '/')
+ out[i++] = '/';
+ else if (**p == 'u') {
+ (*p)++;
+ unsigned int cp = 0;
+ for (int j = 0; j < 4 && **p; j++, (*p)++) {
+ cp <<= 4;
+ char c = **p;
+ if (c >= '0' && c <= '9')
+ cp |= (unsigned)(c - '0');
+ else if (c >= 'a' && c <= 'f')
+ cp |= (unsigned)(c - 'a' + 10);
+ else if (c >= 'A' && c <= 'F')
+ cp |= (unsigned)(c - 'A' + 10);
+ }
+ if (cp < 0x80 && i + 1 < max_len) {
+ out[i++] = (char)cp;
+ } else if (cp < 0x800 && i + 2 < max_len) {
+ out[i++] = (char)(0xC0 | (cp >> 6));
+ out[i++] = (char)(0x80 | (cp & 0x3F));
+ } else if (i + 3 < max_len) {
+ out[i++] = (char)(0xE0 | (cp >> 12));
+ out[i++] = (char)(0x80 | ((cp >> 6) & 0x3F));
+ out[i++] = (char)(0x80 | (cp & 0x3F));
+ }
+ continue;
+ } else {
+ out[i++] = **p;
+ }
+ } else {
+ out[i++] = **p;
+ }
+ (*p)++;
+ }
+ out[i] = '\0';
+ if (**p != '"')
+ return -1;
+ (*p)++;
+ return 0;
+}
+
+static int64_t parse_json_int(const char **p) {
+ skip_ws(p);
+ int neg = 0;
+ if (**p == '-') {
+ neg = 1;
+ (*p)++;
+ }
+ int64_t val = 0;
+ while (**p >= '0' && **p <= '9') {
+ val = val * 10 + (**p - '0');
+ (*p)++;
+ }
+ return neg ? -val : val;
+}
+
+/* ========================================================================
+ * String->int hash map (open addressing)
+ * ======================================================================== */
+
+typedef struct {
+ char *key; /* NULL means empty slot */
+ int value;
+} str_int_entry_t;
+
+static uint64_t fnv1a_hash(const char *s) {
+ uint64_t h = 1469598103934665603ULL;
+ while (*s) {
+ h ^= (unsigned char)*s++;
+ h *= 1099511628211ULL;
+ }
+ return h;
+}
+
+static uint64_t fnv1a_hash_pair(const char *a, const char *b) {
+ uint64_t h = 1469598103934665603ULL;
+ while (*a) {
+ h ^= (unsigned char)*a++;
+ h *= 1099511628211ULL;
+ }
+ h ^= (unsigned char)' ';
+ h *= 1099511628211ULL;
+ while (*b) {
+ h ^= (unsigned char)*b++;
+ h *= 1099511628211ULL;
+ }
+ return h;
+}
+
+static int pair_key_eq(const char *key, const char *a, const char *b) {
+ while (*a) {
+ if (*key++ != *a++)
+ return 0;
+ }
+ if (*key++ != ' ')
+ return 0;
+ while (*b) {
+ if (*key++ != *b++)
+ return 0;
+ }
+ return *key == '\0';
+}
+
+static int next_pow2(int x) {
+ int p = 1;
+ while (p < x)
+ p <<= 1;
+ return p;
+}
+
+static int map_insert(str_int_entry_t *map, int cap, char *key, int value) {
+ if (!map || cap <= 0 || !key)
+ return -1;
+ int mask = cap - 1;
+ int pos = (int)(fnv1a_hash(key) & (uint64_t)mask);
+ for (int i = 0; i < cap; i++) {
+ int idx = (pos + i) & mask;
+ if (!map[idx].key) {
+ map[idx].key = key;
+ map[idx].value = value;
+ return 0;
+ }
+ if (strcmp(map[idx].key, key) == 0) {
+ map[idx].value = value;
+ return 0;
+ }
+ }
+ return -1;
+}
+
+static int map_insert_owned(str_int_entry_t *map, int cap, char **keyp, int value) {
+ if (!keyp)
+ return -1;
+ char *key = *keyp;
+ if (!map || cap <= 0 || !key)
+ return -1;
+ int mask = cap - 1;
+ int pos = (int)(fnv1a_hash(key) & (uint64_t)mask);
+ for (int i = 0; i < cap; i++) {
+ int idx = (pos + i) & mask;
+ if (!map[idx].key) {
+ map[idx].key = key;
+ map[idx].value = value;
+ *keyp = NULL;
+ return 0;
+ }
+ if (strcmp(map[idx].key, key) == 0) {
+ map[idx].value = value;
+ return 0;
+ }
+ }
+ return -1;
+}
+
+static int map_get(const str_int_entry_t *map, int cap, const char *key) {
+ if (!map || cap <= 0 || !key)
+ return -1;
+ int mask = cap - 1;
+ int pos = (int)(fnv1a_hash(key) & (uint64_t)mask);
+ for (int i = 0; i < cap; i++) {
+ int idx = (pos + i) & mask;
+ if (!map[idx].key)
+ return -1;
+ if (strcmp(map[idx].key, key) == 0)
+ return map[idx].value;
+ }
+ return -1;
+}
+
+static int map_get_pair(const str_int_entry_t *map, int cap, const char *a, const char *b) {
+ if (!map || cap <= 0 || !a || !b)
+ return -1;
+ int mask = cap - 1;
+ int pos = (int)(fnv1a_hash_pair(a, b) & (uint64_t)mask);
+ for (int i = 0; i < cap; i++) {
+ int idx = (pos + i) & mask;
+ if (!map[idx].key)
+ return -1;
+ if (pair_key_eq(map[idx].key, a, b))
+ return map[idx].value;
+ }
+ return -1;
+}
+
+/* ========================================================================
+ * BPE helpers
+ * ======================================================================== */
+
+static int utf8_char_len(unsigned char c) {
+ if ((c & 0x80) == 0)
+ return 1;
+ if ((c & 0xE0) == 0xC0)
+ return 2;
+ if ((c & 0xF0) == 0xE0)
+ return 3;
+ if ((c & 0xF8) == 0xF0)
+ return 4;
+ return 1;
+}
+
+static int split_utf8_symbols(const char *s, char ***out_syms, int *out_n) {
+ *out_syms = NULL;
+ *out_n = 0;
+ if (!s || !*s)
+ return 0;
+
+ int n = 0;
+ for (const unsigned char *p = (const unsigned char *)s; *p;) {
+ int l = utf8_char_len(*p);
+ p += l;
+ n++;
+ }
+ if (n <= 0)
+ return 0;
+
+ char **syms = (char **)calloc((size_t)n, sizeof(char *));
+ if (!syms)
+ return -1;
+
+ int i = 0;
+ for (const unsigned char *p = (const unsigned char *)s; *p;) {
+ int l = utf8_char_len(*p);
+ syms[i] = (char *)malloc((size_t)l + 1);
+ if (!syms[i]) {
+ for (int j = 0; j < i; j++)
+ free(syms[j]);
+ free(syms);
+ return -1;
+ }
+ memcpy(syms[i], p, (size_t)l);
+ syms[i][l] = '\0';
+ p += l;
+ i++;
+ }
+
+ *out_syms = syms;
+ *out_n = n;
+ return 0;
+}
+
+static char *str_concat2(const char *a, const char *b) {
+ size_t la = strlen(a), lb = strlen(b);
+ char *r = (char *)malloc(la + lb + 1);
+ if (!r)
+ return NULL;
+ memcpy(r, a, la);
+ memcpy(r + la, b, lb);
+ r[la + lb] = '\0';
+ return r;
+}
+
+/* ========================================================================
+ * Integer-pair BPE merges: (left_id, right_id) -> (rank, merged_id)
+ * ======================================================================== */
+
+typedef struct {
+ uint64_t key; /* (left_id << 32) | right_id; UINT64_MAX = empty */
+ int rank;
+ int merged_id;
+} pair_merge_entry_t;
+
+static uint64_t pair_hash(uint64_t k) {
+ /* splitmix64 finalizer */
+ k ^= k >> 30;
+ k *= 0xbf58476d1ce4e5b9ULL;
+ k ^= k >> 27;
+ k *= 0x94d049bb133111ebULL;
+ k ^= k >> 31;
+ return k;
+}
+
+static void
+pair_map_insert(pair_merge_entry_t *map, int cap, uint64_t key, int rank, int merged_id) {
+ int mask = cap - 1;
+ int idx = (int)(pair_hash(key) & (uint64_t)mask);
+ for (int probe = 0; probe < cap; probe++, idx = (idx + 1) & mask) {
+ if (map[idx].key == UINT64_MAX) {
+ map[idx].key = key;
+ map[idx].rank = rank;
+ map[idx].merged_id = merged_id;
+ return;
+ }
+ if (map[idx].key == key)
+ return; /* first (lowest) rank wins */
+ }
+}
+
+/* Returns the rank and sets *merged_id, or INT_MAX when the pair never
+ * merges. */
+static int pair_merge_lookup(const embed_tokenizer_t *tok, int left, int right, int *merged_id) {
+ const pair_merge_entry_t *map = (const pair_merge_entry_t *)tok->int_merges;
+ uint64_t key = ((uint64_t)(uint32_t)left << 32) | (uint32_t)right;
+ int mask = tok->int_merges_cap - 1;
+ int idx = (int)(pair_hash(key) & (uint64_t)mask);
+ for (int probe = 0; probe < tok->int_merges_cap; probe++, idx = (idx + 1) & mask) {
+ if (map[idx].key == UINT64_MAX)
+ return INT_MAX;
+ if (map[idx].key == key) {
+ *merged_id = map[idx].merged_id;
+ return map[idx].rank;
+ }
+ }
+ return INT_MAX;
+}
+
+static int merge_rank(const embed_tokenizer_t *tok, const char *a, const char *b) {
+ if (!tok->merge_map || tok->merge_map_cap <= 0)
+ return INT_MAX;
+
+ int rank = map_get_pair((const str_int_entry_t *)tok->merge_map, tok->merge_map_cap, a, b);
+ return rank >= 0 ? rank : INT_MAX;
+}
+
+static int append_id(int **arr, int *n, int *cap, int id) {
+ if (*n >= *cap) {
+ int new_cap = (*cap == 0) ? 16 : (*cap * 2);
+ int *tmp = (int *)realloc(*arr, (size_t)new_cap * sizeof(int));
+ if (!tmp)
+ return -1;
+ *arr = tmp;
+ *cap = new_cap;
+ }
+ (*arr)[(*n)++] = id;
+ return 0;
+}
+
+/* Convert UTF-8 bytes to GPT-2 byte-level unicode string. */
+static char *text_to_bpe_unicode(const char *text) {
+ init_gpt2_mapping();
+ size_t len = strlen(text);
+ /* Every input byte becomes one codepoint up to 3 UTF-8 bytes. */
+ char *out = (char *)malloc(len * 3 + 1);
+ if (!out)
+ return NULL;
+
+ size_t w = 0;
+ for (size_t i = 0; i < len; i++) {
+ int cp = gpt2_byte_to_unicode[(unsigned char)text[i]];
+ char tmp[4];
+ int n = utf8_encode_cp(cp, tmp);
+ for (int j = 0; j < n; j++)
+ out[w++] = tmp[j];
+ }
+ out[w] = '\0';
+ return out;
+}
+
+static int
+encode_bpe_word(const embed_tokenizer_t *tok, const char *mapped, int **out_ids, int *out_n);
+
+static int
+utf8_decode_cp_len(const unsigned char *p, const unsigned char *end, int *cp_out, int *len_out) {
+ if (p >= end || *p == '\0')
+ return 0;
+
+ unsigned char c = *p;
+ if ((c & 0x80) == 0) {
+ *cp_out = c;
+ *len_out = 1;
+ return 1;
+ }
+ if ((c & 0xE0) == 0xC0 && p + 1 < end && (p[1] & 0xC0) == 0x80) {
+ *cp_out = ((c & 0x1F) << 6) | (p[1] & 0x3F);
+ *len_out = 2;
+ return 1;
+ }
+ if ((c & 0xF0) == 0xE0 && p + 2 < end && (p[1] & 0xC0) == 0x80 && (p[2] & 0xC0) == 0x80) {
+ *cp_out = ((c & 0x0F) << 12) | ((p[1] & 0x3F) << 6) | (p[2] & 0x3F);
+ *len_out = 3;
+ return 1;
+ }
+ if ((c & 0xF8) == 0xF0 && p + 3 < end && (p[1] & 0xC0) == 0x80 && (p[2] & 0xC0) == 0x80 &&
+ (p[3] & 0xC0) == 0x80) {
+ *cp_out = ((c & 0x07) << 18) | ((p[1] & 0x3F) << 12) | ((p[2] & 0x3F) << 6) | (p[3] & 0x3F);
+ *len_out = 4;
+ return 1;
+ }
+
+ *cp_out = c;
+ *len_out = 1;
+ return 1;
+}
+
+/* The pretokenizer classifies every codepoint, several times each, and the
+ * input is overwhelmingly ASCII; one table lookup replaces the range chains
+ * for cp < 0x80. Non-ASCII codepoints fall through to the full checks.
+ * ASCII has no symbolish codepoints, so that class needs no bit. */
+#define CPC_SPACE 1
+#define CPC_NUMBER 2
+#define CPC_LETTER 4
+
+static const unsigned char ascii_cp_class[128] = {
+ ['\t'] = CPC_SPACE, ['\n'] = CPC_SPACE, ['\v'] = CPC_SPACE,
+ ['\f'] = CPC_SPACE, ['\r'] = CPC_SPACE, [' '] = CPC_SPACE,
+ ['0' ... '9'] = CPC_NUMBER, ['A' ... 'Z'] = CPC_LETTER, ['a' ... 'z'] = CPC_LETTER,
+};
+
+static int is_number_cp(int cp) {
+ if ((unsigned)cp < 0x80)
+ return ascii_cp_class[cp] & CPC_NUMBER;
+ if (cp >= 0x0660 && cp <= 0x0669)
+ return 1;
+ if (cp >= 0x06F0 && cp <= 0x06F9)
+ return 1;
+ if (cp >= 0x0966 && cp <= 0x096F)
+ return 1;
+ if (cp >= 0xFF10 && cp <= 0xFF19)
+ return 1;
+ return 0;
+}
+
+static int is_space_cp(int cp) {
+ if ((unsigned)cp < 0x80)
+ return ascii_cp_class[cp] & CPC_SPACE;
+ return cp == 0x85 || cp == 0xA0 || cp == 0x1680 || (cp >= 0x2000 && cp <= 0x200A) ||
+ cp == 0x2028 || cp == 0x2029 || cp == 0x202F || cp == 0x205F || cp == 0x3000;
+}
+
+static int is_symbolish_cp(int cp) {
+ if (cp < 0x80)
+ return 0;
+ if (cp >= 0x0300 && cp <= 0x036F)
+ return 1;
+ if (cp >= 0x00A1 && cp <= 0x00BF && cp != 0x00AA && cp != 0x00B5 && cp != 0x00BA)
+ return 1;
+ if (cp == 0x00D7 || cp == 0x00F7)
+ return 1;
+ if (cp >= 0x064B && cp <= 0x065F)
+ return 1;
+ if ((cp >= 0x0900 && cp <= 0x0903) || (cp >= 0x093A && cp <= 0x094F) ||
+ (cp >= 0x0951 && cp <= 0x0957) || (cp >= 0x0962 && cp <= 0x0963))
+ return 1;
+ if (cp >= 0x2000 && cp <= 0x206F)
+ return 1;
+ if (cp >= 0x2190 && cp <= 0x27BF)
+ return 1;
+ if (cp >= 0x2E00 && cp <= 0x2E7F)
+ return 1;
+ if (cp >= 0x3000 && cp <= 0x303F)
+ return 1;
+ if (cp >= 0x1F000 && cp <= 0x1FAFF)
+ return 1;
+ return 0;
+}
+
+static int compose_latin_mark(int base, int mark) {
+ switch (mark) {
+ case 0x0300:
+ switch (base) {
+ case 'A':
+ return 0x00C0;
+ case 'E':
+ return 0x00C8;
+ case 'I':
+ return 0x00CC;
+ case 'O':
+ return 0x00D2;
+ case 'U':
+ return 0x00D9;
+ case 'a':
+ return 0x00E0;
+ case 'e':
+ return 0x00E8;
+ case 'i':
+ return 0x00EC;
+ case 'o':
+ return 0x00F2;
+ case 'u':
+ return 0x00F9;
+ }
+ break;
+ case 0x0301:
+ switch (base) {
+ case 'A':
+ return 0x00C1;
+ case 'C':
+ return 0x0106;
+ case 'E':
+ return 0x00C9;
+ case 'I':
+ return 0x00CD;
+ case 'L':
+ return 0x0139;
+ case 'N':
+ return 0x0143;
+ case 'O':
+ return 0x00D3;
+ case 'R':
+ return 0x0154;
+ case 'S':
+ return 0x015A;
+ case 'U':
+ return 0x00DA;
+ case 'Y':
+ return 0x00DD;
+ case 'Z':
+ return 0x0179;
+ case 'a':
+ return 0x00E1;
+ case 'c':
+ return 0x0107;
+ case 'e':
+ return 0x00E9;
+ case 'i':
+ return 0x00ED;
+ case 'l':
+ return 0x013A;
+ case 'n':
+ return 0x0144;
+ case 'o':
+ return 0x00F3;
+ case 'r':
+ return 0x0155;
+ case 's':
+ return 0x015B;
+ case 'u':
+ return 0x00FA;
+ case 'y':
+ return 0x00FD;
+ case 'z':
+ return 0x017A;
+ }
+ break;
+ case 0x0302:
+ switch (base) {
+ case 'A':
+ return 0x00C2;
+ case 'E':
+ return 0x00CA;
+ case 'I':
+ return 0x00CE;
+ case 'O':
+ return 0x00D4;
+ case 'U':
+ return 0x00DB;
+ case 'a':
+ return 0x00E2;
+ case 'e':
+ return 0x00EA;
+ case 'i':
+ return 0x00EE;
+ case 'o':
+ return 0x00F4;
+ case 'u':
+ return 0x00FB;
+ }
+ break;
+ case 0x0303:
+ switch (base) {
+ case 'A':
+ return 0x00C3;
+ case 'N':
+ return 0x00D1;
+ case 'O':
+ return 0x00D5;
+ case 'a':
+ return 0x00E3;
+ case 'n':
+ return 0x00F1;
+ case 'o':
+ return 0x00F5;
+ }
+ break;
+ case 0x0308:
+ switch (base) {
+ case 'A':
+ return 0x00C4;
+ case 'E':
+ return 0x00CB;
+ case 'I':
+ return 0x00CF;
+ case 'O':
+ return 0x00D6;
+ case 'U':
+ return 0x00DC;
+ case 'Y':
+ return 0x0178;
+ case 'a':
+ return 0x00E4;
+ case 'e':
+ return 0x00EB;
+ case 'i':
+ return 0x00EF;
+ case 'o':
+ return 0x00F6;
+ case 'u':
+ return 0x00FC;
+ case 'y':
+ return 0x00FF;
+ }
+ break;
+ case 0x030A:
+ switch (base) {
+ case 'A':
+ return 0x00C5;
+ case 'a':
+ return 0x00E5;
+ }
+ break;
+ case 0x0327:
+ switch (base) {
+ case 'C':
+ return 0x00C7;
+ case 'c':
+ return 0x00E7;
+ }
+ break;
+ }
+ return 0;
+}
+
+static char *normalize_nfc_latin(const char *text) {
+ const unsigned char *p = (const unsigned char *)text;
+ const unsigned char *end = p + strlen(text);
+ char *out = (char *)malloc((size_t)(end - p) * 2 + 1);
+ if (!out)
+ return NULL;
+
+ size_t w = 0;
+ while (p < end) {
+ const unsigned char *cur = p;
+ int cp = 0, len = 0;
+ if (!utf8_decode_cp_len(p, end, &cp, &len))
+ break;
+ p += len;
+
+ if (p < end) {
+ int mark = 0, mark_len = 0;
+ utf8_decode_cp_len(p, end, &mark, &mark_len);
+ int composed = compose_latin_mark(cp, mark);
+ if (composed) {
+ char tmp[4];
+ int n = utf8_encode_cp(composed, tmp);
+ for (int i = 0; i < n; i++)
+ out[w++] = tmp[i];
+ p += mark_len;
+ continue;
+ }
+ }
+
+ memcpy(out + w, cur, (size_t)len);
+ w += (size_t)len;
+ }
+
+ out[w] = '\0';
+ return out;
+}
+
+static int is_letter_cp(int cp) {
+ if ((unsigned)cp < 0x80)
+ return ascii_cp_class[cp] & CPC_LETTER;
+ if (is_space_cp(cp) || is_number_cp(cp) || is_symbolish_cp(cp))
+ return 0;
+ return 1;
+}
+
+static int is_word_cp(int cp) { return is_letter_cp(cp) || is_number_cp(cp); }
+
+static int is_newline_cp(int cp) { return cp == '\n' || cp == '\r'; }
+
+static int ascii_lower(int c) { return (c >= 'A' && c <= 'Z') ? c + ('a' - 'A') : c; }
+
+static int match_contraction(const unsigned char *p, const unsigned char *end) {
+ if (p >= end || *p != '\'')
+ return 0;
+ int remain = (int)(end - p);
+ if (remain >= 2) {
+ int c1 = ascii_lower(p[1]);
+ if (c1 == 's' || c1 == 't' || c1 == 'm' || c1 == 'd')
+ return 2;
+ }
+ if (remain >= 3) {
+ int c1 = ascii_lower(p[1]);
+ int c2 = ascii_lower(p[2]);
+ if ((c1 == 'r' && c2 == 'e') || (c1 == 'v' && c2 == 'e') || (c1 == 'l' && c2 == 'l'))
+ return 3;
+ }
+ return 0;
+}
+
+static int append_encoded_piece(const embed_tokenizer_t *tok,
+ const char *piece,
+ size_t piece_len,
+ int **ids,
+ int *n_ids,
+ int *cap) {
+ if (piece_len == 0)
+ return 0;
+
+ char *tmp = (char *)malloc(piece_len + 1);
+ if (!tmp)
+ return -1;
+ memcpy(tmp, piece, piece_len);
+ tmp[piece_len] = '\0';
+
+ char *mapped = text_to_bpe_unicode(tmp);
+ free(tmp);
+ if (!mapped)
+ return -1;
+
+ int *piece_ids = NULL;
+ int n_piece = 0;
+ if (encode_bpe_word(tok, mapped, &piece_ids, &n_piece) != 0) {
+ free(mapped);
+ free(piece_ids);
+ return -1;
+ }
+ free(mapped);
+
+ for (int i = 0; i < n_piece; i++) {
+ if (append_id(ids, n_ids, cap, piece_ids[i]) != 0) {
+ free(piece_ids);
+ return -1;
+ }
+ }
+ free(piece_ids);
+ return 0;
+}
+
+static int
+encode_pretokenized(const embed_tokenizer_t *tok, const char *text, int **out_ids, int *out_n) {
+ const unsigned char *start = (const unsigned char *)text;
+ const unsigned char *p = start;
+ const unsigned char *end = start + strlen(text);
+ int *ids = NULL;
+ int n_ids = 0, cap = 0;
+
+ while (p < end) {
+ const unsigned char *piece = p;
+ int cp = 0, len = 0;
+ if (!utf8_decode_cp_len(p, end, &cp, &len))
+ break;
+
+ int clen = match_contraction(p, end);
+ if (clen > 0) {
+ p += clen;
+ } else {
+ const unsigned char *next = p + len;
+ int next_cp = 0, next_len = 0;
+ int has_next = utf8_decode_cp_len(next, end, &next_cp, &next_len);
+
+ if (!is_newline_cp(cp) && !is_word_cp(cp) && has_next && is_letter_cp(next_cp)) {
+ p = next + next_len;
+ while (p < end) {
+ int c = 0, l = 0;
+ utf8_decode_cp_len(p, end, &c, &l);
+ if (!is_letter_cp(c))
+ break;
+ p += l;
+ }
+ } else if (is_letter_cp(cp)) {
+ p += len;
+ while (p < end) {
+ int c = 0, l = 0;
+ utf8_decode_cp_len(p, end, &c, &l);
+ if (!is_letter_cp(c))
+ break;
+ p += l;
+ }
+ } else if (is_number_cp(cp)) {
+ p += len;
+ } else if (is_space_cp(cp)) {
+ const unsigned char *q = p;
+ int saw_newline = 0;
+ while (q < end) {
+ int c = 0, l = 0;
+ utf8_decode_cp_len(q, end, &c, &l);
+ if (!is_space_cp(c))
+ break;
+ if (is_newline_cp(c))
+ saw_newline = 1;
+ q += l;
+ if (saw_newline) {
+ while (q < end) {
+ int c2 = 0, l2 = 0;
+ utf8_decode_cp_len(q, end, &c2, &l2);
+ if (!is_newline_cp(c2))
+ break;
+ q += l2;
+ }
+ break;
+ }
+ }
+
+ if (saw_newline) {
+ p = q;
+ } else if (cp == ' ' && has_next && !is_space_cp(next_cp) && !is_word_cp(next_cp)) {
+ p = next + next_len;
+ while (p < end) {
+ int c = 0, l = 0;
+ utf8_decode_cp_len(p, end, &c, &l);
+ if (is_space_cp(c) || is_word_cp(c))
+ break;
+ p += l;
+ }
+ while (p < end) {
+ int c = 0, l = 0;
+ utf8_decode_cp_len(p, end, &c, &l);
+ if (!is_newline_cp(c))
+ break;
+ p += l;
+ }
+ } else {
+ const unsigned char *last = p;
+ const unsigned char *q2 = p;
+ int count = 0;
+ while (q2 < end) {
+ int c = 0, l = 0;
+ utf8_decode_cp_len(q2, end, &c, &l);
+ if (!is_space_cp(c))
+ break;
+ last = q2;
+ q2 += l;
+ count++;
+ }
+ if (q2 < end && count > 1)
+ p = last;
+ else
+ p = q2;
+ }
+ } else {
+ p += len;
+ while (p < end) {
+ int c = 0, l = 0;
+ utf8_decode_cp_len(p, end, &c, &l);
+ if (is_space_cp(c) || is_word_cp(c))
+ break;
+ p += l;
+ }
+ while (p < end) {
+ int c = 0, l = 0;
+ utf8_decode_cp_len(p, end, &c, &l);
+ if (!is_newline_cp(c))
+ break;
+ p += l;
+ }
+ }
+ }
+
+ if (append_encoded_piece(tok, (const char *)piece, (size_t)(p - piece), &ids, &n_ids,
+ &cap) != 0) {
+ free(ids);
+ return -1;
+ }
+ }
+
+ *out_ids = ids;
+ *out_n = n_ids;
+ return 0;
+}
+
+/* Encode one mapped BPE unicode string to token IDs. */
+static int
+encode_bpe_word(const embed_tokenizer_t *tok, const char *mapped, int **out_ids, int *out_n) {
+ *out_ids = NULL;
+ *out_n = 0;
+ if (!mapped || !*mapped)
+ return 0;
+
+ char **syms = NULL;
+ int n_syms = 0;
+ if (split_utf8_symbols(mapped, &syms, &n_syms) != 0)
+ return -1;
+ if (n_syms <= 0) {
+ free(syms);
+ return 0;
+ }
+
+ while (n_syms > 1) {
+ int best_rank = INT_MAX;
+ int best_i = -1;
+ for (int i = 0; i < n_syms - 1; i++) {
+ int r = merge_rank(tok, syms[i], syms[i + 1]);
+ if (r < best_rank) {
+ best_rank = r;
+ best_i = i;
+ }
+ }
+ if (best_i < 0 || best_rank == INT_MAX)
+ break;
+
+ char *merged = str_concat2(syms[best_i], syms[best_i + 1]);
+ if (!merged) {
+ for (int i = 0; i < n_syms; i++)
+ free(syms[i]);
+ free(syms);
+ return -1;
+ }
+ free(syms[best_i]);
+ free(syms[best_i + 1]);
+ syms[best_i] = merged;
+ for (int j = best_i + 1; j < n_syms - 1; j++)
+ syms[j] = syms[j + 1];
+ n_syms--;
+ }
+
+ int *ids = NULL;
+ int n_ids = 0, cap = 0;
+ for (int i = 0; i < n_syms; i++) {
+ int id = map_get((const str_int_entry_t *)tok->vocab_map, tok->vocab_map_cap, syms[i]);
+ if (id < 0) {
+ /* Should not happen with valid vocab + merges + byte-level mapping. */
+ for (int k = 0; k < n_syms; k++)
+ free(syms[k]);
+ free(syms);
+ free(ids);
+ return -1;
+ }
+ if (append_id(&ids, &n_ids, &cap, id) != 0) {
+ for (int k = 0; k < n_syms; k++)
+ free(syms[k]);
+ free(syms);
+ free(ids);
+ return -1;
+ }
+ }
+
+ for (int i = 0; i < n_syms; i++)
+ free(syms[i]);
+ free(syms);
+
+ *out_ids = ids;
+ *out_n = n_ids;
+ return 0;
+}
+
+typedef struct {
+ size_t off;
+} bpe_sym_ref_t;
+
+struct embed_tokenizer_workspace {
+ char *normalized;
+ size_t normalized_cap;
+ char *mapped;
+ size_t mapped_cap;
+ char *arena;
+ size_t arena_cap;
+ size_t arena_len;
+ bpe_sym_ref_t *syms;
+ int syms_cap;
+ int *ids;
+ int ids_cap;
+ /* Integer-pair BPE merge scratch: token id, doubly-linked live order,
+ * and the cached (rank, merged id) of the pair starting at each live
+ * position. */
+ int *bpe_ids;
+ int *bpe_prv;
+ int *bpe_nxt;
+ int *bpe_rnk;
+ int *bpe_mrg;
+ int bpe_cap;
+};
+
+static int reserve_bpe(embed_tokenizer_workspace_t *ws, int need) {
+ if (ws->bpe_cap >= need)
+ return 0;
+ int new_cap = ws->bpe_cap ? ws->bpe_cap : 64;
+ while (new_cap < need) {
+ if (new_cap > INT_MAX / 2)
+ return -1;
+ new_cap *= 2;
+ }
+ int *p;
+#define R(field) \
+ p = (int *)realloc(ws->field, (size_t)new_cap * sizeof(int)); \
+ if (!p) \
+ return -1; \
+ ws->field = p;
+ R(bpe_ids)
+ R(bpe_prv)
+ R(bpe_nxt)
+ R(bpe_rnk)
+ R(bpe_mrg)
+#undef R
+ ws->bpe_cap = new_cap;
+ return 0;
+}
+
+static int reserve_bytes(char **buf, size_t *cap, size_t need) {
+ if (*cap >= need)
+ return 0;
+ size_t new_cap = *cap ? *cap : 256;
+ while (new_cap < need) {
+ if (new_cap > SIZE_MAX / 2)
+ return -1;
+ new_cap *= 2;
+ }
+ char *p = (char *)realloc(*buf, new_cap);
+ if (!p)
+ return -1;
+ *buf = p;
+ *cap = new_cap;
+ return 0;
+}
+
+static int reserve_ints(int **buf, int *cap, int need) {
+ if (*cap >= need)
+ return 0;
+ int new_cap = *cap ? *cap : 64;
+ while (new_cap < need) {
+ if (new_cap > INT_MAX / 2)
+ return -1;
+ new_cap *= 2;
+ }
+ int *p = (int *)realloc(*buf, (size_t)new_cap * sizeof(int));
+ if (!p)
+ return -1;
+ *buf = p;
+ *cap = new_cap;
+ return 0;
+}
+
+static int reserve_syms(embed_tokenizer_workspace_t *ws, int need) {
+ if (ws->syms_cap >= need)
+ return 0;
+ int new_cap = ws->syms_cap ? ws->syms_cap : 64;
+ while (new_cap < need) {
+ if (new_cap > INT_MAX / 2)
+ return -1;
+ new_cap *= 2;
+ }
+ bpe_sym_ref_t *p = (bpe_sym_ref_t *)realloc(ws->syms, (size_t)new_cap * sizeof(*ws->syms));
+ if (!p)
+ return -1;
+ ws->syms = p;
+ ws->syms_cap = new_cap;
+ return 0;
+}
+
+static int arena_append(embed_tokenizer_workspace_t *ws, const char *s, size_t len, size_t *off) {
+ if (ws->arena_len > SIZE_MAX - len - 1)
+ return -1;
+ size_t need = ws->arena_len + len + 1;
+ if (reserve_bytes(&ws->arena, &ws->arena_cap, need) != 0)
+ return -1;
+ *off = ws->arena_len;
+ memcpy(ws->arena + ws->arena_len, s, len);
+ ws->arena_len += len;
+ ws->arena[ws->arena_len++] = '\0';
+ return 0;
+}
+
+static const char *arena_str(const embed_tokenizer_workspace_t *ws, bpe_sym_ref_t sym) {
+ return ws->arena + sym.off;
+}
+
+static int
+normalize_nfc_latin_into(embed_tokenizer_workspace_t *ws, const char *text, const char **out) {
+ const unsigned char *p = (const unsigned char *)text;
+ const unsigned char *end = p + strlen(text);
+ size_t in_len = (size_t)(end - p);
+ if (in_len > (SIZE_MAX - 1) / 2)
+ return -1;
+ if (reserve_bytes(&ws->normalized, &ws->normalized_cap, in_len * 2 + 1) != 0)
+ return -1;
+
+ size_t w = 0;
+ while (p < end) {
+ const unsigned char *cur = p;
+ int cp = 0, len = 0;
+ if (!utf8_decode_cp_len(p, end, &cp, &len))
+ break;
+ p += len;
+
+ if (p < end) {
+ int mark = 0, mark_len = 0;
+ utf8_decode_cp_len(p, end, &mark, &mark_len);
+ int composed = compose_latin_mark(cp, mark);
+ if (composed) {
+ char tmp[4];
+ int n = utf8_encode_cp(composed, tmp);
+ memcpy(ws->normalized + w, tmp, (size_t)n);
+ w += (size_t)n;
+ p += mark_len;
+ continue;
+ }
+ }
+
+ memcpy(ws->normalized + w, cur, (size_t)len);
+ w += (size_t)len;
+ }
+
+ ws->normalized[w] = '\0';
+ *out = ws->normalized;
+ return 0;
+}
+
+static int text_to_bpe_unicode_into(embed_tokenizer_workspace_t *ws,
+ const char *text,
+ size_t len,
+ const char **out) {
+ init_gpt2_mapping();
+ if (len > (SIZE_MAX - 1) / 3)
+ return -1;
+ if (reserve_bytes(&ws->mapped, &ws->mapped_cap, len * 3 + 1) != 0)
+ return -1;
+
+ size_t w = 0;
+ for (size_t i = 0; i < len; i++) {
+ int cp = gpt2_byte_to_unicode[(unsigned char)text[i]];
+ char tmp[4];
+ int n = utf8_encode_cp(cp, tmp);
+ memcpy(ws->mapped + w, tmp, (size_t)n);
+ w += (size_t)n;
+ }
+ ws->mapped[w] = '\0';
+ *out = ws->mapped;
+ return 0;
+}
+
+static int output_append_id(int *out_ids, int out_cap, int *n_ids, int *overflow, int id) {
+ if (*n_ids < out_cap && out_ids)
+ out_ids[*n_ids] = id;
+ else
+ *overflow = 1;
+ (*n_ids)++;
+ return 0;
+}
+
+static int encode_bpe_word_into_slow(const embed_tokenizer_t *tok,
+ embed_tokenizer_workspace_t *ws,
+ const char *mapped,
+ int *out_ids,
+ int out_cap,
+ int *n_ids,
+ int *overflow) {
+ if (!mapped || !*mapped)
+ return 0;
+
+ int n_syms = 0;
+ for (const unsigned char *p = (const unsigned char *)mapped; *p;) {
+ int l = utf8_char_len(*p);
+ p += l;
+ n_syms++;
+ }
+ if (n_syms <= 0)
+ return 0;
+ if (reserve_syms(ws, n_syms) != 0)
+ return -1;
+
+ ws->arena_len = 0;
+ int i = 0;
+ for (const unsigned char *p = (const unsigned char *)mapped; *p;) {
+ int l = utf8_char_len(*p);
+ size_t off = 0;
+ if (arena_append(ws, (const char *)p, (size_t)l, &off) != 0)
+ return -1;
+ ws->syms[i++].off = off;
+ p += l;
+ }
+
+ while (n_syms > 1) {
+ int best_rank = INT_MAX;
+ int best_i = -1;
+ for (int j = 0; j < n_syms - 1; j++) {
+ int r = merge_rank(tok, arena_str(ws, ws->syms[j]), arena_str(ws, ws->syms[j + 1]));
+ if (r < best_rank) {
+ best_rank = r;
+ best_i = j;
+ }
+ }
+ if (best_i < 0 || best_rank == INT_MAX)
+ break;
+
+ const char *a = arena_str(ws, ws->syms[best_i]);
+ const char *b = arena_str(ws, ws->syms[best_i + 1]);
+ size_t la = strlen(a), lb = strlen(b);
+ if (la > SIZE_MAX - lb)
+ return -1;
+ if (reserve_bytes(&ws->arena, &ws->arena_cap, ws->arena_len + la + lb + 1) != 0)
+ return -1;
+
+ a = arena_str(ws, ws->syms[best_i]);
+ b = arena_str(ws, ws->syms[best_i + 1]);
+ size_t off = ws->arena_len;
+ memcpy(ws->arena + ws->arena_len, a, la);
+ ws->arena_len += la;
+ memcpy(ws->arena + ws->arena_len, b, lb);
+ ws->arena_len += lb;
+ ws->arena[ws->arena_len++] = '\0';
+ ws->syms[best_i].off = off;
+ for (int j = best_i + 1; j < n_syms - 1; j++)
+ ws->syms[j] = ws->syms[j + 1];
+ n_syms--;
+ }
+
+ for (int j = 0; j < n_syms; j++) {
+ int id = map_get((const str_int_entry_t *)tok->vocab_map, tok->vocab_map_cap,
+ arena_str(ws, ws->syms[j]));
+ if (id < 0)
+ return -1;
+ output_append_id(out_ids, out_cap, n_ids, overflow, id);
+ }
+ return 0;
+}
+
+/* Integer-pair BPE merge: token ids in a doubly-linked array with cached
+ * pair ranks; each merge updates only the two adjacent pairs. Falls back to
+ * the string-based loop when the int tables are unavailable. Identical
+ * output: initial ids are the byte-level single-char token ids and every
+ * merge result is the vocab id of the concatenated pair. */
+static int encode_bpe_word_into(const embed_tokenizer_t *tok,
+ embed_tokenizer_workspace_t *ws,
+ const char *mapped,
+ int *out_ids,
+ int out_cap,
+ int *n_ids,
+ int *overflow) {
+ if (!mapped || !*mapped)
+ return 0;
+ if (!tok->int_merges || !tok->cp_to_id)
+ return encode_bpe_word_into_slow(tok, ws, mapped, out_ids, out_cap, n_ids, overflow);
+
+ int n = 0;
+ for (const unsigned char *p = (const unsigned char *)mapped; *p;) {
+ p += utf8_char_len(*p);
+ n++;
+ }
+ if (n <= 0)
+ return 0;
+ if (reserve_bpe(ws, n) != 0)
+ return -1;
+
+ int *ids = ws->bpe_ids, *prv = ws->bpe_prv, *nxt = ws->bpe_nxt;
+ int *rnk = ws->bpe_rnk, *mrg = ws->bpe_mrg;
+
+ int i = 0;
+ for (const unsigned char *p = (const unsigned char *)mapped; *p;) {
+ int len = utf8_char_len(*p);
+ int cp;
+ if (len == 1)
+ cp = *p;
+ else if (len == 2)
+ cp = ((*p & 0x1F) << 6) | (p[1] & 0x3F);
+ else
+ cp = 512; /* byte-level alphabet never exceeds two bytes */
+ int id = cp < 512 ? tok->cp_to_id[cp] : -1;
+ if (id < 0)
+ return encode_bpe_word_into_slow(tok, ws, mapped, out_ids, out_cap, n_ids, overflow);
+ ids[i] = id;
+ prv[i] = i - 1;
+ nxt[i] = i + 1 < n ? i + 1 : -1;
+ i++;
+ p += len;
+ }
+
+ for (int j = 0; j < n - 1; j++)
+ rnk[j] = pair_merge_lookup(tok, ids[j], ids[j + 1], &mrg[j]);
+ if (n > 0)
+ rnk[n - 1] = INT_MAX;
+
+ for (;;) {
+ int best = -1, best_rank = INT_MAX;
+ for (int j = 0; j != -1 && nxt[j] != -1; j = nxt[j]) {
+ if (rnk[j] < best_rank) {
+ best_rank = rnk[j];
+ best = j;
+ }
+ }
+ if (best < 0)
+ break;
+
+ ids[best] = mrg[best];
+ int dead = nxt[best];
+ nxt[best] = nxt[dead];
+ if (nxt[dead] != -1)
+ prv[nxt[dead]] = best;
+
+ if (prv[best] != -1)
+ rnk[prv[best]] = pair_merge_lookup(tok, ids[prv[best]], ids[best], &mrg[prv[best]]);
+ rnk[best] = nxt[best] != -1 ? pair_merge_lookup(tok, ids[best], ids[nxt[best]], &mrg[best])
+ : INT_MAX;
+ }
+
+ for (int j = 0; j != -1; j = nxt[j])
+ output_append_id(out_ids, out_cap, n_ids, overflow, ids[j]);
+ return 0;
+}
+
+static int append_encoded_piece_into(const embed_tokenizer_t *tok,
+ embed_tokenizer_workspace_t *ws,
+ const char *piece,
+ size_t piece_len,
+ int *out_ids,
+ int out_cap,
+ int *n_ids,
+ int *overflow) {
+ if (piece_len == 0)
+ return 0;
+
+ const char *mapped = NULL;
+ if (text_to_bpe_unicode_into(ws, piece, piece_len, &mapped) != 0)
+ return -1;
+ return encode_bpe_word_into(tok, ws, mapped, out_ids, out_cap, n_ids, overflow);
+}
+
+static int encode_pretokenized_into(const embed_tokenizer_t *tok,
+ embed_tokenizer_workspace_t *ws,
+ const char *text,
+ int *out_ids,
+ int out_cap,
+ int *out_n) {
+ const unsigned char *start = (const unsigned char *)text;
+ const unsigned char *p = start;
+ const unsigned char *end = start + strlen(text);
+ int n_ids = 0;
+ int overflow = 0;
+
+ while (p < end) {
+ const unsigned char *piece = p;
+ int cp = 0, len = 0;
+ if (!utf8_decode_cp_len(p, end, &cp, &len))
+ break;
+
+ int clen = match_contraction(p, end);
+ if (clen > 0) {
+ p += clen;
+ } else {
+ const unsigned char *next = p + len;
+ int next_cp = 0, next_len = 0;
+ int has_next = utf8_decode_cp_len(next, end, &next_cp, &next_len);
+
+ if (!is_newline_cp(cp) && !is_word_cp(cp) && has_next && is_letter_cp(next_cp)) {
+ p = next + next_len;
+ while (p < end) {
+ int c = 0, l = 0;
+ utf8_decode_cp_len(p, end, &c, &l);
+ if (!is_letter_cp(c))
+ break;
+ p += l;
+ }
+ } else if (is_letter_cp(cp)) {
+ p += len;
+ while (p < end) {
+ int c = 0, l = 0;
+ utf8_decode_cp_len(p, end, &c, &l);
+ if (!is_letter_cp(c))
+ break;
+ p += l;
+ }
+ } else if (is_number_cp(cp)) {
+ p += len;
+ } else if (is_space_cp(cp)) {
+ const unsigned char *q = p;
+ int saw_newline = 0;
+ while (q < end) {
+ int c = 0, l = 0;
+ utf8_decode_cp_len(q, end, &c, &l);
+ if (!is_space_cp(c))
+ break;
+ if (is_newline_cp(c))
+ saw_newline = 1;
+ q += l;
+ if (saw_newline) {
+ while (q < end) {
+ int c2 = 0, l2 = 0;
+ utf8_decode_cp_len(q, end, &c2, &l2);
+ if (!is_newline_cp(c2))
+ break;
+ q += l2;
+ }
+ break;
+ }
+ }
+
+ if (saw_newline) {
+ p = q;
+ } else if (cp == ' ' && has_next && !is_space_cp(next_cp) && !is_word_cp(next_cp)) {
+ p = next + next_len;
+ while (p < end) {
+ int c = 0, l = 0;
+ utf8_decode_cp_len(p, end, &c, &l);
+ if (is_space_cp(c) || is_word_cp(c))
+ break;
+ p += l;
+ }
+ while (p < end) {
+ int c = 0, l = 0;
+ utf8_decode_cp_len(p, end, &c, &l);
+ if (!is_newline_cp(c))
+ break;
+ p += l;
+ }
+ } else {
+ const unsigned char *last = p;
+ const unsigned char *q2 = p;
+ int count = 0;
+ while (q2 < end) {
+ int c = 0, l = 0;
+ utf8_decode_cp_len(q2, end, &c, &l);
+ if (!is_space_cp(c))
+ break;
+ last = q2;
+ q2 += l;
+ count++;
+ }
+ if (q2 < end && count > 1)
+ p = last;
+ else
+ p = q2;
+ }
+ } else {
+ p += len;
+ while (p < end) {
+ int c = 0, l = 0;
+ utf8_decode_cp_len(p, end, &c, &l);
+ if (is_space_cp(c) || is_word_cp(c))
+ break;
+ p += l;
+ }
+ while (p < end) {
+ int c = 0, l = 0;
+ utf8_decode_cp_len(p, end, &c, &l);
+ if (!is_newline_cp(c))
+ break;
+ p += l;
+ }
+ }
+ }
+
+ if (append_encoded_piece_into(tok, ws, (const char *)piece, (size_t)(p - piece), out_ids,
+ out_cap, &n_ids, &overflow) != 0)
+ return -1;
+ }
+
+ *out_n = n_ids;
+ return overflow ? -2 : 0;
+}
+
+static int derive_merges_path(const char *vocab_path, char *out_path, size_t out_cap) {
+ const char *slash = strrchr(vocab_path, '/');
+ if (!slash) {
+ if (snprintf(out_path, out_cap, "merges.txt") >= (int)out_cap)
+ return -1;
+ return 0;
+ }
+ size_t dir_len = (size_t)(slash - vocab_path);
+ if (dir_len + 12 >= out_cap)
+ return -1;
+ memcpy(out_path, vocab_path, dir_len);
+ out_path[dir_len] = '\0';
+ snprintf(out_path + dir_len, out_cap - dir_len, "/merges.txt");
+ return 0;
+}
+
+static void trim_newline(char *line) {
+ size_t n = strlen(line);
+ while (n > 0 && (line[n - 1] == '\n' || line[n - 1] == '\r'))
+ line[--n] = '\0';
+}
+
+static int parse_merge_pair(char *line, char **a, char **b) {
+ *a = NULL;
+ *b = NULL;
+ trim_newline(line);
+ if (line[0] == '\0')
+ return -1;
+ if (line[0] == '#')
+ return -1;
+
+ char *sp = strchr(line, ' ');
+ if (!sp)
+ return -1;
+ *sp = '\0';
+ char *p2 = sp + 1;
+ while (*p2 == ' ')
+ p2++;
+ if (*line == '\0' || *p2 == '\0')
+ return -1;
+ *a = line;
+ *b = p2;
+ return 0;
+}
+
+static int load_merges_map(embed_tokenizer_t *tok, const char *merges_path) {
+ FILE *f = fopen(merges_path, "rb");
+ if (!f)
+ return -1;
+
+ int n_pairs = 0;
+ char line[8192];
+ while (fgets(line, sizeof(line), f)) {
+ char *a = NULL, *b = NULL;
+ if (parse_merge_pair(line, &a, &b) == 0)
+ n_pairs++;
+ }
+ if (n_pairs <= 0) {
+ fclose(f);
+ return -1;
+ }
+
+ tok->merge_map_cap = next_pow2(n_pairs * 2);
+ tok->merge_map = calloc((size_t)tok->merge_map_cap, sizeof(str_int_entry_t));
+ if (!tok->merge_map) {
+ fclose(f);
+ tok->merge_map_cap = 0;
+ return -1;
+ }
+
+ if (fseek(f, 0, SEEK_SET) != 0) {
+ fclose(f);
+ return -1;
+ }
+ tok->int_merges_cap = next_pow2(n_pairs * 2);
+ pair_merge_entry_t *pm =
+ (pair_merge_entry_t *)calloc((size_t)tok->int_merges_cap, sizeof(pair_merge_entry_t));
+ if (pm) {
+ for (int i = 0; i < tok->int_merges_cap; i++) {
+ pm[i].key = UINT64_MAX;
+ pm[i].rank = INT_MAX;
+ pm[i].merged_id = -1;
+ }
+ }
+ tok->int_merges = pm;
+
+ int rank = 0;
+ while (fgets(line, sizeof(line), f)) {
+ char *a = NULL, *b = NULL;
+ if (parse_merge_pair(line, &a, &b) != 0)
+ continue;
+
+ size_t la = strlen(a), lb = strlen(b);
+ char *key = (char *)malloc(la + 1 + lb + 1);
+ if (!key)
+ continue;
+ memcpy(key, a, la);
+ key[la] = ' ';
+ memcpy(key + la + 1, b, lb);
+ key[la + 1 + lb] = '\0';
+
+ if (tok->int_merges) {
+ /* Resolve (a, b) and the merged token a+b to vocab ids; if any
+ * merge is unresolvable, drop the whole int table and keep the
+ * string-based loop as the only path. */
+ const str_int_entry_t *vm = (const str_int_entry_t *)tok->vocab_map;
+ int left = map_get(vm, tok->vocab_map_cap, a);
+ int right = map_get(vm, tok->vocab_map_cap, b);
+ char ab[8192];
+ int merged = -1;
+ if (la + lb < sizeof(ab)) {
+ memcpy(ab, a, la);
+ memcpy(ab + la, b, lb);
+ ab[la + lb] = '\0';
+ merged = map_get(vm, tok->vocab_map_cap, ab);
+ }
+ if (left < 0 || right < 0 || merged < 0) {
+ free(tok->int_merges);
+ tok->int_merges = NULL;
+ tok->int_merges_cap = 0;
+ } else {
+ pair_map_insert((pair_merge_entry_t *)tok->int_merges, tok->int_merges_cap,
+ ((uint64_t)(uint32_t)left << 32) | (uint32_t)right, rank, merged);
+ }
+ }
+ (void)map_insert_owned((str_int_entry_t *)tok->merge_map, tok->merge_map_cap, &key, rank);
+ free(key);
+ rank++;
+ }
+ fclose(f);
+
+ /* Byte-level unicode codepoint -> single-char token id table. */
+ if (tok->int_merges) {
+ init_gpt2_mapping();
+ tok->cp_to_id = (int *)malloc(512 * sizeof(int));
+ if (tok->cp_to_id) {
+ for (int i = 0; i < 512; i++)
+ tok->cp_to_id[i] = -1;
+ for (int byte = 0; byte < 256 && tok->cp_to_id; byte++) {
+ int cp = gpt2_byte_to_unicode[byte];
+ char buf[4];
+ int n;
+ if (cp < 0x80) {
+ buf[0] = (char)cp;
+ n = 1;
+ } else {
+ buf[0] = (char)(0xC0 | (cp >> 6));
+ buf[1] = (char)(0x80 | (cp & 0x3F));
+ n = 2;
+ }
+ buf[n] = '\0';
+ int id = map_get((const str_int_entry_t *)tok->vocab_map, tok->vocab_map_cap, buf);
+ if (id < 0) {
+ free(tok->cp_to_id);
+ tok->cp_to_id = NULL;
+ } else {
+ tok->cp_to_id[cp] = id;
+ }
+ }
+ }
+ }
+ return 0;
+}
+
+/* ========================================================================
+ * Public API
+ * ======================================================================== */
+
+embed_tokenizer_t *embed_tokenizer_load(const char *vocab_json_path) {
+ FILE *f = fopen(vocab_json_path, "rb");
+ if (!f) {
+ fprintf(stderr, "embed_tokenizer_load: cannot open %s\n", vocab_json_path);
+ return NULL;
+ }
+
+ if (fseek(f, 0, SEEK_END) != 0) {
+ fclose(f);
+ return NULL;
+ }
+ long file_size = ftell(f);
+ if (file_size < 0 || fseek(f, 0, SEEK_SET) != 0) {
+ fclose(f);
+ return NULL;
+ }
+
+ char *json = (char *)malloc((size_t)file_size + 1);
+ if (!json || fread(json, 1, (size_t)file_size, f) != (size_t)file_size) {
+ fclose(f);
+ free(json);
+ return NULL;
+ }
+ fclose(f);
+ json[file_size] = '\0';
+
+ int max_id = 0;
+ const char *p = json;
+ skip_ws(&p);
+ if (*p != '{') {
+ free(json);
+ return NULL;
+ }
+ p++;
+
+ const char *saved = p;
+ while (*p && *p != '}') {
+ skip_ws(&p);
+ if (*p == ',') {
+ p++;
+ continue;
+ }
+ if (*p == '}')
+ break;
+
+ char key[4096] = {0};
+ if (parse_json_string(&p, key, sizeof(key)) != 0)
+ break;
+ skip_ws(&p);
+ if (*p != ':')
+ break;
+ p++;
+ int64_t id = parse_json_int(&p);
+ if (id > max_id)
+ max_id = (int)id;
+ }
+
+ int vocab_size = max_id + 1;
+ embed_tokenizer_t *tok = (embed_tokenizer_t *)calloc(1, sizeof(embed_tokenizer_t));
+ if (!tok) {
+ free(json);
+ return NULL;
+ }
+ tok->vocab_size = vocab_size;
+ tok->id_to_text = (char **)calloc((size_t)vocab_size, sizeof(char *));
+ tok->id_to_bpe = (char **)calloc((size_t)vocab_size, sizeof(char *));
+ if (!tok->id_to_text || !tok->id_to_bpe) {
+ embed_tokenizer_free(tok);
+ free(json);
+ return NULL;
+ }
+
+ p = saved;
+ while (*p && *p != '}') {
+ skip_ws(&p);
+ if (*p == ',') {
+ p++;
+ continue;
+ }
+ if (*p == '}')
+ break;
+
+ char key[4096] = {0};
+ if (parse_json_string(&p, key, sizeof(key)) != 0)
+ break;
+ skip_ws(&p);
+ if (*p != ':')
+ break;
+ p++;
+ int64_t id = parse_json_int(&p);
+
+ if (id >= 0 && id < vocab_size) {
+ free(tok->id_to_bpe[id]);
+ free(tok->id_to_text[id]);
+ tok->id_to_bpe[id] = strdup(key);
+ tok->id_to_text[id] = decode_gpt2_token(key);
+ }
+ }
+ free(json);
+
+ int n_vocab_entries = 0;
+ for (int i = 0; i < vocab_size; i++)
+ if (tok->id_to_bpe[i])
+ n_vocab_entries++;
+ tok->vocab_map_cap = next_pow2(n_vocab_entries * 2 + 1);
+ tok->vocab_map = calloc((size_t)tok->vocab_map_cap, sizeof(str_int_entry_t));
+ if (!tok->vocab_map) {
+ embed_tokenizer_free(tok);
+ return NULL;
+ }
+ for (int i = 0; i < vocab_size; i++) {
+ if (tok->id_to_bpe[i]) {
+ map_insert((str_int_entry_t *)tok->vocab_map, tok->vocab_map_cap, tok->id_to_bpe[i], i);
+ }
+ }
+
+ char merges_path[1024];
+ if (derive_merges_path(vocab_json_path, merges_path, sizeof(merges_path)) == 0) {
+ if (load_merges_map(tok, merges_path) != 0 && embed_verbose >= 2) {
+ fprintf(stderr,
+ "Tokenizer: merges not loaded from %s (encoding falls back to byte-level)\n",
+ merges_path);
+ }
+ }
+
+ return tok;
+}
+
+const char *embed_tokenizer_decode(const embed_tokenizer_t *tok, int token_id) {
+ if (!tok || token_id < 0 || token_id >= tok->vocab_size)
+ return "";
+ return tok->id_to_text[token_id] ? tok->id_to_text[token_id] : "";
+}
+
+int embed_tokenizer_token_id(const embed_tokenizer_t *tok, const char *token) {
+ if (!tok || !token || !tok->vocab_map)
+ return -1;
+ return map_get((const str_int_entry_t *)tok->vocab_map, tok->vocab_map_cap, token);
+}
+
+int *embed_tokenizer_encode(const embed_tokenizer_t *tok, const char *text, int *out_n_tokens) {
+ if (out_n_tokens)
+ *out_n_tokens = 0;
+ if (!tok || !text || text[0] == '\0')
+ return NULL;
+
+ char *normalized = normalize_nfc_latin(text);
+ if (!normalized)
+ return NULL;
+
+ int *ids = NULL;
+ int n_ids = 0;
+ if (encode_pretokenized(tok, normalized, &ids, &n_ids) != 0) {
+ free(normalized);
+ free(ids);
+ return NULL;
+ }
+ free(normalized);
+
+ if (out_n_tokens)
+ *out_n_tokens = n_ids;
+ return ids;
+}
+
+embed_tokenizer_workspace_t *embed_tokenizer_workspace_new(void) {
+ return (embed_tokenizer_workspace_t *)calloc(1, sizeof(embed_tokenizer_workspace_t));
+}
+
+void embed_tokenizer_workspace_free(embed_tokenizer_workspace_t *ws) {
+ if (!ws)
+ return;
+ free(ws->normalized);
+ free(ws->mapped);
+ free(ws->arena);
+ free(ws->syms);
+ free(ws->ids);
+ free(ws->bpe_ids);
+ free(ws->bpe_prv);
+ free(ws->bpe_nxt);
+ free(ws->bpe_rnk);
+ free(ws->bpe_mrg);
+ free(ws);
+}
+
+int embed_tokenizer_encode_into(const embed_tokenizer_t *tok,
+ embed_tokenizer_workspace_t *ws,
+ const char *text,
+ int *out_ids,
+ int out_cap,
+ int *out_n_tokens) {
+ if (out_n_tokens)
+ *out_n_tokens = 0;
+ if (!tok || !ws || !text || out_cap < 0)
+ return -1;
+ if (text[0] == '\0')
+ return 0;
+
+ const char *normalized = NULL;
+ if (normalize_nfc_latin_into(ws, text, &normalized) != 0)
+ return -1;
+
+ int n_ids = 0;
+ int rc = encode_pretokenized_into(tok, ws, normalized, out_ids, out_cap, &n_ids);
+ if (out_n_tokens)
+ *out_n_tokens = n_ids;
+ return rc;
+}
+
+int *embed_tokenizer_encode_with_workspace(const embed_tokenizer_t *tok,
+ embed_tokenizer_workspace_t *ws,
+ const char *text,
+ int *out_n_tokens) {
+ if (out_n_tokens)
+ *out_n_tokens = 0;
+ if (!tok || !ws || !text || text[0] == '\0')
+ return NULL;
+
+ size_t len = strlen(text);
+ size_t cap_sz = len > (SIZE_MAX - 8) / 2 ? SIZE_MAX : len * 2 + 8;
+ if (cap_sz > (size_t)INT_MAX)
+ return NULL;
+ int cap = (int)cap_sz;
+
+ if (reserve_ints(&ws->ids, &ws->ids_cap, cap) != 0)
+ return NULL;
+
+ int n_ids = 0;
+ int rc = embed_tokenizer_encode_into(tok, ws, text, ws->ids, ws->ids_cap, &n_ids);
+ if (rc == -2) {
+ if (reserve_ints(&ws->ids, &ws->ids_cap, n_ids) != 0)
+ return NULL;
+ rc = embed_tokenizer_encode_into(tok, ws, text, ws->ids, ws->ids_cap, &n_ids);
+ }
+ if (rc != 0 || n_ids <= 0)
+ return NULL;
+
+ int *ids = (int *)malloc((size_t)n_ids * sizeof(int));
+ if (!ids)
+ return NULL;
+ memcpy(ids, ws->ids, (size_t)n_ids * sizeof(int));
+ if (out_n_tokens)
+ *out_n_tokens = n_ids;
+ return ids;
+}
+
+void embed_tokenizer_free(embed_tokenizer_t *tok) {
+ if (!tok)
+ return;
+
+ if (tok->id_to_text) {
+ for (int i = 0; i < tok->vocab_size; i++)
+ free(tok->id_to_text[i]);
+ free(tok->id_to_text);
+ }
+ if (tok->id_to_bpe) {
+ for (int i = 0; i < tok->vocab_size; i++)
+ free(tok->id_to_bpe[i]);
+ free(tok->id_to_bpe);
+ }
+
+ if (tok->merge_map) {
+ str_int_entry_t *m = (str_int_entry_t *)tok->merge_map;
+ for (int i = 0; i < tok->merge_map_cap; i++)
+ free(m[i].key);
+ free(tok->merge_map);
+ }
+ free(tok->vocab_map);
+ free(tok->int_merges);
+ free(tok->cp_to_id);
+ free(tok);
+}
diff --git a/src/tokenizer_bpe.h b/src/tokenizer_bpe.h
new file mode 100644
index 0000000..8d13d47
--- /dev/null
+++ b/src/tokenizer_bpe.h
@@ -0,0 +1,86 @@
+/*
+ * embed_tokenizer.h - Qwen2/Qwen3 BPE tokenizer (GPT-2 byte-level)
+ *
+ * Supports:
+ * - decode token ID -> UTF-8 text
+ * - encode UTF-8 text -> token IDs (vocab.json + merges.txt)
+ */
+
+#ifndef EMBED_TOKENIZER_H
+#define EMBED_TOKENIZER_H
+
+/* Public-API export annotation. The libraries are built with
+ * -fvisibility=hidden, so only declarations carrying EMBED_API are exported
+ * from the shared library; everything else stays internal. */
+#ifndef EMBED_API
+#if defined(__GNUC__)
+#define EMBED_API __attribute__((visibility("default")))
+#else
+#define EMBED_API
+#endif
+#endif
+
+typedef struct {
+ char **id_to_text; /* [vocab_size] decoded text strings */
+ char **id_to_bpe; /* [vocab_size] raw BPE token strings from vocab.json */
+ int vocab_size;
+
+ /* Internal hash maps (opaque to callers) */
+ void *vocab_map;
+ int vocab_map_cap;
+ void *merge_map;
+ int merge_map_cap;
+ /* Integer-pair BPE merge table: (left_id, right_id) -> (rank, merged_id).
+ * NULL when the vocab could not resolve every merge; encoding then falls
+ * back to the string-based merge loop. */
+ void *int_merges;
+ int int_merges_cap;
+ /* Byte-level unicode codepoint -> single-character token id (512 slots),
+ * or NULL when any byte token is missing from the vocab. */
+ int *cp_to_id;
+} embed_tokenizer_t;
+
+typedef struct embed_tokenizer_workspace embed_tokenizer_workspace_t;
+
+/* Load tokenizer from vocab.json in model directory */
+EMBED_API embed_tokenizer_t *embed_tokenizer_load(const char *vocab_json_path);
+
+/* Decode a single token ID to text. Returns pointer to internal string. */
+EMBED_API const char *embed_tokenizer_decode(const embed_tokenizer_t *tok, int token_id);
+
+/* Look up the id of a raw vocab.json token string (e.g. "<|endoftext|>").
+ * Returns -1 when the token is not in the vocab. */
+EMBED_API int embed_tokenizer_token_id(const embed_tokenizer_t *tok, const char *token);
+
+/* Encode UTF-8 text into token IDs using BPE.
+ * Returns malloc'd array of token IDs and sets *out_n_tokens.
+ * Returns NULL on error (and sets *out_n_tokens to 0). */
+EMBED_API int *
+embed_tokenizer_encode(const embed_tokenizer_t *tok, const char *text, int *out_n_tokens);
+
+/* Reusable scratch for allocation-light repeated encoding. */
+EMBED_API embed_tokenizer_workspace_t *embed_tokenizer_workspace_new(void);
+EMBED_API void embed_tokenizer_workspace_free(embed_tokenizer_workspace_t *ws);
+
+/* Encode into caller-provided out_ids[0..out_cap-1].
+ * Returns 0 on success, -1 on error, -2 if out_cap is too small.
+ * In all cases *out_n_tokens is set to the number of tokens needed/emitted
+ * when out_n_tokens is non-NULL. */
+EMBED_API int embed_tokenizer_encode_into(const embed_tokenizer_t *tok,
+ embed_tokenizer_workspace_t *ws,
+ const char *text,
+ int *out_ids,
+ int out_cap,
+ int *out_n_tokens);
+
+/* Same tokenization as embed_tokenizer_encode(), but reuses ws internally and
+ * performs only the final returned int[] allocation. */
+EMBED_API int *embed_tokenizer_encode_with_workspace(const embed_tokenizer_t *tok,
+ embed_tokenizer_workspace_t *ws,
+ const char *text,
+ int *out_n_tokens);
+
+/* Free tokenizer */
+EMBED_API void embed_tokenizer_free(embed_tokenizer_t *tok);
+
+#endif /* EMBED_TOKENIZER_H */
diff --git a/src/tokenizer_unicode.h b/src/tokenizer_unicode.h
new file mode 100644
index 0000000..8ca2458
--- /dev/null
+++ b/src/tokenizer_unicode.h
@@ -0,0 +1,4985 @@
+/* Generated by tools/gen_wordpiece_unicode.py from Python unicodedata
+ * (Unicode 13.0.0). Do not edit by hand.
+ *
+ * Tables for the BasicTokenizer, matching transformers' BertTokenizer.
+ *
+ * WP_PUNCT_RANGES / WP_CONTROL_RANGES: _is_punctuation and _is_control as sorted
+ * [lo, hi] ranges. Punctuation is the ASCII set (33-47/58-64/91-96/123-126) plus
+ * every category P* codepoint. Control is categories Cc, Cf, Co minus
+ * tab/newline/carriage-return (those route to whitespace). Unassigned (Cn) is
+ * intentionally not control: it never occurs in real text and would bind the
+ * table to one Unicode version.
+ *
+ * WP_FOLD: the do_lower_case fold (Python str.lower then NFD then drop Mn marks),
+ * sorted by codepoint. n is the output length (0 drops a combining mark; up to
+ * 3). Hangul syllables (U+AC00..U+D7A3) decompose by formula on the C side and
+ * are excluded here. */
+#ifndef WORDPIECE_UNICODE_H
+#define WORDPIECE_UNICODE_H
+
+#include <stdint.h>
+
+typedef struct {
+ uint32_t lo;
+ uint32_t hi;
+} wp_range_t;
+
+typedef struct {
+ uint32_t cp;
+ uint32_t out[3];
+ uint8_t n;
+} wp_fold_t;
+
+static const wp_range_t WP_PUNCT_RANGES[] = {
+ {0x21, 0x2F}, {0x3A, 0x40}, {0x5B, 0x60}, {0x7B, 0x7E}, {0xA1, 0xA1}, {0xA7, 0xA7},
+ {0xAB, 0xAB}, {0xB6, 0xB7}, {0xBB, 0xBB}, {0xBF, 0xBF}, {0x37E, 0x37E}, {0x387, 0x387},
+ {0x55A, 0x55F}, {0x589, 0x58A}, {0x5BE, 0x5BE}, {0x5C0, 0x5C0}, {0x5C3, 0x5C3},
+ {0x5C6, 0x5C6}, {0x5F3, 0x5F4}, {0x609, 0x60A}, {0x60C, 0x60D}, {0x61B, 0x61B},
+ {0x61E, 0x61F}, {0x66A, 0x66D}, {0x6D4, 0x6D4}, {0x700, 0x70D}, {0x7F7, 0x7F9},
+ {0x830, 0x83E}, {0x85E, 0x85E}, {0x964, 0x965}, {0x970, 0x970}, {0x9FD, 0x9FD},
+ {0xA76, 0xA76}, {0xAF0, 0xAF0}, {0xC77, 0xC77}, {0xC84, 0xC84}, {0xDF4, 0xDF4},
+ {0xE4F, 0xE4F}, {0xE5A, 0xE5B}, {0xF04, 0xF12}, {0xF14, 0xF14}, {0xF3A, 0xF3D},
+ {0xF85, 0xF85}, {0xFD0, 0xFD4}, {0xFD9, 0xFDA}, {0x104A, 0x104F}, {0x10FB, 0x10FB},
+ {0x1360, 0x1368}, {0x1400, 0x1400}, {0x166E, 0x166E}, {0x169B, 0x169C}, {0x16EB, 0x16ED},
+ {0x1735, 0x1736}, {0x17D4, 0x17D6}, {0x17D8, 0x17DA}, {0x1800, 0x180A}, {0x1944, 0x1945},
+ {0x1A1E, 0x1A1F}, {0x1AA0, 0x1AA6}, {0x1AA8, 0x1AAD}, {0x1B5A, 0x1B60}, {0x1BFC, 0x1BFF},
+ {0x1C3B, 0x1C3F}, {0x1C7E, 0x1C7F}, {0x1CC0, 0x1CC7}, {0x1CD3, 0x1CD3}, {0x2010, 0x2027},
+ {0x2030, 0x2043}, {0x2045, 0x2051}, {0x2053, 0x205E}, {0x207D, 0x207E}, {0x208D, 0x208E},
+ {0x2308, 0x230B}, {0x2329, 0x232A}, {0x2768, 0x2775}, {0x27C5, 0x27C6}, {0x27E6, 0x27EF},
+ {0x2983, 0x2998}, {0x29D8, 0x29DB}, {0x29FC, 0x29FD}, {0x2CF9, 0x2CFC}, {0x2CFE, 0x2CFF},
+ {0x2D70, 0x2D70}, {0x2E00, 0x2E2E}, {0x2E30, 0x2E4F}, {0x2E52, 0x2E52}, {0x3001, 0x3003},
+ {0x3008, 0x3011}, {0x3014, 0x301F}, {0x3030, 0x3030}, {0x303D, 0x303D}, {0x30A0, 0x30A0},
+ {0x30FB, 0x30FB}, {0xA4FE, 0xA4FF}, {0xA60D, 0xA60F}, {0xA673, 0xA673}, {0xA67E, 0xA67E},
+ {0xA6F2, 0xA6F7}, {0xA874, 0xA877}, {0xA8CE, 0xA8CF}, {0xA8F8, 0xA8FA}, {0xA8FC, 0xA8FC},
+ {0xA92E, 0xA92F}, {0xA95F, 0xA95F}, {0xA9C1, 0xA9CD}, {0xA9DE, 0xA9DF}, {0xAA5C, 0xAA5F},
+ {0xAADE, 0xAADF}, {0xAAF0, 0xAAF1}, {0xABEB, 0xABEB}, {0xFD3E, 0xFD3F}, {0xFE10, 0xFE19},
+ {0xFE30, 0xFE52}, {0xFE54, 0xFE61}, {0xFE63, 0xFE63}, {0xFE68, 0xFE68}, {0xFE6A, 0xFE6B},
+ {0xFF01, 0xFF03}, {0xFF05, 0xFF0A}, {0xFF0C, 0xFF0F}, {0xFF1A, 0xFF1B}, {0xFF1F, 0xFF20},
+ {0xFF3B, 0xFF3D}, {0xFF3F, 0xFF3F}, {0xFF5B, 0xFF5B}, {0xFF5D, 0xFF5D}, {0xFF5F, 0xFF65},
+ {0x10100, 0x10102}, {0x1039F, 0x1039F}, {0x103D0, 0x103D0}, {0x1056F, 0x1056F},
+ {0x10857, 0x10857}, {0x1091F, 0x1091F}, {0x1093F, 0x1093F}, {0x10A50, 0x10A58},
+ {0x10A7F, 0x10A7F}, {0x10AF0, 0x10AF6}, {0x10B39, 0x10B3F}, {0x10B99, 0x10B9C},
+ {0x10EAD, 0x10EAD}, {0x10F55, 0x10F59}, {0x11047, 0x1104D}, {0x110BB, 0x110BC},
+ {0x110BE, 0x110C1}, {0x11140, 0x11143}, {0x11174, 0x11175}, {0x111C5, 0x111C8},
+ {0x111CD, 0x111CD}, {0x111DB, 0x111DB}, {0x111DD, 0x111DF}, {0x11238, 0x1123D},
+ {0x112A9, 0x112A9}, {0x1144B, 0x1144F}, {0x1145A, 0x1145B}, {0x1145D, 0x1145D},
+ {0x114C6, 0x114C6}, {0x115C1, 0x115D7}, {0x11641, 0x11643}, {0x11660, 0x1166C},
+ {0x1173C, 0x1173E}, {0x1183B, 0x1183B}, {0x11944, 0x11946}, {0x119E2, 0x119E2},
+ {0x11A3F, 0x11A46}, {0x11A9A, 0x11A9C}, {0x11A9E, 0x11AA2}, {0x11C41, 0x11C45},
+ {0x11C70, 0x11C71}, {0x11EF7, 0x11EF8}, {0x11FFF, 0x11FFF}, {0x12470, 0x12474},
+ {0x16A6E, 0x16A6F}, {0x16AF5, 0x16AF5}, {0x16B37, 0x16B3B}, {0x16B44, 0x16B44},
+ {0x16E97, 0x16E9A}, {0x16FE2, 0x16FE2}, {0x1BC9F, 0x1BC9F}, {0x1DA87, 0x1DA8B},
+ {0x1E95E, 0x1E95F},
+};
+enum { WP_PUNCT_RANGES_N = (int)(sizeof(WP_PUNCT_RANGES) / sizeof(WP_PUNCT_RANGES[0])) };
+
+static const wp_range_t WP_CONTROL_RANGES[] = {
+ {0x0, 0x8}, {0xB, 0xC}, {0xE, 0x1F}, {0x7F, 0x9F}, {0xAD, 0xAD}, {0x600, 0x605},
+ {0x61C, 0x61C}, {0x6DD, 0x6DD}, {0x70F, 0x70F}, {0x8E2, 0x8E2}, {0x180E, 0x180E},
+ {0x200B, 0x200F}, {0x202A, 0x202E}, {0x2060, 0x2064}, {0x2066, 0x206F}, {0xE000, 0xF8FF},
+ {0xFEFF, 0xFEFF}, {0xFFF9, 0xFFFB}, {0x110BD, 0x110BD}, {0x110CD, 0x110CD},
+ {0x13430, 0x13438}, {0x1BCA0, 0x1BCA3}, {0x1D173, 0x1D17A}, {0xE0001, 0xE0001},
+ {0xE0020, 0xE007F}, {0xF0000, 0xFFFFD}, {0x100000, 0x10FFFD},
+};
+enum { WP_CONTROL_RANGES_N = (int)(sizeof(WP_CONTROL_RANGES) / sizeof(WP_CONTROL_RANGES[0])) };
+
+static const wp_fold_t WP_FOLD[] = {
+ {0x41, {0x61, 0x0, 0x0}, 1},
+ {0x42, {0x62, 0x0, 0x0}, 1},
+ {0x43, {0x63, 0x0, 0x0}, 1},
+ {0x44, {0x64, 0x0, 0x0}, 1},
+ {0x45, {0x65, 0x0, 0x0}, 1},
+ {0x46, {0x66, 0x0, 0x0}, 1},
+ {0x47, {0x67, 0x0, 0x0}, 1},
+ {0x48, {0x68, 0x0, 0x0}, 1},
+ {0x49, {0x69, 0x0, 0x0}, 1},
+ {0x4A, {0x6A, 0x0, 0x0}, 1},
+ {0x4B, {0x6B, 0x0, 0x0}, 1},
+ {0x4C, {0x6C, 0x0, 0x0}, 1},
+ {0x4D, {0x6D, 0x0, 0x0}, 1},
+ {0x4E, {0x6E, 0x0, 0x0}, 1},
+ {0x4F, {0x6F, 0x0, 0x0}, 1},
+ {0x50, {0x70, 0x0, 0x0}, 1},
+ {0x51, {0x71, 0x0, 0x0}, 1},
+ {0x52, {0x72, 0x0, 0x0}, 1},
+ {0x53, {0x73, 0x0, 0x0}, 1},
+ {0x54, {0x74, 0x0, 0x0}, 1},
+ {0x55, {0x75, 0x0, 0x0}, 1},
+ {0x56, {0x76, 0x0, 0x0}, 1},
+ {0x57, {0x77, 0x0, 0x0}, 1},
+ {0x58, {0x78, 0x0, 0x0}, 1},
+ {0x59, {0x79, 0x0, 0x0}, 1},
+ {0x5A, {0x7A, 0x0, 0x0}, 1},
+ {0xC0, {0x61, 0x0, 0x0}, 1},
+ {0xC1, {0x61, 0x0, 0x0}, 1},
+ {0xC2, {0x61, 0x0, 0x0}, 1},
+ {0xC3, {0x61, 0x0, 0x0}, 1},
+ {0xC4, {0x61, 0x0, 0x0}, 1},
+ {0xC5, {0x61, 0x0, 0x0}, 1},
+ {0xC6, {0xE6, 0x0, 0x0}, 1},
+ {0xC7, {0x63, 0x0, 0x0}, 1},
+ {0xC8, {0x65, 0x0, 0x0}, 1},
+ {0xC9, {0x65, 0x0, 0x0}, 1},
+ {0xCA, {0x65, 0x0, 0x0}, 1},
+ {0xCB, {0x65, 0x0, 0x0}, 1},
+ {0xCC, {0x69, 0x0, 0x0}, 1},
+ {0xCD, {0x69, 0x0, 0x0}, 1},
+ {0xCE, {0x69, 0x0, 0x0}, 1},
+ {0xCF, {0x69, 0x0, 0x0}, 1},
+ {0xD0, {0xF0, 0x0, 0x0}, 1},
+ {0xD1, {0x6E, 0x0, 0x0}, 1},
+ {0xD2, {0x6F, 0x0, 0x0}, 1},
+ {0xD3, {0x6F, 0x0, 0x0}, 1},
+ {0xD4, {0x6F, 0x0, 0x0}, 1},
+ {0xD5, {0x6F, 0x0, 0x0}, 1},
+ {0xD6, {0x6F, 0x0, 0x0}, 1},
+ {0xD8, {0xF8, 0x0, 0x0}, 1},
+ {0xD9, {0x75, 0x0, 0x0}, 1},
+ {0xDA, {0x75, 0x0, 0x0}, 1},
+ {0xDB, {0x75, 0x0, 0x0}, 1},
+ {0xDC, {0x75, 0x0, 0x0}, 1},
+ {0xDD, {0x79, 0x0, 0x0}, 1},
+ {0xDE, {0xFE, 0x0, 0x0}, 1},
+ {0xE0, {0x61, 0x0, 0x0}, 1},
+ {0xE1, {0x61, 0x0, 0x0}, 1},
+ {0xE2, {0x61, 0x0, 0x0}, 1},
+ {0xE3, {0x61, 0x0, 0x0}, 1},
+ {0xE4, {0x61, 0x0, 0x0}, 1},
+ {0xE5, {0x61, 0x0, 0x0}, 1},
+ {0xE7, {0x63, 0x0, 0x0}, 1},
+ {0xE8, {0x65, 0x0, 0x0}, 1},
+ {0xE9, {0x65, 0x0, 0x0}, 1},
+ {0xEA, {0x65, 0x0, 0x0}, 1},
+ {0xEB, {0x65, 0x0, 0x0}, 1},
+ {0xEC, {0x69, 0x0, 0x0}, 1},
+ {0xED, {0x69, 0x0, 0x0}, 1},
+ {0xEE, {0x69, 0x0, 0x0}, 1},
+ {0xEF, {0x69, 0x0, 0x0}, 1},
+ {0xF1, {0x6E, 0x0, 0x0}, 1},
+ {0xF2, {0x6F, 0x0, 0x0}, 1},
+ {0xF3, {0x6F, 0x0, 0x0}, 1},
+ {0xF4, {0x6F, 0x0, 0x0}, 1},
+ {0xF5, {0x6F, 0x0, 0x0}, 1},
+ {0xF6, {0x6F, 0x0, 0x0}, 1},
+ {0xF9, {0x75, 0x0, 0x0}, 1},
+ {0xFA, {0x75, 0x0, 0x0}, 1},
+ {0xFB, {0x75, 0x0, 0x0}, 1},
+ {0xFC, {0x75, 0x0, 0x0}, 1},
+ {0xFD, {0x79, 0x0, 0x0}, 1},
+ {0xFF, {0x79, 0x0, 0x0}, 1},
+ {0x100, {0x61, 0x0, 0x0}, 1},
+ {0x101, {0x61, 0x0, 0x0}, 1},
+ {0x102, {0x61, 0x0, 0x0}, 1},
+ {0x103, {0x61, 0x0, 0x0}, 1},
+ {0x104, {0x61, 0x0, 0x0}, 1},
+ {0x105, {0x61, 0x0, 0x0}, 1},
+ {0x106, {0x63, 0x0, 0x0}, 1},
+ {0x107, {0x63, 0x0, 0x0}, 1},
+ {0x108, {0x63, 0x0, 0x0}, 1},
+ {0x109, {0x63, 0x0, 0x0}, 1},
+ {0x10A, {0x63, 0x0, 0x0}, 1},
+ {0x10B, {0x63, 0x0, 0x0}, 1},
+ {0x10C, {0x63, 0x0, 0x0}, 1},
+ {0x10D, {0x63, 0x0, 0x0}, 1},
+ {0x10E, {0x64, 0x0, 0x0}, 1},
+ {0x10F, {0x64, 0x0, 0x0}, 1},
+ {0x110, {0x111, 0x0, 0x0}, 1},
+ {0x112, {0x65, 0x0, 0x0}, 1},
+ {0x113, {0x65, 0x0, 0x0}, 1},
+ {0x114, {0x65, 0x0, 0x0}, 1},
+ {0x115, {0x65, 0x0, 0x0}, 1},
+ {0x116, {0x65, 0x0, 0x0}, 1},
+ {0x117, {0x65, 0x0, 0x0}, 1},
+ {0x118, {0x65, 0x0, 0x0}, 1},
+ {0x119, {0x65, 0x0, 0x0}, 1},
+ {0x11A, {0x65, 0x0, 0x0}, 1},
+ {0x11B, {0x65, 0x0, 0x0}, 1},
+ {0x11C, {0x67, 0x0, 0x0}, 1},
+ {0x11D, {0x67, 0x0, 0x0}, 1},
+ {0x11E, {0x67, 0x0, 0x0}, 1},
+ {0x11F, {0x67, 0x0, 0x0}, 1},
+ {0x120, {0x67, 0x0, 0x0}, 1},
+ {0x121, {0x67, 0x0, 0x0}, 1},
+ {0x122, {0x67, 0x0, 0x0}, 1},
+ {0x123, {0x67, 0x0, 0x0}, 1},
+ {0x124, {0x68, 0x0, 0x0}, 1},
+ {0x125, {0x68, 0x0, 0x0}, 1},
+ {0x126, {0x127, 0x0, 0x0}, 1},
+ {0x128, {0x69, 0x0, 0x0}, 1},
+ {0x129, {0x69, 0x0, 0x0}, 1},
+ {0x12A, {0x69, 0x0, 0x0}, 1},
+ {0x12B, {0x69, 0x0, 0x0}, 1},
+ {0x12C, {0x69, 0x0, 0x0}, 1},
+ {0x12D, {0x69, 0x0, 0x0}, 1},
+ {0x12E, {0x69, 0x0, 0x0}, 1},
+ {0x12F, {0x69, 0x0, 0x0}, 1},
+ {0x130, {0x69, 0x0, 0x0}, 1},
+ {0x132, {0x133, 0x0, 0x0}, 1},
+ {0x134, {0x6A, 0x0, 0x0}, 1},
+ {0x135, {0x6A, 0x0, 0x0}, 1},
+ {0x136, {0x6B, 0x0, 0x0}, 1},
+ {0x137, {0x6B, 0x0, 0x0}, 1},
+ {0x139, {0x6C, 0x0, 0x0}, 1},
+ {0x13A, {0x6C, 0x0, 0x0}, 1},
+ {0x13B, {0x6C, 0x0, 0x0}, 1},
+ {0x13C, {0x6C, 0x0, 0x0}, 1},
+ {0x13D, {0x6C, 0x0, 0x0}, 1},
+ {0x13E, {0x6C, 0x0, 0x0}, 1},
+ {0x13F, {0x140, 0x0, 0x0}, 1},
+ {0x141, {0x142, 0x0, 0x0}, 1},
+ {0x143, {0x6E, 0x0, 0x0}, 1},
+ {0x144, {0x6E, 0x0, 0x0}, 1},
+ {0x145, {0x6E, 0x0, 0x0}, 1},
+ {0x146, {0x6E, 0x0, 0x0}, 1},
+ {0x147, {0x6E, 0x0, 0x0}, 1},
+ {0x148, {0x6E, 0x0, 0x0}, 1},
+ {0x14A, {0x14B, 0x0, 0x0}, 1},
+ {0x14C, {0x6F, 0x0, 0x0}, 1},
+ {0x14D, {0x6F, 0x0, 0x0}, 1},
+ {0x14E, {0x6F, 0x0, 0x0}, 1},
+ {0x14F, {0x6F, 0x0, 0x0}, 1},
+ {0x150, {0x6F, 0x0, 0x0}, 1},
+ {0x151, {0x6F, 0x0, 0x0}, 1},
+ {0x152, {0x153, 0x0, 0x0}, 1},
+ {0x154, {0x72, 0x0, 0x0}, 1},
+ {0x155, {0x72, 0x0, 0x0}, 1},
+ {0x156, {0x72, 0x0, 0x0}, 1},
+ {0x157, {0x72, 0x0, 0x0}, 1},
+ {0x158, {0x72, 0x0, 0x0}, 1},
+ {0x159, {0x72, 0x0, 0x0}, 1},
+ {0x15A, {0x73, 0x0, 0x0}, 1},
+ {0x15B, {0x73, 0x0, 0x0}, 1},
+ {0x15C, {0x73, 0x0, 0x0}, 1},
+ {0x15D, {0x73, 0x0, 0x0}, 1},
+ {0x15E, {0x73, 0x0, 0x0}, 1},
+ {0x15F, {0x73, 0x0, 0x0}, 1},
+ {0x160, {0x73, 0x0, 0x0}, 1},
+ {0x161, {0x73, 0x0, 0x0}, 1},
+ {0x162, {0x74, 0x0, 0x0}, 1},
+ {0x163, {0x74, 0x0, 0x0}, 1},
+ {0x164, {0x74, 0x0, 0x0}, 1},
+ {0x165, {0x74, 0x0, 0x0}, 1},
+ {0x166, {0x167, 0x0, 0x0}, 1},
+ {0x168, {0x75, 0x0, 0x0}, 1},
+ {0x169, {0x75, 0x0, 0x0}, 1},
+ {0x16A, {0x75, 0x0, 0x0}, 1},
+ {0x16B, {0x75, 0x0, 0x0}, 1},
+ {0x16C, {0x75, 0x0, 0x0}, 1},
+ {0x16D, {0x75, 0x0, 0x0}, 1},
+ {0x16E, {0x75, 0x0, 0x0}, 1},
+ {0x16F, {0x75, 0x0, 0x0}, 1},
+ {0x170, {0x75, 0x0, 0x0}, 1},
+ {0x171, {0x75, 0x0, 0x0}, 1},
+ {0x172, {0x75, 0x0, 0x0}, 1},
+ {0x173, {0x75, 0x0, 0x0}, 1},
+ {0x174, {0x77, 0x0, 0x0}, 1},
+ {0x175, {0x77, 0x0, 0x0}, 1},
+ {0x176, {0x79, 0x0, 0x0}, 1},
+ {0x177, {0x79, 0x0, 0x0}, 1},
+ {0x178, {0x79, 0x0, 0x0}, 1},
+ {0x179, {0x7A, 0x0, 0x0}, 1},
+ {0x17A, {0x7A, 0x0, 0x0}, 1},
+ {0x17B, {0x7A, 0x0, 0x0}, 1},
+ {0x17C, {0x7A, 0x0, 0x0}, 1},
+ {0x17D, {0x7A, 0x0, 0x0}, 1},
+ {0x17E, {0x7A, 0x0, 0x0}, 1},
+ {0x181, {0x253, 0x0, 0x0}, 1},
+ {0x182, {0x183, 0x0, 0x0}, 1},
+ {0x184, {0x185, 0x0, 0x0}, 1},
+ {0x186, {0x254, 0x0, 0x0}, 1},
+ {0x187, {0x188, 0x0, 0x0}, 1},
+ {0x189, {0x256, 0x0, 0x0}, 1},
+ {0x18A, {0x257, 0x0, 0x0}, 1},
+ {0x18B, {0x18C, 0x0, 0x0}, 1},
+ {0x18E, {0x1DD, 0x0, 0x0}, 1},
+ {0x18F, {0x259, 0x0, 0x0}, 1},
+ {0x190, {0x25B, 0x0, 0x0}, 1},
+ {0x191, {0x192, 0x0, 0x0}, 1},
+ {0x193, {0x260, 0x0, 0x0}, 1},
+ {0x194, {0x263, 0x0, 0x0}, 1},
+ {0x196, {0x269, 0x0, 0x0}, 1},
+ {0x197, {0x268, 0x0, 0x0}, 1},
+ {0x198, {0x199, 0x0, 0x0}, 1},
+ {0x19C, {0x26F, 0x0, 0x0}, 1},
+ {0x19D, {0x272, 0x0, 0x0}, 1},
+ {0x19F, {0x275, 0x0, 0x0}, 1},
+ {0x1A0, {0x6F, 0x0, 0x0}, 1},
+ {0x1A1, {0x6F, 0x0, 0x0}, 1},
+ {0x1A2, {0x1A3, 0x0, 0x0}, 1},
+ {0x1A4, {0x1A5, 0x0, 0x0}, 1},
+ {0x1A6, {0x280, 0x0, 0x0}, 1},
+ {0x1A7, {0x1A8, 0x0, 0x0}, 1},
+ {0x1A9, {0x283, 0x0, 0x0}, 1},
+ {0x1AC, {0x1AD, 0x0, 0x0}, 1},
+ {0x1AE, {0x288, 0x0, 0x0}, 1},
+ {0x1AF, {0x75, 0x0, 0x0}, 1},
+ {0x1B0, {0x75, 0x0, 0x0}, 1},
+ {0x1B1, {0x28A, 0x0, 0x0}, 1},
+ {0x1B2, {0x28B, 0x0, 0x0}, 1},
+ {0x1B3, {0x1B4, 0x0, 0x0}, 1},
+ {0x1B5, {0x1B6, 0x0, 0x0}, 1},
+ {0x1B7, {0x292, 0x0, 0x0}, 1},
+ {0x1B8, {0x1B9, 0x0, 0x0}, 1},
+ {0x1BC, {0x1BD, 0x0, 0x0}, 1},
+ {0x1C4, {0x1C6, 0x0, 0x0}, 1},
+ {0x1C5, {0x1C6, 0x0, 0x0}, 1},
+ {0x1C7, {0x1C9, 0x0, 0x0}, 1},
+ {0x1C8, {0x1C9, 0x0, 0x0}, 1},
+ {0x1CA, {0x1CC, 0x0, 0x0}, 1},
+ {0x1CB, {0x1CC, 0x0, 0x0}, 1},
+ {0x1CD, {0x61, 0x0, 0x0}, 1},
+ {0x1CE, {0x61, 0x0, 0x0}, 1},
+ {0x1CF, {0x69, 0x0, 0x0}, 1},
+ {0x1D0, {0x69, 0x0, 0x0}, 1},
+ {0x1D1, {0x6F, 0x0, 0x0}, 1},
+ {0x1D2, {0x6F, 0x0, 0x0}, 1},
+ {0x1D3, {0x75, 0x0, 0x0}, 1},
+ {0x1D4, {0x75, 0x0, 0x0}, 1},
+ {0x1D5, {0x75, 0x0, 0x0}, 1},
+ {0x1D6, {0x75, 0x0, 0x0}, 1},
+ {0x1D7, {0x75, 0x0, 0x0}, 1},
+ {0x1D8, {0x75, 0x0, 0x0}, 1},
+ {0x1D9, {0x75, 0x0, 0x0}, 1},
+ {0x1DA, {0x75, 0x0, 0x0}, 1},
+ {0x1DB, {0x75, 0x0, 0x0}, 1},
+ {0x1DC, {0x75, 0x0, 0x0}, 1},
+ {0x1DE, {0x61, 0x0, 0x0}, 1},
+ {0x1DF, {0x61, 0x0, 0x0}, 1},
+ {0x1E0, {0x61, 0x0, 0x0}, 1},
+ {0x1E1, {0x61, 0x0, 0x0}, 1},
+ {0x1E2, {0xE6, 0x0, 0x0}, 1},
+ {0x1E3, {0xE6, 0x0, 0x0}, 1},
+ {0x1E4, {0x1E5, 0x0, 0x0}, 1},
+ {0x1E6, {0x67, 0x0, 0x0}, 1},
+ {0x1E7, {0x67, 0x0, 0x0}, 1},
+ {0x1E8, {0x6B, 0x0, 0x0}, 1},
+ {0x1E9, {0x6B, 0x0, 0x0}, 1},
+ {0x1EA, {0x6F, 0x0, 0x0}, 1},
+ {0x1EB, {0x6F, 0x0, 0x0}, 1},
+ {0x1EC, {0x6F, 0x0, 0x0}, 1},
+ {0x1ED, {0x6F, 0x0, 0x0}, 1},
+ {0x1EE, {0x292, 0x0, 0x0}, 1},
+ {0x1EF, {0x292, 0x0, 0x0}, 1},
+ {0x1F0, {0x6A, 0x0, 0x0}, 1},
+ {0x1F1, {0x1F3, 0x0, 0x0}, 1},
+ {0x1F2, {0x1F3, 0x0, 0x0}, 1},
+ {0x1F4, {0x67, 0x0, 0x0}, 1},
+ {0x1F5, {0x67, 0x0, 0x0}, 1},
+ {0x1F6, {0x195, 0x0, 0x0}, 1},
+ {0x1F7, {0x1BF, 0x0, 0x0}, 1},
+ {0x1F8, {0x6E, 0x0, 0x0}, 1},
+ {0x1F9, {0x6E, 0x0, 0x0}, 1},
+ {0x1FA, {0x61, 0x0, 0x0}, 1},
+ {0x1FB, {0x61, 0x0, 0x0}, 1},
+ {0x1FC, {0xE6, 0x0, 0x0}, 1},
+ {0x1FD, {0xE6, 0x0, 0x0}, 1},
+ {0x1FE, {0xF8, 0x0, 0x0}, 1},
+ {0x1FF, {0xF8, 0x0, 0x0}, 1},
+ {0x200, {0x61, 0x0, 0x0}, 1},
+ {0x201, {0x61, 0x0, 0x0}, 1},
+ {0x202, {0x61, 0x0, 0x0}, 1},
+ {0x203, {0x61, 0x0, 0x0}, 1},
+ {0x204, {0x65, 0x0, 0x0}, 1},
+ {0x205, {0x65, 0x0, 0x0}, 1},
+ {0x206, {0x65, 0x0, 0x0}, 1},
+ {0x207, {0x65, 0x0, 0x0}, 1},
+ {0x208, {0x69, 0x0, 0x0}, 1},
+ {0x209, {0x69, 0x0, 0x0}, 1},
+ {0x20A, {0x69, 0x0, 0x0}, 1},
+ {0x20B, {0x69, 0x0, 0x0}, 1},
+ {0x20C, {0x6F, 0x0, 0x0}, 1},
+ {0x20D, {0x6F, 0x0, 0x0}, 1},
+ {0x20E, {0x6F, 0x0, 0x0}, 1},
+ {0x20F, {0x6F, 0x0, 0x0}, 1},
+ {0x210, {0x72, 0x0, 0x0}, 1},
+ {0x211, {0x72, 0x0, 0x0}, 1},
+ {0x212, {0x72, 0x0, 0x0}, 1},
+ {0x213, {0x72, 0x0, 0x0}, 1},
+ {0x214, {0x75, 0x0, 0x0}, 1},
+ {0x215, {0x75, 0x0, 0x0}, 1},
+ {0x216, {0x75, 0x0, 0x0}, 1},
+ {0x217, {0x75, 0x0, 0x0}, 1},
+ {0x218, {0x73, 0x0, 0x0}, 1},
+ {0x219, {0x73, 0x0, 0x0}, 1},
+ {0x21A, {0x74, 0x0, 0x0}, 1},
+ {0x21B, {0x74, 0x0, 0x0}, 1},
+ {0x21C, {0x21D, 0x0, 0x0}, 1},
+ {0x21E, {0x68, 0x0, 0x0}, 1},
+ {0x21F, {0x68, 0x0, 0x0}, 1},
+ {0x220, {0x19E, 0x0, 0x0}, 1},
+ {0x222, {0x223, 0x0, 0x0}, 1},
+ {0x224, {0x225, 0x0, 0x0}, 1},
+ {0x226, {0x61, 0x0, 0x0}, 1},
+ {0x227, {0x61, 0x0, 0x0}, 1},
+ {0x228, {0x65, 0x0, 0x0}, 1},
+ {0x229, {0x65, 0x0, 0x0}, 1},
+ {0x22A, {0x6F, 0x0, 0x0}, 1},
+ {0x22B, {0x6F, 0x0, 0x0}, 1},
+ {0x22C, {0x6F, 0x0, 0x0}, 1},
+ {0x22D, {0x6F, 0x0, 0x0}, 1},
+ {0x22E, {0x6F, 0x0, 0x0}, 1},
+ {0x22F, {0x6F, 0x0, 0x0}, 1},
+ {0x230, {0x6F, 0x0, 0x0}, 1},
+ {0x231, {0x6F, 0x0, 0x0}, 1},
+ {0x232, {0x79, 0x0, 0x0}, 1},
+ {0x233, {0x79, 0x0, 0x0}, 1},
+ {0x23A, {0x2C65, 0x0, 0x0}, 1},
+ {0x23B, {0x23C, 0x0, 0x0}, 1},
+ {0x23D, {0x19A, 0x0, 0x0}, 1},
+ {0x23E, {0x2C66, 0x0, 0x0}, 1},
+ {0x241, {0x242, 0x0, 0x0}, 1},
+ {0x243, {0x180, 0x0, 0x0}, 1},
+ {0x244, {0x289, 0x0, 0x0}, 1},
+ {0x245, {0x28C, 0x0, 0x0}, 1},
+ {0x246, {0x247, 0x0, 0x0}, 1},
+ {0x248, {0x249, 0x0, 0x0}, 1},
+ {0x24A, {0x24B, 0x0, 0x0}, 1},
+ {0x24C, {0x24D, 0x0, 0x0}, 1},
+ {0x24E, {0x24F, 0x0, 0x0}, 1},
+ {0x300, {0x0, 0x0, 0x0}, 0},
+ {0x301, {0x0, 0x0, 0x0}, 0},
+ {0x302, {0x0, 0x0, 0x0}, 0},
+ {0x303, {0x0, 0x0, 0x0}, 0},
+ {0x304, {0x0, 0x0, 0x0}, 0},
+ {0x305, {0x0, 0x0, 0x0}, 0},
+ {0x306, {0x0, 0x0, 0x0}, 0},
+ {0x307, {0x0, 0x0, 0x0}, 0},
+ {0x308, {0x0, 0x0, 0x0}, 0},
+ {0x309, {0x0, 0x0, 0x0}, 0},
+ {0x30A, {0x0, 0x0, 0x0}, 0},
+ {0x30B, {0x0, 0x0, 0x0}, 0},
+ {0x30C, {0x0, 0x0, 0x0}, 0},
+ {0x30D, {0x0, 0x0, 0x0}, 0},
+ {0x30E, {0x0, 0x0, 0x0}, 0},
+ {0x30F, {0x0, 0x0, 0x0}, 0},
+ {0x310, {0x0, 0x0, 0x0}, 0},
+ {0x311, {0x0, 0x0, 0x0}, 0},
+ {0x312, {0x0, 0x0, 0x0}, 0},
+ {0x313, {0x0, 0x0, 0x0}, 0},
+ {0x314, {0x0, 0x0, 0x0}, 0},
+ {0x315, {0x0, 0x0, 0x0}, 0},
+ {0x316, {0x0, 0x0, 0x0}, 0},
+ {0x317, {0x0, 0x0, 0x0}, 0},
+ {0x318, {0x0, 0x0, 0x0}, 0},
+ {0x319, {0x0, 0x0, 0x0}, 0},
+ {0x31A, {0x0, 0x0, 0x0}, 0},
+ {0x31B, {0x0, 0x0, 0x0}, 0},
+ {0x31C, {0x0, 0x0, 0x0}, 0},
+ {0x31D, {0x0, 0x0, 0x0}, 0},
+ {0x31E, {0x0, 0x0, 0x0}, 0},
+ {0x31F, {0x0, 0x0, 0x0}, 0},
+ {0x320, {0x0, 0x0, 0x0}, 0},
+ {0x321, {0x0, 0x0, 0x0}, 0},
+ {0x322, {0x0, 0x0, 0x0}, 0},
+ {0x323, {0x0, 0x0, 0x0}, 0},
+ {0x324, {0x0, 0x0, 0x0}, 0},
+ {0x325, {0x0, 0x0, 0x0}, 0},
+ {0x326, {0x0, 0x0, 0x0}, 0},
+ {0x327, {0x0, 0x0, 0x0}, 0},
+ {0x328, {0x0, 0x0, 0x0}, 0},
+ {0x329, {0x0, 0x0, 0x0}, 0},
+ {0x32A, {0x0, 0x0, 0x0}, 0},
+ {0x32B, {0x0, 0x0, 0x0}, 0},
+ {0x32C, {0x0, 0x0, 0x0}, 0},
+ {0x32D, {0x0, 0x0, 0x0}, 0},
+ {0x32E, {0x0, 0x0, 0x0}, 0},
+ {0x32F, {0x0, 0x0, 0x0}, 0},
+ {0x330, {0x0, 0x0, 0x0}, 0},
+ {0x331, {0x0, 0x0, 0x0}, 0},
+ {0x332, {0x0, 0x0, 0x0}, 0},
+ {0x333, {0x0, 0x0, 0x0}, 0},
+ {0x334, {0x0, 0x0, 0x0}, 0},
+ {0x335, {0x0, 0x0, 0x0}, 0},
+ {0x336, {0x0, 0x0, 0x0}, 0},
+ {0x337, {0x0, 0x0, 0x0}, 0},
+ {0x338, {0x0, 0x0, 0x0}, 0},
+ {0x339, {0x0, 0x0, 0x0}, 0},
+ {0x33A, {0x0, 0x0, 0x0}, 0},
+ {0x33B, {0x0, 0x0, 0x0}, 0},
+ {0x33C, {0x0, 0x0, 0x0}, 0},
+ {0x33D, {0x0, 0x0, 0x0}, 0},
+ {0x33E, {0x0, 0x0, 0x0}, 0},
+ {0x33F, {0x0, 0x0, 0x0}, 0},
+ {0x340, {0x0, 0x0, 0x0}, 0},
+ {0x341, {0x0, 0x0, 0x0}, 0},
+ {0x342, {0x0, 0x0, 0x0}, 0},
+ {0x343, {0x0, 0x0, 0x0}, 0},
+ {0x344, {0x0, 0x0, 0x0}, 0},
+ {0x345, {0x0, 0x0, 0x0}, 0},
+ {0x346, {0x0, 0x0, 0x0}, 0},
+ {0x347, {0x0, 0x0, 0x0}, 0},
+ {0x348, {0x0, 0x0, 0x0}, 0},
+ {0x349, {0x0, 0x0, 0x0}, 0},
+ {0x34A, {0x0, 0x0, 0x0}, 0},
+ {0x34B, {0x0, 0x0, 0x0}, 0},
+ {0x34C, {0x0, 0x0, 0x0}, 0},
+ {0x34D, {0x0, 0x0, 0x0}, 0},
+ {0x34E, {0x0, 0x0, 0x0}, 0},
+ {0x34F, {0x0, 0x0, 0x0}, 0},
+ {0x350, {0x0, 0x0, 0x0}, 0},
+ {0x351, {0x0, 0x0, 0x0}, 0},
+ {0x352, {0x0, 0x0, 0x0}, 0},
+ {0x353, {0x0, 0x0, 0x0}, 0},
+ {0x354, {0x0, 0x0, 0x0}, 0},
+ {0x355, {0x0, 0x0, 0x0}, 0},
+ {0x356, {0x0, 0x0, 0x0}, 0},
+ {0x357, {0x0, 0x0, 0x0}, 0},
+ {0x358, {0x0, 0x0, 0x0}, 0},
+ {0x359, {0x0, 0x0, 0x0}, 0},
+ {0x35A, {0x0, 0x0, 0x0}, 0},
+ {0x35B, {0x0, 0x0, 0x0}, 0},
+ {0x35C, {0x0, 0x0, 0x0}, 0},
+ {0x35D, {0x0, 0x0, 0x0}, 0},
+ {0x35E, {0x0, 0x0, 0x0}, 0},
+ {0x35F, {0x0, 0x0, 0x0}, 0},
+ {0x360, {0x0, 0x0, 0x0}, 0},
+ {0x361, {0x0, 0x0, 0x0}, 0},
+ {0x362, {0x0, 0x0, 0x0}, 0},
+ {0x363, {0x0, 0x0, 0x0}, 0},
+ {0x364, {0x0, 0x0, 0x0}, 0},
+ {0x365, {0x0, 0x0, 0x0}, 0},
+ {0x366, {0x0, 0x0, 0x0}, 0},
+ {0x367, {0x0, 0x0, 0x0}, 0},
+ {0x368, {0x0, 0x0, 0x0}, 0},
+ {0x369, {0x0, 0x0, 0x0}, 0},
+ {0x36A, {0x0, 0x0, 0x0}, 0},
+ {0x36B, {0x0, 0x0, 0x0}, 0},
+ {0x36C, {0x0, 0x0, 0x0}, 0},
+ {0x36D, {0x0, 0x0, 0x0}, 0},
+ {0x36E, {0x0, 0x0, 0x0}, 0},
+ {0x36F, {0x0, 0x0, 0x0}, 0},
+ {0x370, {0x371, 0x0, 0x0}, 1},
+ {0x372, {0x373, 0x0, 0x0}, 1},
+ {0x374, {0x2B9, 0x0, 0x0}, 1},
+ {0x376, {0x377, 0x0, 0x0}, 1},
+ {0x37E, {0x3B, 0x0, 0x0}, 1},
+ {0x37F, {0x3F3, 0x0, 0x0}, 1},
+ {0x385, {0xA8, 0x0, 0x0}, 1},
+ {0x386, {0x3B1, 0x0, 0x0}, 1},
+ {0x387, {0xB7, 0x0, 0x0}, 1},
+ {0x388, {0x3B5, 0x0, 0x0}, 1},
+ {0x389, {0x3B7, 0x0, 0x0}, 1},
+ {0x38A, {0x3B9, 0x0, 0x0}, 1},
+ {0x38C, {0x3BF, 0x0, 0x0}, 1},
+ {0x38E, {0x3C5, 0x0, 0x0}, 1},
+ {0x38F, {0x3C9, 0x0, 0x0}, 1},
+ {0x390, {0x3B9, 0x0, 0x0}, 1},
+ {0x391, {0x3B1, 0x0, 0x0}, 1},
+ {0x392, {0x3B2, 0x0, 0x0}, 1},
+ {0x393, {0x3B3, 0x0, 0x0}, 1},
+ {0x394, {0x3B4, 0x0, 0x0}, 1},
+ {0x395, {0x3B5, 0x0, 0x0}, 1},
+ {0x396, {0x3B6, 0x0, 0x0}, 1},
+ {0x397, {0x3B7, 0x0, 0x0}, 1},
+ {0x398, {0x3B8, 0x0, 0x0}, 1},
+ {0x399, {0x3B9, 0x0, 0x0}, 1},
+ {0x39A, {0x3BA, 0x0, 0x0}, 1},
+ {0x39B, {0x3BB, 0x0, 0x0}, 1},
+ {0x39C, {0x3BC, 0x0, 0x0}, 1},
+ {0x39D, {0x3BD, 0x0, 0x0}, 1},
+ {0x39E, {0x3BE, 0x0, 0x0}, 1},
+ {0x39F, {0x3BF, 0x0, 0x0}, 1},
+ {0x3A0, {0x3C0, 0x0, 0x0}, 1},
+ {0x3A1, {0x3C1, 0x0, 0x0}, 1},
+ {0x3A3, {0x3C3, 0x0, 0x0}, 1},
+ {0x3A4, {0x3C4, 0x0, 0x0}, 1},
+ {0x3A5, {0x3C5, 0x0, 0x0}, 1},
+ {0x3A6, {0x3C6, 0x0, 0x0}, 1},
+ {0x3A7, {0x3C7, 0x0, 0x0}, 1},
+ {0x3A8, {0x3C8, 0x0, 0x0}, 1},
+ {0x3A9, {0x3C9, 0x0, 0x0}, 1},
+ {0x3AA, {0x3B9, 0x0, 0x0}, 1},
+ {0x3AB, {0x3C5, 0x0, 0x0}, 1},
+ {0x3AC, {0x3B1, 0x0, 0x0}, 1},
+ {0x3AD, {0x3B5, 0x0, 0x0}, 1},
+ {0x3AE, {0x3B7, 0x0, 0x0}, 1},
+ {0x3AF, {0x3B9, 0x0, 0x0}, 1},
+ {0x3B0, {0x3C5, 0x0, 0x0}, 1},
+ {0x3CA, {0x3B9, 0x0, 0x0}, 1},
+ {0x3CB, {0x3C5, 0x0, 0x0}, 1},
+ {0x3CC, {0x3BF, 0x0, 0x0}, 1},
+ {0x3CD, {0x3C5, 0x0, 0x0}, 1},
+ {0x3CE, {0x3C9, 0x0, 0x0}, 1},
+ {0x3CF, {0x3D7, 0x0, 0x0}, 1},
+ {0x3D3, {0x3D2, 0x0, 0x0}, 1},
+ {0x3D4, {0x3D2, 0x0, 0x0}, 1},
+ {0x3D8, {0x3D9, 0x0, 0x0}, 1},
+ {0x3DA, {0x3DB, 0x0, 0x0}, 1},
+ {0x3DC, {0x3DD, 0x0, 0x0}, 1},
+ {0x3DE, {0x3DF, 0x0, 0x0}, 1},
+ {0x3E0, {0x3E1, 0x0, 0x0}, 1},
+ {0x3E2, {0x3E3, 0x0, 0x0}, 1},
+ {0x3E4, {0x3E5, 0x0, 0x0}, 1},
+ {0x3E6, {0x3E7, 0x0, 0x0}, 1},
+ {0x3E8, {0x3E9, 0x0, 0x0}, 1},
+ {0x3EA, {0x3EB, 0x0, 0x0}, 1},
+ {0x3EC, {0x3ED, 0x0, 0x0}, 1},
+ {0x3EE, {0x3EF, 0x0, 0x0}, 1},
+ {0x3F4, {0x3B8, 0x0, 0x0}, 1},
+ {0x3F7, {0x3F8, 0x0, 0x0}, 1},
+ {0x3F9, {0x3F2, 0x0, 0x0}, 1},
+ {0x3FA, {0x3FB, 0x0, 0x0}, 1},
+ {0x3FD, {0x37B, 0x0, 0x0}, 1},
+ {0x3FE, {0x37C, 0x0, 0x0}, 1},
+ {0x3FF, {0x37D, 0x0, 0x0}, 1},
+ {0x400, {0x435, 0x0, 0x0}, 1},
+ {0x401, {0x435, 0x0, 0x0}, 1},
+ {0x402, {0x452, 0x0, 0x0}, 1},
+ {0x403, {0x433, 0x0, 0x0}, 1},
+ {0x404, {0x454, 0x0, 0x0}, 1},
+ {0x405, {0x455, 0x0, 0x0}, 1},
+ {0x406, {0x456, 0x0, 0x0}, 1},
+ {0x407, {0x456, 0x0, 0x0}, 1},
+ {0x408, {0x458, 0x0, 0x0}, 1},
+ {0x409, {0x459, 0x0, 0x0}, 1},
+ {0x40A, {0x45A, 0x0, 0x0}, 1},
+ {0x40B, {0x45B, 0x0, 0x0}, 1},
+ {0x40C, {0x43A, 0x0, 0x0}, 1},
+ {0x40D, {0x438, 0x0, 0x0}, 1},
+ {0x40E, {0x443, 0x0, 0x0}, 1},
+ {0x40F, {0x45F, 0x0, 0x0}, 1},
+ {0x410, {0x430, 0x0, 0x0}, 1},
+ {0x411, {0x431, 0x0, 0x0}, 1},
+ {0x412, {0x432, 0x0, 0x0}, 1},
+ {0x413, {0x433, 0x0, 0x0}, 1},
+ {0x414, {0x434, 0x0, 0x0}, 1},
+ {0x415, {0x435, 0x0, 0x0}, 1},
+ {0x416, {0x436, 0x0, 0x0}, 1},
+ {0x417, {0x437, 0x0, 0x0}, 1},
+ {0x418, {0x438, 0x0, 0x0}, 1},
+ {0x419, {0x438, 0x0, 0x0}, 1},
+ {0x41A, {0x43A, 0x0, 0x0}, 1},
+ {0x41B, {0x43B, 0x0, 0x0}, 1},
+ {0x41C, {0x43C, 0x0, 0x0}, 1},
+ {0x41D, {0x43D, 0x0, 0x0}, 1},
+ {0x41E, {0x43E, 0x0, 0x0}, 1},
+ {0x41F, {0x43F, 0x0, 0x0}, 1},
+ {0x420, {0x440, 0x0, 0x0}, 1},
+ {0x421, {0x441, 0x0, 0x0}, 1},
+ {0x422, {0x442, 0x0, 0x0}, 1},
+ {0x423, {0x443, 0x0, 0x0}, 1},
+ {0x424, {0x444, 0x0, 0x0}, 1},
+ {0x425, {0x445, 0x0, 0x0}, 1},
+ {0x426, {0x446, 0x0, 0x0}, 1},
+ {0x427, {0x447, 0x0, 0x0}, 1},
+ {0x428, {0x448, 0x0, 0x0}, 1},
+ {0x429, {0x449, 0x0, 0x0}, 1},
+ {0x42A, {0x44A, 0x0, 0x0}, 1},
+ {0x42B, {0x44B, 0x0, 0x0}, 1},
+ {0x42C, {0x44C, 0x0, 0x0}, 1},
+ {0x42D, {0x44D, 0x0, 0x0}, 1},
+ {0x42E, {0x44E, 0x0, 0x0}, 1},
+ {0x42F, {0x44F, 0x0, 0x0}, 1},
+ {0x439, {0x438, 0x0, 0x0}, 1},
+ {0x450, {0x435, 0x0, 0x0}, 1},
+ {0x451, {0x435, 0x0, 0x0}, 1},
+ {0x453, {0x433, 0x0, 0x0}, 1},
+ {0x457, {0x456, 0x0, 0x0}, 1},
+ {0x45C, {0x43A, 0x0, 0x0}, 1},
+ {0x45D, {0x438, 0x0, 0x0}, 1},
+ {0x45E, {0x443, 0x0, 0x0}, 1},
+ {0x460, {0x461, 0x0, 0x0}, 1},
+ {0x462, {0x463, 0x0, 0x0}, 1},
+ {0x464, {0x465, 0x0, 0x0}, 1},
+ {0x466, {0x467, 0x0, 0x0}, 1},
+ {0x468, {0x469, 0x0, 0x0}, 1},
+ {0x46A, {0x46B, 0x0, 0x0}, 1},
+ {0x46C, {0x46D, 0x0, 0x0}, 1},
+ {0x46E, {0x46F, 0x0, 0x0}, 1},
+ {0x470, {0x471, 0x0, 0x0}, 1},
+ {0x472, {0x473, 0x0, 0x0}, 1},
+ {0x474, {0x475, 0x0, 0x0}, 1},
+ {0x476, {0x475, 0x0, 0x0}, 1},
+ {0x477, {0x475, 0x0, 0x0}, 1},
+ {0x478, {0x479, 0x0, 0x0}, 1},
+ {0x47A, {0x47B, 0x0, 0x0}, 1},
+ {0x47C, {0x47D, 0x0, 0x0}, 1},
+ {0x47E, {0x47F, 0x0, 0x0}, 1},
+ {0x480, {0x481, 0x0, 0x0}, 1},
+ {0x483, {0x0, 0x0, 0x0}, 0},
+ {0x484, {0x0, 0x0, 0x0}, 0},
+ {0x485, {0x0, 0x0, 0x0}, 0},
+ {0x486, {0x0, 0x0, 0x0}, 0},
+ {0x487, {0x0, 0x0, 0x0}, 0},
+ {0x48A, {0x48B, 0x0, 0x0}, 1},
+ {0x48C, {0x48D, 0x0, 0x0}, 1},
+ {0x48E, {0x48F, 0x0, 0x0}, 1},
+ {0x490, {0x491, 0x0, 0x0}, 1},
+ {0x492, {0x493, 0x0, 0x0}, 1},
+ {0x494, {0x495, 0x0, 0x0}, 1},
+ {0x496, {0x497, 0x0, 0x0}, 1},
+ {0x498, {0x499, 0x0, 0x0}, 1},
+ {0x49A, {0x49B, 0x0, 0x0}, 1},
+ {0x49C, {0x49D, 0x0, 0x0}, 1},
+ {0x49E, {0x49F, 0x0, 0x0}, 1},
+ {0x4A0, {0x4A1, 0x0, 0x0}, 1},
+ {0x4A2, {0x4A3, 0x0, 0x0}, 1},
+ {0x4A4, {0x4A5, 0x0, 0x0}, 1},
+ {0x4A6, {0x4A7, 0x0, 0x0}, 1},
+ {0x4A8, {0x4A9, 0x0, 0x0}, 1},
+ {0x4AA, {0x4AB, 0x0, 0x0}, 1},
+ {0x4AC, {0x4AD, 0x0, 0x0}, 1},
+ {0x4AE, {0x4AF, 0x0, 0x0}, 1},
+ {0x4B0, {0x4B1, 0x0, 0x0}, 1},
+ {0x4B2, {0x4B3, 0x0, 0x0}, 1},
+ {0x4B4, {0x4B5, 0x0, 0x0}, 1},
+ {0x4B6, {0x4B7, 0x0, 0x0}, 1},
+ {0x4B8, {0x4B9, 0x0, 0x0}, 1},
+ {0x4BA, {0x4BB, 0x0, 0x0}, 1},
+ {0x4BC, {0x4BD, 0x0, 0x0}, 1},
+ {0x4BE, {0x4BF, 0x0, 0x0}, 1},
+ {0x4C0, {0x4CF, 0x0, 0x0}, 1},
+ {0x4C1, {0x436, 0x0, 0x0}, 1},
+ {0x4C2, {0x436, 0x0, 0x0}, 1},
+ {0x4C3, {0x4C4, 0x0, 0x0}, 1},
+ {0x4C5, {0x4C6, 0x0, 0x0}, 1},
+ {0x4C7, {0x4C8, 0x0, 0x0}, 1},
+ {0x4C9, {0x4CA, 0x0, 0x0}, 1},
+ {0x4CB, {0x4CC, 0x0, 0x0}, 1},
+ {0x4CD, {0x4CE, 0x0, 0x0}, 1},
+ {0x4D0, {0x430, 0x0, 0x0}, 1},
+ {0x4D1, {0x430, 0x0, 0x0}, 1},
+ {0x4D2, {0x430, 0x0, 0x0}, 1},
+ {0x4D3, {0x430, 0x0, 0x0}, 1},
+ {0x4D4, {0x4D5, 0x0, 0x0}, 1},
+ {0x4D6, {0x435, 0x0, 0x0}, 1},
+ {0x4D7, {0x435, 0x0, 0x0}, 1},
+ {0x4D8, {0x4D9, 0x0, 0x0}, 1},
+ {0x4DA, {0x4D9, 0x0, 0x0}, 1},
+ {0x4DB, {0x4D9, 0x0, 0x0}, 1},
+ {0x4DC, {0x436, 0x0, 0x0}, 1},
+ {0x4DD, {0x436, 0x0, 0x0}, 1},
+ {0x4DE, {0x437, 0x0, 0x0}, 1},
+ {0x4DF, {0x437, 0x0, 0x0}, 1},
+ {0x4E0, {0x4E1, 0x0, 0x0}, 1},
+ {0x4E2, {0x438, 0x0, 0x0}, 1},
+ {0x4E3, {0x438, 0x0, 0x0}, 1},
+ {0x4E4, {0x438, 0x0, 0x0}, 1},
+ {0x4E5, {0x438, 0x0, 0x0}, 1},
+ {0x4E6, {0x43E, 0x0, 0x0}, 1},
+ {0x4E7, {0x43E, 0x0, 0x0}, 1},
+ {0x4E8, {0x4E9, 0x0, 0x0}, 1},
+ {0x4EA, {0x4E9, 0x0, 0x0}, 1},
+ {0x4EB, {0x4E9, 0x0, 0x0}, 1},
+ {0x4EC, {0x44D, 0x0, 0x0}, 1},
+ {0x4ED, {0x44D, 0x0, 0x0}, 1},
+ {0x4EE, {0x443, 0x0, 0x0}, 1},
+ {0x4EF, {0x443, 0x0, 0x0}, 1},
+ {0x4F0, {0x443, 0x0, 0x0}, 1},
+ {0x4F1, {0x443, 0x0, 0x0}, 1},
+ {0x4F2, {0x443, 0x0, 0x0}, 1},
+ {0x4F3, {0x443, 0x0, 0x0}, 1},
+ {0x4F4, {0x447, 0x0, 0x0}, 1},
+ {0x4F5, {0x447, 0x0, 0x0}, 1},
+ {0x4F6, {0x4F7, 0x0, 0x0}, 1},
+ {0x4F8, {0x44B, 0x0, 0x0}, 1},
+ {0x4F9, {0x44B, 0x0, 0x0}, 1},
+ {0x4FA, {0x4FB, 0x0, 0x0}, 1},
+ {0x4FC, {0x4FD, 0x0, 0x0}, 1},
+ {0x4FE, {0x4FF, 0x0, 0x0}, 1},
+ {0x500, {0x501, 0x0, 0x0}, 1},
+ {0x502, {0x503, 0x0, 0x0}, 1},
+ {0x504, {0x505, 0x0, 0x0}, 1},
+ {0x506, {0x507, 0x0, 0x0}, 1},
+ {0x508, {0x509, 0x0, 0x0}, 1},
+ {0x50A, {0x50B, 0x0, 0x0}, 1},
+ {0x50C, {0x50D, 0x0, 0x0}, 1},
+ {0x50E, {0x50F, 0x0, 0x0}, 1},
+ {0x510, {0x511, 0x0, 0x0}, 1},
+ {0x512, {0x513, 0x0, 0x0}, 1},
+ {0x514, {0x515, 0x0, 0x0}, 1},
+ {0x516, {0x517, 0x0, 0x0}, 1},
+ {0x518, {0x519, 0x0, 0x0}, 1},
+ {0x51A, {0x51B, 0x0, 0x0}, 1},
+ {0x51C, {0x51D, 0x0, 0x0}, 1},
+ {0x51E, {0x51F, 0x0, 0x0}, 1},
+ {0x520, {0x521, 0x0, 0x0}, 1},
+ {0x522, {0x523, 0x0, 0x0}, 1},
+ {0x524, {0x525, 0x0, 0x0}, 1},
+ {0x526, {0x527, 0x0, 0x0}, 1},
+ {0x528, {0x529, 0x0, 0x0}, 1},
+ {0x52A, {0x52B, 0x0, 0x0}, 1},
+ {0x52C, {0x52D, 0x0, 0x0}, 1},
+ {0x52E, {0x52F, 0x0, 0x0}, 1},
+ {0x531, {0x561, 0x0, 0x0}, 1},
+ {0x532, {0x562, 0x0, 0x0}, 1},
+ {0x533, {0x563, 0x0, 0x0}, 1},
+ {0x534, {0x564, 0x0, 0x0}, 1},
+ {0x535, {0x565, 0x0, 0x0}, 1},
+ {0x536, {0x566, 0x0, 0x0}, 1},
+ {0x537, {0x567, 0x0, 0x0}, 1},
+ {0x538, {0x568, 0x0, 0x0}, 1},
+ {0x539, {0x569, 0x0, 0x0}, 1},
+ {0x53A, {0x56A, 0x0, 0x0}, 1},
+ {0x53B, {0x56B, 0x0, 0x0}, 1},
+ {0x53C, {0x56C, 0x0, 0x0}, 1},
+ {0x53D, {0x56D, 0x0, 0x0}, 1},
+ {0x53E, {0x56E, 0x0, 0x0}, 1},
+ {0x53F, {0x56F, 0x0, 0x0}, 1},
+ {0x540, {0x570, 0x0, 0x0}, 1},
+ {0x541, {0x571, 0x0, 0x0}, 1},
+ {0x542, {0x572, 0x0, 0x0}, 1},
+ {0x543, {0x573, 0x0, 0x0}, 1},
+ {0x544, {0x574, 0x0, 0x0}, 1},
+ {0x545, {0x575, 0x0, 0x0}, 1},
+ {0x546, {0x576, 0x0, 0x0}, 1},
+ {0x547, {0x577, 0x0, 0x0}, 1},
+ {0x548, {0x578, 0x0, 0x0}, 1},
+ {0x549, {0x579, 0x0, 0x0}, 1},
+ {0x54A, {0x57A, 0x0, 0x0}, 1},
+ {0x54B, {0x57B, 0x0, 0x0}, 1},
+ {0x54C, {0x57C, 0x0, 0x0}, 1},
+ {0x54D, {0x57D, 0x0, 0x0}, 1},
+ {0x54E, {0x57E, 0x0, 0x0}, 1},
+ {0x54F, {0x57F, 0x0, 0x0}, 1},
+ {0x550, {0x580, 0x0, 0x0}, 1},
+ {0x551, {0x581, 0x0, 0x0}, 1},
+ {0x552, {0x582, 0x0, 0x0}, 1},
+ {0x553, {0x583, 0x0, 0x0}, 1},
+ {0x554, {0x584, 0x0, 0x0}, 1},
+ {0x555, {0x585, 0x0, 0x0}, 1},
+ {0x556, {0x586, 0x0, 0x0}, 1},
+ {0x591, {0x0, 0x0, 0x0}, 0},
+ {0x592, {0x0, 0x0, 0x0}, 0},
+ {0x593, {0x0, 0x0, 0x0}, 0},
+ {0x594, {0x0, 0x0, 0x0}, 0},
+ {0x595, {0x0, 0x0, 0x0}, 0},
+ {0x596, {0x0, 0x0, 0x0}, 0},
+ {0x597, {0x0, 0x0, 0x0}, 0},
+ {0x598, {0x0, 0x0, 0x0}, 0},
+ {0x599, {0x0, 0x0, 0x0}, 0},
+ {0x59A, {0x0, 0x0, 0x0}, 0},
+ {0x59B, {0x0, 0x0, 0x0}, 0},
+ {0x59C, {0x0, 0x0, 0x0}, 0},
+ {0x59D, {0x0, 0x0, 0x0}, 0},
+ {0x59E, {0x0, 0x0, 0x0}, 0},
+ {0x59F, {0x0, 0x0, 0x0}, 0},
+ {0x5A0, {0x0, 0x0, 0x0}, 0},
+ {0x5A1, {0x0, 0x0, 0x0}, 0},
+ {0x5A2, {0x0, 0x0, 0x0}, 0},
+ {0x5A3, {0x0, 0x0, 0x0}, 0},
+ {0x5A4, {0x0, 0x0, 0x0}, 0},
+ {0x5A5, {0x0, 0x0, 0x0}, 0},
+ {0x5A6, {0x0, 0x0, 0x0}, 0},
+ {0x5A7, {0x0, 0x0, 0x0}, 0},
+ {0x5A8, {0x0, 0x0, 0x0}, 0},
+ {0x5A9, {0x0, 0x0, 0x0}, 0},
+ {0x5AA, {0x0, 0x0, 0x0}, 0},
+ {0x5AB, {0x0, 0x0, 0x0}, 0},
+ {0x5AC, {0x0, 0x0, 0x0}, 0},
+ {0x5AD, {0x0, 0x0, 0x0}, 0},
+ {0x5AE, {0x0, 0x0, 0x0}, 0},
+ {0x5AF, {0x0, 0x0, 0x0}, 0},
+ {0x5B0, {0x0, 0x0, 0x0}, 0},
+ {0x5B1, {0x0, 0x0, 0x0}, 0},
+ {0x5B2, {0x0, 0x0, 0x0}, 0},
+ {0x5B3, {0x0, 0x0, 0x0}, 0},
+ {0x5B4, {0x0, 0x0, 0x0}, 0},
+ {0x5B5, {0x0, 0x0, 0x0}, 0},
+ {0x5B6, {0x0, 0x0, 0x0}, 0},
+ {0x5B7, {0x0, 0x0, 0x0}, 0},
+ {0x5B8, {0x0, 0x0, 0x0}, 0},
+ {0x5B9, {0x0, 0x0, 0x0}, 0},
+ {0x5BA, {0x0, 0x0, 0x0}, 0},
+ {0x5BB, {0x0, 0x0, 0x0}, 0},
+ {0x5BC, {0x0, 0x0, 0x0}, 0},
+ {0x5BD, {0x0, 0x0, 0x0}, 0},
+ {0x5BF, {0x0, 0x0, 0x0}, 0},
+ {0x5C1, {0x0, 0x0, 0x0}, 0},
+ {0x5C2, {0x0, 0x0, 0x0}, 0},
+ {0x5C4, {0x0, 0x0, 0x0}, 0},
+ {0x5C5, {0x0, 0x0, 0x0}, 0},
+ {0x5C7, {0x0, 0x0, 0x0}, 0},
+ {0x610, {0x0, 0x0, 0x0}, 0},
+ {0x611, {0x0, 0x0, 0x0}, 0},
+ {0x612, {0x0, 0x0, 0x0}, 0},
+ {0x613, {0x0, 0x0, 0x0}, 0},
+ {0x614, {0x0, 0x0, 0x0}, 0},
+ {0x615, {0x0, 0x0, 0x0}, 0},
+ {0x616, {0x0, 0x0, 0x0}, 0},
+ {0x617, {0x0, 0x0, 0x0}, 0},
+ {0x618, {0x0, 0x0, 0x0}, 0},
+ {0x619, {0x0, 0x0, 0x0}, 0},
+ {0x61A, {0x0, 0x0, 0x0}, 0},
+ {0x622, {0x627, 0x0, 0x0}, 1},
+ {0x623, {0x627, 0x0, 0x0}, 1},
+ {0x624, {0x648, 0x0, 0x0}, 1},
+ {0x625, {0x627, 0x0, 0x0}, 1},
+ {0x626, {0x64A, 0x0, 0x0}, 1},
+ {0x64B, {0x0, 0x0, 0x0}, 0},
+ {0x64C, {0x0, 0x0, 0x0}, 0},
+ {0x64D, {0x0, 0x0, 0x0}, 0},
+ {0x64E, {0x0, 0x0, 0x0}, 0},
+ {0x64F, {0x0, 0x0, 0x0}, 0},
+ {0x650, {0x0, 0x0, 0x0}, 0},
+ {0x651, {0x0, 0x0, 0x0}, 0},
+ {0x652, {0x0, 0x0, 0x0}, 0},
+ {0x653, {0x0, 0x0, 0x0}, 0},
+ {0x654, {0x0, 0x0, 0x0}, 0},
+ {0x655, {0x0, 0x0, 0x0}, 0},
+ {0x656, {0x0, 0x0, 0x0}, 0},
+ {0x657, {0x0, 0x0, 0x0}, 0},
+ {0x658, {0x0, 0x0, 0x0}, 0},
+ {0x659, {0x0, 0x0, 0x0}, 0},
+ {0x65A, {0x0, 0x0, 0x0}, 0},
+ {0x65B, {0x0, 0x0, 0x0}, 0},
+ {0x65C, {0x0, 0x0, 0x0}, 0},
+ {0x65D, {0x0, 0x0, 0x0}, 0},
+ {0x65E, {0x0, 0x0, 0x0}, 0},
+ {0x65F, {0x0, 0x0, 0x0}, 0},
+ {0x670, {0x0, 0x0, 0x0}, 0},
+ {0x6C0, {0x6D5, 0x0, 0x0}, 1},
+ {0x6C2, {0x6C1, 0x0, 0x0}, 1},
+ {0x6D3, {0x6D2, 0x0, 0x0}, 1},
+ {0x6D6, {0x0, 0x0, 0x0}, 0},
+ {0x6D7, {0x0, 0x0, 0x0}, 0},
+ {0x6D8, {0x0, 0x0, 0x0}, 0},
+ {0x6D9, {0x0, 0x0, 0x0}, 0},
+ {0x6DA, {0x0, 0x0, 0x0}, 0},
+ {0x6DB, {0x0, 0x0, 0x0}, 0},
+ {0x6DC, {0x0, 0x0, 0x0}, 0},
+ {0x6DF, {0x0, 0x0, 0x0}, 0},
+ {0x6E0, {0x0, 0x0, 0x0}, 0},
+ {0x6E1, {0x0, 0x0, 0x0}, 0},
+ {0x6E2, {0x0, 0x0, 0x0}, 0},
+ {0x6E3, {0x0, 0x0, 0x0}, 0},
+ {0x6E4, {0x0, 0x0, 0x0}, 0},
+ {0x6E7, {0x0, 0x0, 0x0}, 0},
+ {0x6E8, {0x0, 0x0, 0x0}, 0},
+ {0x6EA, {0x0, 0x0, 0x0}, 0},
+ {0x6EB, {0x0, 0x0, 0x0}, 0},
+ {0x6EC, {0x0, 0x0, 0x0}, 0},
+ {0x6ED, {0x0, 0x0, 0x0}, 0},
+ {0x711, {0x0, 0x0, 0x0}, 0},
+ {0x730, {0x0, 0x0, 0x0}, 0},
+ {0x731, {0x0, 0x0, 0x0}, 0},
+ {0x732, {0x0, 0x0, 0x0}, 0},
+ {0x733, {0x0, 0x0, 0x0}, 0},
+ {0x734, {0x0, 0x0, 0x0}, 0},
+ {0x735, {0x0, 0x0, 0x0}, 0},
+ {0x736, {0x0, 0x0, 0x0}, 0},
+ {0x737, {0x0, 0x0, 0x0}, 0},
+ {0x738, {0x0, 0x0, 0x0}, 0},
+ {0x739, {0x0, 0x0, 0x0}, 0},
+ {0x73A, {0x0, 0x0, 0x0}, 0},
+ {0x73B, {0x0, 0x0, 0x0}, 0},
+ {0x73C, {0x0, 0x0, 0x0}, 0},
+ {0x73D, {0x0, 0x0, 0x0}, 0},
+ {0x73E, {0x0, 0x0, 0x0}, 0},
+ {0x73F, {0x0, 0x0, 0x0}, 0},
+ {0x740, {0x0, 0x0, 0x0}, 0},
+ {0x741, {0x0, 0x0, 0x0}, 0},
+ {0x742, {0x0, 0x0, 0x0}, 0},
+ {0x743, {0x0, 0x0, 0x0}, 0},
+ {0x744, {0x0, 0x0, 0x0}, 0},
+ {0x745, {0x0, 0x0, 0x0}, 0},
+ {0x746, {0x0, 0x0, 0x0}, 0},
+ {0x747, {0x0, 0x0, 0x0}, 0},
+ {0x748, {0x0, 0x0, 0x0}, 0},
+ {0x749, {0x0, 0x0, 0x0}, 0},
+ {0x74A, {0x0, 0x0, 0x0}, 0},
+ {0x7A6, {0x0, 0x0, 0x0}, 0},
+ {0x7A7, {0x0, 0x0, 0x0}, 0},
+ {0x7A8, {0x0, 0x0, 0x0}, 0},
+ {0x7A9, {0x0, 0x0, 0x0}, 0},
+ {0x7AA, {0x0, 0x0, 0x0}, 0},
+ {0x7AB, {0x0, 0x0, 0x0}, 0},
+ {0x7AC, {0x0, 0x0, 0x0}, 0},
+ {0x7AD, {0x0, 0x0, 0x0}, 0},
+ {0x7AE, {0x0, 0x0, 0x0}, 0},
+ {0x7AF, {0x0, 0x0, 0x0}, 0},
+ {0x7B0, {0x0, 0x0, 0x0}, 0},
+ {0x7EB, {0x0, 0x0, 0x0}, 0},
+ {0x7EC, {0x0, 0x0, 0x0}, 0},
+ {0x7ED, {0x0, 0x0, 0x0}, 0},
+ {0x7EE, {0x0, 0x0, 0x0}, 0},
+ {0x7EF, {0x0, 0x0, 0x0}, 0},
+ {0x7F0, {0x0, 0x0, 0x0}, 0},
+ {0x7F1, {0x0, 0x0, 0x0}, 0},
+ {0x7F2, {0x0, 0x0, 0x0}, 0},
+ {0x7F3, {0x0, 0x0, 0x0}, 0},
+ {0x7FD, {0x0, 0x0, 0x0}, 0},
+ {0x816, {0x0, 0x0, 0x0}, 0},
+ {0x817, {0x0, 0x0, 0x0}, 0},
+ {0x818, {0x0, 0x0, 0x0}, 0},
+ {0x819, {0x0, 0x0, 0x0}, 0},
+ {0x81B, {0x0, 0x0, 0x0}, 0},
+ {0x81C, {0x0, 0x0, 0x0}, 0},
+ {0x81D, {0x0, 0x0, 0x0}, 0},
+ {0x81E, {0x0, 0x0, 0x0}, 0},
+ {0x81F, {0x0, 0x0, 0x0}, 0},
+ {0x820, {0x0, 0x0, 0x0}, 0},
+ {0x821, {0x0, 0x0, 0x0}, 0},
+ {0x822, {0x0, 0x0, 0x0}, 0},
+ {0x823, {0x0, 0x0, 0x0}, 0},
+ {0x825, {0x0, 0x0, 0x0}, 0},
+ {0x826, {0x0, 0x0, 0x0}, 0},
+ {0x827, {0x0, 0x0, 0x0}, 0},
+ {0x829, {0x0, 0x0, 0x0}, 0},
+ {0x82A, {0x0, 0x0, 0x0}, 0},
+ {0x82B, {0x0, 0x0, 0x0}, 0},
+ {0x82C, {0x0, 0x0, 0x0}, 0},
+ {0x82D, {0x0, 0x0, 0x0}, 0},
+ {0x859, {0x0, 0x0, 0x0}, 0},
+ {0x85A, {0x0, 0x0, 0x0}, 0},
+ {0x85B, {0x0, 0x0, 0x0}, 0},
+ {0x8D3, {0x0, 0x0, 0x0}, 0},
+ {0x8D4, {0x0, 0x0, 0x0}, 0},
+ {0x8D5, {0x0, 0x0, 0x0}, 0},
+ {0x8D6, {0x0, 0x0, 0x0}, 0},
+ {0x8D7, {0x0, 0x0, 0x0}, 0},
+ {0x8D8, {0x0, 0x0, 0x0}, 0},
+ {0x8D9, {0x0, 0x0, 0x0}, 0},
+ {0x8DA, {0x0, 0x0, 0x0}, 0},
+ {0x8DB, {0x0, 0x0, 0x0}, 0},
+ {0x8DC, {0x0, 0x0, 0x0}, 0},
+ {0x8DD, {0x0, 0x0, 0x0}, 0},
+ {0x8DE, {0x0, 0x0, 0x0}, 0},
+ {0x8DF, {0x0, 0x0, 0x0}, 0},
+ {0x8E0, {0x0, 0x0, 0x0}, 0},
+ {0x8E1, {0x0, 0x0, 0x0}, 0},
+ {0x8E3, {0x0, 0x0, 0x0}, 0},
+ {0x8E4, {0x0, 0x0, 0x0}, 0},
+ {0x8E5, {0x0, 0x0, 0x0}, 0},
+ {0x8E6, {0x0, 0x0, 0x0}, 0},
+ {0x8E7, {0x0, 0x0, 0x0}, 0},
+ {0x8E8, {0x0, 0x0, 0x0}, 0},
+ {0x8E9, {0x0, 0x0, 0x0}, 0},
+ {0x8EA, {0x0, 0x0, 0x0}, 0},
+ {0x8EB, {0x0, 0x0, 0x0}, 0},
+ {0x8EC, {0x0, 0x0, 0x0}, 0},
+ {0x8ED, {0x0, 0x0, 0x0}, 0},
+ {0x8EE, {0x0, 0x0, 0x0}, 0},
+ {0x8EF, {0x0, 0x0, 0x0}, 0},
+ {0x8F0, {0x0, 0x0, 0x0}, 0},
+ {0x8F1, {0x0, 0x0, 0x0}, 0},
+ {0x8F2, {0x0, 0x0, 0x0}, 0},
+ {0x8F3, {0x0, 0x0, 0x0}, 0},
+ {0x8F4, {0x0, 0x0, 0x0}, 0},
+ {0x8F5, {0x0, 0x0, 0x0}, 0},
+ {0x8F6, {0x0, 0x0, 0x0}, 0},
+ {0x8F7, {0x0, 0x0, 0x0}, 0},
+ {0x8F8, {0x0, 0x0, 0x0}, 0},
+ {0x8F9, {0x0, 0x0, 0x0}, 0},
+ {0x8FA, {0x0, 0x0, 0x0}, 0},
+ {0x8FB, {0x0, 0x0, 0x0}, 0},
+ {0x8FC, {0x0, 0x0, 0x0}, 0},
+ {0x8FD, {0x0, 0x0, 0x0}, 0},
+ {0x8FE, {0x0, 0x0, 0x0}, 0},
+ {0x8FF, {0x0, 0x0, 0x0}, 0},
+ {0x900, {0x0, 0x0, 0x0}, 0},
+ {0x901, {0x0, 0x0, 0x0}, 0},
+ {0x902, {0x0, 0x0, 0x0}, 0},
+ {0x929, {0x928, 0x0, 0x0}, 1},
+ {0x931, {0x930, 0x0, 0x0}, 1},
+ {0x934, {0x933, 0x0, 0x0}, 1},
+ {0x93A, {0x0, 0x0, 0x0}, 0},
+ {0x93C, {0x0, 0x0, 0x0}, 0},
+ {0x941, {0x0, 0x0, 0x0}, 0},
+ {0x942, {0x0, 0x0, 0x0}, 0},
+ {0x943, {0x0, 0x0, 0x0}, 0},
+ {0x944, {0x0, 0x0, 0x0}, 0},
+ {0x945, {0x0, 0x0, 0x0}, 0},
+ {0x946, {0x0, 0x0, 0x0}, 0},
+ {0x947, {0x0, 0x0, 0x0}, 0},
+ {0x948, {0x0, 0x0, 0x0}, 0},
+ {0x94D, {0x0, 0x0, 0x0}, 0},
+ {0x951, {0x0, 0x0, 0x0}, 0},
+ {0x952, {0x0, 0x0, 0x0}, 0},
+ {0x953, {0x0, 0x0, 0x0}, 0},
+ {0x954, {0x0, 0x0, 0x0}, 0},
+ {0x955, {0x0, 0x0, 0x0}, 0},
+ {0x956, {0x0, 0x0, 0x0}, 0},
+ {0x957, {0x0, 0x0, 0x0}, 0},
+ {0x958, {0x915, 0x0, 0x0}, 1},
+ {0x959, {0x916, 0x0, 0x0}, 1},
+ {0x95A, {0x917, 0x0, 0x0}, 1},
+ {0x95B, {0x91C, 0x0, 0x0}, 1},
+ {0x95C, {0x921, 0x0, 0x0}, 1},
+ {0x95D, {0x922, 0x0, 0x0}, 1},
+ {0x95E, {0x92B, 0x0, 0x0}, 1},
+ {0x95F, {0x92F, 0x0, 0x0}, 1},
+ {0x962, {0x0, 0x0, 0x0}, 0},
+ {0x963, {0x0, 0x0, 0x0}, 0},
+ {0x981, {0x0, 0x0, 0x0}, 0},
+ {0x9BC, {0x0, 0x0, 0x0}, 0},
+ {0x9C1, {0x0, 0x0, 0x0}, 0},
+ {0x9C2, {0x0, 0x0, 0x0}, 0},
+ {0x9C3, {0x0, 0x0, 0x0}, 0},
+ {0x9C4, {0x0, 0x0, 0x0}, 0},
+ {0x9CB, {0x9C7, 0x9BE, 0x0}, 2},
+ {0x9CC, {0x9C7, 0x9D7, 0x0}, 2},
+ {0x9CD, {0x0, 0x0, 0x0}, 0},
+ {0x9DC, {0x9A1, 0x0, 0x0}, 1},
+ {0x9DD, {0x9A2, 0x0, 0x0}, 1},
+ {0x9DF, {0x9AF, 0x0, 0x0}, 1},
+ {0x9E2, {0x0, 0x0, 0x0}, 0},
+ {0x9E3, {0x0, 0x0, 0x0}, 0},
+ {0x9FE, {0x0, 0x0, 0x0}, 0},
+ {0xA01, {0x0, 0x0, 0x0}, 0},
+ {0xA02, {0x0, 0x0, 0x0}, 0},
+ {0xA33, {0xA32, 0x0, 0x0}, 1},
+ {0xA36, {0xA38, 0x0, 0x0}, 1},
+ {0xA3C, {0x0, 0x0, 0x0}, 0},
+ {0xA41, {0x0, 0x0, 0x0}, 0},
+ {0xA42, {0x0, 0x0, 0x0}, 0},
+ {0xA47, {0x0, 0x0, 0x0}, 0},
+ {0xA48, {0x0, 0x0, 0x0}, 0},
+ {0xA4B, {0x0, 0x0, 0x0}, 0},
+ {0xA4C, {0x0, 0x0, 0x0}, 0},
+ {0xA4D, {0x0, 0x0, 0x0}, 0},
+ {0xA51, {0x0, 0x0, 0x0}, 0},
+ {0xA59, {0xA16, 0x0, 0x0}, 1},
+ {0xA5A, {0xA17, 0x0, 0x0}, 1},
+ {0xA5B, {0xA1C, 0x0, 0x0}, 1},
+ {0xA5E, {0xA2B, 0x0, 0x0}, 1},
+ {0xA70, {0x0, 0x0, 0x0}, 0},
+ {0xA71, {0x0, 0x0, 0x0}, 0},
+ {0xA75, {0x0, 0x0, 0x0}, 0},
+ {0xA81, {0x0, 0x0, 0x0}, 0},
+ {0xA82, {0x0, 0x0, 0x0}, 0},
+ {0xABC, {0x0, 0x0, 0x0}, 0},
+ {0xAC1, {0x0, 0x0, 0x0}, 0},
+ {0xAC2, {0x0, 0x0, 0x0}, 0},
+ {0xAC3, {0x0, 0x0, 0x0}, 0},
+ {0xAC4, {0x0, 0x0, 0x0}, 0},
+ {0xAC5, {0x0, 0x0, 0x0}, 0},
+ {0xAC7, {0x0, 0x0, 0x0}, 0},
+ {0xAC8, {0x0, 0x0, 0x0}, 0},
+ {0xACD, {0x0, 0x0, 0x0}, 0},
+ {0xAE2, {0x0, 0x0, 0x0}, 0},
+ {0xAE3, {0x0, 0x0, 0x0}, 0},
+ {0xAFA, {0x0, 0x0, 0x0}, 0},
+ {0xAFB, {0x0, 0x0, 0x0}, 0},
+ {0xAFC, {0x0, 0x0, 0x0}, 0},
+ {0xAFD, {0x0, 0x0, 0x0}, 0},
+ {0xAFE, {0x0, 0x0, 0x0}, 0},
+ {0xAFF, {0x0, 0x0, 0x0}, 0},
+ {0xB01, {0x0, 0x0, 0x0}, 0},
+ {0xB3C, {0x0, 0x0, 0x0}, 0},
+ {0xB3F, {0x0, 0x0, 0x0}, 0},
+ {0xB41, {0x0, 0x0, 0x0}, 0},
+ {0xB42, {0x0, 0x0, 0x0}, 0},
+ {0xB43, {0x0, 0x0, 0x0}, 0},
+ {0xB44, {0x0, 0x0, 0x0}, 0},
+ {0xB48, {0xB47, 0x0, 0x0}, 1},
+ {0xB4B, {0xB47, 0xB3E, 0x0}, 2},
+ {0xB4C, {0xB47, 0xB57, 0x0}, 2},
+ {0xB4D, {0x0, 0x0, 0x0}, 0},
+ {0xB55, {0x0, 0x0, 0x0}, 0},
+ {0xB56, {0x0, 0x0, 0x0}, 0},
+ {0xB5C, {0xB21, 0x0, 0x0}, 1},
+ {0xB5D, {0xB22, 0x0, 0x0}, 1},
+ {0xB62, {0x0, 0x0, 0x0}, 0},
+ {0xB63, {0x0, 0x0, 0x0}, 0},
+ {0xB82, {0x0, 0x0, 0x0}, 0},
+ {0xB94, {0xB92, 0xBD7, 0x0}, 2},
+ {0xBC0, {0x0, 0x0, 0x0}, 0},
+ {0xBCA, {0xBC6, 0xBBE, 0x0}, 2},
+ {0xBCB, {0xBC7, 0xBBE, 0x0}, 2},
+ {0xBCC, {0xBC6, 0xBD7, 0x0}, 2},
+ {0xBCD, {0x0, 0x0, 0x0}, 0},
+ {0xC00, {0x0, 0x0, 0x0}, 0},
+ {0xC04, {0x0, 0x0, 0x0}, 0},
+ {0xC3E, {0x0, 0x0, 0x0}, 0},
+ {0xC3F, {0x0, 0x0, 0x0}, 0},
+ {0xC40, {0x0, 0x0, 0x0}, 0},
+ {0xC46, {0x0, 0x0, 0x0}, 0},
+ {0xC47, {0x0, 0x0, 0x0}, 0},
+ {0xC48, {0x0, 0x0, 0x0}, 0},
+ {0xC4A, {0x0, 0x0, 0x0}, 0},
+ {0xC4B, {0x0, 0x0, 0x0}, 0},
+ {0xC4C, {0x0, 0x0, 0x0}, 0},
+ {0xC4D, {0x0, 0x0, 0x0}, 0},
+ {0xC55, {0x0, 0x0, 0x0}, 0},
+ {0xC56, {0x0, 0x0, 0x0}, 0},
+ {0xC62, {0x0, 0x0, 0x0}, 0},
+ {0xC63, {0x0, 0x0, 0x0}, 0},
+ {0xC81, {0x0, 0x0, 0x0}, 0},
+ {0xCBC, {0x0, 0x0, 0x0}, 0},
+ {0xCBF, {0x0, 0x0, 0x0}, 0},
+ {0xCC0, {0xCD5, 0x0, 0x0}, 1},
+ {0xCC6, {0x0, 0x0, 0x0}, 0},
+ {0xCC7, {0xCD5, 0x0, 0x0}, 1},
+ {0xCC8, {0xCD6, 0x0, 0x0}, 1},
+ {0xCCA, {0xCC2, 0x0, 0x0}, 1},
+ {0xCCB, {0xCC2, 0xCD5, 0x0}, 2},
+ {0xCCC, {0x0, 0x0, 0x0}, 0},
+ {0xCCD, {0x0, 0x0, 0x0}, 0},
+ {0xCE2, {0x0, 0x0, 0x0}, 0},
+ {0xCE3, {0x0, 0x0, 0x0}, 0},
+ {0xD00, {0x0, 0x0, 0x0}, 0},
+ {0xD01, {0x0, 0x0, 0x0}, 0},
+ {0xD3B, {0x0, 0x0, 0x0}, 0},
+ {0xD3C, {0x0, 0x0, 0x0}, 0},
+ {0xD41, {0x0, 0x0, 0x0}, 0},
+ {0xD42, {0x0, 0x0, 0x0}, 0},
+ {0xD43, {0x0, 0x0, 0x0}, 0},
+ {0xD44, {0x0, 0x0, 0x0}, 0},
+ {0xD4A, {0xD46, 0xD3E, 0x0}, 2},
+ {0xD4B, {0xD47, 0xD3E, 0x0}, 2},
+ {0xD4C, {0xD46, 0xD57, 0x0}, 2},
+ {0xD4D, {0x0, 0x0, 0x0}, 0},
+ {0xD62, {0x0, 0x0, 0x0}, 0},
+ {0xD63, {0x0, 0x0, 0x0}, 0},
+ {0xD81, {0x0, 0x0, 0x0}, 0},
+ {0xDCA, {0x0, 0x0, 0x0}, 0},
+ {0xDD2, {0x0, 0x0, 0x0}, 0},
+ {0xDD3, {0x0, 0x0, 0x0}, 0},
+ {0xDD4, {0x0, 0x0, 0x0}, 0},
+ {0xDD6, {0x0, 0x0, 0x0}, 0},
+ {0xDDA, {0xDD9, 0x0, 0x0}, 1},
+ {0xDDC, {0xDD9, 0xDCF, 0x0}, 2},
+ {0xDDD, {0xDD9, 0xDCF, 0x0}, 2},
+ {0xDDE, {0xDD9, 0xDDF, 0x0}, 2},
+ {0xE31, {0x0, 0x0, 0x0}, 0},
+ {0xE34, {0x0, 0x0, 0x0}, 0},
+ {0xE35, {0x0, 0x0, 0x0}, 0},
+ {0xE36, {0x0, 0x0, 0x0}, 0},
+ {0xE37, {0x0, 0x0, 0x0}, 0},
+ {0xE38, {0x0, 0x0, 0x0}, 0},
+ {0xE39, {0x0, 0x0, 0x0}, 0},
+ {0xE3A, {0x0, 0x0, 0x0}, 0},
+ {0xE47, {0x0, 0x0, 0x0}, 0},
+ {0xE48, {0x0, 0x0, 0x0}, 0},
+ {0xE49, {0x0, 0x0, 0x0}, 0},
+ {0xE4A, {0x0, 0x0, 0x0}, 0},
+ {0xE4B, {0x0, 0x0, 0x0}, 0},
+ {0xE4C, {0x0, 0x0, 0x0}, 0},
+ {0xE4D, {0x0, 0x0, 0x0}, 0},
+ {0xE4E, {0x0, 0x0, 0x0}, 0},
+ {0xEB1, {0x0, 0x0, 0x0}, 0},
+ {0xEB4, {0x0, 0x0, 0x0}, 0},
+ {0xEB5, {0x0, 0x0, 0x0}, 0},
+ {0xEB6, {0x0, 0x0, 0x0}, 0},
+ {0xEB7, {0x0, 0x0, 0x0}, 0},
+ {0xEB8, {0x0, 0x0, 0x0}, 0},
+ {0xEB9, {0x0, 0x0, 0x0}, 0},
+ {0xEBA, {0x0, 0x0, 0x0}, 0},
+ {0xEBB, {0x0, 0x0, 0x0}, 0},
+ {0xEBC, {0x0, 0x0, 0x0}, 0},
+ {0xEC8, {0x0, 0x0, 0x0}, 0},
+ {0xEC9, {0x0, 0x0, 0x0}, 0},
+ {0xECA, {0x0, 0x0, 0x0}, 0},
+ {0xECB, {0x0, 0x0, 0x0}, 0},
+ {0xECC, {0x0, 0x0, 0x0}, 0},
+ {0xECD, {0x0, 0x0, 0x0}, 0},
+ {0xF18, {0x0, 0x0, 0x0}, 0},
+ {0xF19, {0x0, 0x0, 0x0}, 0},
+ {0xF35, {0x0, 0x0, 0x0}, 0},
+ {0xF37, {0x0, 0x0, 0x0}, 0},
+ {0xF39, {0x0, 0x0, 0x0}, 0},
+ {0xF43, {0xF42, 0x0, 0x0}, 1},
+ {0xF4D, {0xF4C, 0x0, 0x0}, 1},
+ {0xF52, {0xF51, 0x0, 0x0}, 1},
+ {0xF57, {0xF56, 0x0, 0x0}, 1},
+ {0xF5C, {0xF5B, 0x0, 0x0}, 1},
+ {0xF69, {0xF40, 0x0, 0x0}, 1},
+ {0xF71, {0x0, 0x0, 0x0}, 0},
+ {0xF72, {0x0, 0x0, 0x0}, 0},
+ {0xF73, {0x0, 0x0, 0x0}, 0},
+ {0xF74, {0x0, 0x0, 0x0}, 0},
+ {0xF75, {0x0, 0x0, 0x0}, 0},
+ {0xF76, {0x0, 0x0, 0x0}, 0},
+ {0xF77, {0x0, 0x0, 0x0}, 0},
+ {0xF78, {0x0, 0x0, 0x0}, 0},
+ {0xF79, {0x0, 0x0, 0x0}, 0},
+ {0xF7A, {0x0, 0x0, 0x0}, 0},
+ {0xF7B, {0x0, 0x0, 0x0}, 0},
+ {0xF7C, {0x0, 0x0, 0x0}, 0},
+ {0xF7D, {0x0, 0x0, 0x0}, 0},
+ {0xF7E, {0x0, 0x0, 0x0}, 0},
+ {0xF80, {0x0, 0x0, 0x0}, 0},
+ {0xF81, {0x0, 0x0, 0x0}, 0},
+ {0xF82, {0x0, 0x0, 0x0}, 0},
+ {0xF83, {0x0, 0x0, 0x0}, 0},
+ {0xF84, {0x0, 0x0, 0x0}, 0},
+ {0xF86, {0x0, 0x0, 0x0}, 0},
+ {0xF87, {0x0, 0x0, 0x0}, 0},
+ {0xF8D, {0x0, 0x0, 0x0}, 0},
+ {0xF8E, {0x0, 0x0, 0x0}, 0},
+ {0xF8F, {0x0, 0x0, 0x0}, 0},
+ {0xF90, {0x0, 0x0, 0x0}, 0},
+ {0xF91, {0x0, 0x0, 0x0}, 0},
+ {0xF92, {0x0, 0x0, 0x0}, 0},
+ {0xF93, {0x0, 0x0, 0x0}, 0},
+ {0xF94, {0x0, 0x0, 0x0}, 0},
+ {0xF95, {0x0, 0x0, 0x0}, 0},
+ {0xF96, {0x0, 0x0, 0x0}, 0},
+ {0xF97, {0x0, 0x0, 0x0}, 0},
+ {0xF99, {0x0, 0x0, 0x0}, 0},
+ {0xF9A, {0x0, 0x0, 0x0}, 0},
+ {0xF9B, {0x0, 0x0, 0x0}, 0},
+ {0xF9C, {0x0, 0x0, 0x0}, 0},
+ {0xF9D, {0x0, 0x0, 0x0}, 0},
+ {0xF9E, {0x0, 0x0, 0x0}, 0},
+ {0xF9F, {0x0, 0x0, 0x0}, 0},
+ {0xFA0, {0x0, 0x0, 0x0}, 0},
+ {0xFA1, {0x0, 0x0, 0x0}, 0},
+ {0xFA2, {0x0, 0x0, 0x0}, 0},
+ {0xFA3, {0x0, 0x0, 0x0}, 0},
+ {0xFA4, {0x0, 0x0, 0x0}, 0},
+ {0xFA5, {0x0, 0x0, 0x0}, 0},
+ {0xFA6, {0x0, 0x0, 0x0}, 0},
+ {0xFA7, {0x0, 0x0, 0x0}, 0},
+ {0xFA8, {0x0, 0x0, 0x0}, 0},
+ {0xFA9, {0x0, 0x0, 0x0}, 0},
+ {0xFAA, {0x0, 0x0, 0x0}, 0},
+ {0xFAB, {0x0, 0x0, 0x0}, 0},
+ {0xFAC, {0x0, 0x0, 0x0}, 0},
+ {0xFAD, {0x0, 0x0, 0x0}, 0},
+ {0xFAE, {0x0, 0x0, 0x0}, 0},
+ {0xFAF, {0x0, 0x0, 0x0}, 0},
+ {0xFB0, {0x0, 0x0, 0x0}, 0},
+ {0xFB1, {0x0, 0x0, 0x0}, 0},
+ {0xFB2, {0x0, 0x0, 0x0}, 0},
+ {0xFB3, {0x0, 0x0, 0x0}, 0},
+ {0xFB4, {0x0, 0x0, 0x0}, 0},
+ {0xFB5, {0x0, 0x0, 0x0}, 0},
+ {0xFB6, {0x0, 0x0, 0x0}, 0},
+ {0xFB7, {0x0, 0x0, 0x0}, 0},
+ {0xFB8, {0x0, 0x0, 0x0}, 0},
+ {0xFB9, {0x0, 0x0, 0x0}, 0},
+ {0xFBA, {0x0, 0x0, 0x0}, 0},
+ {0xFBB, {0x0, 0x0, 0x0}, 0},
+ {0xFBC, {0x0, 0x0, 0x0}, 0},
+ {0xFC6, {0x0, 0x0, 0x0}, 0},
+ {0x1026, {0x1025, 0x0, 0x0}, 1},
+ {0x102D, {0x0, 0x0, 0x0}, 0},
+ {0x102E, {0x0, 0x0, 0x0}, 0},
+ {0x102F, {0x0, 0x0, 0x0}, 0},
+ {0x1030, {0x0, 0x0, 0x0}, 0},
+ {0x1032, {0x0, 0x0, 0x0}, 0},
+ {0x1033, {0x0, 0x0, 0x0}, 0},
+ {0x1034, {0x0, 0x0, 0x0}, 0},
+ {0x1035, {0x0, 0x0, 0x0}, 0},
+ {0x1036, {0x0, 0x0, 0x0}, 0},
+ {0x1037, {0x0, 0x0, 0x0}, 0},
+ {0x1039, {0x0, 0x0, 0x0}, 0},
+ {0x103A, {0x0, 0x0, 0x0}, 0},
+ {0x103D, {0x0, 0x0, 0x0}, 0},
+ {0x103E, {0x0, 0x0, 0x0}, 0},
+ {0x1058, {0x0, 0x0, 0x0}, 0},
+ {0x1059, {0x0, 0x0, 0x0}, 0},
+ {0x105E, {0x0, 0x0, 0x0}, 0},
+ {0x105F, {0x0, 0x0, 0x0}, 0},
+ {0x1060, {0x0, 0x0, 0x0}, 0},
+ {0x1071, {0x0, 0x0, 0x0}, 0},
+ {0x1072, {0x0, 0x0, 0x0}, 0},
+ {0x1073, {0x0, 0x0, 0x0}, 0},
+ {0x1074, {0x0, 0x0, 0x0}, 0},
+ {0x1082, {0x0, 0x0, 0x0}, 0},
+ {0x1085, {0x0, 0x0, 0x0}, 0},
+ {0x1086, {0x0, 0x0, 0x0}, 0},
+ {0x108D, {0x0, 0x0, 0x0}, 0},
+ {0x109D, {0x0, 0x0, 0x0}, 0},
+ {0x10A0, {0x2D00, 0x0, 0x0}, 1},
+ {0x10A1, {0x2D01, 0x0, 0x0}, 1},
+ {0x10A2, {0x2D02, 0x0, 0x0}, 1},
+ {0x10A3, {0x2D03, 0x0, 0x0}, 1},
+ {0x10A4, {0x2D04, 0x0, 0x0}, 1},
+ {0x10A5, {0x2D05, 0x0, 0x0}, 1},
+ {0x10A6, {0x2D06, 0x0, 0x0}, 1},
+ {0x10A7, {0x2D07, 0x0, 0x0}, 1},
+ {0x10A8, {0x2D08, 0x0, 0x0}, 1},
+ {0x10A9, {0x2D09, 0x0, 0x0}, 1},
+ {0x10AA, {0x2D0A, 0x0, 0x0}, 1},
+ {0x10AB, {0x2D0B, 0x0, 0x0}, 1},
+ {0x10AC, {0x2D0C, 0x0, 0x0}, 1},
+ {0x10AD, {0x2D0D, 0x0, 0x0}, 1},
+ {0x10AE, {0x2D0E, 0x0, 0x0}, 1},
+ {0x10AF, {0x2D0F, 0x0, 0x0}, 1},
+ {0x10B0, {0x2D10, 0x0, 0x0}, 1},
+ {0x10B1, {0x2D11, 0x0, 0x0}, 1},
+ {0x10B2, {0x2D12, 0x0, 0x0}, 1},
+ {0x10B3, {0x2D13, 0x0, 0x0}, 1},
+ {0x10B4, {0x2D14, 0x0, 0x0}, 1},
+ {0x10B5, {0x2D15, 0x0, 0x0}, 1},
+ {0x10B6, {0x2D16, 0x0, 0x0}, 1},
+ {0x10B7, {0x2D17, 0x0, 0x0}, 1},
+ {0x10B8, {0x2D18, 0x0, 0x0}, 1},
+ {0x10B9, {0x2D19, 0x0, 0x0}, 1},
+ {0x10BA, {0x2D1A, 0x0, 0x0}, 1},
+ {0x10BB, {0x2D1B, 0x0, 0x0}, 1},
+ {0x10BC, {0x2D1C, 0x0, 0x0}, 1},
+ {0x10BD, {0x2D1D, 0x0, 0x0}, 1},
+ {0x10BE, {0x2D1E, 0x0, 0x0}, 1},
+ {0x10BF, {0x2D1F, 0x0, 0x0}, 1},
+ {0x10C0, {0x2D20, 0x0, 0x0}, 1},
+ {0x10C1, {0x2D21, 0x0, 0x0}, 1},
+ {0x10C2, {0x2D22, 0x0, 0x0}, 1},
+ {0x10C3, {0x2D23, 0x0, 0x0}, 1},
+ {0x10C4, {0x2D24, 0x0, 0x0}, 1},
+ {0x10C5, {0x2D25, 0x0, 0x0}, 1},
+ {0x10C7, {0x2D27, 0x0, 0x0}, 1},
+ {0x10CD, {0x2D2D, 0x0, 0x0}, 1},
+ {0x135D, {0x0, 0x0, 0x0}, 0},
+ {0x135E, {0x0, 0x0, 0x0}, 0},
+ {0x135F, {0x0, 0x0, 0x0}, 0},
+ {0x13A0, {0xAB70, 0x0, 0x0}, 1},
+ {0x13A1, {0xAB71, 0x0, 0x0}, 1},
+ {0x13A2, {0xAB72, 0x0, 0x0}, 1},
+ {0x13A3, {0xAB73, 0x0, 0x0}, 1},
+ {0x13A4, {0xAB74, 0x0, 0x0}, 1},
+ {0x13A5, {0xAB75, 0x0, 0x0}, 1},
+ {0x13A6, {0xAB76, 0x0, 0x0}, 1},
+ {0x13A7, {0xAB77, 0x0, 0x0}, 1},
+ {0x13A8, {0xAB78, 0x0, 0x0}, 1},
+ {0x13A9, {0xAB79, 0x0, 0x0}, 1},
+ {0x13AA, {0xAB7A, 0x0, 0x0}, 1},
+ {0x13AB, {0xAB7B, 0x0, 0x0}, 1},
+ {0x13AC, {0xAB7C, 0x0, 0x0}, 1},
+ {0x13AD, {0xAB7D, 0x0, 0x0}, 1},
+ {0x13AE, {0xAB7E, 0x0, 0x0}, 1},
+ {0x13AF, {0xAB7F, 0x0, 0x0}, 1},
+ {0x13B0, {0xAB80, 0x0, 0x0}, 1},
+ {0x13B1, {0xAB81, 0x0, 0x0}, 1},
+ {0x13B2, {0xAB82, 0x0, 0x0}, 1},
+ {0x13B3, {0xAB83, 0x0, 0x0}, 1},
+ {0x13B4, {0xAB84, 0x0, 0x0}, 1},
+ {0x13B5, {0xAB85, 0x0, 0x0}, 1},
+ {0x13B6, {0xAB86, 0x0, 0x0}, 1},
+ {0x13B7, {0xAB87, 0x0, 0x0}, 1},
+ {0x13B8, {0xAB88, 0x0, 0x0}, 1},
+ {0x13B9, {0xAB89, 0x0, 0x0}, 1},
+ {0x13BA, {0xAB8A, 0x0, 0x0}, 1},
+ {0x13BB, {0xAB8B, 0x0, 0x0}, 1},
+ {0x13BC, {0xAB8C, 0x0, 0x0}, 1},
+ {0x13BD, {0xAB8D, 0x0, 0x0}, 1},
+ {0x13BE, {0xAB8E, 0x0, 0x0}, 1},
+ {0x13BF, {0xAB8F, 0x0, 0x0}, 1},
+ {0x13C0, {0xAB90, 0x0, 0x0}, 1},
+ {0x13C1, {0xAB91, 0x0, 0x0}, 1},
+ {0x13C2, {0xAB92, 0x0, 0x0}, 1},
+ {0x13C3, {0xAB93, 0x0, 0x0}, 1},
+ {0x13C4, {0xAB94, 0x0, 0x0}, 1},
+ {0x13C5, {0xAB95, 0x0, 0x0}, 1},
+ {0x13C6, {0xAB96, 0x0, 0x0}, 1},
+ {0x13C7, {0xAB97, 0x0, 0x0}, 1},
+ {0x13C8, {0xAB98, 0x0, 0x0}, 1},
+ {0x13C9, {0xAB99, 0x0, 0x0}, 1},
+ {0x13CA, {0xAB9A, 0x0, 0x0}, 1},
+ {0x13CB, {0xAB9B, 0x0, 0x0}, 1},
+ {0x13CC, {0xAB9C, 0x0, 0x0}, 1},
+ {0x13CD, {0xAB9D, 0x0, 0x0}, 1},
+ {0x13CE, {0xAB9E, 0x0, 0x0}, 1},
+ {0x13CF, {0xAB9F, 0x0, 0x0}, 1},
+ {0x13D0, {0xABA0, 0x0, 0x0}, 1},
+ {0x13D1, {0xABA1, 0x0, 0x0}, 1},
+ {0x13D2, {0xABA2, 0x0, 0x0}, 1},
+ {0x13D3, {0xABA3, 0x0, 0x0}, 1},
+ {0x13D4, {0xABA4, 0x0, 0x0}, 1},
+ {0x13D5, {0xABA5, 0x0, 0x0}, 1},
+ {0x13D6, {0xABA6, 0x0, 0x0}, 1},
+ {0x13D7, {0xABA7, 0x0, 0x0}, 1},
+ {0x13D8, {0xABA8, 0x0, 0x0}, 1},
+ {0x13D9, {0xABA9, 0x0, 0x0}, 1},
+ {0x13DA, {0xABAA, 0x0, 0x0}, 1},
+ {0x13DB, {0xABAB, 0x0, 0x0}, 1},
+ {0x13DC, {0xABAC, 0x0, 0x0}, 1},
+ {0x13DD, {0xABAD, 0x0, 0x0}, 1},
+ {0x13DE, {0xABAE, 0x0, 0x0}, 1},
+ {0x13DF, {0xABAF, 0x0, 0x0}, 1},
+ {0x13E0, {0xABB0, 0x0, 0x0}, 1},
+ {0x13E1, {0xABB1, 0x0, 0x0}, 1},
+ {0x13E2, {0xABB2, 0x0, 0x0}, 1},
+ {0x13E3, {0xABB3, 0x0, 0x0}, 1},
+ {0x13E4, {0xABB4, 0x0, 0x0}, 1},
+ {0x13E5, {0xABB5, 0x0, 0x0}, 1},
+ {0x13E6, {0xABB6, 0x0, 0x0}, 1},
+ {0x13E7, {0xABB7, 0x0, 0x0}, 1},
+ {0x13E8, {0xABB8, 0x0, 0x0}, 1},
+ {0x13E9, {0xABB9, 0x0, 0x0}, 1},
+ {0x13EA, {0xABBA, 0x0, 0x0}, 1},
+ {0x13EB, {0xABBB, 0x0, 0x0}, 1},
+ {0x13EC, {0xABBC, 0x0, 0x0}, 1},
+ {0x13ED, {0xABBD, 0x0, 0x0}, 1},
+ {0x13EE, {0xABBE, 0x0, 0x0}, 1},
+ {0x13EF, {0xABBF, 0x0, 0x0}, 1},
+ {0x13F0, {0x13F8, 0x0, 0x0}, 1},
+ {0x13F1, {0x13F9, 0x0, 0x0}, 1},
+ {0x13F2, {0x13FA, 0x0, 0x0}, 1},
+ {0x13F3, {0x13FB, 0x0, 0x0}, 1},
+ {0x13F4, {0x13FC, 0x0, 0x0}, 1},
+ {0x13F5, {0x13FD, 0x0, 0x0}, 1},
+ {0x1712, {0x0, 0x0, 0x0}, 0},
+ {0x1713, {0x0, 0x0, 0x0}, 0},
+ {0x1714, {0x0, 0x0, 0x0}, 0},
+ {0x1732, {0x0, 0x0, 0x0}, 0},
+ {0x1733, {0x0, 0x0, 0x0}, 0},
+ {0x1734, {0x0, 0x0, 0x0}, 0},
+ {0x1752, {0x0, 0x0, 0x0}, 0},
+ {0x1753, {0x0, 0x0, 0x0}, 0},
+ {0x1772, {0x0, 0x0, 0x0}, 0},
+ {0x1773, {0x0, 0x0, 0x0}, 0},
+ {0x17B4, {0x0, 0x0, 0x0}, 0},
+ {0x17B5, {0x0, 0x0, 0x0}, 0},
+ {0x17B7, {0x0, 0x0, 0x0}, 0},
+ {0x17B8, {0x0, 0x0, 0x0}, 0},
+ {0x17B9, {0x0, 0x0, 0x0}, 0},
+ {0x17BA, {0x0, 0x0, 0x0}, 0},
+ {0x17BB, {0x0, 0x0, 0x0}, 0},
+ {0x17BC, {0x0, 0x0, 0x0}, 0},
+ {0x17BD, {0x0, 0x0, 0x0}, 0},
+ {0x17C6, {0x0, 0x0, 0x0}, 0},
+ {0x17C9, {0x0, 0x0, 0x0}, 0},
+ {0x17CA, {0x0, 0x0, 0x0}, 0},
+ {0x17CB, {0x0, 0x0, 0x0}, 0},
+ {0x17CC, {0x0, 0x0, 0x0}, 0},
+ {0x17CD, {0x0, 0x0, 0x0}, 0},
+ {0x17CE, {0x0, 0x0, 0x0}, 0},
+ {0x17CF, {0x0, 0x0, 0x0}, 0},
+ {0x17D0, {0x0, 0x0, 0x0}, 0},
+ {0x17D1, {0x0, 0x0, 0x0}, 0},
+ {0x17D2, {0x0, 0x0, 0x0}, 0},
+ {0x17D3, {0x0, 0x0, 0x0}, 0},
+ {0x17DD, {0x0, 0x0, 0x0}, 0},
+ {0x180B, {0x0, 0x0, 0x0}, 0},
+ {0x180C, {0x0, 0x0, 0x0}, 0},
+ {0x180D, {0x0, 0x0, 0x0}, 0},
+ {0x1885, {0x0, 0x0, 0x0}, 0},
+ {0x1886, {0x0, 0x0, 0x0}, 0},
+ {0x18A9, {0x0, 0x0, 0x0}, 0},
+ {0x1920, {0x0, 0x0, 0x0}, 0},
+ {0x1921, {0x0, 0x0, 0x0}, 0},
+ {0x1922, {0x0, 0x0, 0x0}, 0},
+ {0x1927, {0x0, 0x0, 0x0}, 0},
+ {0x1928, {0x0, 0x0, 0x0}, 0},
+ {0x1932, {0x0, 0x0, 0x0}, 0},
+ {0x1939, {0x0, 0x0, 0x0}, 0},
+ {0x193A, {0x0, 0x0, 0x0}, 0},
+ {0x193B, {0x0, 0x0, 0x0}, 0},
+ {0x1A17, {0x0, 0x0, 0x0}, 0},
+ {0x1A18, {0x0, 0x0, 0x0}, 0},
+ {0x1A1B, {0x0, 0x0, 0x0}, 0},
+ {0x1A56, {0x0, 0x0, 0x0}, 0},
+ {0x1A58, {0x0, 0x0, 0x0}, 0},
+ {0x1A59, {0x0, 0x0, 0x0}, 0},
+ {0x1A5A, {0x0, 0x0, 0x0}, 0},
+ {0x1A5B, {0x0, 0x0, 0x0}, 0},
+ {0x1A5C, {0x0, 0x0, 0x0}, 0},
+ {0x1A5D, {0x0, 0x0, 0x0}, 0},
+ {0x1A5E, {0x0, 0x0, 0x0}, 0},
+ {0x1A60, {0x0, 0x0, 0x0}, 0},
+ {0x1A62, {0x0, 0x0, 0x0}, 0},
+ {0x1A65, {0x0, 0x0, 0x0}, 0},
+ {0x1A66, {0x0, 0x0, 0x0}, 0},
+ {0x1A67, {0x0, 0x0, 0x0}, 0},
+ {0x1A68, {0x0, 0x0, 0x0}, 0},
+ {0x1A69, {0x0, 0x0, 0x0}, 0},
+ {0x1A6A, {0x0, 0x0, 0x0}, 0},
+ {0x1A6B, {0x0, 0x0, 0x0}, 0},
+ {0x1A6C, {0x0, 0x0, 0x0}, 0},
+ {0x1A73, {0x0, 0x0, 0x0}, 0},
+ {0x1A74, {0x0, 0x0, 0x0}, 0},
+ {0x1A75, {0x0, 0x0, 0x0}, 0},
+ {0x1A76, {0x0, 0x0, 0x0}, 0},
+ {0x1A77, {0x0, 0x0, 0x0}, 0},
+ {0x1A78, {0x0, 0x0, 0x0}, 0},
+ {0x1A79, {0x0, 0x0, 0x0}, 0},
+ {0x1A7A, {0x0, 0x0, 0x0}, 0},
+ {0x1A7B, {0x0, 0x0, 0x0}, 0},
+ {0x1A7C, {0x0, 0x0, 0x0}, 0},
+ {0x1A7F, {0x0, 0x0, 0x0}, 0},
+ {0x1AB0, {0x0, 0x0, 0x0}, 0},
+ {0x1AB1, {0x0, 0x0, 0x0}, 0},
+ {0x1AB2, {0x0, 0x0, 0x0}, 0},
+ {0x1AB3, {0x0, 0x0, 0x0}, 0},
+ {0x1AB4, {0x0, 0x0, 0x0}, 0},
+ {0x1AB5, {0x0, 0x0, 0x0}, 0},
+ {0x1AB6, {0x0, 0x0, 0x0}, 0},
+ {0x1AB7, {0x0, 0x0, 0x0}, 0},
+ {0x1AB8, {0x0, 0x0, 0x0}, 0},
+ {0x1AB9, {0x0, 0x0, 0x0}, 0},
+ {0x1ABA, {0x0, 0x0, 0x0}, 0},
+ {0x1ABB, {0x0, 0x0, 0x0}, 0},
+ {0x1ABC, {0x0, 0x0, 0x0}, 0},
+ {0x1ABD, {0x0, 0x0, 0x0}, 0},
+ {0x1ABF, {0x0, 0x0, 0x0}, 0},
+ {0x1AC0, {0x0, 0x0, 0x0}, 0},
+ {0x1B00, {0x0, 0x0, 0x0}, 0},
+ {0x1B01, {0x0, 0x0, 0x0}, 0},
+ {0x1B02, {0x0, 0x0, 0x0}, 0},
+ {0x1B03, {0x0, 0x0, 0x0}, 0},
+ {0x1B06, {0x1B05, 0x1B35, 0x0}, 2},
+ {0x1B08, {0x1B07, 0x1B35, 0x0}, 2},
+ {0x1B0A, {0x1B09, 0x1B35, 0x0}, 2},
+ {0x1B0C, {0x1B0B, 0x1B35, 0x0}, 2},
+ {0x1B0E, {0x1B0D, 0x1B35, 0x0}, 2},
+ {0x1B12, {0x1B11, 0x1B35, 0x0}, 2},
+ {0x1B34, {0x0, 0x0, 0x0}, 0},
+ {0x1B36, {0x0, 0x0, 0x0}, 0},
+ {0x1B37, {0x0, 0x0, 0x0}, 0},
+ {0x1B38, {0x0, 0x0, 0x0}, 0},
+ {0x1B39, {0x0, 0x0, 0x0}, 0},
+ {0x1B3A, {0x0, 0x0, 0x0}, 0},
+ {0x1B3B, {0x1B35, 0x0, 0x0}, 1},
+ {0x1B3C, {0x0, 0x0, 0x0}, 0},
+ {0x1B3D, {0x1B35, 0x0, 0x0}, 1},
+ {0x1B40, {0x1B3E, 0x1B35, 0x0}, 2},
+ {0x1B41, {0x1B3F, 0x1B35, 0x0}, 2},
+ {0x1B42, {0x0, 0x0, 0x0}, 0},
+ {0x1B43, {0x1B35, 0x0, 0x0}, 1},
+ {0x1B6B, {0x0, 0x0, 0x0}, 0},
+ {0x1B6C, {0x0, 0x0, 0x0}, 0},
+ {0x1B6D, {0x0, 0x0, 0x0}, 0},
+ {0x1B6E, {0x0, 0x0, 0x0}, 0},
+ {0x1B6F, {0x0, 0x0, 0x0}, 0},
+ {0x1B70, {0x0, 0x0, 0x0}, 0},
+ {0x1B71, {0x0, 0x0, 0x0}, 0},
+ {0x1B72, {0x0, 0x0, 0x0}, 0},
+ {0x1B73, {0x0, 0x0, 0x0}, 0},
+ {0x1B80, {0x0, 0x0, 0x0}, 0},
+ {0x1B81, {0x0, 0x0, 0x0}, 0},
+ {0x1BA2, {0x0, 0x0, 0x0}, 0},
+ {0x1BA3, {0x0, 0x0, 0x0}, 0},
+ {0x1BA4, {0x0, 0x0, 0x0}, 0},
+ {0x1BA5, {0x0, 0x0, 0x0}, 0},
+ {0x1BA8, {0x0, 0x0, 0x0}, 0},
+ {0x1BA9, {0x0, 0x0, 0x0}, 0},
+ {0x1BAB, {0x0, 0x0, 0x0}, 0},
+ {0x1BAC, {0x0, 0x0, 0x0}, 0},
+ {0x1BAD, {0x0, 0x0, 0x0}, 0},
+ {0x1BE6, {0x0, 0x0, 0x0}, 0},
+ {0x1BE8, {0x0, 0x0, 0x0}, 0},
+ {0x1BE9, {0x0, 0x0, 0x0}, 0},
+ {0x1BED, {0x0, 0x0, 0x0}, 0},
+ {0x1BEF, {0x0, 0x0, 0x0}, 0},
+ {0x1BF0, {0x0, 0x0, 0x0}, 0},
+ {0x1BF1, {0x0, 0x0, 0x0}, 0},
+ {0x1C2C, {0x0, 0x0, 0x0}, 0},
+ {0x1C2D, {0x0, 0x0, 0x0}, 0},
+ {0x1C2E, {0x0, 0x0, 0x0}, 0},
+ {0x1C2F, {0x0, 0x0, 0x0}, 0},
+ {0x1C30, {0x0, 0x0, 0x0}, 0},
+ {0x1C31, {0x0, 0x0, 0x0}, 0},
+ {0x1C32, {0x0, 0x0, 0x0}, 0},
+ {0x1C33, {0x0, 0x0, 0x0}, 0},
+ {0x1C36, {0x0, 0x0, 0x0}, 0},
+ {0x1C37, {0x0, 0x0, 0x0}, 0},
+ {0x1C90, {0x10D0, 0x0, 0x0}, 1},
+ {0x1C91, {0x10D1, 0x0, 0x0}, 1},
+ {0x1C92, {0x10D2, 0x0, 0x0}, 1},
+ {0x1C93, {0x10D3, 0x0, 0x0}, 1},
+ {0x1C94, {0x10D4, 0x0, 0x0}, 1},
+ {0x1C95, {0x10D5, 0x0, 0x0}, 1},
+ {0x1C96, {0x10D6, 0x0, 0x0}, 1},
+ {0x1C97, {0x10D7, 0x0, 0x0}, 1},
+ {0x1C98, {0x10D8, 0x0, 0x0}, 1},
+ {0x1C99, {0x10D9, 0x0, 0x0}, 1},
+ {0x1C9A, {0x10DA, 0x0, 0x0}, 1},
+ {0x1C9B, {0x10DB, 0x0, 0x0}, 1},
+ {0x1C9C, {0x10DC, 0x0, 0x0}, 1},
+ {0x1C9D, {0x10DD, 0x0, 0x0}, 1},
+ {0x1C9E, {0x10DE, 0x0, 0x0}, 1},
+ {0x1C9F, {0x10DF, 0x0, 0x0}, 1},
+ {0x1CA0, {0x10E0, 0x0, 0x0}, 1},
+ {0x1CA1, {0x10E1, 0x0, 0x0}, 1},
+ {0x1CA2, {0x10E2, 0x0, 0x0}, 1},
+ {0x1CA3, {0x10E3, 0x0, 0x0}, 1},
+ {0x1CA4, {0x10E4, 0x0, 0x0}, 1},
+ {0x1CA5, {0x10E5, 0x0, 0x0}, 1},
+ {0x1CA6, {0x10E6, 0x0, 0x0}, 1},
+ {0x1CA7, {0x10E7, 0x0, 0x0}, 1},
+ {0x1CA8, {0x10E8, 0x0, 0x0}, 1},
+ {0x1CA9, {0x10E9, 0x0, 0x0}, 1},
+ {0x1CAA, {0x10EA, 0x0, 0x0}, 1},
+ {0x1CAB, {0x10EB, 0x0, 0x0}, 1},
+ {0x1CAC, {0x10EC, 0x0, 0x0}, 1},
+ {0x1CAD, {0x10ED, 0x0, 0x0}, 1},
+ {0x1CAE, {0x10EE, 0x0, 0x0}, 1},
+ {0x1CAF, {0x10EF, 0x0, 0x0}, 1},
+ {0x1CB0, {0x10F0, 0x0, 0x0}, 1},
+ {0x1CB1, {0x10F1, 0x0, 0x0}, 1},
+ {0x1CB2, {0x10F2, 0x0, 0x0}, 1},
+ {0x1CB3, {0x10F3, 0x0, 0x0}, 1},
+ {0x1CB4, {0x10F4, 0x0, 0x0}, 1},
+ {0x1CB5, {0x10F5, 0x0, 0x0}, 1},
+ {0x1CB6, {0x10F6, 0x0, 0x0}, 1},
+ {0x1CB7, {0x10F7, 0x0, 0x0}, 1},
+ {0x1CB8, {0x10F8, 0x0, 0x0}, 1},
+ {0x1CB9, {0x10F9, 0x0, 0x0}, 1},
+ {0x1CBA, {0x10FA, 0x0, 0x0}, 1},
+ {0x1CBD, {0x10FD, 0x0, 0x0}, 1},
+ {0x1CBE, {0x10FE, 0x0, 0x0}, 1},
+ {0x1CBF, {0x10FF, 0x0, 0x0}, 1},
+ {0x1CD0, {0x0, 0x0, 0x0}, 0},
+ {0x1CD1, {0x0, 0x0, 0x0}, 0},
+ {0x1CD2, {0x0, 0x0, 0x0}, 0},
+ {0x1CD4, {0x0, 0x0, 0x0}, 0},
+ {0x1CD5, {0x0, 0x0, 0x0}, 0},
+ {0x1CD6, {0x0, 0x0, 0x0}, 0},
+ {0x1CD7, {0x0, 0x0, 0x0}, 0},
+ {0x1CD8, {0x0, 0x0, 0x0}, 0},
+ {0x1CD9, {0x0, 0x0, 0x0}, 0},
+ {0x1CDA, {0x0, 0x0, 0x0}, 0},
+ {0x1CDB, {0x0, 0x0, 0x0}, 0},
+ {0x1CDC, {0x0, 0x0, 0x0}, 0},
+ {0x1CDD, {0x0, 0x0, 0x0}, 0},
+ {0x1CDE, {0x0, 0x0, 0x0}, 0},
+ {0x1CDF, {0x0, 0x0, 0x0}, 0},
+ {0x1CE0, {0x0, 0x0, 0x0}, 0},
+ {0x1CE2, {0x0, 0x0, 0x0}, 0},
+ {0x1CE3, {0x0, 0x0, 0x0}, 0},
+ {0x1CE4, {0x0, 0x0, 0x0}, 0},
+ {0x1CE5, {0x0, 0x0, 0x0}, 0},
+ {0x1CE6, {0x0, 0x0, 0x0}, 0},
+ {0x1CE7, {0x0, 0x0, 0x0}, 0},
+ {0x1CE8, {0x0, 0x0, 0x0}, 0},
+ {0x1CED, {0x0, 0x0, 0x0}, 0},
+ {0x1CF4, {0x0, 0x0, 0x0}, 0},
+ {0x1CF8, {0x0, 0x0, 0x0}, 0},
+ {0x1CF9, {0x0, 0x0, 0x0}, 0},
+ {0x1DC0, {0x0, 0x0, 0x0}, 0},
+ {0x1DC1, {0x0, 0x0, 0x0}, 0},
+ {0x1DC2, {0x0, 0x0, 0x0}, 0},
+ {0x1DC3, {0x0, 0x0, 0x0}, 0},
+ {0x1DC4, {0x0, 0x0, 0x0}, 0},
+ {0x1DC5, {0x0, 0x0, 0x0}, 0},
+ {0x1DC6, {0x0, 0x0, 0x0}, 0},
+ {0x1DC7, {0x0, 0x0, 0x0}, 0},
+ {0x1DC8, {0x0, 0x0, 0x0}, 0},
+ {0x1DC9, {0x0, 0x0, 0x0}, 0},
+ {0x1DCA, {0x0, 0x0, 0x0}, 0},
+ {0x1DCB, {0x0, 0x0, 0x0}, 0},
+ {0x1DCC, {0x0, 0x0, 0x0}, 0},
+ {0x1DCD, {0x0, 0x0, 0x0}, 0},
+ {0x1DCE, {0x0, 0x0, 0x0}, 0},
+ {0x1DCF, {0x0, 0x0, 0x0}, 0},
+ {0x1DD0, {0x0, 0x0, 0x0}, 0},
+ {0x1DD1, {0x0, 0x0, 0x0}, 0},
+ {0x1DD2, {0x0, 0x0, 0x0}, 0},
+ {0x1DD3, {0x0, 0x0, 0x0}, 0},
+ {0x1DD4, {0x0, 0x0, 0x0}, 0},
+ {0x1DD5, {0x0, 0x0, 0x0}, 0},
+ {0x1DD6, {0x0, 0x0, 0x0}, 0},
+ {0x1DD7, {0x0, 0x0, 0x0}, 0},
+ {0x1DD8, {0x0, 0x0, 0x0}, 0},
+ {0x1DD9, {0x0, 0x0, 0x0}, 0},
+ {0x1DDA, {0x0, 0x0, 0x0}, 0},
+ {0x1DDB, {0x0, 0x0, 0x0}, 0},
+ {0x1DDC, {0x0, 0x0, 0x0}, 0},
+ {0x1DDD, {0x0, 0x0, 0x0}, 0},
+ {0x1DDE, {0x0, 0x0, 0x0}, 0},
+ {0x1DDF, {0x0, 0x0, 0x0}, 0},
+ {0x1DE0, {0x0, 0x0, 0x0}, 0},
+ {0x1DE1, {0x0, 0x0, 0x0}, 0},
+ {0x1DE2, {0x0, 0x0, 0x0}, 0},
+ {0x1DE3, {0x0, 0x0, 0x0}, 0},
+ {0x1DE4, {0x0, 0x0, 0x0}, 0},
+ {0x1DE5, {0x0, 0x0, 0x0}, 0},
+ {0x1DE6, {0x0, 0x0, 0x0}, 0},
+ {0x1DE7, {0x0, 0x0, 0x0}, 0},
+ {0x1DE8, {0x0, 0x0, 0x0}, 0},
+ {0x1DE9, {0x0, 0x0, 0x0}, 0},
+ {0x1DEA, {0x0, 0x0, 0x0}, 0},
+ {0x1DEB, {0x0, 0x0, 0x0}, 0},
+ {0x1DEC, {0x0, 0x0, 0x0}, 0},
+ {0x1DED, {0x0, 0x0, 0x0}, 0},
+ {0x1DEE, {0x0, 0x0, 0x0}, 0},
+ {0x1DEF, {0x0, 0x0, 0x0}, 0},
+ {0x1DF0, {0x0, 0x0, 0x0}, 0},
+ {0x1DF1, {0x0, 0x0, 0x0}, 0},
+ {0x1DF2, {0x0, 0x0, 0x0}, 0},
+ {0x1DF3, {0x0, 0x0, 0x0}, 0},
+ {0x1DF4, {0x0, 0x0, 0x0}, 0},
+ {0x1DF5, {0x0, 0x0, 0x0}, 0},
+ {0x1DF6, {0x0, 0x0, 0x0}, 0},
+ {0x1DF7, {0x0, 0x0, 0x0}, 0},
+ {0x1DF8, {0x0, 0x0, 0x0}, 0},
+ {0x1DF9, {0x0, 0x0, 0x0}, 0},
+ {0x1DFB, {0x0, 0x0, 0x0}, 0},
+ {0x1DFC, {0x0, 0x0, 0x0}, 0},
+ {0x1DFD, {0x0, 0x0, 0x0}, 0},
+ {0x1DFE, {0x0, 0x0, 0x0}, 0},
+ {0x1DFF, {0x0, 0x0, 0x0}, 0},
+ {0x1E00, {0x61, 0x0, 0x0}, 1},
+ {0x1E01, {0x61, 0x0, 0x0}, 1},
+ {0x1E02, {0x62, 0x0, 0x0}, 1},
+ {0x1E03, {0x62, 0x0, 0x0}, 1},
+ {0x1E04, {0x62, 0x0, 0x0}, 1},
+ {0x1E05, {0x62, 0x0, 0x0}, 1},
+ {0x1E06, {0x62, 0x0, 0x0}, 1},
+ {0x1E07, {0x62, 0x0, 0x0}, 1},
+ {0x1E08, {0x63, 0x0, 0x0}, 1},
+ {0x1E09, {0x63, 0x0, 0x0}, 1},
+ {0x1E0A, {0x64, 0x0, 0x0}, 1},
+ {0x1E0B, {0x64, 0x0, 0x0}, 1},
+ {0x1E0C, {0x64, 0x0, 0x0}, 1},
+ {0x1E0D, {0x64, 0x0, 0x0}, 1},
+ {0x1E0E, {0x64, 0x0, 0x0}, 1},
+ {0x1E0F, {0x64, 0x0, 0x0}, 1},
+ {0x1E10, {0x64, 0x0, 0x0}, 1},
+ {0x1E11, {0x64, 0x0, 0x0}, 1},
+ {0x1E12, {0x64, 0x0, 0x0}, 1},
+ {0x1E13, {0x64, 0x0, 0x0}, 1},
+ {0x1E14, {0x65, 0x0, 0x0}, 1},
+ {0x1E15, {0x65, 0x0, 0x0}, 1},
+ {0x1E16, {0x65, 0x0, 0x0}, 1},
+ {0x1E17, {0x65, 0x0, 0x0}, 1},
+ {0x1E18, {0x65, 0x0, 0x0}, 1},
+ {0x1E19, {0x65, 0x0, 0x0}, 1},
+ {0x1E1A, {0x65, 0x0, 0x0}, 1},
+ {0x1E1B, {0x65, 0x0, 0x0}, 1},
+ {0x1E1C, {0x65, 0x0, 0x0}, 1},
+ {0x1E1D, {0x65, 0x0, 0x0}, 1},
+ {0x1E1E, {0x66, 0x0, 0x0}, 1},
+ {0x1E1F, {0x66, 0x0, 0x0}, 1},
+ {0x1E20, {0x67, 0x0, 0x0}, 1},
+ {0x1E21, {0x67, 0x0, 0x0}, 1},
+ {0x1E22, {0x68, 0x0, 0x0}, 1},
+ {0x1E23, {0x68, 0x0, 0x0}, 1},
+ {0x1E24, {0x68, 0x0, 0x0}, 1},
+ {0x1E25, {0x68, 0x0, 0x0}, 1},
+ {0x1E26, {0x68, 0x0, 0x0}, 1},
+ {0x1E27, {0x68, 0x0, 0x0}, 1},
+ {0x1E28, {0x68, 0x0, 0x0}, 1},
+ {0x1E29, {0x68, 0x0, 0x0}, 1},
+ {0x1E2A, {0x68, 0x0, 0x0}, 1},
+ {0x1E2B, {0x68, 0x0, 0x0}, 1},
+ {0x1E2C, {0x69, 0x0, 0x0}, 1},
+ {0x1E2D, {0x69, 0x0, 0x0}, 1},
+ {0x1E2E, {0x69, 0x0, 0x0}, 1},
+ {0x1E2F, {0x69, 0x0, 0x0}, 1},
+ {0x1E30, {0x6B, 0x0, 0x0}, 1},
+ {0x1E31, {0x6B, 0x0, 0x0}, 1},
+ {0x1E32, {0x6B, 0x0, 0x0}, 1},
+ {0x1E33, {0x6B, 0x0, 0x0}, 1},
+ {0x1E34, {0x6B, 0x0, 0x0}, 1},
+ {0x1E35, {0x6B, 0x0, 0x0}, 1},
+ {0x1E36, {0x6C, 0x0, 0x0}, 1},
+ {0x1E37, {0x6C, 0x0, 0x0}, 1},
+ {0x1E38, {0x6C, 0x0, 0x0}, 1},
+ {0x1E39, {0x6C, 0x0, 0x0}, 1},
+ {0x1E3A, {0x6C, 0x0, 0x0}, 1},
+ {0x1E3B, {0x6C, 0x0, 0x0}, 1},
+ {0x1E3C, {0x6C, 0x0, 0x0}, 1},
+ {0x1E3D, {0x6C, 0x0, 0x0}, 1},
+ {0x1E3E, {0x6D, 0x0, 0x0}, 1},
+ {0x1E3F, {0x6D, 0x0, 0x0}, 1},
+ {0x1E40, {0x6D, 0x0, 0x0}, 1},
+ {0x1E41, {0x6D, 0x0, 0x0}, 1},
+ {0x1E42, {0x6D, 0x0, 0x0}, 1},
+ {0x1E43, {0x6D, 0x0, 0x0}, 1},
+ {0x1E44, {0x6E, 0x0, 0x0}, 1},
+ {0x1E45, {0x6E, 0x0, 0x0}, 1},
+ {0x1E46, {0x6E, 0x0, 0x0}, 1},
+ {0x1E47, {0x6E, 0x0, 0x0}, 1},
+ {0x1E48, {0x6E, 0x0, 0x0}, 1},
+ {0x1E49, {0x6E, 0x0, 0x0}, 1},
+ {0x1E4A, {0x6E, 0x0, 0x0}, 1},
+ {0x1E4B, {0x6E, 0x0, 0x0}, 1},
+ {0x1E4C, {0x6F, 0x0, 0x0}, 1},
+ {0x1E4D, {0x6F, 0x0, 0x0}, 1},
+ {0x1E4E, {0x6F, 0x0, 0x0}, 1},
+ {0x1E4F, {0x6F, 0x0, 0x0}, 1},
+ {0x1E50, {0x6F, 0x0, 0x0}, 1},
+ {0x1E51, {0x6F, 0x0, 0x0}, 1},
+ {0x1E52, {0x6F, 0x0, 0x0}, 1},
+ {0x1E53, {0x6F, 0x0, 0x0}, 1},
+ {0x1E54, {0x70, 0x0, 0x0}, 1},
+ {0x1E55, {0x70, 0x0, 0x0}, 1},
+ {0x1E56, {0x70, 0x0, 0x0}, 1},
+ {0x1E57, {0x70, 0x0, 0x0}, 1},
+ {0x1E58, {0x72, 0x0, 0x0}, 1},
+ {0x1E59, {0x72, 0x0, 0x0}, 1},
+ {0x1E5A, {0x72, 0x0, 0x0}, 1},
+ {0x1E5B, {0x72, 0x0, 0x0}, 1},
+ {0x1E5C, {0x72, 0x0, 0x0}, 1},
+ {0x1E5D, {0x72, 0x0, 0x0}, 1},
+ {0x1E5E, {0x72, 0x0, 0x0}, 1},
+ {0x1E5F, {0x72, 0x0, 0x0}, 1},
+ {0x1E60, {0x73, 0x0, 0x0}, 1},
+ {0x1E61, {0x73, 0x0, 0x0}, 1},
+ {0x1E62, {0x73, 0x0, 0x0}, 1},
+ {0x1E63, {0x73, 0x0, 0x0}, 1},
+ {0x1E64, {0x73, 0x0, 0x0}, 1},
+ {0x1E65, {0x73, 0x0, 0x0}, 1},
+ {0x1E66, {0x73, 0x0, 0x0}, 1},
+ {0x1E67, {0x73, 0x0, 0x0}, 1},
+ {0x1E68, {0x73, 0x0, 0x0}, 1},
+ {0x1E69, {0x73, 0x0, 0x0}, 1},
+ {0x1E6A, {0x74, 0x0, 0x0}, 1},
+ {0x1E6B, {0x74, 0x0, 0x0}, 1},
+ {0x1E6C, {0x74, 0x0, 0x0}, 1},
+ {0x1E6D, {0x74, 0x0, 0x0}, 1},
+ {0x1E6E, {0x74, 0x0, 0x0}, 1},
+ {0x1E6F, {0x74, 0x0, 0x0}, 1},
+ {0x1E70, {0x74, 0x0, 0x0}, 1},
+ {0x1E71, {0x74, 0x0, 0x0}, 1},
+ {0x1E72, {0x75, 0x0, 0x0}, 1},
+ {0x1E73, {0x75, 0x0, 0x0}, 1},
+ {0x1E74, {0x75, 0x0, 0x0}, 1},
+ {0x1E75, {0x75, 0x0, 0x0}, 1},
+ {0x1E76, {0x75, 0x0, 0x0}, 1},
+ {0x1E77, {0x75, 0x0, 0x0}, 1},
+ {0x1E78, {0x75, 0x0, 0x0}, 1},
+ {0x1E79, {0x75, 0x0, 0x0}, 1},
+ {0x1E7A, {0x75, 0x0, 0x0}, 1},
+ {0x1E7B, {0x75, 0x0, 0x0}, 1},
+ {0x1E7C, {0x76, 0x0, 0x0}, 1},
+ {0x1E7D, {0x76, 0x0, 0x0}, 1},
+ {0x1E7E, {0x76, 0x0, 0x0}, 1},
+ {0x1E7F, {0x76, 0x0, 0x0}, 1},
+ {0x1E80, {0x77, 0x0, 0x0}, 1},
+ {0x1E81, {0x77, 0x0, 0x0}, 1},
+ {0x1E82, {0x77, 0x0, 0x0}, 1},
+ {0x1E83, {0x77, 0x0, 0x0}, 1},
+ {0x1E84, {0x77, 0x0, 0x0}, 1},
+ {0x1E85, {0x77, 0x0, 0x0}, 1},
+ {0x1E86, {0x77, 0x0, 0x0}, 1},
+ {0x1E87, {0x77, 0x0, 0x0}, 1},
+ {0x1E88, {0x77, 0x0, 0x0}, 1},
+ {0x1E89, {0x77, 0x0, 0x0}, 1},
+ {0x1E8A, {0x78, 0x0, 0x0}, 1},
+ {0x1E8B, {0x78, 0x0, 0x0}, 1},
+ {0x1E8C, {0x78, 0x0, 0x0}, 1},
+ {0x1E8D, {0x78, 0x0, 0x0}, 1},
+ {0x1E8E, {0x79, 0x0, 0x0}, 1},
+ {0x1E8F, {0x79, 0x0, 0x0}, 1},
+ {0x1E90, {0x7A, 0x0, 0x0}, 1},
+ {0x1E91, {0x7A, 0x0, 0x0}, 1},
+ {0x1E92, {0x7A, 0x0, 0x0}, 1},
+ {0x1E93, {0x7A, 0x0, 0x0}, 1},
+ {0x1E94, {0x7A, 0x0, 0x0}, 1},
+ {0x1E95, {0x7A, 0x0, 0x0}, 1},
+ {0x1E96, {0x68, 0x0, 0x0}, 1},
+ {0x1E97, {0x74, 0x0, 0x0}, 1},
+ {0x1E98, {0x77, 0x0, 0x0}, 1},
+ {0x1E99, {0x79, 0x0, 0x0}, 1},
+ {0x1E9B, {0x17F, 0x0, 0x0}, 1},
+ {0x1E9E, {0xDF, 0x0, 0x0}, 1},
+ {0x1EA0, {0x61, 0x0, 0x0}, 1},
+ {0x1EA1, {0x61, 0x0, 0x0}, 1},
+ {0x1EA2, {0x61, 0x0, 0x0}, 1},
+ {0x1EA3, {0x61, 0x0, 0x0}, 1},
+ {0x1EA4, {0x61, 0x0, 0x0}, 1},
+ {0x1EA5, {0x61, 0x0, 0x0}, 1},
+ {0x1EA6, {0x61, 0x0, 0x0}, 1},
+ {0x1EA7, {0x61, 0x0, 0x0}, 1},
+ {0x1EA8, {0x61, 0x0, 0x0}, 1},
+ {0x1EA9, {0x61, 0x0, 0x0}, 1},
+ {0x1EAA, {0x61, 0x0, 0x0}, 1},
+ {0x1EAB, {0x61, 0x0, 0x0}, 1},
+ {0x1EAC, {0x61, 0x0, 0x0}, 1},
+ {0x1EAD, {0x61, 0x0, 0x0}, 1},
+ {0x1EAE, {0x61, 0x0, 0x0}, 1},
+ {0x1EAF, {0x61, 0x0, 0x0}, 1},
+ {0x1EB0, {0x61, 0x0, 0x0}, 1},
+ {0x1EB1, {0x61, 0x0, 0x0}, 1},
+ {0x1EB2, {0x61, 0x0, 0x0}, 1},
+ {0x1EB3, {0x61, 0x0, 0x0}, 1},
+ {0x1EB4, {0x61, 0x0, 0x0}, 1},
+ {0x1EB5, {0x61, 0x0, 0x0}, 1},
+ {0x1EB6, {0x61, 0x0, 0x0}, 1},
+ {0x1EB7, {0x61, 0x0, 0x0}, 1},
+ {0x1EB8, {0x65, 0x0, 0x0}, 1},
+ {0x1EB9, {0x65, 0x0, 0x0}, 1},
+ {0x1EBA, {0x65, 0x0, 0x0}, 1},
+ {0x1EBB, {0x65, 0x0, 0x0}, 1},
+ {0x1EBC, {0x65, 0x0, 0x0}, 1},
+ {0x1EBD, {0x65, 0x0, 0x0}, 1},
+ {0x1EBE, {0x65, 0x0, 0x0}, 1},
+ {0x1EBF, {0x65, 0x0, 0x0}, 1},
+ {0x1EC0, {0x65, 0x0, 0x0}, 1},
+ {0x1EC1, {0x65, 0x0, 0x0}, 1},
+ {0x1EC2, {0x65, 0x0, 0x0}, 1},
+ {0x1EC3, {0x65, 0x0, 0x0}, 1},
+ {0x1EC4, {0x65, 0x0, 0x0}, 1},
+ {0x1EC5, {0x65, 0x0, 0x0}, 1},
+ {0x1EC6, {0x65, 0x0, 0x0}, 1},
+ {0x1EC7, {0x65, 0x0, 0x0}, 1},
+ {0x1EC8, {0x69, 0x0, 0x0}, 1},
+ {0x1EC9, {0x69, 0x0, 0x0}, 1},
+ {0x1ECA, {0x69, 0x0, 0x0}, 1},
+ {0x1ECB, {0x69, 0x0, 0x0}, 1},
+ {0x1ECC, {0x6F, 0x0, 0x0}, 1},
+ {0x1ECD, {0x6F, 0x0, 0x0}, 1},
+ {0x1ECE, {0x6F, 0x0, 0x0}, 1},
+ {0x1ECF, {0x6F, 0x0, 0x0}, 1},
+ {0x1ED0, {0x6F, 0x0, 0x0}, 1},
+ {0x1ED1, {0x6F, 0x0, 0x0}, 1},
+ {0x1ED2, {0x6F, 0x0, 0x0}, 1},
+ {0x1ED3, {0x6F, 0x0, 0x0}, 1},
+ {0x1ED4, {0x6F, 0x0, 0x0}, 1},
+ {0x1ED5, {0x6F, 0x0, 0x0}, 1},
+ {0x1ED6, {0x6F, 0x0, 0x0}, 1},
+ {0x1ED7, {0x6F, 0x0, 0x0}, 1},
+ {0x1ED8, {0x6F, 0x0, 0x0}, 1},
+ {0x1ED9, {0x6F, 0x0, 0x0}, 1},
+ {0x1EDA, {0x6F, 0x0, 0x0}, 1},
+ {0x1EDB, {0x6F, 0x0, 0x0}, 1},
+ {0x1EDC, {0x6F, 0x0, 0x0}, 1},
+ {0x1EDD, {0x6F, 0x0, 0x0}, 1},
+ {0x1EDE, {0x6F, 0x0, 0x0}, 1},
+ {0x1EDF, {0x6F, 0x0, 0x0}, 1},
+ {0x1EE0, {0x6F, 0x0, 0x0}, 1},
+ {0x1EE1, {0x6F, 0x0, 0x0}, 1},
+ {0x1EE2, {0x6F, 0x0, 0x0}, 1},
+ {0x1EE3, {0x6F, 0x0, 0x0}, 1},
+ {0x1EE4, {0x75, 0x0, 0x0}, 1},
+ {0x1EE5, {0x75, 0x0, 0x0}, 1},
+ {0x1EE6, {0x75, 0x0, 0x0}, 1},
+ {0x1EE7, {0x75, 0x0, 0x0}, 1},
+ {0x1EE8, {0x75, 0x0, 0x0}, 1},
+ {0x1EE9, {0x75, 0x0, 0x0}, 1},
+ {0x1EEA, {0x75, 0x0, 0x0}, 1},
+ {0x1EEB, {0x75, 0x0, 0x0}, 1},
+ {0x1EEC, {0x75, 0x0, 0x0}, 1},
+ {0x1EED, {0x75, 0x0, 0x0}, 1},
+ {0x1EEE, {0x75, 0x0, 0x0}, 1},
+ {0x1EEF, {0x75, 0x0, 0x0}, 1},
+ {0x1EF0, {0x75, 0x0, 0x0}, 1},
+ {0x1EF1, {0x75, 0x0, 0x0}, 1},
+ {0x1EF2, {0x79, 0x0, 0x0}, 1},
+ {0x1EF3, {0x79, 0x0, 0x0}, 1},
+ {0x1EF4, {0x79, 0x0, 0x0}, 1},
+ {0x1EF5, {0x79, 0x0, 0x0}, 1},
+ {0x1EF6, {0x79, 0x0, 0x0}, 1},
+ {0x1EF7, {0x79, 0x0, 0x0}, 1},
+ {0x1EF8, {0x79, 0x0, 0x0}, 1},
+ {0x1EF9, {0x79, 0x0, 0x0}, 1},
+ {0x1EFA, {0x1EFB, 0x0, 0x0}, 1},
+ {0x1EFC, {0x1EFD, 0x0, 0x0}, 1},
+ {0x1EFE, {0x1EFF, 0x0, 0x0}, 1},
+ {0x1F00, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F01, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F02, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F03, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F04, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F05, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F06, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F07, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F08, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F09, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F0A, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F0B, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F0C, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F0D, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F0E, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F0F, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F10, {0x3B5, 0x0, 0x0}, 1},
+ {0x1F11, {0x3B5, 0x0, 0x0}, 1},
+ {0x1F12, {0x3B5, 0x0, 0x0}, 1},
+ {0x1F13, {0x3B5, 0x0, 0x0}, 1},
+ {0x1F14, {0x3B5, 0x0, 0x0}, 1},
+ {0x1F15, {0x3B5, 0x0, 0x0}, 1},
+ {0x1F18, {0x3B5, 0x0, 0x0}, 1},
+ {0x1F19, {0x3B5, 0x0, 0x0}, 1},
+ {0x1F1A, {0x3B5, 0x0, 0x0}, 1},
+ {0x1F1B, {0x3B5, 0x0, 0x0}, 1},
+ {0x1F1C, {0x3B5, 0x0, 0x0}, 1},
+ {0x1F1D, {0x3B5, 0x0, 0x0}, 1},
+ {0x1F20, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F21, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F22, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F23, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F24, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F25, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F26, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F27, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F28, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F29, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F2A, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F2B, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F2C, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F2D, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F2E, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F2F, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F30, {0x3B9, 0x0, 0x0}, 1},
+ {0x1F31, {0x3B9, 0x0, 0x0}, 1},
+ {0x1F32, {0x3B9, 0x0, 0x0}, 1},
+ {0x1F33, {0x3B9, 0x0, 0x0}, 1},
+ {0x1F34, {0x3B9, 0x0, 0x0}, 1},
+ {0x1F35, {0x3B9, 0x0, 0x0}, 1},
+ {0x1F36, {0x3B9, 0x0, 0x0}, 1},
+ {0x1F37, {0x3B9, 0x0, 0x0}, 1},
+ {0x1F38, {0x3B9, 0x0, 0x0}, 1},
+ {0x1F39, {0x3B9, 0x0, 0x0}, 1},
+ {0x1F3A, {0x3B9, 0x0, 0x0}, 1},
+ {0x1F3B, {0x3B9, 0x0, 0x0}, 1},
+ {0x1F3C, {0x3B9, 0x0, 0x0}, 1},
+ {0x1F3D, {0x3B9, 0x0, 0x0}, 1},
+ {0x1F3E, {0x3B9, 0x0, 0x0}, 1},
+ {0x1F3F, {0x3B9, 0x0, 0x0}, 1},
+ {0x1F40, {0x3BF, 0x0, 0x0}, 1},
+ {0x1F41, {0x3BF, 0x0, 0x0}, 1},
+ {0x1F42, {0x3BF, 0x0, 0x0}, 1},
+ {0x1F43, {0x3BF, 0x0, 0x0}, 1},
+ {0x1F44, {0x3BF, 0x0, 0x0}, 1},
+ {0x1F45, {0x3BF, 0x0, 0x0}, 1},
+ {0x1F48, {0x3BF, 0x0, 0x0}, 1},
+ {0x1F49, {0x3BF, 0x0, 0x0}, 1},
+ {0x1F4A, {0x3BF, 0x0, 0x0}, 1},
+ {0x1F4B, {0x3BF, 0x0, 0x0}, 1},
+ {0x1F4C, {0x3BF, 0x0, 0x0}, 1},
+ {0x1F4D, {0x3BF, 0x0, 0x0}, 1},
+ {0x1F50, {0x3C5, 0x0, 0x0}, 1},
+ {0x1F51, {0x3C5, 0x0, 0x0}, 1},
+ {0x1F52, {0x3C5, 0x0, 0x0}, 1},
+ {0x1F53, {0x3C5, 0x0, 0x0}, 1},
+ {0x1F54, {0x3C5, 0x0, 0x0}, 1},
+ {0x1F55, {0x3C5, 0x0, 0x0}, 1},
+ {0x1F56, {0x3C5, 0x0, 0x0}, 1},
+ {0x1F57, {0x3C5, 0x0, 0x0}, 1},
+ {0x1F59, {0x3C5, 0x0, 0x0}, 1},
+ {0x1F5B, {0x3C5, 0x0, 0x0}, 1},
+ {0x1F5D, {0x3C5, 0x0, 0x0}, 1},
+ {0x1F5F, {0x3C5, 0x0, 0x0}, 1},
+ {0x1F60, {0x3C9, 0x0, 0x0}, 1},
+ {0x1F61, {0x3C9, 0x0, 0x0}, 1},
+ {0x1F62, {0x3C9, 0x0, 0x0}, 1},
+ {0x1F63, {0x3C9, 0x0, 0x0}, 1},
+ {0x1F64, {0x3C9, 0x0, 0x0}, 1},
+ {0x1F65, {0x3C9, 0x0, 0x0}, 1},
+ {0x1F66, {0x3C9, 0x0, 0x0}, 1},
+ {0x1F67, {0x3C9, 0x0, 0x0}, 1},
+ {0x1F68, {0x3C9, 0x0, 0x0}, 1},
+ {0x1F69, {0x3C9, 0x0, 0x0}, 1},
+ {0x1F6A, {0x3C9, 0x0, 0x0}, 1},
+ {0x1F6B, {0x3C9, 0x0, 0x0}, 1},
+ {0x1F6C, {0x3C9, 0x0, 0x0}, 1},
+ {0x1F6D, {0x3C9, 0x0, 0x0}, 1},
+ {0x1F6E, {0x3C9, 0x0, 0x0}, 1},
+ {0x1F6F, {0x3C9, 0x0, 0x0}, 1},
+ {0x1F70, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F71, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F72, {0x3B5, 0x0, 0x0}, 1},
+ {0x1F73, {0x3B5, 0x0, 0x0}, 1},
+ {0x1F74, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F75, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F76, {0x3B9, 0x0, 0x0}, 1},
+ {0x1F77, {0x3B9, 0x0, 0x0}, 1},
+ {0x1F78, {0x3BF, 0x0, 0x0}, 1},
+ {0x1F79, {0x3BF, 0x0, 0x0}, 1},
+ {0x1F7A, {0x3C5, 0x0, 0x0}, 1},
+ {0x1F7B, {0x3C5, 0x0, 0x0}, 1},
+ {0x1F7C, {0x3C9, 0x0, 0x0}, 1},
+ {0x1F7D, {0x3C9, 0x0, 0x0}, 1},
+ {0x1F80, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F81, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F82, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F83, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F84, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F85, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F86, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F87, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F88, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F89, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F8A, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F8B, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F8C, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F8D, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F8E, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F8F, {0x3B1, 0x0, 0x0}, 1},
+ {0x1F90, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F91, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F92, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F93, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F94, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F95, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F96, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F97, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F98, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F99, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F9A, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F9B, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F9C, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F9D, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F9E, {0x3B7, 0x0, 0x0}, 1},
+ {0x1F9F, {0x3B7, 0x0, 0x0}, 1},
+ {0x1FA0, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FA1, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FA2, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FA3, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FA4, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FA5, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FA6, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FA7, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FA8, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FA9, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FAA, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FAB, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FAC, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FAD, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FAE, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FAF, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FB0, {0x3B1, 0x0, 0x0}, 1},
+ {0x1FB1, {0x3B1, 0x0, 0x0}, 1},
+ {0x1FB2, {0x3B1, 0x0, 0x0}, 1},
+ {0x1FB3, {0x3B1, 0x0, 0x0}, 1},
+ {0x1FB4, {0x3B1, 0x0, 0x0}, 1},
+ {0x1FB6, {0x3B1, 0x0, 0x0}, 1},
+ {0x1FB7, {0x3B1, 0x0, 0x0}, 1},
+ {0x1FB8, {0x3B1, 0x0, 0x0}, 1},
+ {0x1FB9, {0x3B1, 0x0, 0x0}, 1},
+ {0x1FBA, {0x3B1, 0x0, 0x0}, 1},
+ {0x1FBB, {0x3B1, 0x0, 0x0}, 1},
+ {0x1FBC, {0x3B1, 0x0, 0x0}, 1},
+ {0x1FBE, {0x3B9, 0x0, 0x0}, 1},
+ {0x1FC1, {0xA8, 0x0, 0x0}, 1},
+ {0x1FC2, {0x3B7, 0x0, 0x0}, 1},
+ {0x1FC3, {0x3B7, 0x0, 0x0}, 1},
+ {0x1FC4, {0x3B7, 0x0, 0x0}, 1},
+ {0x1FC6, {0x3B7, 0x0, 0x0}, 1},
+ {0x1FC7, {0x3B7, 0x0, 0x0}, 1},
+ {0x1FC8, {0x3B5, 0x0, 0x0}, 1},
+ {0x1FC9, {0x3B5, 0x0, 0x0}, 1},
+ {0x1FCA, {0x3B7, 0x0, 0x0}, 1},
+ {0x1FCB, {0x3B7, 0x0, 0x0}, 1},
+ {0x1FCC, {0x3B7, 0x0, 0x0}, 1},
+ {0x1FCD, {0x1FBF, 0x0, 0x0}, 1},
+ {0x1FCE, {0x1FBF, 0x0, 0x0}, 1},
+ {0x1FCF, {0x1FBF, 0x0, 0x0}, 1},
+ {0x1FD0, {0x3B9, 0x0, 0x0}, 1},
+ {0x1FD1, {0x3B9, 0x0, 0x0}, 1},
+ {0x1FD2, {0x3B9, 0x0, 0x0}, 1},
+ {0x1FD3, {0x3B9, 0x0, 0x0}, 1},
+ {0x1FD6, {0x3B9, 0x0, 0x0}, 1},
+ {0x1FD7, {0x3B9, 0x0, 0x0}, 1},
+ {0x1FD8, {0x3B9, 0x0, 0x0}, 1},
+ {0x1FD9, {0x3B9, 0x0, 0x0}, 1},
+ {0x1FDA, {0x3B9, 0x0, 0x0}, 1},
+ {0x1FDB, {0x3B9, 0x0, 0x0}, 1},
+ {0x1FDD, {0x1FFE, 0x0, 0x0}, 1},
+ {0x1FDE, {0x1FFE, 0x0, 0x0}, 1},
+ {0x1FDF, {0x1FFE, 0x0, 0x0}, 1},
+ {0x1FE0, {0x3C5, 0x0, 0x0}, 1},
+ {0x1FE1, {0x3C5, 0x0, 0x0}, 1},
+ {0x1FE2, {0x3C5, 0x0, 0x0}, 1},
+ {0x1FE3, {0x3C5, 0x0, 0x0}, 1},
+ {0x1FE4, {0x3C1, 0x0, 0x0}, 1},
+ {0x1FE5, {0x3C1, 0x0, 0x0}, 1},
+ {0x1FE6, {0x3C5, 0x0, 0x0}, 1},
+ {0x1FE7, {0x3C5, 0x0, 0x0}, 1},
+ {0x1FE8, {0x3C5, 0x0, 0x0}, 1},
+ {0x1FE9, {0x3C5, 0x0, 0x0}, 1},
+ {0x1FEA, {0x3C5, 0x0, 0x0}, 1},
+ {0x1FEB, {0x3C5, 0x0, 0x0}, 1},
+ {0x1FEC, {0x3C1, 0x0, 0x0}, 1},
+ {0x1FED, {0xA8, 0x0, 0x0}, 1},
+ {0x1FEE, {0xA8, 0x0, 0x0}, 1},
+ {0x1FEF, {0x60, 0x0, 0x0}, 1},
+ {0x1FF2, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FF3, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FF4, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FF6, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FF7, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FF8, {0x3BF, 0x0, 0x0}, 1},
+ {0x1FF9, {0x3BF, 0x0, 0x0}, 1},
+ {0x1FFA, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FFB, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FFC, {0x3C9, 0x0, 0x0}, 1},
+ {0x1FFD, {0xB4, 0x0, 0x0}, 1},
+ {0x2000, {0x2002, 0x0, 0x0}, 1},
+ {0x2001, {0x2003, 0x0, 0x0}, 1},
+ {0x20D0, {0x0, 0x0, 0x0}, 0},
+ {0x20D1, {0x0, 0x0, 0x0}, 0},
+ {0x20D2, {0x0, 0x0, 0x0}, 0},
+ {0x20D3, {0x0, 0x0, 0x0}, 0},
+ {0x20D4, {0x0, 0x0, 0x0}, 0},
+ {0x20D5, {0x0, 0x0, 0x0}, 0},
+ {0x20D6, {0x0, 0x0, 0x0}, 0},
+ {0x20D7, {0x0, 0x0, 0x0}, 0},
+ {0x20D8, {0x0, 0x0, 0x0}, 0},
+ {0x20D9, {0x0, 0x0, 0x0}, 0},
+ {0x20DA, {0x0, 0x0, 0x0}, 0},
+ {0x20DB, {0x0, 0x0, 0x0}, 0},
+ {0x20DC, {0x0, 0x0, 0x0}, 0},
+ {0x20E1, {0x0, 0x0, 0x0}, 0},
+ {0x20E5, {0x0, 0x0, 0x0}, 0},
+ {0x20E6, {0x0, 0x0, 0x0}, 0},
+ {0x20E7, {0x0, 0x0, 0x0}, 0},
+ {0x20E8, {0x0, 0x0, 0x0}, 0},
+ {0x20E9, {0x0, 0x0, 0x0}, 0},
+ {0x20EA, {0x0, 0x0, 0x0}, 0},
+ {0x20EB, {0x0, 0x0, 0x0}, 0},
+ {0x20EC, {0x0, 0x0, 0x0}, 0},
+ {0x20ED, {0x0, 0x0, 0x0}, 0},
+ {0x20EE, {0x0, 0x0, 0x0}, 0},
+ {0x20EF, {0x0, 0x0, 0x0}, 0},
+ {0x20F0, {0x0, 0x0, 0x0}, 0},
+ {0x2126, {0x3C9, 0x0, 0x0}, 1},
+ {0x212A, {0x6B, 0x0, 0x0}, 1},
+ {0x212B, {0x61, 0x0, 0x0}, 1},
+ {0x2132, {0x214E, 0x0, 0x0}, 1},
+ {0x2160, {0x2170, 0x0, 0x0}, 1},
+ {0x2161, {0x2171, 0x0, 0x0}, 1},
+ {0x2162, {0x2172, 0x0, 0x0}, 1},
+ {0x2163, {0x2173, 0x0, 0x0}, 1},
+ {0x2164, {0x2174, 0x0, 0x0}, 1},
+ {0x2165, {0x2175, 0x0, 0x0}, 1},
+ {0x2166, {0x2176, 0x0, 0x0}, 1},
+ {0x2167, {0x2177, 0x0, 0x0}, 1},
+ {0x2168, {0x2178, 0x0, 0x0}, 1},
+ {0x2169, {0x2179, 0x0, 0x0}, 1},
+ {0x216A, {0x217A, 0x0, 0x0}, 1},
+ {0x216B, {0x217B, 0x0, 0x0}, 1},
+ {0x216C, {0x217C, 0x0, 0x0}, 1},
+ {0x216D, {0x217D, 0x0, 0x0}, 1},
+ {0x216E, {0x217E, 0x0, 0x0}, 1},
+ {0x216F, {0x217F, 0x0, 0x0}, 1},
+ {0x2183, {0x2184, 0x0, 0x0}, 1},
+ {0x219A, {0x2190, 0x0, 0x0}, 1},
+ {0x219B, {0x2192, 0x0, 0x0}, 1},
+ {0x21AE, {0x2194, 0x0, 0x0}, 1},
+ {0x21CD, {0x21D0, 0x0, 0x0}, 1},
+ {0x21CE, {0x21D4, 0x0, 0x0}, 1},
+ {0x21CF, {0x21D2, 0x0, 0x0}, 1},
+ {0x2204, {0x2203, 0x0, 0x0}, 1},
+ {0x2209, {0x2208, 0x0, 0x0}, 1},
+ {0x220C, {0x220B, 0x0, 0x0}, 1},
+ {0x2224, {0x2223, 0x0, 0x0}, 1},
+ {0x2226, {0x2225, 0x0, 0x0}, 1},
+ {0x2241, {0x223C, 0x0, 0x0}, 1},
+ {0x2244, {0x2243, 0x0, 0x0}, 1},
+ {0x2247, {0x2245, 0x0, 0x0}, 1},
+ {0x2249, {0x2248, 0x0, 0x0}, 1},
+ {0x2260, {0x3D, 0x0, 0x0}, 1},
+ {0x2262, {0x2261, 0x0, 0x0}, 1},
+ {0x226D, {0x224D, 0x0, 0x0}, 1},
+ {0x226E, {0x3C, 0x0, 0x0}, 1},
+ {0x226F, {0x3E, 0x0, 0x0}, 1},
+ {0x2270, {0x2264, 0x0, 0x0}, 1},
+ {0x2271, {0x2265, 0x0, 0x0}, 1},
+ {0x2274, {0x2272, 0x0, 0x0}, 1},
+ {0x2275, {0x2273, 0x0, 0x0}, 1},
+ {0x2278, {0x2276, 0x0, 0x0}, 1},
+ {0x2279, {0x2277, 0x0, 0x0}, 1},
+ {0x2280, {0x227A, 0x0, 0x0}, 1},
+ {0x2281, {0x227B, 0x0, 0x0}, 1},
+ {0x2284, {0x2282, 0x0, 0x0}, 1},
+ {0x2285, {0x2283, 0x0, 0x0}, 1},
+ {0x2288, {0x2286, 0x0, 0x0}, 1},
+ {0x2289, {0x2287, 0x0, 0x0}, 1},
+ {0x22AC, {0x22A2, 0x0, 0x0}, 1},
+ {0x22AD, {0x22A8, 0x0, 0x0}, 1},
+ {0x22AE, {0x22A9, 0x0, 0x0}, 1},
+ {0x22AF, {0x22AB, 0x0, 0x0}, 1},
+ {0x22E0, {0x227C, 0x0, 0x0}, 1},
+ {0x22E1, {0x227D, 0x0, 0x0}, 1},
+ {0x22E2, {0x2291, 0x0, 0x0}, 1},
+ {0x22E3, {0x2292, 0x0, 0x0}, 1},
+ {0x22EA, {0x22B2, 0x0, 0x0}, 1},
+ {0x22EB, {0x22B3, 0x0, 0x0}, 1},
+ {0x22EC, {0x22B4, 0x0, 0x0}, 1},
+ {0x22ED, {0x22B5, 0x0, 0x0}, 1},
+ {0x2329, {0x3008, 0x0, 0x0}, 1},
+ {0x232A, {0x3009, 0x0, 0x0}, 1},
+ {0x24B6, {0x24D0, 0x0, 0x0}, 1},
+ {0x24B7, {0x24D1, 0x0, 0x0}, 1},
+ {0x24B8, {0x24D2, 0x0, 0x0}, 1},
+ {0x24B9, {0x24D3, 0x0, 0x0}, 1},
+ {0x24BA, {0x24D4, 0x0, 0x0}, 1},
+ {0x24BB, {0x24D5, 0x0, 0x0}, 1},
+ {0x24BC, {0x24D6, 0x0, 0x0}, 1},
+ {0x24BD, {0x24D7, 0x0, 0x0}, 1},
+ {0x24BE, {0x24D8, 0x0, 0x0}, 1},
+ {0x24BF, {0x24D9, 0x0, 0x0}, 1},
+ {0x24C0, {0x24DA, 0x0, 0x0}, 1},
+ {0x24C1, {0x24DB, 0x0, 0x0}, 1},
+ {0x24C2, {0x24DC, 0x0, 0x0}, 1},
+ {0x24C3, {0x24DD, 0x0, 0x0}, 1},
+ {0x24C4, {0x24DE, 0x0, 0x0}, 1},
+ {0x24C5, {0x24DF, 0x0, 0x0}, 1},
+ {0x24C6, {0x24E0, 0x0, 0x0}, 1},
+ {0x24C7, {0x24E1, 0x0, 0x0}, 1},
+ {0x24C8, {0x24E2, 0x0, 0x0}, 1},
+ {0x24C9, {0x24E3, 0x0, 0x0}, 1},
+ {0x24CA, {0x24E4, 0x0, 0x0}, 1},
+ {0x24CB, {0x24E5, 0x0, 0x0}, 1},
+ {0x24CC, {0x24E6, 0x0, 0x0}, 1},
+ {0x24CD, {0x24E7, 0x0, 0x0}, 1},
+ {0x24CE, {0x24E8, 0x0, 0x0}, 1},
+ {0x24CF, {0x24E9, 0x0, 0x0}, 1},
+ {0x2ADC, {0x2ADD, 0x0, 0x0}, 1},
+ {0x2C00, {0x2C30, 0x0, 0x0}, 1},
+ {0x2C01, {0x2C31, 0x0, 0x0}, 1},
+ {0x2C02, {0x2C32, 0x0, 0x0}, 1},
+ {0x2C03, {0x2C33, 0x0, 0x0}, 1},
+ {0x2C04, {0x2C34, 0x0, 0x0}, 1},
+ {0x2C05, {0x2C35, 0x0, 0x0}, 1},
+ {0x2C06, {0x2C36, 0x0, 0x0}, 1},
+ {0x2C07, {0x2C37, 0x0, 0x0}, 1},
+ {0x2C08, {0x2C38, 0x0, 0x0}, 1},
+ {0x2C09, {0x2C39, 0x0, 0x0}, 1},
+ {0x2C0A, {0x2C3A, 0x0, 0x0}, 1},
+ {0x2C0B, {0x2C3B, 0x0, 0x0}, 1},
+ {0x2C0C, {0x2C3C, 0x0, 0x0}, 1},
+ {0x2C0D, {0x2C3D, 0x0, 0x0}, 1},
+ {0x2C0E, {0x2C3E, 0x0, 0x0}, 1},
+ {0x2C0F, {0x2C3F, 0x0, 0x0}, 1},
+ {0x2C10, {0x2C40, 0x0, 0x0}, 1},
+ {0x2C11, {0x2C41, 0x0, 0x0}, 1},
+ {0x2C12, {0x2C42, 0x0, 0x0}, 1},
+ {0x2C13, {0x2C43, 0x0, 0x0}, 1},
+ {0x2C14, {0x2C44, 0x0, 0x0}, 1},
+ {0x2C15, {0x2C45, 0x0, 0x0}, 1},
+ {0x2C16, {0x2C46, 0x0, 0x0}, 1},
+ {0x2C17, {0x2C47, 0x0, 0x0}, 1},
+ {0x2C18, {0x2C48, 0x0, 0x0}, 1},
+ {0x2C19, {0x2C49, 0x0, 0x0}, 1},
+ {0x2C1A, {0x2C4A, 0x0, 0x0}, 1},
+ {0x2C1B, {0x2C4B, 0x0, 0x0}, 1},
+ {0x2C1C, {0x2C4C, 0x0, 0x0}, 1},
+ {0x2C1D, {0x2C4D, 0x0, 0x0}, 1},
+ {0x2C1E, {0x2C4E, 0x0, 0x0}, 1},
+ {0x2C1F, {0x2C4F, 0x0, 0x0}, 1},
+ {0x2C20, {0x2C50, 0x0, 0x0}, 1},
+ {0x2C21, {0x2C51, 0x0, 0x0}, 1},
+ {0x2C22, {0x2C52, 0x0, 0x0}, 1},
+ {0x2C23, {0x2C53, 0x0, 0x0}, 1},
+ {0x2C24, {0x2C54, 0x0, 0x0}, 1},
+ {0x2C25, {0x2C55, 0x0, 0x0}, 1},
+ {0x2C26, {0x2C56, 0x0, 0x0}, 1},
+ {0x2C27, {0x2C57, 0x0, 0x0}, 1},
+ {0x2C28, {0x2C58, 0x0, 0x0}, 1},
+ {0x2C29, {0x2C59, 0x0, 0x0}, 1},
+ {0x2C2A, {0x2C5A, 0x0, 0x0}, 1},
+ {0x2C2B, {0x2C5B, 0x0, 0x0}, 1},
+ {0x2C2C, {0x2C5C, 0x0, 0x0}, 1},
+ {0x2C2D, {0x2C5D, 0x0, 0x0}, 1},
+ {0x2C2E, {0x2C5E, 0x0, 0x0}, 1},
+ {0x2C60, {0x2C61, 0x0, 0x0}, 1},
+ {0x2C62, {0x26B, 0x0, 0x0}, 1},
+ {0x2C63, {0x1D7D, 0x0, 0x0}, 1},
+ {0x2C64, {0x27D, 0x0, 0x0}, 1},
+ {0x2C67, {0x2C68, 0x0, 0x0}, 1},
+ {0x2C69, {0x2C6A, 0x0, 0x0}, 1},
+ {0x2C6B, {0x2C6C, 0x0, 0x0}, 1},
+ {0x2C6D, {0x251, 0x0, 0x0}, 1},
+ {0x2C6E, {0x271, 0x0, 0x0}, 1},
+ {0x2C6F, {0x250, 0x0, 0x0}, 1},
+ {0x2C70, {0x252, 0x0, 0x0}, 1},
+ {0x2C72, {0x2C73, 0x0, 0x0}, 1},
+ {0x2C75, {0x2C76, 0x0, 0x0}, 1},
+ {0x2C7E, {0x23F, 0x0, 0x0}, 1},
+ {0x2C7F, {0x240, 0x0, 0x0}, 1},
+ {0x2C80, {0x2C81, 0x0, 0x0}, 1},
+ {0x2C82, {0x2C83, 0x0, 0x0}, 1},
+ {0x2C84, {0x2C85, 0x0, 0x0}, 1},
+ {0x2C86, {0x2C87, 0x0, 0x0}, 1},
+ {0x2C88, {0x2C89, 0x0, 0x0}, 1},
+ {0x2C8A, {0x2C8B, 0x0, 0x0}, 1},
+ {0x2C8C, {0x2C8D, 0x0, 0x0}, 1},
+ {0x2C8E, {0x2C8F, 0x0, 0x0}, 1},
+ {0x2C90, {0x2C91, 0x0, 0x0}, 1},
+ {0x2C92, {0x2C93, 0x0, 0x0}, 1},
+ {0x2C94, {0x2C95, 0x0, 0x0}, 1},
+ {0x2C96, {0x2C97, 0x0, 0x0}, 1},
+ {0x2C98, {0x2C99, 0x0, 0x0}, 1},
+ {0x2C9A, {0x2C9B, 0x0, 0x0}, 1},
+ {0x2C9C, {0x2C9D, 0x0, 0x0}, 1},
+ {0x2C9E, {0x2C9F, 0x0, 0x0}, 1},
+ {0x2CA0, {0x2CA1, 0x0, 0x0}, 1},
+ {0x2CA2, {0x2CA3, 0x0, 0x0}, 1},
+ {0x2CA4, {0x2CA5, 0x0, 0x0}, 1},
+ {0x2CA6, {0x2CA7, 0x0, 0x0}, 1},
+ {0x2CA8, {0x2CA9, 0x0, 0x0}, 1},
+ {0x2CAA, {0x2CAB, 0x0, 0x0}, 1},
+ {0x2CAC, {0x2CAD, 0x0, 0x0}, 1},
+ {0x2CAE, {0x2CAF, 0x0, 0x0}, 1},
+ {0x2CB0, {0x2CB1, 0x0, 0x0}, 1},
+ {0x2CB2, {0x2CB3, 0x0, 0x0}, 1},
+ {0x2CB4, {0x2CB5, 0x0, 0x0}, 1},
+ {0x2CB6, {0x2CB7, 0x0, 0x0}, 1},
+ {0x2CB8, {0x2CB9, 0x0, 0x0}, 1},
+ {0x2CBA, {0x2CBB, 0x0, 0x0}, 1},
+ {0x2CBC, {0x2CBD, 0x0, 0x0}, 1},
+ {0x2CBE, {0x2CBF, 0x0, 0x0}, 1},
+ {0x2CC0, {0x2CC1, 0x0, 0x0}, 1},
+ {0x2CC2, {0x2CC3, 0x0, 0x0}, 1},
+ {0x2CC4, {0x2CC5, 0x0, 0x0}, 1},
+ {0x2CC6, {0x2CC7, 0x0, 0x0}, 1},
+ {0x2CC8, {0x2CC9, 0x0, 0x0}, 1},
+ {0x2CCA, {0x2CCB, 0x0, 0x0}, 1},
+ {0x2CCC, {0x2CCD, 0x0, 0x0}, 1},
+ {0x2CCE, {0x2CCF, 0x0, 0x0}, 1},
+ {0x2CD0, {0x2CD1, 0x0, 0x0}, 1},
+ {0x2CD2, {0x2CD3, 0x0, 0x0}, 1},
+ {0x2CD4, {0x2CD5, 0x0, 0x0}, 1},
+ {0x2CD6, {0x2CD7, 0x0, 0x0}, 1},
+ {0x2CD8, {0x2CD9, 0x0, 0x0}, 1},
+ {0x2CDA, {0x2CDB, 0x0, 0x0}, 1},
+ {0x2CDC, {0x2CDD, 0x0, 0x0}, 1},
+ {0x2CDE, {0x2CDF, 0x0, 0x0}, 1},
+ {0x2CE0, {0x2CE1, 0x0, 0x0}, 1},
+ {0x2CE2, {0x2CE3, 0x0, 0x0}, 1},
+ {0x2CEB, {0x2CEC, 0x0, 0x0}, 1},
+ {0x2CED, {0x2CEE, 0x0, 0x0}, 1},
+ {0x2CEF, {0x0, 0x0, 0x0}, 0},
+ {0x2CF0, {0x0, 0x0, 0x0}, 0},
+ {0x2CF1, {0x0, 0x0, 0x0}, 0},
+ {0x2CF2, {0x2CF3, 0x0, 0x0}, 1},
+ {0x2D7F, {0x0, 0x0, 0x0}, 0},
+ {0x2DE0, {0x0, 0x0, 0x0}, 0},
+ {0x2DE1, {0x0, 0x0, 0x0}, 0},
+ {0x2DE2, {0x0, 0x0, 0x0}, 0},
+ {0x2DE3, {0x0, 0x0, 0x0}, 0},
+ {0x2DE4, {0x0, 0x0, 0x0}, 0},
+ {0x2DE5, {0x0, 0x0, 0x0}, 0},
+ {0x2DE6, {0x0, 0x0, 0x0}, 0},
+ {0x2DE7, {0x0, 0x0, 0x0}, 0},
+ {0x2DE8, {0x0, 0x0, 0x0}, 0},
+ {0x2DE9, {0x0, 0x0, 0x0}, 0},
+ {0x2DEA, {0x0, 0x0, 0x0}, 0},
+ {0x2DEB, {0x0, 0x0, 0x0}, 0},
+ {0x2DEC, {0x0, 0x0, 0x0}, 0},
+ {0x2DED, {0x0, 0x0, 0x0}, 0},
+ {0x2DEE, {0x0, 0x0, 0x0}, 0},
+ {0x2DEF, {0x0, 0x0, 0x0}, 0},
+ {0x2DF0, {0x0, 0x0, 0x0}, 0},
+ {0x2DF1, {0x0, 0x0, 0x0}, 0},
+ {0x2DF2, {0x0, 0x0, 0x0}, 0},
+ {0x2DF3, {0x0, 0x0, 0x0}, 0},
+ {0x2DF4, {0x0, 0x0, 0x0}, 0},
+ {0x2DF5, {0x0, 0x0, 0x0}, 0},
+ {0x2DF6, {0x0, 0x0, 0x0}, 0},
+ {0x2DF7, {0x0, 0x0, 0x0}, 0},
+ {0x2DF8, {0x0, 0x0, 0x0}, 0},
+ {0x2DF9, {0x0, 0x0, 0x0}, 0},
+ {0x2DFA, {0x0, 0x0, 0x0}, 0},
+ {0x2DFB, {0x0, 0x0, 0x0}, 0},
+ {0x2DFC, {0x0, 0x0, 0x0}, 0},
+ {0x2DFD, {0x0, 0x0, 0x0}, 0},
+ {0x2DFE, {0x0, 0x0, 0x0}, 0},
+ {0x2DFF, {0x0, 0x0, 0x0}, 0},
+ {0x302A, {0x0, 0x0, 0x0}, 0},
+ {0x302B, {0x0, 0x0, 0x0}, 0},
+ {0x302C, {0x0, 0x0, 0x0}, 0},
+ {0x302D, {0x0, 0x0, 0x0}, 0},
+ {0x304C, {0x304B, 0x0, 0x0}, 1},
+ {0x304E, {0x304D, 0x0, 0x0}, 1},
+ {0x3050, {0x304F, 0x0, 0x0}, 1},
+ {0x3052, {0x3051, 0x0, 0x0}, 1},
+ {0x3054, {0x3053, 0x0, 0x0}, 1},
+ {0x3056, {0x3055, 0x0, 0x0}, 1},
+ {0x3058, {0x3057, 0x0, 0x0}, 1},
+ {0x305A, {0x3059, 0x0, 0x0}, 1},
+ {0x305C, {0x305B, 0x0, 0x0}, 1},
+ {0x305E, {0x305D, 0x0, 0x0}, 1},
+ {0x3060, {0x305F, 0x0, 0x0}, 1},
+ {0x3062, {0x3061, 0x0, 0x0}, 1},
+ {0x3065, {0x3064, 0x0, 0x0}, 1},
+ {0x3067, {0x3066, 0x0, 0x0}, 1},
+ {0x3069, {0x3068, 0x0, 0x0}, 1},
+ {0x3070, {0x306F, 0x0, 0x0}, 1},
+ {0x3071, {0x306F, 0x0, 0x0}, 1},
+ {0x3073, {0x3072, 0x0, 0x0}, 1},
+ {0x3074, {0x3072, 0x0, 0x0}, 1},
+ {0x3076, {0x3075, 0x0, 0x0}, 1},
+ {0x3077, {0x3075, 0x0, 0x0}, 1},
+ {0x3079, {0x3078, 0x0, 0x0}, 1},
+ {0x307A, {0x3078, 0x0, 0x0}, 1},
+ {0x307C, {0x307B, 0x0, 0x0}, 1},
+ {0x307D, {0x307B, 0x0, 0x0}, 1},
+ {0x3094, {0x3046, 0x0, 0x0}, 1},
+ {0x3099, {0x0, 0x0, 0x0}, 0},
+ {0x309A, {0x0, 0x0, 0x0}, 0},
+ {0x309E, {0x309D, 0x0, 0x0}, 1},
+ {0x30AC, {0x30AB, 0x0, 0x0}, 1},
+ {0x30AE, {0x30AD, 0x0, 0x0}, 1},
+ {0x30B0, {0x30AF, 0x0, 0x0}, 1},
+ {0x30B2, {0x30B1, 0x0, 0x0}, 1},
+ {0x30B4, {0x30B3, 0x0, 0x0}, 1},
+ {0x30B6, {0x30B5, 0x0, 0x0}, 1},
+ {0x30B8, {0x30B7, 0x0, 0x0}, 1},
+ {0x30BA, {0x30B9, 0x0, 0x0}, 1},
+ {0x30BC, {0x30BB, 0x0, 0x0}, 1},
+ {0x30BE, {0x30BD, 0x0, 0x0}, 1},
+ {0x30C0, {0x30BF, 0x0, 0x0}, 1},
+ {0x30C2, {0x30C1, 0x0, 0x0}, 1},
+ {0x30C5, {0x30C4, 0x0, 0x0}, 1},
+ {0x30C7, {0x30C6, 0x0, 0x0}, 1},
+ {0x30C9, {0x30C8, 0x0, 0x0}, 1},
+ {0x30D0, {0x30CF, 0x0, 0x0}, 1},
+ {0x30D1, {0x30CF, 0x0, 0x0}, 1},
+ {0x30D3, {0x30D2, 0x0, 0x0}, 1},
+ {0x30D4, {0x30D2, 0x0, 0x0}, 1},
+ {0x30D6, {0x30D5, 0x0, 0x0}, 1},
+ {0x30D7, {0x30D5, 0x0, 0x0}, 1},
+ {0x30D9, {0x30D8, 0x0, 0x0}, 1},
+ {0x30DA, {0x30D8, 0x0, 0x0}, 1},
+ {0x30DC, {0x30DB, 0x0, 0x0}, 1},
+ {0x30DD, {0x30DB, 0x0, 0x0}, 1},
+ {0x30F4, {0x30A6, 0x0, 0x0}, 1},
+ {0x30F7, {0x30EF, 0x0, 0x0}, 1},
+ {0x30F8, {0x30F0, 0x0, 0x0}, 1},
+ {0x30F9, {0x30F1, 0x0, 0x0}, 1},
+ {0x30FA, {0x30F2, 0x0, 0x0}, 1},
+ {0x30FE, {0x30FD, 0x0, 0x0}, 1},
+ {0xA640, {0xA641, 0x0, 0x0}, 1},
+ {0xA642, {0xA643, 0x0, 0x0}, 1},
+ {0xA644, {0xA645, 0x0, 0x0}, 1},
+ {0xA646, {0xA647, 0x0, 0x0}, 1},
+ {0xA648, {0xA649, 0x0, 0x0}, 1},
+ {0xA64A, {0xA64B, 0x0, 0x0}, 1},
+ {0xA64C, {0xA64D, 0x0, 0x0}, 1},
+ {0xA64E, {0xA64F, 0x0, 0x0}, 1},
+ {0xA650, {0xA651, 0x0, 0x0}, 1},
+ {0xA652, {0xA653, 0x0, 0x0}, 1},
+ {0xA654, {0xA655, 0x0, 0x0}, 1},
+ {0xA656, {0xA657, 0x0, 0x0}, 1},
+ {0xA658, {0xA659, 0x0, 0x0}, 1},
+ {0xA65A, {0xA65B, 0x0, 0x0}, 1},
+ {0xA65C, {0xA65D, 0x0, 0x0}, 1},
+ {0xA65E, {0xA65F, 0x0, 0x0}, 1},
+ {0xA660, {0xA661, 0x0, 0x0}, 1},
+ {0xA662, {0xA663, 0x0, 0x0}, 1},
+ {0xA664, {0xA665, 0x0, 0x0}, 1},
+ {0xA666, {0xA667, 0x0, 0x0}, 1},
+ {0xA668, {0xA669, 0x0, 0x0}, 1},
+ {0xA66A, {0xA66B, 0x0, 0x0}, 1},
+ {0xA66C, {0xA66D, 0x0, 0x0}, 1},
+ {0xA66F, {0x0, 0x0, 0x0}, 0},
+ {0xA674, {0x0, 0x0, 0x0}, 0},
+ {0xA675, {0x0, 0x0, 0x0}, 0},
+ {0xA676, {0x0, 0x0, 0x0}, 0},
+ {0xA677, {0x0, 0x0, 0x0}, 0},
+ {0xA678, {0x0, 0x0, 0x0}, 0},
+ {0xA679, {0x0, 0x0, 0x0}, 0},
+ {0xA67A, {0x0, 0x0, 0x0}, 0},
+ {0xA67B, {0x0, 0x0, 0x0}, 0},
+ {0xA67C, {0x0, 0x0, 0x0}, 0},
+ {0xA67D, {0x0, 0x0, 0x0}, 0},
+ {0xA680, {0xA681, 0x0, 0x0}, 1},
+ {0xA682, {0xA683, 0x0, 0x0}, 1},
+ {0xA684, {0xA685, 0x0, 0x0}, 1},
+ {0xA686, {0xA687, 0x0, 0x0}, 1},
+ {0xA688, {0xA689, 0x0, 0x0}, 1},
+ {0xA68A, {0xA68B, 0x0, 0x0}, 1},
+ {0xA68C, {0xA68D, 0x0, 0x0}, 1},
+ {0xA68E, {0xA68F, 0x0, 0x0}, 1},
+ {0xA690, {0xA691, 0x0, 0x0}, 1},
+ {0xA692, {0xA693, 0x0, 0x0}, 1},
+ {0xA694, {0xA695, 0x0, 0x0}, 1},
+ {0xA696, {0xA697, 0x0, 0x0}, 1},
+ {0xA698, {0xA699, 0x0, 0x0}, 1},
+ {0xA69A, {0xA69B, 0x0, 0x0}, 1},
+ {0xA69E, {0x0, 0x0, 0x0}, 0},
+ {0xA69F, {0x0, 0x0, 0x0}, 0},
+ {0xA6F0, {0x0, 0x0, 0x0}, 0},
+ {0xA6F1, {0x0, 0x0, 0x0}, 0},
+ {0xA722, {0xA723, 0x0, 0x0}, 1},
+ {0xA724, {0xA725, 0x0, 0x0}, 1},
+ {0xA726, {0xA727, 0x0, 0x0}, 1},
+ {0xA728, {0xA729, 0x0, 0x0}, 1},
+ {0xA72A, {0xA72B, 0x0, 0x0}, 1},
+ {0xA72C, {0xA72D, 0x0, 0x0}, 1},
+ {0xA72E, {0xA72F, 0x0, 0x0}, 1},
+ {0xA732, {0xA733, 0x0, 0x0}, 1},
+ {0xA734, {0xA735, 0x0, 0x0}, 1},
+ {0xA736, {0xA737, 0x0, 0x0}, 1},
+ {0xA738, {0xA739, 0x0, 0x0}, 1},
+ {0xA73A, {0xA73B, 0x0, 0x0}, 1},
+ {0xA73C, {0xA73D, 0x0, 0x0}, 1},
+ {0xA73E, {0xA73F, 0x0, 0x0}, 1},
+ {0xA740, {0xA741, 0x0, 0x0}, 1},
+ {0xA742, {0xA743, 0x0, 0x0}, 1},
+ {0xA744, {0xA745, 0x0, 0x0}, 1},
+ {0xA746, {0xA747, 0x0, 0x0}, 1},
+ {0xA748, {0xA749, 0x0, 0x0}, 1},
+ {0xA74A, {0xA74B, 0x0, 0x0}, 1},
+ {0xA74C, {0xA74D, 0x0, 0x0}, 1},
+ {0xA74E, {0xA74F, 0x0, 0x0}, 1},
+ {0xA750, {0xA751, 0x0, 0x0}, 1},
+ {0xA752, {0xA753, 0x0, 0x0}, 1},
+ {0xA754, {0xA755, 0x0, 0x0}, 1},
+ {0xA756, {0xA757, 0x0, 0x0}, 1},
+ {0xA758, {0xA759, 0x0, 0x0}, 1},
+ {0xA75A, {0xA75B, 0x0, 0x0}, 1},
+ {0xA75C, {0xA75D, 0x0, 0x0}, 1},
+ {0xA75E, {0xA75F, 0x0, 0x0}, 1},
+ {0xA760, {0xA761, 0x0, 0x0}, 1},
+ {0xA762, {0xA763, 0x0, 0x0}, 1},
+ {0xA764, {0xA765, 0x0, 0x0}, 1},
+ {0xA766, {0xA767, 0x0, 0x0}, 1},
+ {0xA768, {0xA769, 0x0, 0x0}, 1},
+ {0xA76A, {0xA76B, 0x0, 0x0}, 1},
+ {0xA76C, {0xA76D, 0x0, 0x0}, 1},
+ {0xA76E, {0xA76F, 0x0, 0x0}, 1},
+ {0xA779, {0xA77A, 0x0, 0x0}, 1},
+ {0xA77B, {0xA77C, 0x0, 0x0}, 1},
+ {0xA77D, {0x1D79, 0x0, 0x0}, 1},
+ {0xA77E, {0xA77F, 0x0, 0x0}, 1},
+ {0xA780, {0xA781, 0x0, 0x0}, 1},
+ {0xA782, {0xA783, 0x0, 0x0}, 1},
+ {0xA784, {0xA785, 0x0, 0x0}, 1},
+ {0xA786, {0xA787, 0x0, 0x0}, 1},
+ {0xA78B, {0xA78C, 0x0, 0x0}, 1},
+ {0xA78D, {0x265, 0x0, 0x0}, 1},
+ {0xA790, {0xA791, 0x0, 0x0}, 1},
+ {0xA792, {0xA793, 0x0, 0x0}, 1},
+ {0xA796, {0xA797, 0x0, 0x0}, 1},
+ {0xA798, {0xA799, 0x0, 0x0}, 1},
+ {0xA79A, {0xA79B, 0x0, 0x0}, 1},
+ {0xA79C, {0xA79D, 0x0, 0x0}, 1},
+ {0xA79E, {0xA79F, 0x0, 0x0}, 1},
+ {0xA7A0, {0xA7A1, 0x0, 0x0}, 1},
+ {0xA7A2, {0xA7A3, 0x0, 0x0}, 1},
+ {0xA7A4, {0xA7A5, 0x0, 0x0}, 1},
+ {0xA7A6, {0xA7A7, 0x0, 0x0}, 1},
+ {0xA7A8, {0xA7A9, 0x0, 0x0}, 1},
+ {0xA7AA, {0x266, 0x0, 0x0}, 1},
+ {0xA7AB, {0x25C, 0x0, 0x0}, 1},
+ {0xA7AC, {0x261, 0x0, 0x0}, 1},
+ {0xA7AD, {0x26C, 0x0, 0x0}, 1},
+ {0xA7AE, {0x26A, 0x0, 0x0}, 1},
+ {0xA7B0, {0x29E, 0x0, 0x0}, 1},
+ {0xA7B1, {0x287, 0x0, 0x0}, 1},
+ {0xA7B2, {0x29D, 0x0, 0x0}, 1},
+ {0xA7B3, {0xAB53, 0x0, 0x0}, 1},
+ {0xA7B4, {0xA7B5, 0x0, 0x0}, 1},
+ {0xA7B6, {0xA7B7, 0x0, 0x0}, 1},
+ {0xA7B8, {0xA7B9, 0x0, 0x0}, 1},
+ {0xA7BA, {0xA7BB, 0x0, 0x0}, 1},
+ {0xA7BC, {0xA7BD, 0x0, 0x0}, 1},
+ {0xA7BE, {0xA7BF, 0x0, 0x0}, 1},
+ {0xA7C2, {0xA7C3, 0x0, 0x0}, 1},
+ {0xA7C4, {0xA794, 0x0, 0x0}, 1},
+ {0xA7C5, {0x282, 0x0, 0x0}, 1},
+ {0xA7C6, {0x1D8E, 0x0, 0x0}, 1},
+ {0xA7C7, {0xA7C8, 0x0, 0x0}, 1},
+ {0xA7C9, {0xA7CA, 0x0, 0x0}, 1},
+ {0xA7F5, {0xA7F6, 0x0, 0x0}, 1},
+ {0xA802, {0x0, 0x0, 0x0}, 0},
+ {0xA806, {0x0, 0x0, 0x0}, 0},
+ {0xA80B, {0x0, 0x0, 0x0}, 0},
+ {0xA825, {0x0, 0x0, 0x0}, 0},
+ {0xA826, {0x0, 0x0, 0x0}, 0},
+ {0xA82C, {0x0, 0x0, 0x0}, 0},
+ {0xA8C4, {0x0, 0x0, 0x0}, 0},
+ {0xA8C5, {0x0, 0x0, 0x0}, 0},
+ {0xA8E0, {0x0, 0x0, 0x0}, 0},
+ {0xA8E1, {0x0, 0x0, 0x0}, 0},
+ {0xA8E2, {0x0, 0x0, 0x0}, 0},
+ {0xA8E3, {0x0, 0x0, 0x0}, 0},
+ {0xA8E4, {0x0, 0x0, 0x0}, 0},
+ {0xA8E5, {0x0, 0x0, 0x0}, 0},
+ {0xA8E6, {0x0, 0x0, 0x0}, 0},
+ {0xA8E7, {0x0, 0x0, 0x0}, 0},
+ {0xA8E8, {0x0, 0x0, 0x0}, 0},
+ {0xA8E9, {0x0, 0x0, 0x0}, 0},
+ {0xA8EA, {0x0, 0x0, 0x0}, 0},
+ {0xA8EB, {0x0, 0x0, 0x0}, 0},
+ {0xA8EC, {0x0, 0x0, 0x0}, 0},
+ {0xA8ED, {0x0, 0x0, 0x0}, 0},
+ {0xA8EE, {0x0, 0x0, 0x0}, 0},
+ {0xA8EF, {0x0, 0x0, 0x0}, 0},
+ {0xA8F0, {0x0, 0x0, 0x0}, 0},
+ {0xA8F1, {0x0, 0x0, 0x0}, 0},
+ {0xA8FF, {0x0, 0x0, 0x0}, 0},
+ {0xA926, {0x0, 0x0, 0x0}, 0},
+ {0xA927, {0x0, 0x0, 0x0}, 0},
+ {0xA928, {0x0, 0x0, 0x0}, 0},
+ {0xA929, {0x0, 0x0, 0x0}, 0},
+ {0xA92A, {0x0, 0x0, 0x0}, 0},
+ {0xA92B, {0x0, 0x0, 0x0}, 0},
+ {0xA92C, {0x0, 0x0, 0x0}, 0},
+ {0xA92D, {0x0, 0x0, 0x0}, 0},
+ {0xA947, {0x0, 0x0, 0x0}, 0},
+ {0xA948, {0x0, 0x0, 0x0}, 0},
+ {0xA949, {0x0, 0x0, 0x0}, 0},
+ {0xA94A, {0x0, 0x0, 0x0}, 0},
+ {0xA94B, {0x0, 0x0, 0x0}, 0},
+ {0xA94C, {0x0, 0x0, 0x0}, 0},
+ {0xA94D, {0x0, 0x0, 0x0}, 0},
+ {0xA94E, {0x0, 0x0, 0x0}, 0},
+ {0xA94F, {0x0, 0x0, 0x0}, 0},
+ {0xA950, {0x0, 0x0, 0x0}, 0},
+ {0xA951, {0x0, 0x0, 0x0}, 0},
+ {0xA980, {0x0, 0x0, 0x0}, 0},
+ {0xA981, {0x0, 0x0, 0x0}, 0},
+ {0xA982, {0x0, 0x0, 0x0}, 0},
+ {0xA9B3, {0x0, 0x0, 0x0}, 0},
+ {0xA9B6, {0x0, 0x0, 0x0}, 0},
+ {0xA9B7, {0x0, 0x0, 0x0}, 0},
+ {0xA9B8, {0x0, 0x0, 0x0}, 0},
+ {0xA9B9, {0x0, 0x0, 0x0}, 0},
+ {0xA9BC, {0x0, 0x0, 0x0}, 0},
+ {0xA9BD, {0x0, 0x0, 0x0}, 0},
+ {0xA9E5, {0x0, 0x0, 0x0}, 0},
+ {0xAA29, {0x0, 0x0, 0x0}, 0},
+ {0xAA2A, {0x0, 0x0, 0x0}, 0},
+ {0xAA2B, {0x0, 0x0, 0x0}, 0},
+ {0xAA2C, {0x0, 0x0, 0x0}, 0},
+ {0xAA2D, {0x0, 0x0, 0x0}, 0},
+ {0xAA2E, {0x0, 0x0, 0x0}, 0},
+ {0xAA31, {0x0, 0x0, 0x0}, 0},
+ {0xAA32, {0x0, 0x0, 0x0}, 0},
+ {0xAA35, {0x0, 0x0, 0x0}, 0},
+ {0xAA36, {0x0, 0x0, 0x0}, 0},
+ {0xAA43, {0x0, 0x0, 0x0}, 0},
+ {0xAA4C, {0x0, 0x0, 0x0}, 0},
+ {0xAA7C, {0x0, 0x0, 0x0}, 0},
+ {0xAAB0, {0x0, 0x0, 0x0}, 0},
+ {0xAAB2, {0x0, 0x0, 0x0}, 0},
+ {0xAAB3, {0x0, 0x0, 0x0}, 0},
+ {0xAAB4, {0x0, 0x0, 0x0}, 0},
+ {0xAAB7, {0x0, 0x0, 0x0}, 0},
+ {0xAAB8, {0x0, 0x0, 0x0}, 0},
+ {0xAABE, {0x0, 0x0, 0x0}, 0},
+ {0xAABF, {0x0, 0x0, 0x0}, 0},
+ {0xAAC1, {0x0, 0x0, 0x0}, 0},
+ {0xAAEC, {0x0, 0x0, 0x0}, 0},
+ {0xAAED, {0x0, 0x0, 0x0}, 0},
+ {0xAAF6, {0x0, 0x0, 0x0}, 0},
+ {0xABE5, {0x0, 0x0, 0x0}, 0},
+ {0xABE8, {0x0, 0x0, 0x0}, 0},
+ {0xABED, {0x0, 0x0, 0x0}, 0},
+ {0xF900, {0x8C48, 0x0, 0x0}, 1},
+ {0xF901, {0x66F4, 0x0, 0x0}, 1},
+ {0xF902, {0x8ECA, 0x0, 0x0}, 1},
+ {0xF903, {0x8CC8, 0x0, 0x0}, 1},
+ {0xF904, {0x6ED1, 0x0, 0x0}, 1},
+ {0xF905, {0x4E32, 0x0, 0x0}, 1},
+ {0xF906, {0x53E5, 0x0, 0x0}, 1},
+ {0xF907, {0x9F9C, 0x0, 0x0}, 1},
+ {0xF908, {0x9F9C, 0x0, 0x0}, 1},
+ {0xF909, {0x5951, 0x0, 0x0}, 1},
+ {0xF90A, {0x91D1, 0x0, 0x0}, 1},
+ {0xF90B, {0x5587, 0x0, 0x0}, 1},
+ {0xF90C, {0x5948, 0x0, 0x0}, 1},
+ {0xF90D, {0x61F6, 0x0, 0x0}, 1},
+ {0xF90E, {0x7669, 0x0, 0x0}, 1},
+ {0xF90F, {0x7F85, 0x0, 0x0}, 1},
+ {0xF910, {0x863F, 0x0, 0x0}, 1},
+ {0xF911, {0x87BA, 0x0, 0x0}, 1},
+ {0xF912, {0x88F8, 0x0, 0x0}, 1},
+ {0xF913, {0x908F, 0x0, 0x0}, 1},
+ {0xF914, {0x6A02, 0x0, 0x0}, 1},
+ {0xF915, {0x6D1B, 0x0, 0x0}, 1},
+ {0xF916, {0x70D9, 0x0, 0x0}, 1},
+ {0xF917, {0x73DE, 0x0, 0x0}, 1},
+ {0xF918, {0x843D, 0x0, 0x0}, 1},
+ {0xF919, {0x916A, 0x0, 0x0}, 1},
+ {0xF91A, {0x99F1, 0x0, 0x0}, 1},
+ {0xF91B, {0x4E82, 0x0, 0x0}, 1},
+ {0xF91C, {0x5375, 0x0, 0x0}, 1},
+ {0xF91D, {0x6B04, 0x0, 0x0}, 1},
+ {0xF91E, {0x721B, 0x0, 0x0}, 1},
+ {0xF91F, {0x862D, 0x0, 0x0}, 1},
+ {0xF920, {0x9E1E, 0x0, 0x0}, 1},
+ {0xF921, {0x5D50, 0x0, 0x0}, 1},
+ {0xF922, {0x6FEB, 0x0, 0x0}, 1},
+ {0xF923, {0x85CD, 0x0, 0x0}, 1},
+ {0xF924, {0x8964, 0x0, 0x0}, 1},
+ {0xF925, {0x62C9, 0x0, 0x0}, 1},
+ {0xF926, {0x81D8, 0x0, 0x0}, 1},
+ {0xF927, {0x881F, 0x0, 0x0}, 1},
+ {0xF928, {0x5ECA, 0x0, 0x0}, 1},
+ {0xF929, {0x6717, 0x0, 0x0}, 1},
+ {0xF92A, {0x6D6A, 0x0, 0x0}, 1},
+ {0xF92B, {0x72FC, 0x0, 0x0}, 1},
+ {0xF92C, {0x90CE, 0x0, 0x0}, 1},
+ {0xF92D, {0x4F86, 0x0, 0x0}, 1},
+ {0xF92E, {0x51B7, 0x0, 0x0}, 1},
+ {0xF92F, {0x52DE, 0x0, 0x0}, 1},
+ {0xF930, {0x64C4, 0x0, 0x0}, 1},
+ {0xF931, {0x6AD3, 0x0, 0x0}, 1},
+ {0xF932, {0x7210, 0x0, 0x0}, 1},
+ {0xF933, {0x76E7, 0x0, 0x0}, 1},
+ {0xF934, {0x8001, 0x0, 0x0}, 1},
+ {0xF935, {0x8606, 0x0, 0x0}, 1},
+ {0xF936, {0x865C, 0x0, 0x0}, 1},
+ {0xF937, {0x8DEF, 0x0, 0x0}, 1},
+ {0xF938, {0x9732, 0x0, 0x0}, 1},
+ {0xF939, {0x9B6F, 0x0, 0x0}, 1},
+ {0xF93A, {0x9DFA, 0x0, 0x0}, 1},
+ {0xF93B, {0x788C, 0x0, 0x0}, 1},
+ {0xF93C, {0x797F, 0x0, 0x0}, 1},
+ {0xF93D, {0x7DA0, 0x0, 0x0}, 1},
+ {0xF93E, {0x83C9, 0x0, 0x0}, 1},
+ {0xF93F, {0x9304, 0x0, 0x0}, 1},
+ {0xF940, {0x9E7F, 0x0, 0x0}, 1},
+ {0xF941, {0x8AD6, 0x0, 0x0}, 1},
+ {0xF942, {0x58DF, 0x0, 0x0}, 1},
+ {0xF943, {0x5F04, 0x0, 0x0}, 1},
+ {0xF944, {0x7C60, 0x0, 0x0}, 1},
+ {0xF945, {0x807E, 0x0, 0x0}, 1},
+ {0xF946, {0x7262, 0x0, 0x0}, 1},
+ {0xF947, {0x78CA, 0x0, 0x0}, 1},
+ {0xF948, {0x8CC2, 0x0, 0x0}, 1},
+ {0xF949, {0x96F7, 0x0, 0x0}, 1},
+ {0xF94A, {0x58D8, 0x0, 0x0}, 1},
+ {0xF94B, {0x5C62, 0x0, 0x0}, 1},
+ {0xF94C, {0x6A13, 0x0, 0x0}, 1},
+ {0xF94D, {0x6DDA, 0x0, 0x0}, 1},
+ {0xF94E, {0x6F0F, 0x0, 0x0}, 1},
+ {0xF94F, {0x7D2F, 0x0, 0x0}, 1},
+ {0xF950, {0x7E37, 0x0, 0x0}, 1},
+ {0xF951, {0x964B, 0x0, 0x0}, 1},
+ {0xF952, {0x52D2, 0x0, 0x0}, 1},
+ {0xF953, {0x808B, 0x0, 0x0}, 1},
+ {0xF954, {0x51DC, 0x0, 0x0}, 1},
+ {0xF955, {0x51CC, 0x0, 0x0}, 1},
+ {0xF956, {0x7A1C, 0x0, 0x0}, 1},
+ {0xF957, {0x7DBE, 0x0, 0x0}, 1},
+ {0xF958, {0x83F1, 0x0, 0x0}, 1},
+ {0xF959, {0x9675, 0x0, 0x0}, 1},
+ {0xF95A, {0x8B80, 0x0, 0x0}, 1},
+ {0xF95B, {0x62CF, 0x0, 0x0}, 1},
+ {0xF95C, {0x6A02, 0x0, 0x0}, 1},
+ {0xF95D, {0x8AFE, 0x0, 0x0}, 1},
+ {0xF95E, {0x4E39, 0x0, 0x0}, 1},
+ {0xF95F, {0x5BE7, 0x0, 0x0}, 1},
+ {0xF960, {0x6012, 0x0, 0x0}, 1},
+ {0xF961, {0x7387, 0x0, 0x0}, 1},
+ {0xF962, {0x7570, 0x0, 0x0}, 1},
+ {0xF963, {0x5317, 0x0, 0x0}, 1},
+ {0xF964, {0x78FB, 0x0, 0x0}, 1},
+ {0xF965, {0x4FBF, 0x0, 0x0}, 1},
+ {0xF966, {0x5FA9, 0x0, 0x0}, 1},
+ {0xF967, {0x4E0D, 0x0, 0x0}, 1},
+ {0xF968, {0x6CCC, 0x0, 0x0}, 1},
+ {0xF969, {0x6578, 0x0, 0x0}, 1},
+ {0xF96A, {0x7D22, 0x0, 0x0}, 1},
+ {0xF96B, {0x53C3, 0x0, 0x0}, 1},
+ {0xF96C, {0x585E, 0x0, 0x0}, 1},
+ {0xF96D, {0x7701, 0x0, 0x0}, 1},
+ {0xF96E, {0x8449, 0x0, 0x0}, 1},
+ {0xF96F, {0x8AAA, 0x0, 0x0}, 1},
+ {0xF970, {0x6BBA, 0x0, 0x0}, 1},
+ {0xF971, {0x8FB0, 0x0, 0x0}, 1},
+ {0xF972, {0x6C88, 0x0, 0x0}, 1},
+ {0xF973, {0x62FE, 0x0, 0x0}, 1},
+ {0xF974, {0x82E5, 0x0, 0x0}, 1},
+ {0xF975, {0x63A0, 0x0, 0x0}, 1},
+ {0xF976, {0x7565, 0x0, 0x0}, 1},
+ {0xF977, {0x4EAE, 0x0, 0x0}, 1},
+ {0xF978, {0x5169, 0x0, 0x0}, 1},
+ {0xF979, {0x51C9, 0x0, 0x0}, 1},
+ {0xF97A, {0x6881, 0x0, 0x0}, 1},
+ {0xF97B, {0x7CE7, 0x0, 0x0}, 1},
+ {0xF97C, {0x826F, 0x0, 0x0}, 1},
+ {0xF97D, {0x8AD2, 0x0, 0x0}, 1},
+ {0xF97E, {0x91CF, 0x0, 0x0}, 1},
+ {0xF97F, {0x52F5, 0x0, 0x0}, 1},
+ {0xF980, {0x5442, 0x0, 0x0}, 1},
+ {0xF981, {0x5973, 0x0, 0x0}, 1},
+ {0xF982, {0x5EEC, 0x0, 0x0}, 1},
+ {0xF983, {0x65C5, 0x0, 0x0}, 1},
+ {0xF984, {0x6FFE, 0x0, 0x0}, 1},
+ {0xF985, {0x792A, 0x0, 0x0}, 1},
+ {0xF986, {0x95AD, 0x0, 0x0}, 1},
+ {0xF987, {0x9A6A, 0x0, 0x0}, 1},
+ {0xF988, {0x9E97, 0x0, 0x0}, 1},
+ {0xF989, {0x9ECE, 0x0, 0x0}, 1},
+ {0xF98A, {0x529B, 0x0, 0x0}, 1},
+ {0xF98B, {0x66C6, 0x0, 0x0}, 1},
+ {0xF98C, {0x6B77, 0x0, 0x0}, 1},
+ {0xF98D, {0x8F62, 0x0, 0x0}, 1},
+ {0xF98E, {0x5E74, 0x0, 0x0}, 1},
+ {0xF98F, {0x6190, 0x0, 0x0}, 1},
+ {0xF990, {0x6200, 0x0, 0x0}, 1},
+ {0xF991, {0x649A, 0x0, 0x0}, 1},
+ {0xF992, {0x6F23, 0x0, 0x0}, 1},
+ {0xF993, {0x7149, 0x0, 0x0}, 1},
+ {0xF994, {0x7489, 0x0, 0x0}, 1},
+ {0xF995, {0x79CA, 0x0, 0x0}, 1},
+ {0xF996, {0x7DF4, 0x0, 0x0}, 1},
+ {0xF997, {0x806F, 0x0, 0x0}, 1},
+ {0xF998, {0x8F26, 0x0, 0x0}, 1},
+ {0xF999, {0x84EE, 0x0, 0x0}, 1},
+ {0xF99A, {0x9023, 0x0, 0x0}, 1},
+ {0xF99B, {0x934A, 0x0, 0x0}, 1},
+ {0xF99C, {0x5217, 0x0, 0x0}, 1},
+ {0xF99D, {0x52A3, 0x0, 0x0}, 1},
+ {0xF99E, {0x54BD, 0x0, 0x0}, 1},
+ {0xF99F, {0x70C8, 0x0, 0x0}, 1},
+ {0xF9A0, {0x88C2, 0x0, 0x0}, 1},
+ {0xF9A1, {0x8AAA, 0x0, 0x0}, 1},
+ {0xF9A2, {0x5EC9, 0x0, 0x0}, 1},
+ {0xF9A3, {0x5FF5, 0x0, 0x0}, 1},
+ {0xF9A4, {0x637B, 0x0, 0x0}, 1},
+ {0xF9A5, {0x6BAE, 0x0, 0x0}, 1},
+ {0xF9A6, {0x7C3E, 0x0, 0x0}, 1},
+ {0xF9A7, {0x7375, 0x0, 0x0}, 1},
+ {0xF9A8, {0x4EE4, 0x0, 0x0}, 1},
+ {0xF9A9, {0x56F9, 0x0, 0x0}, 1},
+ {0xF9AA, {0x5BE7, 0x0, 0x0}, 1},
+ {0xF9AB, {0x5DBA, 0x0, 0x0}, 1},
+ {0xF9AC, {0x601C, 0x0, 0x0}, 1},
+ {0xF9AD, {0x73B2, 0x0, 0x0}, 1},
+ {0xF9AE, {0x7469, 0x0, 0x0}, 1},
+ {0xF9AF, {0x7F9A, 0x0, 0x0}, 1},
+ {0xF9B0, {0x8046, 0x0, 0x0}, 1},
+ {0xF9B1, {0x9234, 0x0, 0x0}, 1},
+ {0xF9B2, {0x96F6, 0x0, 0x0}, 1},
+ {0xF9B3, {0x9748, 0x0, 0x0}, 1},
+ {0xF9B4, {0x9818, 0x0, 0x0}, 1},
+ {0xF9B5, {0x4F8B, 0x0, 0x0}, 1},
+ {0xF9B6, {0x79AE, 0x0, 0x0}, 1},
+ {0xF9B7, {0x91B4, 0x0, 0x0}, 1},
+ {0xF9B8, {0x96B8, 0x0, 0x0}, 1},
+ {0xF9B9, {0x60E1, 0x0, 0x0}, 1},
+ {0xF9BA, {0x4E86, 0x0, 0x0}, 1},
+ {0xF9BB, {0x50DA, 0x0, 0x0}, 1},
+ {0xF9BC, {0x5BEE, 0x0, 0x0}, 1},
+ {0xF9BD, {0x5C3F, 0x0, 0x0}, 1},
+ {0xF9BE, {0x6599, 0x0, 0x0}, 1},
+ {0xF9BF, {0x6A02, 0x0, 0x0}, 1},
+ {0xF9C0, {0x71CE, 0x0, 0x0}, 1},
+ {0xF9C1, {0x7642, 0x0, 0x0}, 1},
+ {0xF9C2, {0x84FC, 0x0, 0x0}, 1},
+ {0xF9C3, {0x907C, 0x0, 0x0}, 1},
+ {0xF9C4, {0x9F8D, 0x0, 0x0}, 1},
+ {0xF9C5, {0x6688, 0x0, 0x0}, 1},
+ {0xF9C6, {0x962E, 0x0, 0x0}, 1},
+ {0xF9C7, {0x5289, 0x0, 0x0}, 1},
+ {0xF9C8, {0x677B, 0x0, 0x0}, 1},
+ {0xF9C9, {0x67F3, 0x0, 0x0}, 1},
+ {0xF9CA, {0x6D41, 0x0, 0x0}, 1},
+ {0xF9CB, {0x6E9C, 0x0, 0x0}, 1},
+ {0xF9CC, {0x7409, 0x0, 0x0}, 1},
+ {0xF9CD, {0x7559, 0x0, 0x0}, 1},
+ {0xF9CE, {0x786B, 0x0, 0x0}, 1},
+ {0xF9CF, {0x7D10, 0x0, 0x0}, 1},
+ {0xF9D0, {0x985E, 0x0, 0x0}, 1},
+ {0xF9D1, {0x516D, 0x0, 0x0}, 1},
+ {0xF9D2, {0x622E, 0x0, 0x0}, 1},
+ {0xF9D3, {0x9678, 0x0, 0x0}, 1},
+ {0xF9D4, {0x502B, 0x0, 0x0}, 1},
+ {0xF9D5, {0x5D19, 0x0, 0x0}, 1},
+ {0xF9D6, {0x6DEA, 0x0, 0x0}, 1},
+ {0xF9D7, {0x8F2A, 0x0, 0x0}, 1},
+ {0xF9D8, {0x5F8B, 0x0, 0x0}, 1},
+ {0xF9D9, {0x6144, 0x0, 0x0}, 1},
+ {0xF9DA, {0x6817, 0x0, 0x0}, 1},
+ {0xF9DB, {0x7387, 0x0, 0x0}, 1},
+ {0xF9DC, {0x9686, 0x0, 0x0}, 1},
+ {0xF9DD, {0x5229, 0x0, 0x0}, 1},
+ {0xF9DE, {0x540F, 0x0, 0x0}, 1},
+ {0xF9DF, {0x5C65, 0x0, 0x0}, 1},
+ {0xF9E0, {0x6613, 0x0, 0x0}, 1},
+ {0xF9E1, {0x674E, 0x0, 0x0}, 1},
+ {0xF9E2, {0x68A8, 0x0, 0x0}, 1},
+ {0xF9E3, {0x6CE5, 0x0, 0x0}, 1},
+ {0xF9E4, {0x7406, 0x0, 0x0}, 1},
+ {0xF9E5, {0x75E2, 0x0, 0x0}, 1},
+ {0xF9E6, {0x7F79, 0x0, 0x0}, 1},
+ {0xF9E7, {0x88CF, 0x0, 0x0}, 1},
+ {0xF9E8, {0x88E1, 0x0, 0x0}, 1},
+ {0xF9E9, {0x91CC, 0x0, 0x0}, 1},
+ {0xF9EA, {0x96E2, 0x0, 0x0}, 1},
+ {0xF9EB, {0x533F, 0x0, 0x0}, 1},
+ {0xF9EC, {0x6EBA, 0x0, 0x0}, 1},
+ {0xF9ED, {0x541D, 0x0, 0x0}, 1},
+ {0xF9EE, {0x71D0, 0x0, 0x0}, 1},
+ {0xF9EF, {0x7498, 0x0, 0x0}, 1},
+ {0xF9F0, {0x85FA, 0x0, 0x0}, 1},
+ {0xF9F1, {0x96A3, 0x0, 0x0}, 1},
+ {0xF9F2, {0x9C57, 0x0, 0x0}, 1},
+ {0xF9F3, {0x9E9F, 0x0, 0x0}, 1},
+ {0xF9F4, {0x6797, 0x0, 0x0}, 1},
+ {0xF9F5, {0x6DCB, 0x0, 0x0}, 1},
+ {0xF9F6, {0x81E8, 0x0, 0x0}, 1},
+ {0xF9F7, {0x7ACB, 0x0, 0x0}, 1},
+ {0xF9F8, {0x7B20, 0x0, 0x0}, 1},
+ {0xF9F9, {0x7C92, 0x0, 0x0}, 1},
+ {0xF9FA, {0x72C0, 0x0, 0x0}, 1},
+ {0xF9FB, {0x7099, 0x0, 0x0}, 1},
+ {0xF9FC, {0x8B58, 0x0, 0x0}, 1},
+ {0xF9FD, {0x4EC0, 0x0, 0x0}, 1},
+ {0xF9FE, {0x8336, 0x0, 0x0}, 1},
+ {0xF9FF, {0x523A, 0x0, 0x0}, 1},
+ {0xFA00, {0x5207, 0x0, 0x0}, 1},
+ {0xFA01, {0x5EA6, 0x0, 0x0}, 1},
+ {0xFA02, {0x62D3, 0x0, 0x0}, 1},
+ {0xFA03, {0x7CD6, 0x0, 0x0}, 1},
+ {0xFA04, {0x5B85, 0x0, 0x0}, 1},
+ {0xFA05, {0x6D1E, 0x0, 0x0}, 1},
+ {0xFA06, {0x66B4, 0x0, 0x0}, 1},
+ {0xFA07, {0x8F3B, 0x0, 0x0}, 1},
+ {0xFA08, {0x884C, 0x0, 0x0}, 1},
+ {0xFA09, {0x964D, 0x0, 0x0}, 1},
+ {0xFA0A, {0x898B, 0x0, 0x0}, 1},
+ {0xFA0B, {0x5ED3, 0x0, 0x0}, 1},
+ {0xFA0C, {0x5140, 0x0, 0x0}, 1},
+ {0xFA0D, {0x55C0, 0x0, 0x0}, 1},
+ {0xFA10, {0x585A, 0x0, 0x0}, 1},
+ {0xFA12, {0x6674, 0x0, 0x0}, 1},
+ {0xFA15, {0x51DE, 0x0, 0x0}, 1},
+ {0xFA16, {0x732A, 0x0, 0x0}, 1},
+ {0xFA17, {0x76CA, 0x0, 0x0}, 1},
+ {0xFA18, {0x793C, 0x0, 0x0}, 1},
+ {0xFA19, {0x795E, 0x0, 0x0}, 1},
+ {0xFA1A, {0x7965, 0x0, 0x0}, 1},
+ {0xFA1B, {0x798F, 0x0, 0x0}, 1},
+ {0xFA1C, {0x9756, 0x0, 0x0}, 1},
+ {0xFA1D, {0x7CBE, 0x0, 0x0}, 1},
+ {0xFA1E, {0x7FBD, 0x0, 0x0}, 1},
+ {0xFA20, {0x8612, 0x0, 0x0}, 1},
+ {0xFA22, {0x8AF8, 0x0, 0x0}, 1},
+ {0xFA25, {0x9038, 0x0, 0x0}, 1},
+ {0xFA26, {0x90FD, 0x0, 0x0}, 1},
+ {0xFA2A, {0x98EF, 0x0, 0x0}, 1},
+ {0xFA2B, {0x98FC, 0x0, 0x0}, 1},
+ {0xFA2C, {0x9928, 0x0, 0x0}, 1},
+ {0xFA2D, {0x9DB4, 0x0, 0x0}, 1},
+ {0xFA2E, {0x90DE, 0x0, 0x0}, 1},
+ {0xFA2F, {0x96B7, 0x0, 0x0}, 1},
+ {0xFA30, {0x4FAE, 0x0, 0x0}, 1},
+ {0xFA31, {0x50E7, 0x0, 0x0}, 1},
+ {0xFA32, {0x514D, 0x0, 0x0}, 1},
+ {0xFA33, {0x52C9, 0x0, 0x0}, 1},
+ {0xFA34, {0x52E4, 0x0, 0x0}, 1},
+ {0xFA35, {0x5351, 0x0, 0x0}, 1},
+ {0xFA36, {0x559D, 0x0, 0x0}, 1},
+ {0xFA37, {0x5606, 0x0, 0x0}, 1},
+ {0xFA38, {0x5668, 0x0, 0x0}, 1},
+ {0xFA39, {0x5840, 0x0, 0x0}, 1},
+ {0xFA3A, {0x58A8, 0x0, 0x0}, 1},
+ {0xFA3B, {0x5C64, 0x0, 0x0}, 1},
+ {0xFA3C, {0x5C6E, 0x0, 0x0}, 1},
+ {0xFA3D, {0x6094, 0x0, 0x0}, 1},
+ {0xFA3E, {0x6168, 0x0, 0x0}, 1},
+ {0xFA3F, {0x618E, 0x0, 0x0}, 1},
+ {0xFA40, {0x61F2, 0x0, 0x0}, 1},
+ {0xFA41, {0x654F, 0x0, 0x0}, 1},
+ {0xFA42, {0x65E2, 0x0, 0x0}, 1},
+ {0xFA43, {0x6691, 0x0, 0x0}, 1},
+ {0xFA44, {0x6885, 0x0, 0x0}, 1},
+ {0xFA45, {0x6D77, 0x0, 0x0}, 1},
+ {0xFA46, {0x6E1A, 0x0, 0x0}, 1},
+ {0xFA47, {0x6F22, 0x0, 0x0}, 1},
+ {0xFA48, {0x716E, 0x0, 0x0}, 1},
+ {0xFA49, {0x722B, 0x0, 0x0}, 1},
+ {0xFA4A, {0x7422, 0x0, 0x0}, 1},
+ {0xFA4B, {0x7891, 0x0, 0x0}, 1},
+ {0xFA4C, {0x793E, 0x0, 0x0}, 1},
+ {0xFA4D, {0x7949, 0x0, 0x0}, 1},
+ {0xFA4E, {0x7948, 0x0, 0x0}, 1},
+ {0xFA4F, {0x7950, 0x0, 0x0}, 1},
+ {0xFA50, {0x7956, 0x0, 0x0}, 1},
+ {0xFA51, {0x795D, 0x0, 0x0}, 1},
+ {0xFA52, {0x798D, 0x0, 0x0}, 1},
+ {0xFA53, {0x798E, 0x0, 0x0}, 1},
+ {0xFA54, {0x7A40, 0x0, 0x0}, 1},
+ {0xFA55, {0x7A81, 0x0, 0x0}, 1},
+ {0xFA56, {0x7BC0, 0x0, 0x0}, 1},
+ {0xFA57, {0x7DF4, 0x0, 0x0}, 1},
+ {0xFA58, {0x7E09, 0x0, 0x0}, 1},
+ {0xFA59, {0x7E41, 0x0, 0x0}, 1},
+ {0xFA5A, {0x7F72, 0x0, 0x0}, 1},
+ {0xFA5B, {0x8005, 0x0, 0x0}, 1},
+ {0xFA5C, {0x81ED, 0x0, 0x0}, 1},
+ {0xFA5D, {0x8279, 0x0, 0x0}, 1},
+ {0xFA5E, {0x8279, 0x0, 0x0}, 1},
+ {0xFA5F, {0x8457, 0x0, 0x0}, 1},
+ {0xFA60, {0x8910, 0x0, 0x0}, 1},
+ {0xFA61, {0x8996, 0x0, 0x0}, 1},
+ {0xFA62, {0x8B01, 0x0, 0x0}, 1},
+ {0xFA63, {0x8B39, 0x0, 0x0}, 1},
+ {0xFA64, {0x8CD3, 0x0, 0x0}, 1},
+ {0xFA65, {0x8D08, 0x0, 0x0}, 1},
+ {0xFA66, {0x8FB6, 0x0, 0x0}, 1},
+ {0xFA67, {0x9038, 0x0, 0x0}, 1},
+ {0xFA68, {0x96E3, 0x0, 0x0}, 1},
+ {0xFA69, {0x97FF, 0x0, 0x0}, 1},
+ {0xFA6A, {0x983B, 0x0, 0x0}, 1},
+ {0xFA6B, {0x6075, 0x0, 0x0}, 1},
+ {0xFA6C, {0x242EE, 0x0, 0x0}, 1},
+ {0xFA6D, {0x8218, 0x0, 0x0}, 1},
+ {0xFA70, {0x4E26, 0x0, 0x0}, 1},
+ {0xFA71, {0x51B5, 0x0, 0x0}, 1},
+ {0xFA72, {0x5168, 0x0, 0x0}, 1},
+ {0xFA73, {0x4F80, 0x0, 0x0}, 1},
+ {0xFA74, {0x5145, 0x0, 0x0}, 1},
+ {0xFA75, {0x5180, 0x0, 0x0}, 1},
+ {0xFA76, {0x52C7, 0x0, 0x0}, 1},
+ {0xFA77, {0x52FA, 0x0, 0x0}, 1},
+ {0xFA78, {0x559D, 0x0, 0x0}, 1},
+ {0xFA79, {0x5555, 0x0, 0x0}, 1},
+ {0xFA7A, {0x5599, 0x0, 0x0}, 1},
+ {0xFA7B, {0x55E2, 0x0, 0x0}, 1},
+ {0xFA7C, {0x585A, 0x0, 0x0}, 1},
+ {0xFA7D, {0x58B3, 0x0, 0x0}, 1},
+ {0xFA7E, {0x5944, 0x0, 0x0}, 1},
+ {0xFA7F, {0x5954, 0x0, 0x0}, 1},
+ {0xFA80, {0x5A62, 0x0, 0x0}, 1},
+ {0xFA81, {0x5B28, 0x0, 0x0}, 1},
+ {0xFA82, {0x5ED2, 0x0, 0x0}, 1},
+ {0xFA83, {0x5ED9, 0x0, 0x0}, 1},
+ {0xFA84, {0x5F69, 0x0, 0x0}, 1},
+ {0xFA85, {0x5FAD, 0x0, 0x0}, 1},
+ {0xFA86, {0x60D8, 0x0, 0x0}, 1},
+ {0xFA87, {0x614E, 0x0, 0x0}, 1},
+ {0xFA88, {0x6108, 0x0, 0x0}, 1},
+ {0xFA89, {0x618E, 0x0, 0x0}, 1},
+ {0xFA8A, {0x6160, 0x0, 0x0}, 1},
+ {0xFA8B, {0x61F2, 0x0, 0x0}, 1},
+ {0xFA8C, {0x6234, 0x0, 0x0}, 1},
+ {0xFA8D, {0x63C4, 0x0, 0x0}, 1},
+ {0xFA8E, {0x641C, 0x0, 0x0}, 1},
+ {0xFA8F, {0x6452, 0x0, 0x0}, 1},
+ {0xFA90, {0x6556, 0x0, 0x0}, 1},
+ {0xFA91, {0x6674, 0x0, 0x0}, 1},
+ {0xFA92, {0x6717, 0x0, 0x0}, 1},
+ {0xFA93, {0x671B, 0x0, 0x0}, 1},
+ {0xFA94, {0x6756, 0x0, 0x0}, 1},
+ {0xFA95, {0x6B79, 0x0, 0x0}, 1},
+ {0xFA96, {0x6BBA, 0x0, 0x0}, 1},
+ {0xFA97, {0x6D41, 0x0, 0x0}, 1},
+ {0xFA98, {0x6EDB, 0x0, 0x0}, 1},
+ {0xFA99, {0x6ECB, 0x0, 0x0}, 1},
+ {0xFA9A, {0x6F22, 0x0, 0x0}, 1},
+ {0xFA9B, {0x701E, 0x0, 0x0}, 1},
+ {0xFA9C, {0x716E, 0x0, 0x0}, 1},
+ {0xFA9D, {0x77A7, 0x0, 0x0}, 1},
+ {0xFA9E, {0x7235, 0x0, 0x0}, 1},
+ {0xFA9F, {0x72AF, 0x0, 0x0}, 1},
+ {0xFAA0, {0x732A, 0x0, 0x0}, 1},
+ {0xFAA1, {0x7471, 0x0, 0x0}, 1},
+ {0xFAA2, {0x7506, 0x0, 0x0}, 1},
+ {0xFAA3, {0x753B, 0x0, 0x0}, 1},
+ {0xFAA4, {0x761D, 0x0, 0x0}, 1},
+ {0xFAA5, {0x761F, 0x0, 0x0}, 1},
+ {0xFAA6, {0x76CA, 0x0, 0x0}, 1},
+ {0xFAA7, {0x76DB, 0x0, 0x0}, 1},
+ {0xFAA8, {0x76F4, 0x0, 0x0}, 1},
+ {0xFAA9, {0x774A, 0x0, 0x0}, 1},
+ {0xFAAA, {0x7740, 0x0, 0x0}, 1},
+ {0xFAAB, {0x78CC, 0x0, 0x0}, 1},
+ {0xFAAC, {0x7AB1, 0x0, 0x0}, 1},
+ {0xFAAD, {0x7BC0, 0x0, 0x0}, 1},
+ {0xFAAE, {0x7C7B, 0x0, 0x0}, 1},
+ {0xFAAF, {0x7D5B, 0x0, 0x0}, 1},
+ {0xFAB0, {0x7DF4, 0x0, 0x0}, 1},
+ {0xFAB1, {0x7F3E, 0x0, 0x0}, 1},
+ {0xFAB2, {0x8005, 0x0, 0x0}, 1},
+ {0xFAB3, {0x8352, 0x0, 0x0}, 1},
+ {0xFAB4, {0x83EF, 0x0, 0x0}, 1},
+ {0xFAB5, {0x8779, 0x0, 0x0}, 1},
+ {0xFAB6, {0x8941, 0x0, 0x0}, 1},
+ {0xFAB7, {0x8986, 0x0, 0x0}, 1},
+ {0xFAB8, {0x8996, 0x0, 0x0}, 1},
+ {0xFAB9, {0x8ABF, 0x0, 0x0}, 1},
+ {0xFABA, {0x8AF8, 0x0, 0x0}, 1},
+ {0xFABB, {0x8ACB, 0x0, 0x0}, 1},
+ {0xFABC, {0x8B01, 0x0, 0x0}, 1},
+ {0xFABD, {0x8AFE, 0x0, 0x0}, 1},
+ {0xFABE, {0x8AED, 0x0, 0x0}, 1},
+ {0xFABF, {0x8B39, 0x0, 0x0}, 1},
+ {0xFAC0, {0x8B8A, 0x0, 0x0}, 1},
+ {0xFAC1, {0x8D08, 0x0, 0x0}, 1},
+ {0xFAC2, {0x8F38, 0x0, 0x0}, 1},
+ {0xFAC3, {0x9072, 0x0, 0x0}, 1},
+ {0xFAC4, {0x9199, 0x0, 0x0}, 1},
+ {0xFAC5, {0x9276, 0x0, 0x0}, 1},
+ {0xFAC6, {0x967C, 0x0, 0x0}, 1},
+ {0xFAC7, {0x96E3, 0x0, 0x0}, 1},
+ {0xFAC8, {0x9756, 0x0, 0x0}, 1},
+ {0xFAC9, {0x97DB, 0x0, 0x0}, 1},
+ {0xFACA, {0x97FF, 0x0, 0x0}, 1},
+ {0xFACB, {0x980B, 0x0, 0x0}, 1},
+ {0xFACC, {0x983B, 0x0, 0x0}, 1},
+ {0xFACD, {0x9B12, 0x0, 0x0}, 1},
+ {0xFACE, {0x9F9C, 0x0, 0x0}, 1},
+ {0xFACF, {0x2284A, 0x0, 0x0}, 1},
+ {0xFAD0, {0x22844, 0x0, 0x0}, 1},
+ {0xFAD1, {0x233D5, 0x0, 0x0}, 1},
+ {0xFAD2, {0x3B9D, 0x0, 0x0}, 1},
+ {0xFAD3, {0x4018, 0x0, 0x0}, 1},
+ {0xFAD4, {0x4039, 0x0, 0x0}, 1},
+ {0xFAD5, {0x25249, 0x0, 0x0}, 1},
+ {0xFAD6, {0x25CD0, 0x0, 0x0}, 1},
+ {0xFAD7, {0x27ED3, 0x0, 0x0}, 1},
+ {0xFAD8, {0x9F43, 0x0, 0x0}, 1},
+ {0xFAD9, {0x9F8E, 0x0, 0x0}, 1},
+ {0xFB1D, {0x5D9, 0x0, 0x0}, 1},
+ {0xFB1E, {0x0, 0x0, 0x0}, 0},
+ {0xFB1F, {0x5F2, 0x0, 0x0}, 1},
+ {0xFB2A, {0x5E9, 0x0, 0x0}, 1},
+ {0xFB2B, {0x5E9, 0x0, 0x0}, 1},
+ {0xFB2C, {0x5E9, 0x0, 0x0}, 1},
+ {0xFB2D, {0x5E9, 0x0, 0x0}, 1},
+ {0xFB2E, {0x5D0, 0x0, 0x0}, 1},
+ {0xFB2F, {0x5D0, 0x0, 0x0}, 1},
+ {0xFB30, {0x5D0, 0x0, 0x0}, 1},
+ {0xFB31, {0x5D1, 0x0, 0x0}, 1},
+ {0xFB32, {0x5D2, 0x0, 0x0}, 1},
+ {0xFB33, {0x5D3, 0x0, 0x0}, 1},
+ {0xFB34, {0x5D4, 0x0, 0x0}, 1},
+ {0xFB35, {0x5D5, 0x0, 0x0}, 1},
+ {0xFB36, {0x5D6, 0x0, 0x0}, 1},
+ {0xFB38, {0x5D8, 0x0, 0x0}, 1},
+ {0xFB39, {0x5D9, 0x0, 0x0}, 1},
+ {0xFB3A, {0x5DA, 0x0, 0x0}, 1},
+ {0xFB3B, {0x5DB, 0x0, 0x0}, 1},
+ {0xFB3C, {0x5DC, 0x0, 0x0}, 1},
+ {0xFB3E, {0x5DE, 0x0, 0x0}, 1},
+ {0xFB40, {0x5E0, 0x0, 0x0}, 1},
+ {0xFB41, {0x5E1, 0x0, 0x0}, 1},
+ {0xFB43, {0x5E3, 0x0, 0x0}, 1},
+ {0xFB44, {0x5E4, 0x0, 0x0}, 1},
+ {0xFB46, {0x5E6, 0x0, 0x0}, 1},
+ {0xFB47, {0x5E7, 0x0, 0x0}, 1},
+ {0xFB48, {0x5E8, 0x0, 0x0}, 1},
+ {0xFB49, {0x5E9, 0x0, 0x0}, 1},
+ {0xFB4A, {0x5EA, 0x0, 0x0}, 1},
+ {0xFB4B, {0x5D5, 0x0, 0x0}, 1},
+ {0xFB4C, {0x5D1, 0x0, 0x0}, 1},
+ {0xFB4D, {0x5DB, 0x0, 0x0}, 1},
+ {0xFB4E, {0x5E4, 0x0, 0x0}, 1},
+ {0xFE00, {0x0, 0x0, 0x0}, 0},
+ {0xFE01, {0x0, 0x0, 0x0}, 0},
+ {0xFE02, {0x0, 0x0, 0x0}, 0},
+ {0xFE03, {0x0, 0x0, 0x0}, 0},
+ {0xFE04, {0x0, 0x0, 0x0}, 0},
+ {0xFE05, {0x0, 0x0, 0x0}, 0},
+ {0xFE06, {0x0, 0x0, 0x0}, 0},
+ {0xFE07, {0x0, 0x0, 0x0}, 0},
+ {0xFE08, {0x0, 0x0, 0x0}, 0},
+ {0xFE09, {0x0, 0x0, 0x0}, 0},
+ {0xFE0A, {0x0, 0x0, 0x0}, 0},
+ {0xFE0B, {0x0, 0x0, 0x0}, 0},
+ {0xFE0C, {0x0, 0x0, 0x0}, 0},
+ {0xFE0D, {0x0, 0x0, 0x0}, 0},
+ {0xFE0E, {0x0, 0x0, 0x0}, 0},
+ {0xFE0F, {0x0, 0x0, 0x0}, 0},
+ {0xFE20, {0x0, 0x0, 0x0}, 0},
+ {0xFE21, {0x0, 0x0, 0x0}, 0},
+ {0xFE22, {0x0, 0x0, 0x0}, 0},
+ {0xFE23, {0x0, 0x0, 0x0}, 0},
+ {0xFE24, {0x0, 0x0, 0x0}, 0},
+ {0xFE25, {0x0, 0x0, 0x0}, 0},
+ {0xFE26, {0x0, 0x0, 0x0}, 0},
+ {0xFE27, {0x0, 0x0, 0x0}, 0},
+ {0xFE28, {0x0, 0x0, 0x0}, 0},
+ {0xFE29, {0x0, 0x0, 0x0}, 0},
+ {0xFE2A, {0x0, 0x0, 0x0}, 0},
+ {0xFE2B, {0x0, 0x0, 0x0}, 0},
+ {0xFE2C, {0x0, 0x0, 0x0}, 0},
+ {0xFE2D, {0x0, 0x0, 0x0}, 0},
+ {0xFE2E, {0x0, 0x0, 0x0}, 0},
+ {0xFE2F, {0x0, 0x0, 0x0}, 0},
+ {0xFF21, {0xFF41, 0x0, 0x0}, 1},
+ {0xFF22, {0xFF42, 0x0, 0x0}, 1},
+ {0xFF23, {0xFF43, 0x0, 0x0}, 1},
+ {0xFF24, {0xFF44, 0x0, 0x0}, 1},
+ {0xFF25, {0xFF45, 0x0, 0x0}, 1},
+ {0xFF26, {0xFF46, 0x0, 0x0}, 1},
+ {0xFF27, {0xFF47, 0x0, 0x0}, 1},
+ {0xFF28, {0xFF48, 0x0, 0x0}, 1},
+ {0xFF29, {0xFF49, 0x0, 0x0}, 1},
+ {0xFF2A, {0xFF4A, 0x0, 0x0}, 1},
+ {0xFF2B, {0xFF4B, 0x0, 0x0}, 1},
+ {0xFF2C, {0xFF4C, 0x0, 0x0}, 1},
+ {0xFF2D, {0xFF4D, 0x0, 0x0}, 1},
+ {0xFF2E, {0xFF4E, 0x0, 0x0}, 1},
+ {0xFF2F, {0xFF4F, 0x0, 0x0}, 1},
+ {0xFF30, {0xFF50, 0x0, 0x0}, 1},
+ {0xFF31, {0xFF51, 0x0, 0x0}, 1},
+ {0xFF32, {0xFF52, 0x0, 0x0}, 1},
+ {0xFF33, {0xFF53, 0x0, 0x0}, 1},
+ {0xFF34, {0xFF54, 0x0, 0x0}, 1},
+ {0xFF35, {0xFF55, 0x0, 0x0}, 1},
+ {0xFF36, {0xFF56, 0x0, 0x0}, 1},
+ {0xFF37, {0xFF57, 0x0, 0x0}, 1},
+ {0xFF38, {0xFF58, 0x0, 0x0}, 1},
+ {0xFF39, {0xFF59, 0x0, 0x0}, 1},
+ {0xFF3A, {0xFF5A, 0x0, 0x0}, 1},
+ {0x101FD, {0x0, 0x0, 0x0}, 0},
+ {0x102E0, {0x0, 0x0, 0x0}, 0},
+ {0x10376, {0x0, 0x0, 0x0}, 0},
+ {0x10377, {0x0, 0x0, 0x0}, 0},
+ {0x10378, {0x0, 0x0, 0x0}, 0},
+ {0x10379, {0x0, 0x0, 0x0}, 0},
+ {0x1037A, {0x0, 0x0, 0x0}, 0},
+ {0x10400, {0x10428, 0x0, 0x0}, 1},
+ {0x10401, {0x10429, 0x0, 0x0}, 1},
+ {0x10402, {0x1042A, 0x0, 0x0}, 1},
+ {0x10403, {0x1042B, 0x0, 0x0}, 1},
+ {0x10404, {0x1042C, 0x0, 0x0}, 1},
+ {0x10405, {0x1042D, 0x0, 0x0}, 1},
+ {0x10406, {0x1042E, 0x0, 0x0}, 1},
+ {0x10407, {0x1042F, 0x0, 0x0}, 1},
+ {0x10408, {0x10430, 0x0, 0x0}, 1},
+ {0x10409, {0x10431, 0x0, 0x0}, 1},
+ {0x1040A, {0x10432, 0x0, 0x0}, 1},
+ {0x1040B, {0x10433, 0x0, 0x0}, 1},
+ {0x1040C, {0x10434, 0x0, 0x0}, 1},
+ {0x1040D, {0x10435, 0x0, 0x0}, 1},
+ {0x1040E, {0x10436, 0x0, 0x0}, 1},
+ {0x1040F, {0x10437, 0x0, 0x0}, 1},
+ {0x10410, {0x10438, 0x0, 0x0}, 1},
+ {0x10411, {0x10439, 0x0, 0x0}, 1},
+ {0x10412, {0x1043A, 0x0, 0x0}, 1},
+ {0x10413, {0x1043B, 0x0, 0x0}, 1},
+ {0x10414, {0x1043C, 0x0, 0x0}, 1},
+ {0x10415, {0x1043D, 0x0, 0x0}, 1},
+ {0x10416, {0x1043E, 0x0, 0x0}, 1},
+ {0x10417, {0x1043F, 0x0, 0x0}, 1},
+ {0x10418, {0x10440, 0x0, 0x0}, 1},
+ {0x10419, {0x10441, 0x0, 0x0}, 1},
+ {0x1041A, {0x10442, 0x0, 0x0}, 1},
+ {0x1041B, {0x10443, 0x0, 0x0}, 1},
+ {0x1041C, {0x10444, 0x0, 0x0}, 1},
+ {0x1041D, {0x10445, 0x0, 0x0}, 1},
+ {0x1041E, {0x10446, 0x0, 0x0}, 1},
+ {0x1041F, {0x10447, 0x0, 0x0}, 1},
+ {0x10420, {0x10448, 0x0, 0x0}, 1},
+ {0x10421, {0x10449, 0x0, 0x0}, 1},
+ {0x10422, {0x1044A, 0x0, 0x0}, 1},
+ {0x10423, {0x1044B, 0x0, 0x0}, 1},
+ {0x10424, {0x1044C, 0x0, 0x0}, 1},
+ {0x10425, {0x1044D, 0x0, 0x0}, 1},
+ {0x10426, {0x1044E, 0x0, 0x0}, 1},
+ {0x10427, {0x1044F, 0x0, 0x0}, 1},
+ {0x104B0, {0x104D8, 0x0, 0x0}, 1},
+ {0x104B1, {0x104D9, 0x0, 0x0}, 1},
+ {0x104B2, {0x104DA, 0x0, 0x0}, 1},
+ {0x104B3, {0x104DB, 0x0, 0x0}, 1},
+ {0x104B4, {0x104DC, 0x0, 0x0}, 1},
+ {0x104B5, {0x104DD, 0x0, 0x0}, 1},
+ {0x104B6, {0x104DE, 0x0, 0x0}, 1},
+ {0x104B7, {0x104DF, 0x0, 0x0}, 1},
+ {0x104B8, {0x104E0, 0x0, 0x0}, 1},
+ {0x104B9, {0x104E1, 0x0, 0x0}, 1},
+ {0x104BA, {0x104E2, 0x0, 0x0}, 1},
+ {0x104BB, {0x104E3, 0x0, 0x0}, 1},
+ {0x104BC, {0x104E4, 0x0, 0x0}, 1},
+ {0x104BD, {0x104E5, 0x0, 0x0}, 1},
+ {0x104BE, {0x104E6, 0x0, 0x0}, 1},
+ {0x104BF, {0x104E7, 0x0, 0x0}, 1},
+ {0x104C0, {0x104E8, 0x0, 0x0}, 1},
+ {0x104C1, {0x104E9, 0x0, 0x0}, 1},
+ {0x104C2, {0x104EA, 0x0, 0x0}, 1},
+ {0x104C3, {0x104EB, 0x0, 0x0}, 1},
+ {0x104C4, {0x104EC, 0x0, 0x0}, 1},
+ {0x104C5, {0x104ED, 0x0, 0x0}, 1},
+ {0x104C6, {0x104EE, 0x0, 0x0}, 1},
+ {0x104C7, {0x104EF, 0x0, 0x0}, 1},
+ {0x104C8, {0x104F0, 0x0, 0x0}, 1},
+ {0x104C9, {0x104F1, 0x0, 0x0}, 1},
+ {0x104CA, {0x104F2, 0x0, 0x0}, 1},
+ {0x104CB, {0x104F3, 0x0, 0x0}, 1},
+ {0x104CC, {0x104F4, 0x0, 0x0}, 1},
+ {0x104CD, {0x104F5, 0x0, 0x0}, 1},
+ {0x104CE, {0x104F6, 0x0, 0x0}, 1},
+ {0x104CF, {0x104F7, 0x0, 0x0}, 1},
+ {0x104D0, {0x104F8, 0x0, 0x0}, 1},
+ {0x104D1, {0x104F9, 0x0, 0x0}, 1},
+ {0x104D2, {0x104FA, 0x0, 0x0}, 1},
+ {0x104D3, {0x104FB, 0x0, 0x0}, 1},
+ {0x10A01, {0x0, 0x0, 0x0}, 0},
+ {0x10A02, {0x0, 0x0, 0x0}, 0},
+ {0x10A03, {0x0, 0x0, 0x0}, 0},
+ {0x10A05, {0x0, 0x0, 0x0}, 0},
+ {0x10A06, {0x0, 0x0, 0x0}, 0},
+ {0x10A0C, {0x0, 0x0, 0x0}, 0},
+ {0x10A0D, {0x0, 0x0, 0x0}, 0},
+ {0x10A0E, {0x0, 0x0, 0x0}, 0},
+ {0x10A0F, {0x0, 0x0, 0x0}, 0},
+ {0x10A38, {0x0, 0x0, 0x0}, 0},
+ {0x10A39, {0x0, 0x0, 0x0}, 0},
+ {0x10A3A, {0x0, 0x0, 0x0}, 0},
+ {0x10A3F, {0x0, 0x0, 0x0}, 0},
+ {0x10AE5, {0x0, 0x0, 0x0}, 0},
+ {0x10AE6, {0x0, 0x0, 0x0}, 0},
+ {0x10C80, {0x10CC0, 0x0, 0x0}, 1},
+ {0x10C81, {0x10CC1, 0x0, 0x0}, 1},
+ {0x10C82, {0x10CC2, 0x0, 0x0}, 1},
+ {0x10C83, {0x10CC3, 0x0, 0x0}, 1},
+ {0x10C84, {0x10CC4, 0x0, 0x0}, 1},
+ {0x10C85, {0x10CC5, 0x0, 0x0}, 1},
+ {0x10C86, {0x10CC6, 0x0, 0x0}, 1},
+ {0x10C87, {0x10CC7, 0x0, 0x0}, 1},
+ {0x10C88, {0x10CC8, 0x0, 0x0}, 1},
+ {0x10C89, {0x10CC9, 0x0, 0x0}, 1},
+ {0x10C8A, {0x10CCA, 0x0, 0x0}, 1},
+ {0x10C8B, {0x10CCB, 0x0, 0x0}, 1},
+ {0x10C8C, {0x10CCC, 0x0, 0x0}, 1},
+ {0x10C8D, {0x10CCD, 0x0, 0x0}, 1},
+ {0x10C8E, {0x10CCE, 0x0, 0x0}, 1},
+ {0x10C8F, {0x10CCF, 0x0, 0x0}, 1},
+ {0x10C90, {0x10CD0, 0x0, 0x0}, 1},
+ {0x10C91, {0x10CD1, 0x0, 0x0}, 1},
+ {0x10C92, {0x10CD2, 0x0, 0x0}, 1},
+ {0x10C93, {0x10CD3, 0x0, 0x0}, 1},
+ {0x10C94, {0x10CD4, 0x0, 0x0}, 1},
+ {0x10C95, {0x10CD5, 0x0, 0x0}, 1},
+ {0x10C96, {0x10CD6, 0x0, 0x0}, 1},
+ {0x10C97, {0x10CD7, 0x0, 0x0}, 1},
+ {0x10C98, {0x10CD8, 0x0, 0x0}, 1},
+ {0x10C99, {0x10CD9, 0x0, 0x0}, 1},
+ {0x10C9A, {0x10CDA, 0x0, 0x0}, 1},
+ {0x10C9B, {0x10CDB, 0x0, 0x0}, 1},
+ {0x10C9C, {0x10CDC, 0x0, 0x0}, 1},
+ {0x10C9D, {0x10CDD, 0x0, 0x0}, 1},
+ {0x10C9E, {0x10CDE, 0x0, 0x0}, 1},
+ {0x10C9F, {0x10CDF, 0x0, 0x0}, 1},
+ {0x10CA0, {0x10CE0, 0x0, 0x0}, 1},
+ {0x10CA1, {0x10CE1, 0x0, 0x0}, 1},
+ {0x10CA2, {0x10CE2, 0x0, 0x0}, 1},
+ {0x10CA3, {0x10CE3, 0x0, 0x0}, 1},
+ {0x10CA4, {0x10CE4, 0x0, 0x0}, 1},
+ {0x10CA5, {0x10CE5, 0x0, 0x0}, 1},
+ {0x10CA6, {0x10CE6, 0x0, 0x0}, 1},
+ {0x10CA7, {0x10CE7, 0x0, 0x0}, 1},
+ {0x10CA8, {0x10CE8, 0x0, 0x0}, 1},
+ {0x10CA9, {0x10CE9, 0x0, 0x0}, 1},
+ {0x10CAA, {0x10CEA, 0x0, 0x0}, 1},
+ {0x10CAB, {0x10CEB, 0x0, 0x0}, 1},
+ {0x10CAC, {0x10CEC, 0x0, 0x0}, 1},
+ {0x10CAD, {0x10CED, 0x0, 0x0}, 1},
+ {0x10CAE, {0x10CEE, 0x0, 0x0}, 1},
+ {0x10CAF, {0x10CEF, 0x0, 0x0}, 1},
+ {0x10CB0, {0x10CF0, 0x0, 0x0}, 1},
+ {0x10CB1, {0x10CF1, 0x0, 0x0}, 1},
+ {0x10CB2, {0x10CF2, 0x0, 0x0}, 1},
+ {0x10D24, {0x0, 0x0, 0x0}, 0},
+ {0x10D25, {0x0, 0x0, 0x0}, 0},
+ {0x10D26, {0x0, 0x0, 0x0}, 0},
+ {0x10D27, {0x0, 0x0, 0x0}, 0},
+ {0x10EAB, {0x0, 0x0, 0x0}, 0},
+ {0x10EAC, {0x0, 0x0, 0x0}, 0},
+ {0x10F46, {0x0, 0x0, 0x0}, 0},
+ {0x10F47, {0x0, 0x0, 0x0}, 0},
+ {0x10F48, {0x0, 0x0, 0x0}, 0},
+ {0x10F49, {0x0, 0x0, 0x0}, 0},
+ {0x10F4A, {0x0, 0x0, 0x0}, 0},
+ {0x10F4B, {0x0, 0x0, 0x0}, 0},
+ {0x10F4C, {0x0, 0x0, 0x0}, 0},
+ {0x10F4D, {0x0, 0x0, 0x0}, 0},
+ {0x10F4E, {0x0, 0x0, 0x0}, 0},
+ {0x10F4F, {0x0, 0x0, 0x0}, 0},
+ {0x10F50, {0x0, 0x0, 0x0}, 0},
+ {0x11001, {0x0, 0x0, 0x0}, 0},
+ {0x11038, {0x0, 0x0, 0x0}, 0},
+ {0x11039, {0x0, 0x0, 0x0}, 0},
+ {0x1103A, {0x0, 0x0, 0x0}, 0},
+ {0x1103B, {0x0, 0x0, 0x0}, 0},
+ {0x1103C, {0x0, 0x0, 0x0}, 0},
+ {0x1103D, {0x0, 0x0, 0x0}, 0},
+ {0x1103E, {0x0, 0x0, 0x0}, 0},
+ {0x1103F, {0x0, 0x0, 0x0}, 0},
+ {0x11040, {0x0, 0x0, 0x0}, 0},
+ {0x11041, {0x0, 0x0, 0x0}, 0},
+ {0x11042, {0x0, 0x0, 0x0}, 0},
+ {0x11043, {0x0, 0x0, 0x0}, 0},
+ {0x11044, {0x0, 0x0, 0x0}, 0},
+ {0x11045, {0x0, 0x0, 0x0}, 0},
+ {0x11046, {0x0, 0x0, 0x0}, 0},
+ {0x1107F, {0x0, 0x0, 0x0}, 0},
+ {0x11080, {0x0, 0x0, 0x0}, 0},
+ {0x11081, {0x0, 0x0, 0x0}, 0},
+ {0x1109A, {0x11099, 0x0, 0x0}, 1},
+ {0x1109C, {0x1109B, 0x0, 0x0}, 1},
+ {0x110AB, {0x110A5, 0x0, 0x0}, 1},
+ {0x110B3, {0x0, 0x0, 0x0}, 0},
+ {0x110B4, {0x0, 0x0, 0x0}, 0},
+ {0x110B5, {0x0, 0x0, 0x0}, 0},
+ {0x110B6, {0x0, 0x0, 0x0}, 0},
+ {0x110B9, {0x0, 0x0, 0x0}, 0},
+ {0x110BA, {0x0, 0x0, 0x0}, 0},
+ {0x11100, {0x0, 0x0, 0x0}, 0},
+ {0x11101, {0x0, 0x0, 0x0}, 0},
+ {0x11102, {0x0, 0x0, 0x0}, 0},
+ {0x11127, {0x0, 0x0, 0x0}, 0},
+ {0x11128, {0x0, 0x0, 0x0}, 0},
+ {0x11129, {0x0, 0x0, 0x0}, 0},
+ {0x1112A, {0x0, 0x0, 0x0}, 0},
+ {0x1112B, {0x0, 0x0, 0x0}, 0},
+ {0x1112D, {0x0, 0x0, 0x0}, 0},
+ {0x1112E, {0x0, 0x0, 0x0}, 0},
+ {0x1112F, {0x0, 0x0, 0x0}, 0},
+ {0x11130, {0x0, 0x0, 0x0}, 0},
+ {0x11131, {0x0, 0x0, 0x0}, 0},
+ {0x11132, {0x0, 0x0, 0x0}, 0},
+ {0x11133, {0x0, 0x0, 0x0}, 0},
+ {0x11134, {0x0, 0x0, 0x0}, 0},
+ {0x11173, {0x0, 0x0, 0x0}, 0},
+ {0x11180, {0x0, 0x0, 0x0}, 0},
+ {0x11181, {0x0, 0x0, 0x0}, 0},
+ {0x111B6, {0x0, 0x0, 0x0}, 0},
+ {0x111B7, {0x0, 0x0, 0x0}, 0},
+ {0x111B8, {0x0, 0x0, 0x0}, 0},
+ {0x111B9, {0x0, 0x0, 0x0}, 0},
+ {0x111BA, {0x0, 0x0, 0x0}, 0},
+ {0x111BB, {0x0, 0x0, 0x0}, 0},
+ {0x111BC, {0x0, 0x0, 0x0}, 0},
+ {0x111BD, {0x0, 0x0, 0x0}, 0},
+ {0x111BE, {0x0, 0x0, 0x0}, 0},
+ {0x111C9, {0x0, 0x0, 0x0}, 0},
+ {0x111CA, {0x0, 0x0, 0x0}, 0},
+ {0x111CB, {0x0, 0x0, 0x0}, 0},
+ {0x111CC, {0x0, 0x0, 0x0}, 0},
+ {0x111CF, {0x0, 0x0, 0x0}, 0},
+ {0x1122F, {0x0, 0x0, 0x0}, 0},
+ {0x11230, {0x0, 0x0, 0x0}, 0},
+ {0x11231, {0x0, 0x0, 0x0}, 0},
+ {0x11234, {0x0, 0x0, 0x0}, 0},
+ {0x11236, {0x0, 0x0, 0x0}, 0},
+ {0x11237, {0x0, 0x0, 0x0}, 0},
+ {0x1123E, {0x0, 0x0, 0x0}, 0},
+ {0x112DF, {0x0, 0x0, 0x0}, 0},
+ {0x112E3, {0x0, 0x0, 0x0}, 0},
+ {0x112E4, {0x0, 0x0, 0x0}, 0},
+ {0x112E5, {0x0, 0x0, 0x0}, 0},
+ {0x112E6, {0x0, 0x0, 0x0}, 0},
+ {0x112E7, {0x0, 0x0, 0x0}, 0},
+ {0x112E8, {0x0, 0x0, 0x0}, 0},
+ {0x112E9, {0x0, 0x0, 0x0}, 0},
+ {0x112EA, {0x0, 0x0, 0x0}, 0},
+ {0x11300, {0x0, 0x0, 0x0}, 0},
+ {0x11301, {0x0, 0x0, 0x0}, 0},
+ {0x1133B, {0x0, 0x0, 0x0}, 0},
+ {0x1133C, {0x0, 0x0, 0x0}, 0},
+ {0x11340, {0x0, 0x0, 0x0}, 0},
+ {0x1134B, {0x11347, 0x1133E, 0x0}, 2},
+ {0x1134C, {0x11347, 0x11357, 0x0}, 2},
+ {0x11366, {0x0, 0x0, 0x0}, 0},
+ {0x11367, {0x0, 0x0, 0x0}, 0},
+ {0x11368, {0x0, 0x0, 0x0}, 0},
+ {0x11369, {0x0, 0x0, 0x0}, 0},
+ {0x1136A, {0x0, 0x0, 0x0}, 0},
+ {0x1136B, {0x0, 0x0, 0x0}, 0},
+ {0x1136C, {0x0, 0x0, 0x0}, 0},
+ {0x11370, {0x0, 0x0, 0x0}, 0},
+ {0x11371, {0x0, 0x0, 0x0}, 0},
+ {0x11372, {0x0, 0x0, 0x0}, 0},
+ {0x11373, {0x0, 0x0, 0x0}, 0},
+ {0x11374, {0x0, 0x0, 0x0}, 0},
+ {0x11438, {0x0, 0x0, 0x0}, 0},
+ {0x11439, {0x0, 0x0, 0x0}, 0},
+ {0x1143A, {0x0, 0x0, 0x0}, 0},
+ {0x1143B, {0x0, 0x0, 0x0}, 0},
+ {0x1143C, {0x0, 0x0, 0x0}, 0},
+ {0x1143D, {0x0, 0x0, 0x0}, 0},
+ {0x1143E, {0x0, 0x0, 0x0}, 0},
+ {0x1143F, {0x0, 0x0, 0x0}, 0},
+ {0x11442, {0x0, 0x0, 0x0}, 0},
+ {0x11443, {0x0, 0x0, 0x0}, 0},
+ {0x11444, {0x0, 0x0, 0x0}, 0},
+ {0x11446, {0x0, 0x0, 0x0}, 0},
+ {0x1145E, {0x0, 0x0, 0x0}, 0},
+ {0x114B3, {0x0, 0x0, 0x0}, 0},
+ {0x114B4, {0x0, 0x0, 0x0}, 0},
+ {0x114B5, {0x0, 0x0, 0x0}, 0},
+ {0x114B6, {0x0, 0x0, 0x0}, 0},
+ {0x114B7, {0x0, 0x0, 0x0}, 0},
+ {0x114B8, {0x0, 0x0, 0x0}, 0},
+ {0x114BA, {0x0, 0x0, 0x0}, 0},
+ {0x114BB, {0x114B9, 0x0, 0x0}, 1},
+ {0x114BC, {0x114B9, 0x114B0, 0x0}, 2},
+ {0x114BE, {0x114B9, 0x114BD, 0x0}, 2},
+ {0x114BF, {0x0, 0x0, 0x0}, 0},
+ {0x114C0, {0x0, 0x0, 0x0}, 0},
+ {0x114C2, {0x0, 0x0, 0x0}, 0},
+ {0x114C3, {0x0, 0x0, 0x0}, 0},
+ {0x115B2, {0x0, 0x0, 0x0}, 0},
+ {0x115B3, {0x0, 0x0, 0x0}, 0},
+ {0x115B4, {0x0, 0x0, 0x0}, 0},
+ {0x115B5, {0x0, 0x0, 0x0}, 0},
+ {0x115BA, {0x115B8, 0x115AF, 0x0}, 2},
+ {0x115BB, {0x115B9, 0x115AF, 0x0}, 2},
+ {0x115BC, {0x0, 0x0, 0x0}, 0},
+ {0x115BD, {0x0, 0x0, 0x0}, 0},
+ {0x115BF, {0x0, 0x0, 0x0}, 0},
+ {0x115C0, {0x0, 0x0, 0x0}, 0},
+ {0x115DC, {0x0, 0x0, 0x0}, 0},
+ {0x115DD, {0x0, 0x0, 0x0}, 0},
+ {0x11633, {0x0, 0x0, 0x0}, 0},
+ {0x11634, {0x0, 0x0, 0x0}, 0},
+ {0x11635, {0x0, 0x0, 0x0}, 0},
+ {0x11636, {0x0, 0x0, 0x0}, 0},
+ {0x11637, {0x0, 0x0, 0x0}, 0},
+ {0x11638, {0x0, 0x0, 0x0}, 0},
+ {0x11639, {0x0, 0x0, 0x0}, 0},
+ {0x1163A, {0x0, 0x0, 0x0}, 0},
+ {0x1163D, {0x0, 0x0, 0x0}, 0},
+ {0x1163F, {0x0, 0x0, 0x0}, 0},
+ {0x11640, {0x0, 0x0, 0x0}, 0},
+ {0x116AB, {0x0, 0x0, 0x0}, 0},
+ {0x116AD, {0x0, 0x0, 0x0}, 0},
+ {0x116B0, {0x0, 0x0, 0x0}, 0},
+ {0x116B1, {0x0, 0x0, 0x0}, 0},
+ {0x116B2, {0x0, 0x0, 0x0}, 0},
+ {0x116B3, {0x0, 0x0, 0x0}, 0},
+ {0x116B4, {0x0, 0x0, 0x0}, 0},
+ {0x116B5, {0x0, 0x0, 0x0}, 0},
+ {0x116B7, {0x0, 0x0, 0x0}, 0},
+ {0x1171D, {0x0, 0x0, 0x0}, 0},
+ {0x1171E, {0x0, 0x0, 0x0}, 0},
+ {0x1171F, {0x0, 0x0, 0x0}, 0},
+ {0x11722, {0x0, 0x0, 0x0}, 0},
+ {0x11723, {0x0, 0x0, 0x0}, 0},
+ {0x11724, {0x0, 0x0, 0x0}, 0},
+ {0x11725, {0x0, 0x0, 0x0}, 0},
+ {0x11727, {0x0, 0x0, 0x0}, 0},
+ {0x11728, {0x0, 0x0, 0x0}, 0},
+ {0x11729, {0x0, 0x0, 0x0}, 0},
+ {0x1172A, {0x0, 0x0, 0x0}, 0},
+ {0x1172B, {0x0, 0x0, 0x0}, 0},
+ {0x1182F, {0x0, 0x0, 0x0}, 0},
+ {0x11830, {0x0, 0x0, 0x0}, 0},
+ {0x11831, {0x0, 0x0, 0x0}, 0},
+ {0x11832, {0x0, 0x0, 0x0}, 0},
+ {0x11833, {0x0, 0x0, 0x0}, 0},
+ {0x11834, {0x0, 0x0, 0x0}, 0},
+ {0x11835, {0x0, 0x0, 0x0}, 0},
+ {0x11836, {0x0, 0x0, 0x0}, 0},
+ {0x11837, {0x0, 0x0, 0x0}, 0},
+ {0x11839, {0x0, 0x0, 0x0}, 0},
+ {0x1183A, {0x0, 0x0, 0x0}, 0},
+ {0x118A0, {0x118C0, 0x0, 0x0}, 1},
+ {0x118A1, {0x118C1, 0x0, 0x0}, 1},
+ {0x118A2, {0x118C2, 0x0, 0x0}, 1},
+ {0x118A3, {0x118C3, 0x0, 0x0}, 1},
+ {0x118A4, {0x118C4, 0x0, 0x0}, 1},
+ {0x118A5, {0x118C5, 0x0, 0x0}, 1},
+ {0x118A6, {0x118C6, 0x0, 0x0}, 1},
+ {0x118A7, {0x118C7, 0x0, 0x0}, 1},
+ {0x118A8, {0x118C8, 0x0, 0x0}, 1},
+ {0x118A9, {0x118C9, 0x0, 0x0}, 1},
+ {0x118AA, {0x118CA, 0x0, 0x0}, 1},
+ {0x118AB, {0x118CB, 0x0, 0x0}, 1},
+ {0x118AC, {0x118CC, 0x0, 0x0}, 1},
+ {0x118AD, {0x118CD, 0x0, 0x0}, 1},
+ {0x118AE, {0x118CE, 0x0, 0x0}, 1},
+ {0x118AF, {0x118CF, 0x0, 0x0}, 1},
+ {0x118B0, {0x118D0, 0x0, 0x0}, 1},
+ {0x118B1, {0x118D1, 0x0, 0x0}, 1},
+ {0x118B2, {0x118D2, 0x0, 0x0}, 1},
+ {0x118B3, {0x118D3, 0x0, 0x0}, 1},
+ {0x118B4, {0x118D4, 0x0, 0x0}, 1},
+ {0x118B5, {0x118D5, 0x0, 0x0}, 1},
+ {0x118B6, {0x118D6, 0x0, 0x0}, 1},
+ {0x118B7, {0x118D7, 0x0, 0x0}, 1},
+ {0x118B8, {0x118D8, 0x0, 0x0}, 1},
+ {0x118B9, {0x118D9, 0x0, 0x0}, 1},
+ {0x118BA, {0x118DA, 0x0, 0x0}, 1},
+ {0x118BB, {0x118DB, 0x0, 0x0}, 1},
+ {0x118BC, {0x118DC, 0x0, 0x0}, 1},
+ {0x118BD, {0x118DD, 0x0, 0x0}, 1},
+ {0x118BE, {0x118DE, 0x0, 0x0}, 1},
+ {0x118BF, {0x118DF, 0x0, 0x0}, 1},
+ {0x11938, {0x11935, 0x11930, 0x0}, 2},
+ {0x1193B, {0x0, 0x0, 0x0}, 0},
+ {0x1193C, {0x0, 0x0, 0x0}, 0},
+ {0x1193E, {0x0, 0x0, 0x0}, 0},
+ {0x11943, {0x0, 0x0, 0x0}, 0},
+ {0x119D4, {0x0, 0x0, 0x0}, 0},
+ {0x119D5, {0x0, 0x0, 0x0}, 0},
+ {0x119D6, {0x0, 0x0, 0x0}, 0},
+ {0x119D7, {0x0, 0x0, 0x0}, 0},
+ {0x119DA, {0x0, 0x0, 0x0}, 0},
+ {0x119DB, {0x0, 0x0, 0x0}, 0},
+ {0x119E0, {0x0, 0x0, 0x0}, 0},
+ {0x11A01, {0x0, 0x0, 0x0}, 0},
+ {0x11A02, {0x0, 0x0, 0x0}, 0},
+ {0x11A03, {0x0, 0x0, 0x0}, 0},
+ {0x11A04, {0x0, 0x0, 0x0}, 0},
+ {0x11A05, {0x0, 0x0, 0x0}, 0},
+ {0x11A06, {0x0, 0x0, 0x0}, 0},
+ {0x11A07, {0x0, 0x0, 0x0}, 0},
+ {0x11A08, {0x0, 0x0, 0x0}, 0},
+ {0x11A09, {0x0, 0x0, 0x0}, 0},
+ {0x11A0A, {0x0, 0x0, 0x0}, 0},
+ {0x11A33, {0x0, 0x0, 0x0}, 0},
+ {0x11A34, {0x0, 0x0, 0x0}, 0},
+ {0x11A35, {0x0, 0x0, 0x0}, 0},
+ {0x11A36, {0x0, 0x0, 0x0}, 0},
+ {0x11A37, {0x0, 0x0, 0x0}, 0},
+ {0x11A38, {0x0, 0x0, 0x0}, 0},
+ {0x11A3B, {0x0, 0x0, 0x0}, 0},
+ {0x11A3C, {0x0, 0x0, 0x0}, 0},
+ {0x11A3D, {0x0, 0x0, 0x0}, 0},
+ {0x11A3E, {0x0, 0x0, 0x0}, 0},
+ {0x11A47, {0x0, 0x0, 0x0}, 0},
+ {0x11A51, {0x0, 0x0, 0x0}, 0},
+ {0x11A52, {0x0, 0x0, 0x0}, 0},
+ {0x11A53, {0x0, 0x0, 0x0}, 0},
+ {0x11A54, {0x0, 0x0, 0x0}, 0},
+ {0x11A55, {0x0, 0x0, 0x0}, 0},
+ {0x11A56, {0x0, 0x0, 0x0}, 0},
+ {0x11A59, {0x0, 0x0, 0x0}, 0},
+ {0x11A5A, {0x0, 0x0, 0x0}, 0},
+ {0x11A5B, {0x0, 0x0, 0x0}, 0},
+ {0x11A8A, {0x0, 0x0, 0x0}, 0},
+ {0x11A8B, {0x0, 0x0, 0x0}, 0},
+ {0x11A8C, {0x0, 0x0, 0x0}, 0},
+ {0x11A8D, {0x0, 0x0, 0x0}, 0},
+ {0x11A8E, {0x0, 0x0, 0x0}, 0},
+ {0x11A8F, {0x0, 0x0, 0x0}, 0},
+ {0x11A90, {0x0, 0x0, 0x0}, 0},
+ {0x11A91, {0x0, 0x0, 0x0}, 0},
+ {0x11A92, {0x0, 0x0, 0x0}, 0},
+ {0x11A93, {0x0, 0x0, 0x0}, 0},
+ {0x11A94, {0x0, 0x0, 0x0}, 0},
+ {0x11A95, {0x0, 0x0, 0x0}, 0},
+ {0x11A96, {0x0, 0x0, 0x0}, 0},
+ {0x11A98, {0x0, 0x0, 0x0}, 0},
+ {0x11A99, {0x0, 0x0, 0x0}, 0},
+ {0x11C30, {0x0, 0x0, 0x0}, 0},
+ {0x11C31, {0x0, 0x0, 0x0}, 0},
+ {0x11C32, {0x0, 0x0, 0x0}, 0},
+ {0x11C33, {0x0, 0x0, 0x0}, 0},
+ {0x11C34, {0x0, 0x0, 0x0}, 0},
+ {0x11C35, {0x0, 0x0, 0x0}, 0},
+ {0x11C36, {0x0, 0x0, 0x0}, 0},
+ {0x11C38, {0x0, 0x0, 0x0}, 0},
+ {0x11C39, {0x0, 0x0, 0x0}, 0},
+ {0x11C3A, {0x0, 0x0, 0x0}, 0},
+ {0x11C3B, {0x0, 0x0, 0x0}, 0},
+ {0x11C3C, {0x0, 0x0, 0x0}, 0},
+ {0x11C3D, {0x0, 0x0, 0x0}, 0},
+ {0x11C3F, {0x0, 0x0, 0x0}, 0},
+ {0x11C92, {0x0, 0x0, 0x0}, 0},
+ {0x11C93, {0x0, 0x0, 0x0}, 0},
+ {0x11C94, {0x0, 0x0, 0x0}, 0},
+ {0x11C95, {0x0, 0x0, 0x0}, 0},
+ {0x11C96, {0x0, 0x0, 0x0}, 0},
+ {0x11C97, {0x0, 0x0, 0x0}, 0},
+ {0x11C98, {0x0, 0x0, 0x0}, 0},
+ {0x11C99, {0x0, 0x0, 0x0}, 0},
+ {0x11C9A, {0x0, 0x0, 0x0}, 0},
+ {0x11C9B, {0x0, 0x0, 0x0}, 0},
+ {0x11C9C, {0x0, 0x0, 0x0}, 0},
+ {0x11C9D, {0x0, 0x0, 0x0}, 0},
+ {0x11C9E, {0x0, 0x0, 0x0}, 0},
+ {0x11C9F, {0x0, 0x0, 0x0}, 0},
+ {0x11CA0, {0x0, 0x0, 0x0}, 0},
+ {0x11CA1, {0x0, 0x0, 0x0}, 0},
+ {0x11CA2, {0x0, 0x0, 0x0}, 0},
+ {0x11CA3, {0x0, 0x0, 0x0}, 0},
+ {0x11CA4, {0x0, 0x0, 0x0}, 0},
+ {0x11CA5, {0x0, 0x0, 0x0}, 0},
+ {0x11CA6, {0x0, 0x0, 0x0}, 0},
+ {0x11CA7, {0x0, 0x0, 0x0}, 0},
+ {0x11CAA, {0x0, 0x0, 0x0}, 0},
+ {0x11CAB, {0x0, 0x0, 0x0}, 0},
+ {0x11CAC, {0x0, 0x0, 0x0}, 0},
+ {0x11CAD, {0x0, 0x0, 0x0}, 0},
+ {0x11CAE, {0x0, 0x0, 0x0}, 0},
+ {0x11CAF, {0x0, 0x0, 0x0}, 0},
+ {0x11CB0, {0x0, 0x0, 0x0}, 0},
+ {0x11CB2, {0x0, 0x0, 0x0}, 0},
+ {0x11CB3, {0x0, 0x0, 0x0}, 0},
+ {0x11CB5, {0x0, 0x0, 0x0}, 0},
+ {0x11CB6, {0x0, 0x0, 0x0}, 0},
+ {0x11D31, {0x0, 0x0, 0x0}, 0},
+ {0x11D32, {0x0, 0x0, 0x0}, 0},
+ {0x11D33, {0x0, 0x0, 0x0}, 0},
+ {0x11D34, {0x0, 0x0, 0x0}, 0},
+ {0x11D35, {0x0, 0x0, 0x0}, 0},
+ {0x11D36, {0x0, 0x0, 0x0}, 0},
+ {0x11D3A, {0x0, 0x0, 0x0}, 0},
+ {0x11D3C, {0x0, 0x0, 0x0}, 0},
+ {0x11D3D, {0x0, 0x0, 0x0}, 0},
+ {0x11D3F, {0x0, 0x0, 0x0}, 0},
+ {0x11D40, {0x0, 0x0, 0x0}, 0},
+ {0x11D41, {0x0, 0x0, 0x0}, 0},
+ {0x11D42, {0x0, 0x0, 0x0}, 0},
+ {0x11D43, {0x0, 0x0, 0x0}, 0},
+ {0x11D44, {0x0, 0x0, 0x0}, 0},
+ {0x11D45, {0x0, 0x0, 0x0}, 0},
+ {0x11D47, {0x0, 0x0, 0x0}, 0},
+ {0x11D90, {0x0, 0x0, 0x0}, 0},
+ {0x11D91, {0x0, 0x0, 0x0}, 0},
+ {0x11D95, {0x0, 0x0, 0x0}, 0},
+ {0x11D97, {0x0, 0x0, 0x0}, 0},
+ {0x11EF3, {0x0, 0x0, 0x0}, 0},
+ {0x11EF4, {0x0, 0x0, 0x0}, 0},
+ {0x16AF0, {0x0, 0x0, 0x0}, 0},
+ {0x16AF1, {0x0, 0x0, 0x0}, 0},
+ {0x16AF2, {0x0, 0x0, 0x0}, 0},
+ {0x16AF3, {0x0, 0x0, 0x0}, 0},
+ {0x16AF4, {0x0, 0x0, 0x0}, 0},
+ {0x16B30, {0x0, 0x0, 0x0}, 0},
+ {0x16B31, {0x0, 0x0, 0x0}, 0},
+ {0x16B32, {0x0, 0x0, 0x0}, 0},
+ {0x16B33, {0x0, 0x0, 0x0}, 0},
+ {0x16B34, {0x0, 0x0, 0x0}, 0},
+ {0x16B35, {0x0, 0x0, 0x0}, 0},
+ {0x16B36, {0x0, 0x0, 0x0}, 0},
+ {0x16E40, {0x16E60, 0x0, 0x0}, 1},
+ {0x16E41, {0x16E61, 0x0, 0x0}, 1},
+ {0x16E42, {0x16E62, 0x0, 0x0}, 1},
+ {0x16E43, {0x16E63, 0x0, 0x0}, 1},
+ {0x16E44, {0x16E64, 0x0, 0x0}, 1},
+ {0x16E45, {0x16E65, 0x0, 0x0}, 1},
+ {0x16E46, {0x16E66, 0x0, 0x0}, 1},
+ {0x16E47, {0x16E67, 0x0, 0x0}, 1},
+ {0x16E48, {0x16E68, 0x0, 0x0}, 1},
+ {0x16E49, {0x16E69, 0x0, 0x0}, 1},
+ {0x16E4A, {0x16E6A, 0x0, 0x0}, 1},
+ {0x16E4B, {0x16E6B, 0x0, 0x0}, 1},
+ {0x16E4C, {0x16E6C, 0x0, 0x0}, 1},
+ {0x16E4D, {0x16E6D, 0x0, 0x0}, 1},
+ {0x16E4E, {0x16E6E, 0x0, 0x0}, 1},
+ {0x16E4F, {0x16E6F, 0x0, 0x0}, 1},
+ {0x16E50, {0x16E70, 0x0, 0x0}, 1},
+ {0x16E51, {0x16E71, 0x0, 0x0}, 1},
+ {0x16E52, {0x16E72, 0x0, 0x0}, 1},
+ {0x16E53, {0x16E73, 0x0, 0x0}, 1},
+ {0x16E54, {0x16E74, 0x0, 0x0}, 1},
+ {0x16E55, {0x16E75, 0x0, 0x0}, 1},
+ {0x16E56, {0x16E76, 0x0, 0x0}, 1},
+ {0x16E57, {0x16E77, 0x0, 0x0}, 1},
+ {0x16E58, {0x16E78, 0x0, 0x0}, 1},
+ {0x16E59, {0x16E79, 0x0, 0x0}, 1},
+ {0x16E5A, {0x16E7A, 0x0, 0x0}, 1},
+ {0x16E5B, {0x16E7B, 0x0, 0x0}, 1},
+ {0x16E5C, {0x16E7C, 0x0, 0x0}, 1},
+ {0x16E5D, {0x16E7D, 0x0, 0x0}, 1},
+ {0x16E5E, {0x16E7E, 0x0, 0x0}, 1},
+ {0x16E5F, {0x16E7F, 0x0, 0x0}, 1},
+ {0x16F4F, {0x0, 0x0, 0x0}, 0},
+ {0x16F8F, {0x0, 0x0, 0x0}, 0},
+ {0x16F90, {0x0, 0x0, 0x0}, 0},
+ {0x16F91, {0x0, 0x0, 0x0}, 0},
+ {0x16F92, {0x0, 0x0, 0x0}, 0},
+ {0x16FE4, {0x0, 0x0, 0x0}, 0},
+ {0x1BC9D, {0x0, 0x0, 0x0}, 0},
+ {0x1BC9E, {0x0, 0x0, 0x0}, 0},
+ {0x1D15E, {0x1D157, 0x1D165, 0x0}, 2},
+ {0x1D15F, {0x1D158, 0x1D165, 0x0}, 2},
+ {0x1D160, {0x1D158, 0x1D165, 0x1D16E}, 3},
+ {0x1D161, {0x1D158, 0x1D165, 0x1D16F}, 3},
+ {0x1D162, {0x1D158, 0x1D165, 0x1D170}, 3},
+ {0x1D163, {0x1D158, 0x1D165, 0x1D171}, 3},
+ {0x1D164, {0x1D158, 0x1D165, 0x1D172}, 3},
+ {0x1D167, {0x0, 0x0, 0x0}, 0},
+ {0x1D168, {0x0, 0x0, 0x0}, 0},
+ {0x1D169, {0x0, 0x0, 0x0}, 0},
+ {0x1D17B, {0x0, 0x0, 0x0}, 0},
+ {0x1D17C, {0x0, 0x0, 0x0}, 0},
+ {0x1D17D, {0x0, 0x0, 0x0}, 0},
+ {0x1D17E, {0x0, 0x0, 0x0}, 0},
+ {0x1D17F, {0x0, 0x0, 0x0}, 0},
+ {0x1D180, {0x0, 0x0, 0x0}, 0},
+ {0x1D181, {0x0, 0x0, 0x0}, 0},
+ {0x1D182, {0x0, 0x0, 0x0}, 0},
+ {0x1D185, {0x0, 0x0, 0x0}, 0},
+ {0x1D186, {0x0, 0x0, 0x0}, 0},
+ {0x1D187, {0x0, 0x0, 0x0}, 0},
+ {0x1D188, {0x0, 0x0, 0x0}, 0},
+ {0x1D189, {0x0, 0x0, 0x0}, 0},
+ {0x1D18A, {0x0, 0x0, 0x0}, 0},
+ {0x1D18B, {0x0, 0x0, 0x0}, 0},
+ {0x1D1AA, {0x0, 0x0, 0x0}, 0},
+ {0x1D1AB, {0x0, 0x0, 0x0}, 0},
+ {0x1D1AC, {0x0, 0x0, 0x0}, 0},
+ {0x1D1AD, {0x0, 0x0, 0x0}, 0},
+ {0x1D1BB, {0x1D1B9, 0x1D165, 0x0}, 2},
+ {0x1D1BC, {0x1D1BA, 0x1D165, 0x0}, 2},
+ {0x1D1BD, {0x1D1B9, 0x1D165, 0x1D16E}, 3},
+ {0x1D1BE, {0x1D1BA, 0x1D165, 0x1D16E}, 3},
+ {0x1D1BF, {0x1D1B9, 0x1D165, 0x1D16F}, 3},
+ {0x1D1C0, {0x1D1BA, 0x1D165, 0x1D16F}, 3},
+ {0x1D242, {0x0, 0x0, 0x0}, 0},
+ {0x1D243, {0x0, 0x0, 0x0}, 0},
+ {0x1D244, {0x0, 0x0, 0x0}, 0},
+ {0x1DA00, {0x0, 0x0, 0x0}, 0},
+ {0x1DA01, {0x0, 0x0, 0x0}, 0},
+ {0x1DA02, {0x0, 0x0, 0x0}, 0},
+ {0x1DA03, {0x0, 0x0, 0x0}, 0},
+ {0x1DA04, {0x0, 0x0, 0x0}, 0},
+ {0x1DA05, {0x0, 0x0, 0x0}, 0},
+ {0x1DA06, {0x0, 0x0, 0x0}, 0},
+ {0x1DA07, {0x0, 0x0, 0x0}, 0},
+ {0x1DA08, {0x0, 0x0, 0x0}, 0},
+ {0x1DA09, {0x0, 0x0, 0x0}, 0},
+ {0x1DA0A, {0x0, 0x0, 0x0}, 0},
+ {0x1DA0B, {0x0, 0x0, 0x0}, 0},
+ {0x1DA0C, {0x0, 0x0, 0x0}, 0},
+ {0x1DA0D, {0x0, 0x0, 0x0}, 0},
+ {0x1DA0E, {0x0, 0x0, 0x0}, 0},
+ {0x1DA0F, {0x0, 0x0, 0x0}, 0},
+ {0x1DA10, {0x0, 0x0, 0x0}, 0},
+ {0x1DA11, {0x0, 0x0, 0x0}, 0},
+ {0x1DA12, {0x0, 0x0, 0x0}, 0},
+ {0x1DA13, {0x0, 0x0, 0x0}, 0},
+ {0x1DA14, {0x0, 0x0, 0x0}, 0},
+ {0x1DA15, {0x0, 0x0, 0x0}, 0},
+ {0x1DA16, {0x0, 0x0, 0x0}, 0},
+ {0x1DA17, {0x0, 0x0, 0x0}, 0},
+ {0x1DA18, {0x0, 0x0, 0x0}, 0},
+ {0x1DA19, {0x0, 0x0, 0x0}, 0},
+ {0x1DA1A, {0x0, 0x0, 0x0}, 0},
+ {0x1DA1B, {0x0, 0x0, 0x0}, 0},
+ {0x1DA1C, {0x0, 0x0, 0x0}, 0},
+ {0x1DA1D, {0x0, 0x0, 0x0}, 0},
+ {0x1DA1E, {0x0, 0x0, 0x0}, 0},
+ {0x1DA1F, {0x0, 0x0, 0x0}, 0},
+ {0x1DA20, {0x0, 0x0, 0x0}, 0},
+ {0x1DA21, {0x0, 0x0, 0x0}, 0},
+ {0x1DA22, {0x0, 0x0, 0x0}, 0},
+ {0x1DA23, {0x0, 0x0, 0x0}, 0},
+ {0x1DA24, {0x0, 0x0, 0x0}, 0},
+ {0x1DA25, {0x0, 0x0, 0x0}, 0},
+ {0x1DA26, {0x0, 0x0, 0x0}, 0},
+ {0x1DA27, {0x0, 0x0, 0x0}, 0},
+ {0x1DA28, {0x0, 0x0, 0x0}, 0},
+ {0x1DA29, {0x0, 0x0, 0x0}, 0},
+ {0x1DA2A, {0x0, 0x0, 0x0}, 0},
+ {0x1DA2B, {0x0, 0x0, 0x0}, 0},
+ {0x1DA2C, {0x0, 0x0, 0x0}, 0},
+ {0x1DA2D, {0x0, 0x0, 0x0}, 0},
+ {0x1DA2E, {0x0, 0x0, 0x0}, 0},
+ {0x1DA2F, {0x0, 0x0, 0x0}, 0},
+ {0x1DA30, {0x0, 0x0, 0x0}, 0},
+ {0x1DA31, {0x0, 0x0, 0x0}, 0},
+ {0x1DA32, {0x0, 0x0, 0x0}, 0},
+ {0x1DA33, {0x0, 0x0, 0x0}, 0},
+ {0x1DA34, {0x0, 0x0, 0x0}, 0},
+ {0x1DA35, {0x0, 0x0, 0x0}, 0},
+ {0x1DA36, {0x0, 0x0, 0x0}, 0},
+ {0x1DA3B, {0x0, 0x0, 0x0}, 0},
+ {0x1DA3C, {0x0, 0x0, 0x0}, 0},
+ {0x1DA3D, {0x0, 0x0, 0x0}, 0},
+ {0x1DA3E, {0x0, 0x0, 0x0}, 0},
+ {0x1DA3F, {0x0, 0x0, 0x0}, 0},
+ {0x1DA40, {0x0, 0x0, 0x0}, 0},
+ {0x1DA41, {0x0, 0x0, 0x0}, 0},
+ {0x1DA42, {0x0, 0x0, 0x0}, 0},
+ {0x1DA43, {0x0, 0x0, 0x0}, 0},
+ {0x1DA44, {0x0, 0x0, 0x0}, 0},
+ {0x1DA45, {0x0, 0x0, 0x0}, 0},
+ {0x1DA46, {0x0, 0x0, 0x0}, 0},
+ {0x1DA47, {0x0, 0x0, 0x0}, 0},
+ {0x1DA48, {0x0, 0x0, 0x0}, 0},
+ {0x1DA49, {0x0, 0x0, 0x0}, 0},
+ {0x1DA4A, {0x0, 0x0, 0x0}, 0},
+ {0x1DA4B, {0x0, 0x0, 0x0}, 0},
+ {0x1DA4C, {0x0, 0x0, 0x0}, 0},
+ {0x1DA4D, {0x0, 0x0, 0x0}, 0},
+ {0x1DA4E, {0x0, 0x0, 0x0}, 0},
+ {0x1DA4F, {0x0, 0x0, 0x0}, 0},
+ {0x1DA50, {0x0, 0x0, 0x0}, 0},
+ {0x1DA51, {0x0, 0x0, 0x0}, 0},
+ {0x1DA52, {0x0, 0x0, 0x0}, 0},
+ {0x1DA53, {0x0, 0x0, 0x0}, 0},
+ {0x1DA54, {0x0, 0x0, 0x0}, 0},
+ {0x1DA55, {0x0, 0x0, 0x0}, 0},
+ {0x1DA56, {0x0, 0x0, 0x0}, 0},
+ {0x1DA57, {0x0, 0x0, 0x0}, 0},
+ {0x1DA58, {0x0, 0x0, 0x0}, 0},
+ {0x1DA59, {0x0, 0x0, 0x0}, 0},
+ {0x1DA5A, {0x0, 0x0, 0x0}, 0},
+ {0x1DA5B, {0x0, 0x0, 0x0}, 0},
+ {0x1DA5C, {0x0, 0x0, 0x0}, 0},
+ {0x1DA5D, {0x0, 0x0, 0x0}, 0},
+ {0x1DA5E, {0x0, 0x0, 0x0}, 0},
+ {0x1DA5F, {0x0, 0x0, 0x0}, 0},
+ {0x1DA60, {0x0, 0x0, 0x0}, 0},
+ {0x1DA61, {0x0, 0x0, 0x0}, 0},
+ {0x1DA62, {0x0, 0x0, 0x0}, 0},
+ {0x1DA63, {0x0, 0x0, 0x0}, 0},
+ {0x1DA64, {0x0, 0x0, 0x0}, 0},
+ {0x1DA65, {0x0, 0x0, 0x0}, 0},
+ {0x1DA66, {0x0, 0x0, 0x0}, 0},
+ {0x1DA67, {0x0, 0x0, 0x0}, 0},
+ {0x1DA68, {0x0, 0x0, 0x0}, 0},
+ {0x1DA69, {0x0, 0x0, 0x0}, 0},
+ {0x1DA6A, {0x0, 0x0, 0x0}, 0},
+ {0x1DA6B, {0x0, 0x0, 0x0}, 0},
+ {0x1DA6C, {0x0, 0x0, 0x0}, 0},
+ {0x1DA75, {0x0, 0x0, 0x0}, 0},
+ {0x1DA84, {0x0, 0x0, 0x0}, 0},
+ {0x1DA9B, {0x0, 0x0, 0x0}, 0},
+ {0x1DA9C, {0x0, 0x0, 0x0}, 0},
+ {0x1DA9D, {0x0, 0x0, 0x0}, 0},
+ {0x1DA9E, {0x0, 0x0, 0x0}, 0},
+ {0x1DA9F, {0x0, 0x0, 0x0}, 0},
+ {0x1DAA1, {0x0, 0x0, 0x0}, 0},
+ {0x1DAA2, {0x0, 0x0, 0x0}, 0},
+ {0x1DAA3, {0x0, 0x0, 0x0}, 0},
+ {0x1DAA4, {0x0, 0x0, 0x0}, 0},
+ {0x1DAA5, {0x0, 0x0, 0x0}, 0},
+ {0x1DAA6, {0x0, 0x0, 0x0}, 0},
+ {0x1DAA7, {0x0, 0x0, 0x0}, 0},
+ {0x1DAA8, {0x0, 0x0, 0x0}, 0},
+ {0x1DAA9, {0x0, 0x0, 0x0}, 0},
+ {0x1DAAA, {0x0, 0x0, 0x0}, 0},
+ {0x1DAAB, {0x0, 0x0, 0x0}, 0},
+ {0x1DAAC, {0x0, 0x0, 0x0}, 0},
+ {0x1DAAD, {0x0, 0x0, 0x0}, 0},
+ {0x1DAAE, {0x0, 0x0, 0x0}, 0},
+ {0x1DAAF, {0x0, 0x0, 0x0}, 0},
+ {0x1E000, {0x0, 0x0, 0x0}, 0},
+ {0x1E001, {0x0, 0x0, 0x0}, 0},
+ {0x1E002, {0x0, 0x0, 0x0}, 0},
+ {0x1E003, {0x0, 0x0, 0x0}, 0},
+ {0x1E004, {0x0, 0x0, 0x0}, 0},
+ {0x1E005, {0x0, 0x0, 0x0}, 0},
+ {0x1E006, {0x0, 0x0, 0x0}, 0},
+ {0x1E008, {0x0, 0x0, 0x0}, 0},
+ {0x1E009, {0x0, 0x0, 0x0}, 0},
+ {0x1E00A, {0x0, 0x0, 0x0}, 0},
+ {0x1E00B, {0x0, 0x0, 0x0}, 0},
+ {0x1E00C, {0x0, 0x0, 0x0}, 0},
+ {0x1E00D, {0x0, 0x0, 0x0}, 0},
+ {0x1E00E, {0x0, 0x0, 0x0}, 0},
+ {0x1E00F, {0x0, 0x0, 0x0}, 0},
+ {0x1E010, {0x0, 0x0, 0x0}, 0},
+ {0x1E011, {0x0, 0x0, 0x0}, 0},
+ {0x1E012, {0x0, 0x0, 0x0}, 0},
+ {0x1E013, {0x0, 0x0, 0x0}, 0},
+ {0x1E014, {0x0, 0x0, 0x0}, 0},
+ {0x1E015, {0x0, 0x0, 0x0}, 0},
+ {0x1E016, {0x0, 0x0, 0x0}, 0},
+ {0x1E017, {0x0, 0x0, 0x0}, 0},
+ {0x1E018, {0x0, 0x0, 0x0}, 0},
+ {0x1E01B, {0x0, 0x0, 0x0}, 0},
+ {0x1E01C, {0x0, 0x0, 0x0}, 0},
+ {0x1E01D, {0x0, 0x0, 0x0}, 0},
+ {0x1E01E, {0x0, 0x0, 0x0}, 0},
+ {0x1E01F, {0x0, 0x0, 0x0}, 0},
+ {0x1E020, {0x0, 0x0, 0x0}, 0},
+ {0x1E021, {0x0, 0x0, 0x0}, 0},
+ {0x1E023, {0x0, 0x0, 0x0}, 0},
+ {0x1E024, {0x0, 0x0, 0x0}, 0},
+ {0x1E026, {0x0, 0x0, 0x0}, 0},
+ {0x1E027, {0x0, 0x0, 0x0}, 0},
+ {0x1E028, {0x0, 0x0, 0x0}, 0},
+ {0x1E029, {0x0, 0x0, 0x0}, 0},
+ {0x1E02A, {0x0, 0x0, 0x0}, 0},
+ {0x1E130, {0x0, 0x0, 0x0}, 0},
+ {0x1E131, {0x0, 0x0, 0x0}, 0},
+ {0x1E132, {0x0, 0x0, 0x0}, 0},
+ {0x1E133, {0x0, 0x0, 0x0}, 0},
+ {0x1E134, {0x0, 0x0, 0x0}, 0},
+ {0x1E135, {0x0, 0x0, 0x0}, 0},
+ {0x1E136, {0x0, 0x0, 0x0}, 0},
+ {0x1E2EC, {0x0, 0x0, 0x0}, 0},
+ {0x1E2ED, {0x0, 0x0, 0x0}, 0},
+ {0x1E2EE, {0x0, 0x0, 0x0}, 0},
+ {0x1E2EF, {0x0, 0x0, 0x0}, 0},
+ {0x1E8D0, {0x0, 0x0, 0x0}, 0},
+ {0x1E8D1, {0x0, 0x0, 0x0}, 0},
+ {0x1E8D2, {0x0, 0x0, 0x0}, 0},
+ {0x1E8D3, {0x0, 0x0, 0x0}, 0},
+ {0x1E8D4, {0x0, 0x0, 0x0}, 0},
+ {0x1E8D5, {0x0, 0x0, 0x0}, 0},
+ {0x1E8D6, {0x0, 0x0, 0x0}, 0},
+ {0x1E900, {0x1E922, 0x0, 0x0}, 1},
+ {0x1E901, {0x1E923, 0x0, 0x0}, 1},
+ {0x1E902, {0x1E924, 0x0, 0x0}, 1},
+ {0x1E903, {0x1E925, 0x0, 0x0}, 1},
+ {0x1E904, {0x1E926, 0x0, 0x0}, 1},
+ {0x1E905, {0x1E927, 0x0, 0x0}, 1},
+ {0x1E906, {0x1E928, 0x0, 0x0}, 1},
+ {0x1E907, {0x1E929, 0x0, 0x0}, 1},
+ {0x1E908, {0x1E92A, 0x0, 0x0}, 1},
+ {0x1E909, {0x1E92B, 0x0, 0x0}, 1},
+ {0x1E90A, {0x1E92C, 0x0, 0x0}, 1},
+ {0x1E90B, {0x1E92D, 0x0, 0x0}, 1},
+ {0x1E90C, {0x1E92E, 0x0, 0x0}, 1},
+ {0x1E90D, {0x1E92F, 0x0, 0x0}, 1},
+ {0x1E90E, {0x1E930, 0x0, 0x0}, 1},
+ {0x1E90F, {0x1E931, 0x0, 0x0}, 1},
+ {0x1E910, {0x1E932, 0x0, 0x0}, 1},
+ {0x1E911, {0x1E933, 0x0, 0x0}, 1},
+ {0x1E912, {0x1E934, 0x0, 0x0}, 1},
+ {0x1E913, {0x1E935, 0x0, 0x0}, 1},
+ {0x1E914, {0x1E936, 0x0, 0x0}, 1},
+ {0x1E915, {0x1E937, 0x0, 0x0}, 1},
+ {0x1E916, {0x1E938, 0x0, 0x0}, 1},
+ {0x1E917, {0x1E939, 0x0, 0x0}, 1},
+ {0x1E918, {0x1E93A, 0x0, 0x0}, 1},
+ {0x1E919, {0x1E93B, 0x0, 0x0}, 1},
+ {0x1E91A, {0x1E93C, 0x0, 0x0}, 1},
+ {0x1E91B, {0x1E93D, 0x0, 0x0}, 1},
+ {0x1E91C, {0x1E93E, 0x0, 0x0}, 1},
+ {0x1E91D, {0x1E93F, 0x0, 0x0}, 1},
+ {0x1E91E, {0x1E940, 0x0, 0x0}, 1},
+ {0x1E91F, {0x1E941, 0x0, 0x0}, 1},
+ {0x1E920, {0x1E942, 0x0, 0x0}, 1},
+ {0x1E921, {0x1E943, 0x0, 0x0}, 1},
+ {0x1E944, {0x0, 0x0, 0x0}, 0},
+ {0x1E945, {0x0, 0x0, 0x0}, 0},
+ {0x1E946, {0x0, 0x0, 0x0}, 0},
+ {0x1E947, {0x0, 0x0, 0x0}, 0},
+ {0x1E948, {0x0, 0x0, 0x0}, 0},
+ {0x1E949, {0x0, 0x0, 0x0}, 0},
+ {0x1E94A, {0x0, 0x0, 0x0}, 0},
+ {0x2F800, {0x4E3D, 0x0, 0x0}, 1},
+ {0x2F801, {0x4E38, 0x0, 0x0}, 1},
+ {0x2F802, {0x4E41, 0x0, 0x0}, 1},
+ {0x2F803, {0x20122, 0x0, 0x0}, 1},
+ {0x2F804, {0x4F60, 0x0, 0x0}, 1},
+ {0x2F805, {0x4FAE, 0x0, 0x0}, 1},
+ {0x2F806, {0x4FBB, 0x0, 0x0}, 1},
+ {0x2F807, {0x5002, 0x0, 0x0}, 1},
+ {0x2F808, {0x507A, 0x0, 0x0}, 1},
+ {0x2F809, {0x5099, 0x0, 0x0}, 1},
+ {0x2F80A, {0x50E7, 0x0, 0x0}, 1},
+ {0x2F80B, {0x50CF, 0x0, 0x0}, 1},
+ {0x2F80C, {0x349E, 0x0, 0x0}, 1},
+ {0x2F80D, {0x2063A, 0x0, 0x0}, 1},
+ {0x2F80E, {0x514D, 0x0, 0x0}, 1},
+ {0x2F80F, {0x5154, 0x0, 0x0}, 1},
+ {0x2F810, {0x5164, 0x0, 0x0}, 1},
+ {0x2F811, {0x5177, 0x0, 0x0}, 1},
+ {0x2F812, {0x2051C, 0x0, 0x0}, 1},
+ {0x2F813, {0x34B9, 0x0, 0x0}, 1},
+ {0x2F814, {0x5167, 0x0, 0x0}, 1},
+ {0x2F815, {0x518D, 0x0, 0x0}, 1},
+ {0x2F816, {0x2054B, 0x0, 0x0}, 1},
+ {0x2F817, {0x5197, 0x0, 0x0}, 1},
+ {0x2F818, {0x51A4, 0x0, 0x0}, 1},
+ {0x2F819, {0x4ECC, 0x0, 0x0}, 1},
+ {0x2F81A, {0x51AC, 0x0, 0x0}, 1},
+ {0x2F81B, {0x51B5, 0x0, 0x0}, 1},
+ {0x2F81C, {0x291DF, 0x0, 0x0}, 1},
+ {0x2F81D, {0x51F5, 0x0, 0x0}, 1},
+ {0x2F81E, {0x5203, 0x0, 0x0}, 1},
+ {0x2F81F, {0x34DF, 0x0, 0x0}, 1},
+ {0x2F820, {0x523B, 0x0, 0x0}, 1},
+ {0x2F821, {0x5246, 0x0, 0x0}, 1},
+ {0x2F822, {0x5272, 0x0, 0x0}, 1},
+ {0x2F823, {0x5277, 0x0, 0x0}, 1},
+ {0x2F824, {0x3515, 0x0, 0x0}, 1},
+ {0x2F825, {0x52C7, 0x0, 0x0}, 1},
+ {0x2F826, {0x52C9, 0x0, 0x0}, 1},
+ {0x2F827, {0x52E4, 0x0, 0x0}, 1},
+ {0x2F828, {0x52FA, 0x0, 0x0}, 1},
+ {0x2F829, {0x5305, 0x0, 0x0}, 1},
+ {0x2F82A, {0x5306, 0x0, 0x0}, 1},
+ {0x2F82B, {0x5317, 0x0, 0x0}, 1},
+ {0x2F82C, {0x5349, 0x0, 0x0}, 1},
+ {0x2F82D, {0x5351, 0x0, 0x0}, 1},
+ {0x2F82E, {0x535A, 0x0, 0x0}, 1},
+ {0x2F82F, {0x5373, 0x0, 0x0}, 1},
+ {0x2F830, {0x537D, 0x0, 0x0}, 1},
+ {0x2F831, {0x537F, 0x0, 0x0}, 1},
+ {0x2F832, {0x537F, 0x0, 0x0}, 1},
+ {0x2F833, {0x537F, 0x0, 0x0}, 1},
+ {0x2F834, {0x20A2C, 0x0, 0x0}, 1},
+ {0x2F835, {0x7070, 0x0, 0x0}, 1},
+ {0x2F836, {0x53CA, 0x0, 0x0}, 1},
+ {0x2F837, {0x53DF, 0x0, 0x0}, 1},
+ {0x2F838, {0x20B63, 0x0, 0x0}, 1},
+ {0x2F839, {0x53EB, 0x0, 0x0}, 1},
+ {0x2F83A, {0x53F1, 0x0, 0x0}, 1},
+ {0x2F83B, {0x5406, 0x0, 0x0}, 1},
+ {0x2F83C, {0x549E, 0x0, 0x0}, 1},
+ {0x2F83D, {0x5438, 0x0, 0x0}, 1},
+ {0x2F83E, {0x5448, 0x0, 0x0}, 1},
+ {0x2F83F, {0x5468, 0x0, 0x0}, 1},
+ {0x2F840, {0x54A2, 0x0, 0x0}, 1},
+ {0x2F841, {0x54F6, 0x0, 0x0}, 1},
+ {0x2F842, {0x5510, 0x0, 0x0}, 1},
+ {0x2F843, {0x5553, 0x0, 0x0}, 1},
+ {0x2F844, {0x5563, 0x0, 0x0}, 1},
+ {0x2F845, {0x5584, 0x0, 0x0}, 1},
+ {0x2F846, {0x5584, 0x0, 0x0}, 1},
+ {0x2F847, {0x5599, 0x0, 0x0}, 1},
+ {0x2F848, {0x55AB, 0x0, 0x0}, 1},
+ {0x2F849, {0x55B3, 0x0, 0x0}, 1},
+ {0x2F84A, {0x55C2, 0x0, 0x0}, 1},
+ {0x2F84B, {0x5716, 0x0, 0x0}, 1},
+ {0x2F84C, {0x5606, 0x0, 0x0}, 1},
+ {0x2F84D, {0x5717, 0x0, 0x0}, 1},
+ {0x2F84E, {0x5651, 0x0, 0x0}, 1},
+ {0x2F84F, {0x5674, 0x0, 0x0}, 1},
+ {0x2F850, {0x5207, 0x0, 0x0}, 1},
+ {0x2F851, {0x58EE, 0x0, 0x0}, 1},
+ {0x2F852, {0x57CE, 0x0, 0x0}, 1},
+ {0x2F853, {0x57F4, 0x0, 0x0}, 1},
+ {0x2F854, {0x580D, 0x0, 0x0}, 1},
+ {0x2F855, {0x578B, 0x0, 0x0}, 1},
+ {0x2F856, {0x5832, 0x0, 0x0}, 1},
+ {0x2F857, {0x5831, 0x0, 0x0}, 1},
+ {0x2F858, {0x58AC, 0x0, 0x0}, 1},
+ {0x2F859, {0x214E4, 0x0, 0x0}, 1},
+ {0x2F85A, {0x58F2, 0x0, 0x0}, 1},
+ {0x2F85B, {0x58F7, 0x0, 0x0}, 1},
+ {0x2F85C, {0x5906, 0x0, 0x0}, 1},
+ {0x2F85D, {0x591A, 0x0, 0x0}, 1},
+ {0x2F85E, {0x5922, 0x0, 0x0}, 1},
+ {0x2F85F, {0x5962, 0x0, 0x0}, 1},
+ {0x2F860, {0x216A8, 0x0, 0x0}, 1},
+ {0x2F861, {0x216EA, 0x0, 0x0}, 1},
+ {0x2F862, {0x59EC, 0x0, 0x0}, 1},
+ {0x2F863, {0x5A1B, 0x0, 0x0}, 1},
+ {0x2F864, {0x5A27, 0x0, 0x0}, 1},
+ {0x2F865, {0x59D8, 0x0, 0x0}, 1},
+ {0x2F866, {0x5A66, 0x0, 0x0}, 1},
+ {0x2F867, {0x36EE, 0x0, 0x0}, 1},
+ {0x2F868, {0x36FC, 0x0, 0x0}, 1},
+ {0x2F869, {0x5B08, 0x0, 0x0}, 1},
+ {0x2F86A, {0x5B3E, 0x0, 0x0}, 1},
+ {0x2F86B, {0x5B3E, 0x0, 0x0}, 1},
+ {0x2F86C, {0x219C8, 0x0, 0x0}, 1},
+ {0x2F86D, {0x5BC3, 0x0, 0x0}, 1},
+ {0x2F86E, {0x5BD8, 0x0, 0x0}, 1},
+ {0x2F86F, {0x5BE7, 0x0, 0x0}, 1},
+ {0x2F870, {0x5BF3, 0x0, 0x0}, 1},
+ {0x2F871, {0x21B18, 0x0, 0x0}, 1},
+ {0x2F872, {0x5BFF, 0x0, 0x0}, 1},
+ {0x2F873, {0x5C06, 0x0, 0x0}, 1},
+ {0x2F874, {0x5F53, 0x0, 0x0}, 1},
+ {0x2F875, {0x5C22, 0x0, 0x0}, 1},
+ {0x2F876, {0x3781, 0x0, 0x0}, 1},
+ {0x2F877, {0x5C60, 0x0, 0x0}, 1},
+ {0x2F878, {0x5C6E, 0x0, 0x0}, 1},
+ {0x2F879, {0x5CC0, 0x0, 0x0}, 1},
+ {0x2F87A, {0x5C8D, 0x0, 0x0}, 1},
+ {0x2F87B, {0x21DE4, 0x0, 0x0}, 1},
+ {0x2F87C, {0x5D43, 0x0, 0x0}, 1},
+ {0x2F87D, {0x21DE6, 0x0, 0x0}, 1},
+ {0x2F87E, {0x5D6E, 0x0, 0x0}, 1},
+ {0x2F87F, {0x5D6B, 0x0, 0x0}, 1},
+ {0x2F880, {0x5D7C, 0x0, 0x0}, 1},
+ {0x2F881, {0x5DE1, 0x0, 0x0}, 1},
+ {0x2F882, {0x5DE2, 0x0, 0x0}, 1},
+ {0x2F883, {0x382F, 0x0, 0x0}, 1},
+ {0x2F884, {0x5DFD, 0x0, 0x0}, 1},
+ {0x2F885, {0x5E28, 0x0, 0x0}, 1},
+ {0x2F886, {0x5E3D, 0x0, 0x0}, 1},
+ {0x2F887, {0x5E69, 0x0, 0x0}, 1},
+ {0x2F888, {0x3862, 0x0, 0x0}, 1},
+ {0x2F889, {0x22183, 0x0, 0x0}, 1},
+ {0x2F88A, {0x387C, 0x0, 0x0}, 1},
+ {0x2F88B, {0x5EB0, 0x0, 0x0}, 1},
+ {0x2F88C, {0x5EB3, 0x0, 0x0}, 1},
+ {0x2F88D, {0x5EB6, 0x0, 0x0}, 1},
+ {0x2F88E, {0x5ECA, 0x0, 0x0}, 1},
+ {0x2F88F, {0x2A392, 0x0, 0x0}, 1},
+ {0x2F890, {0x5EFE, 0x0, 0x0}, 1},
+ {0x2F891, {0x22331, 0x0, 0x0}, 1},
+ {0x2F892, {0x22331, 0x0, 0x0}, 1},
+ {0x2F893, {0x8201, 0x0, 0x0}, 1},
+ {0x2F894, {0x5F22, 0x0, 0x0}, 1},
+ {0x2F895, {0x5F22, 0x0, 0x0}, 1},
+ {0x2F896, {0x38C7, 0x0, 0x0}, 1},
+ {0x2F897, {0x232B8, 0x0, 0x0}, 1},
+ {0x2F898, {0x261DA, 0x0, 0x0}, 1},
+ {0x2F899, {0x5F62, 0x0, 0x0}, 1},
+ {0x2F89A, {0x5F6B, 0x0, 0x0}, 1},
+ {0x2F89B, {0x38E3, 0x0, 0x0}, 1},
+ {0x2F89C, {0x5F9A, 0x0, 0x0}, 1},
+ {0x2F89D, {0x5FCD, 0x0, 0x0}, 1},
+ {0x2F89E, {0x5FD7, 0x0, 0x0}, 1},
+ {0x2F89F, {0x5FF9, 0x0, 0x0}, 1},
+ {0x2F8A0, {0x6081, 0x0, 0x0}, 1},
+ {0x2F8A1, {0x393A, 0x0, 0x0}, 1},
+ {0x2F8A2, {0x391C, 0x0, 0x0}, 1},
+ {0x2F8A3, {0x6094, 0x0, 0x0}, 1},
+ {0x2F8A4, {0x226D4, 0x0, 0x0}, 1},
+ {0x2F8A5, {0x60C7, 0x0, 0x0}, 1},
+ {0x2F8A6, {0x6148, 0x0, 0x0}, 1},
+ {0x2F8A7, {0x614C, 0x0, 0x0}, 1},
+ {0x2F8A8, {0x614E, 0x0, 0x0}, 1},
+ {0x2F8A9, {0x614C, 0x0, 0x0}, 1},
+ {0x2F8AA, {0x617A, 0x0, 0x0}, 1},
+ {0x2F8AB, {0x618E, 0x0, 0x0}, 1},
+ {0x2F8AC, {0x61B2, 0x0, 0x0}, 1},
+ {0x2F8AD, {0x61A4, 0x0, 0x0}, 1},
+ {0x2F8AE, {0x61AF, 0x0, 0x0}, 1},
+ {0x2F8AF, {0x61DE, 0x0, 0x0}, 1},
+ {0x2F8B0, {0x61F2, 0x0, 0x0}, 1},
+ {0x2F8B1, {0x61F6, 0x0, 0x0}, 1},
+ {0x2F8B2, {0x6210, 0x0, 0x0}, 1},
+ {0x2F8B3, {0x621B, 0x0, 0x0}, 1},
+ {0x2F8B4, {0x625D, 0x0, 0x0}, 1},
+ {0x2F8B5, {0x62B1, 0x0, 0x0}, 1},
+ {0x2F8B6, {0x62D4, 0x0, 0x0}, 1},
+ {0x2F8B7, {0x6350, 0x0, 0x0}, 1},
+ {0x2F8B8, {0x22B0C, 0x0, 0x0}, 1},
+ {0x2F8B9, {0x633D, 0x0, 0x0}, 1},
+ {0x2F8BA, {0x62FC, 0x0, 0x0}, 1},
+ {0x2F8BB, {0x6368, 0x0, 0x0}, 1},
+ {0x2F8BC, {0x6383, 0x0, 0x0}, 1},
+ {0x2F8BD, {0x63E4, 0x0, 0x0}, 1},
+ {0x2F8BE, {0x22BF1, 0x0, 0x0}, 1},
+ {0x2F8BF, {0x6422, 0x0, 0x0}, 1},
+ {0x2F8C0, {0x63C5, 0x0, 0x0}, 1},
+ {0x2F8C1, {0x63A9, 0x0, 0x0}, 1},
+ {0x2F8C2, {0x3A2E, 0x0, 0x0}, 1},
+ {0x2F8C3, {0x6469, 0x0, 0x0}, 1},
+ {0x2F8C4, {0x647E, 0x0, 0x0}, 1},
+ {0x2F8C5, {0x649D, 0x0, 0x0}, 1},
+ {0x2F8C6, {0x6477, 0x0, 0x0}, 1},
+ {0x2F8C7, {0x3A6C, 0x0, 0x0}, 1},
+ {0x2F8C8, {0x654F, 0x0, 0x0}, 1},
+ {0x2F8C9, {0x656C, 0x0, 0x0}, 1},
+ {0x2F8CA, {0x2300A, 0x0, 0x0}, 1},
+ {0x2F8CB, {0x65E3, 0x0, 0x0}, 1},
+ {0x2F8CC, {0x66F8, 0x0, 0x0}, 1},
+ {0x2F8CD, {0x6649, 0x0, 0x0}, 1},
+ {0x2F8CE, {0x3B19, 0x0, 0x0}, 1},
+ {0x2F8CF, {0x6691, 0x0, 0x0}, 1},
+ {0x2F8D0, {0x3B08, 0x0, 0x0}, 1},
+ {0x2F8D1, {0x3AE4, 0x0, 0x0}, 1},
+ {0x2F8D2, {0x5192, 0x0, 0x0}, 1},
+ {0x2F8D3, {0x5195, 0x0, 0x0}, 1},
+ {0x2F8D4, {0x6700, 0x0, 0x0}, 1},
+ {0x2F8D5, {0x669C, 0x0, 0x0}, 1},
+ {0x2F8D6, {0x80AD, 0x0, 0x0}, 1},
+ {0x2F8D7, {0x43D9, 0x0, 0x0}, 1},
+ {0x2F8D8, {0x6717, 0x0, 0x0}, 1},
+ {0x2F8D9, {0x671B, 0x0, 0x0}, 1},
+ {0x2F8DA, {0x6721, 0x0, 0x0}, 1},
+ {0x2F8DB, {0x675E, 0x0, 0x0}, 1},
+ {0x2F8DC, {0x6753, 0x0, 0x0}, 1},
+ {0x2F8DD, {0x233C3, 0x0, 0x0}, 1},
+ {0x2F8DE, {0x3B49, 0x0, 0x0}, 1},
+ {0x2F8DF, {0x67FA, 0x0, 0x0}, 1},
+ {0x2F8E0, {0x6785, 0x0, 0x0}, 1},
+ {0x2F8E1, {0x6852, 0x0, 0x0}, 1},
+ {0x2F8E2, {0x6885, 0x0, 0x0}, 1},
+ {0x2F8E3, {0x2346D, 0x0, 0x0}, 1},
+ {0x2F8E4, {0x688E, 0x0, 0x0}, 1},
+ {0x2F8E5, {0x681F, 0x0, 0x0}, 1},
+ {0x2F8E6, {0x6914, 0x0, 0x0}, 1},
+ {0x2F8E7, {0x3B9D, 0x0, 0x0}, 1},
+ {0x2F8E8, {0x6942, 0x0, 0x0}, 1},
+ {0x2F8E9, {0x69A3, 0x0, 0x0}, 1},
+ {0x2F8EA, {0x69EA, 0x0, 0x0}, 1},
+ {0x2F8EB, {0x6AA8, 0x0, 0x0}, 1},
+ {0x2F8EC, {0x236A3, 0x0, 0x0}, 1},
+ {0x2F8ED, {0x6ADB, 0x0, 0x0}, 1},
+ {0x2F8EE, {0x3C18, 0x0, 0x0}, 1},
+ {0x2F8EF, {0x6B21, 0x0, 0x0}, 1},
+ {0x2F8F0, {0x238A7, 0x0, 0x0}, 1},
+ {0x2F8F1, {0x6B54, 0x0, 0x0}, 1},
+ {0x2F8F2, {0x3C4E, 0x0, 0x0}, 1},
+ {0x2F8F3, {0x6B72, 0x0, 0x0}, 1},
+ {0x2F8F4, {0x6B9F, 0x0, 0x0}, 1},
+ {0x2F8F5, {0x6BBA, 0x0, 0x0}, 1},
+ {0x2F8F6, {0x6BBB, 0x0, 0x0}, 1},
+ {0x2F8F7, {0x23A8D, 0x0, 0x0}, 1},
+ {0x2F8F8, {0x21D0B, 0x0, 0x0}, 1},
+ {0x2F8F9, {0x23AFA, 0x0, 0x0}, 1},
+ {0x2F8FA, {0x6C4E, 0x0, 0x0}, 1},
+ {0x2F8FB, {0x23CBC, 0x0, 0x0}, 1},
+ {0x2F8FC, {0x6CBF, 0x0, 0x0}, 1},
+ {0x2F8FD, {0x6CCD, 0x0, 0x0}, 1},
+ {0x2F8FE, {0x6C67, 0x0, 0x0}, 1},
+ {0x2F8FF, {0x6D16, 0x0, 0x0}, 1},
+ {0x2F900, {0x6D3E, 0x0, 0x0}, 1},
+ {0x2F901, {0x6D77, 0x0, 0x0}, 1},
+ {0x2F902, {0x6D41, 0x0, 0x0}, 1},
+ {0x2F903, {0x6D69, 0x0, 0x0}, 1},
+ {0x2F904, {0x6D78, 0x0, 0x0}, 1},
+ {0x2F905, {0x6D85, 0x0, 0x0}, 1},
+ {0x2F906, {0x23D1E, 0x0, 0x0}, 1},
+ {0x2F907, {0x6D34, 0x0, 0x0}, 1},
+ {0x2F908, {0x6E2F, 0x0, 0x0}, 1},
+ {0x2F909, {0x6E6E, 0x0, 0x0}, 1},
+ {0x2F90A, {0x3D33, 0x0, 0x0}, 1},
+ {0x2F90B, {0x6ECB, 0x0, 0x0}, 1},
+ {0x2F90C, {0x6EC7, 0x0, 0x0}, 1},
+ {0x2F90D, {0x23ED1, 0x0, 0x0}, 1},
+ {0x2F90E, {0x6DF9, 0x0, 0x0}, 1},
+ {0x2F90F, {0x6F6E, 0x0, 0x0}, 1},
+ {0x2F910, {0x23F5E, 0x0, 0x0}, 1},
+ {0x2F911, {0x23F8E, 0x0, 0x0}, 1},
+ {0x2F912, {0x6FC6, 0x0, 0x0}, 1},
+ {0x2F913, {0x7039, 0x0, 0x0}, 1},
+ {0x2F914, {0x701E, 0x0, 0x0}, 1},
+ {0x2F915, {0x701B, 0x0, 0x0}, 1},
+ {0x2F916, {0x3D96, 0x0, 0x0}, 1},
+ {0x2F917, {0x704A, 0x0, 0x0}, 1},
+ {0x2F918, {0x707D, 0x0, 0x0}, 1},
+ {0x2F919, {0x7077, 0x0, 0x0}, 1},
+ {0x2F91A, {0x70AD, 0x0, 0x0}, 1},
+ {0x2F91B, {0x20525, 0x0, 0x0}, 1},
+ {0x2F91C, {0x7145, 0x0, 0x0}, 1},
+ {0x2F91D, {0x24263, 0x0, 0x0}, 1},
+ {0x2F91E, {0x719C, 0x0, 0x0}, 1},
+ {0x2F91F, {0x243AB, 0x0, 0x0}, 1},
+ {0x2F920, {0x7228, 0x0, 0x0}, 1},
+ {0x2F921, {0x7235, 0x0, 0x0}, 1},
+ {0x2F922, {0x7250, 0x0, 0x0}, 1},
+ {0x2F923, {0x24608, 0x0, 0x0}, 1},
+ {0x2F924, {0x7280, 0x0, 0x0}, 1},
+ {0x2F925, {0x7295, 0x0, 0x0}, 1},
+ {0x2F926, {0x24735, 0x0, 0x0}, 1},
+ {0x2F927, {0x24814, 0x0, 0x0}, 1},
+ {0x2F928, {0x737A, 0x0, 0x0}, 1},
+ {0x2F929, {0x738B, 0x0, 0x0}, 1},
+ {0x2F92A, {0x3EAC, 0x0, 0x0}, 1},
+ {0x2F92B, {0x73A5, 0x0, 0x0}, 1},
+ {0x2F92C, {0x3EB8, 0x0, 0x0}, 1},
+ {0x2F92D, {0x3EB8, 0x0, 0x0}, 1},
+ {0x2F92E, {0x7447, 0x0, 0x0}, 1},
+ {0x2F92F, {0x745C, 0x0, 0x0}, 1},
+ {0x2F930, {0x7471, 0x0, 0x0}, 1},
+ {0x2F931, {0x7485, 0x0, 0x0}, 1},
+ {0x2F932, {0x74CA, 0x0, 0x0}, 1},
+ {0x2F933, {0x3F1B, 0x0, 0x0}, 1},
+ {0x2F934, {0x7524, 0x0, 0x0}, 1},
+ {0x2F935, {0x24C36, 0x0, 0x0}, 1},
+ {0x2F936, {0x753E, 0x0, 0x0}, 1},
+ {0x2F937, {0x24C92, 0x0, 0x0}, 1},
+ {0x2F938, {0x7570, 0x0, 0x0}, 1},
+ {0x2F939, {0x2219F, 0x0, 0x0}, 1},
+ {0x2F93A, {0x7610, 0x0, 0x0}, 1},
+ {0x2F93B, {0x24FA1, 0x0, 0x0}, 1},
+ {0x2F93C, {0x24FB8, 0x0, 0x0}, 1},
+ {0x2F93D, {0x25044, 0x0, 0x0}, 1},
+ {0x2F93E, {0x3FFC, 0x0, 0x0}, 1},
+ {0x2F93F, {0x4008, 0x0, 0x0}, 1},
+ {0x2F940, {0x76F4, 0x0, 0x0}, 1},
+ {0x2F941, {0x250F3, 0x0, 0x0}, 1},
+ {0x2F942, {0x250F2, 0x0, 0x0}, 1},
+ {0x2F943, {0x25119, 0x0, 0x0}, 1},
+ {0x2F944, {0x25133, 0x0, 0x0}, 1},
+ {0x2F945, {0x771E, 0x0, 0x0}, 1},
+ {0x2F946, {0x771F, 0x0, 0x0}, 1},
+ {0x2F947, {0x771F, 0x0, 0x0}, 1},
+ {0x2F948, {0x774A, 0x0, 0x0}, 1},
+ {0x2F949, {0x4039, 0x0, 0x0}, 1},
+ {0x2F94A, {0x778B, 0x0, 0x0}, 1},
+ {0x2F94B, {0x4046, 0x0, 0x0}, 1},
+ {0x2F94C, {0x4096, 0x0, 0x0}, 1},
+ {0x2F94D, {0x2541D, 0x0, 0x0}, 1},
+ {0x2F94E, {0x784E, 0x0, 0x0}, 1},
+ {0x2F94F, {0x788C, 0x0, 0x0}, 1},
+ {0x2F950, {0x78CC, 0x0, 0x0}, 1},
+ {0x2F951, {0x40E3, 0x0, 0x0}, 1},
+ {0x2F952, {0x25626, 0x0, 0x0}, 1},
+ {0x2F953, {0x7956, 0x0, 0x0}, 1},
+ {0x2F954, {0x2569A, 0x0, 0x0}, 1},
+ {0x2F955, {0x256C5, 0x0, 0x0}, 1},
+ {0x2F956, {0x798F, 0x0, 0x0}, 1},
+ {0x2F957, {0x79EB, 0x0, 0x0}, 1},
+ {0x2F958, {0x412F, 0x0, 0x0}, 1},
+ {0x2F959, {0x7A40, 0x0, 0x0}, 1},
+ {0x2F95A, {0x7A4A, 0x0, 0x0}, 1},
+ {0x2F95B, {0x7A4F, 0x0, 0x0}, 1},
+ {0x2F95C, {0x2597C, 0x0, 0x0}, 1},
+ {0x2F95D, {0x25AA7, 0x0, 0x0}, 1},
+ {0x2F95E, {0x25AA7, 0x0, 0x0}, 1},
+ {0x2F95F, {0x7AEE, 0x0, 0x0}, 1},
+ {0x2F960, {0x4202, 0x0, 0x0}, 1},
+ {0x2F961, {0x25BAB, 0x0, 0x0}, 1},
+ {0x2F962, {0x7BC6, 0x0, 0x0}, 1},
+ {0x2F963, {0x7BC9, 0x0, 0x0}, 1},
+ {0x2F964, {0x4227, 0x0, 0x0}, 1},
+ {0x2F965, {0x25C80, 0x0, 0x0}, 1},
+ {0x2F966, {0x7CD2, 0x0, 0x0}, 1},
+ {0x2F967, {0x42A0, 0x0, 0x0}, 1},
+ {0x2F968, {0x7CE8, 0x0, 0x0}, 1},
+ {0x2F969, {0x7CE3, 0x0, 0x0}, 1},
+ {0x2F96A, {0x7D00, 0x0, 0x0}, 1},
+ {0x2F96B, {0x25F86, 0x0, 0x0}, 1},
+ {0x2F96C, {0x7D63, 0x0, 0x0}, 1},
+ {0x2F96D, {0x4301, 0x0, 0x0}, 1},
+ {0x2F96E, {0x7DC7, 0x0, 0x0}, 1},
+ {0x2F96F, {0x7E02, 0x0, 0x0}, 1},
+ {0x2F970, {0x7E45, 0x0, 0x0}, 1},
+ {0x2F971, {0x4334, 0x0, 0x0}, 1},
+ {0x2F972, {0x26228, 0x0, 0x0}, 1},
+ {0x2F973, {0x26247, 0x0, 0x0}, 1},
+ {0x2F974, {0x4359, 0x0, 0x0}, 1},
+ {0x2F975, {0x262D9, 0x0, 0x0}, 1},
+ {0x2F976, {0x7F7A, 0x0, 0x0}, 1},
+ {0x2F977, {0x2633E, 0x0, 0x0}, 1},
+ {0x2F978, {0x7F95, 0x0, 0x0}, 1},
+ {0x2F979, {0x7FFA, 0x0, 0x0}, 1},
+ {0x2F97A, {0x8005, 0x0, 0x0}, 1},
+ {0x2F97B, {0x264DA, 0x0, 0x0}, 1},
+ {0x2F97C, {0x26523, 0x0, 0x0}, 1},
+ {0x2F97D, {0x8060, 0x0, 0x0}, 1},
+ {0x2F97E, {0x265A8, 0x0, 0x0}, 1},
+ {0x2F97F, {0x8070, 0x0, 0x0}, 1},
+ {0x2F980, {0x2335F, 0x0, 0x0}, 1},
+ {0x2F981, {0x43D5, 0x0, 0x0}, 1},
+ {0x2F982, {0x80B2, 0x0, 0x0}, 1},
+ {0x2F983, {0x8103, 0x0, 0x0}, 1},
+ {0x2F984, {0x440B, 0x0, 0x0}, 1},
+ {0x2F985, {0x813E, 0x0, 0x0}, 1},
+ {0x2F986, {0x5AB5, 0x0, 0x0}, 1},
+ {0x2F987, {0x267A7, 0x0, 0x0}, 1},
+ {0x2F988, {0x267B5, 0x0, 0x0}, 1},
+ {0x2F989, {0x23393, 0x0, 0x0}, 1},
+ {0x2F98A, {0x2339C, 0x0, 0x0}, 1},
+ {0x2F98B, {0x8201, 0x0, 0x0}, 1},
+ {0x2F98C, {0x8204, 0x0, 0x0}, 1},
+ {0x2F98D, {0x8F9E, 0x0, 0x0}, 1},
+ {0x2F98E, {0x446B, 0x0, 0x0}, 1},
+ {0x2F98F, {0x8291, 0x0, 0x0}, 1},
+ {0x2F990, {0x828B, 0x0, 0x0}, 1},
+ {0x2F991, {0x829D, 0x0, 0x0}, 1},
+ {0x2F992, {0x52B3, 0x0, 0x0}, 1},
+ {0x2F993, {0x82B1, 0x0, 0x0}, 1},
+ {0x2F994, {0x82B3, 0x0, 0x0}, 1},
+ {0x2F995, {0x82BD, 0x0, 0x0}, 1},
+ {0x2F996, {0x82E6, 0x0, 0x0}, 1},
+ {0x2F997, {0x26B3C, 0x0, 0x0}, 1},
+ {0x2F998, {0x82E5, 0x0, 0x0}, 1},
+ {0x2F999, {0x831D, 0x0, 0x0}, 1},
+ {0x2F99A, {0x8363, 0x0, 0x0}, 1},
+ {0x2F99B, {0x83AD, 0x0, 0x0}, 1},
+ {0x2F99C, {0x8323, 0x0, 0x0}, 1},
+ {0x2F99D, {0x83BD, 0x0, 0x0}, 1},
+ {0x2F99E, {0x83E7, 0x0, 0x0}, 1},
+ {0x2F99F, {0x8457, 0x0, 0x0}, 1},
+ {0x2F9A0, {0x8353, 0x0, 0x0}, 1},
+ {0x2F9A1, {0x83CA, 0x0, 0x0}, 1},
+ {0x2F9A2, {0x83CC, 0x0, 0x0}, 1},
+ {0x2F9A3, {0x83DC, 0x0, 0x0}, 1},
+ {0x2F9A4, {0x26C36, 0x0, 0x0}, 1},
+ {0x2F9A5, {0x26D6B, 0x0, 0x0}, 1},
+ {0x2F9A6, {0x26CD5, 0x0, 0x0}, 1},
+ {0x2F9A7, {0x452B, 0x0, 0x0}, 1},
+ {0x2F9A8, {0x84F1, 0x0, 0x0}, 1},
+ {0x2F9A9, {0x84F3, 0x0, 0x0}, 1},
+ {0x2F9AA, {0x8516, 0x0, 0x0}, 1},
+ {0x2F9AB, {0x273CA, 0x0, 0x0}, 1},
+ {0x2F9AC, {0x8564, 0x0, 0x0}, 1},
+ {0x2F9AD, {0x26F2C, 0x0, 0x0}, 1},
+ {0x2F9AE, {0x455D, 0x0, 0x0}, 1},
+ {0x2F9AF, {0x4561, 0x0, 0x0}, 1},
+ {0x2F9B0, {0x26FB1, 0x0, 0x0}, 1},
+ {0x2F9B1, {0x270D2, 0x0, 0x0}, 1},
+ {0x2F9B2, {0x456B, 0x0, 0x0}, 1},
+ {0x2F9B3, {0x8650, 0x0, 0x0}, 1},
+ {0x2F9B4, {0x865C, 0x0, 0x0}, 1},
+ {0x2F9B5, {0x8667, 0x0, 0x0}, 1},
+ {0x2F9B6, {0x8669, 0x0, 0x0}, 1},
+ {0x2F9B7, {0x86A9, 0x0, 0x0}, 1},
+ {0x2F9B8, {0x8688, 0x0, 0x0}, 1},
+ {0x2F9B9, {0x870E, 0x0, 0x0}, 1},
+ {0x2F9BA, {0x86E2, 0x0, 0x0}, 1},
+ {0x2F9BB, {0x8779, 0x0, 0x0}, 1},
+ {0x2F9BC, {0x8728, 0x0, 0x0}, 1},
+ {0x2F9BD, {0x876B, 0x0, 0x0}, 1},
+ {0x2F9BE, {0x8786, 0x0, 0x0}, 1},
+ {0x2F9BF, {0x45D7, 0x0, 0x0}, 1},
+ {0x2F9C0, {0x87E1, 0x0, 0x0}, 1},
+ {0x2F9C1, {0x8801, 0x0, 0x0}, 1},
+ {0x2F9C2, {0x45F9, 0x0, 0x0}, 1},
+ {0x2F9C3, {0x8860, 0x0, 0x0}, 1},
+ {0x2F9C4, {0x8863, 0x0, 0x0}, 1},
+ {0x2F9C5, {0x27667, 0x0, 0x0}, 1},
+ {0x2F9C6, {0x88D7, 0x0, 0x0}, 1},
+ {0x2F9C7, {0x88DE, 0x0, 0x0}, 1},
+ {0x2F9C8, {0x4635, 0x0, 0x0}, 1},
+ {0x2F9C9, {0x88FA, 0x0, 0x0}, 1},
+ {0x2F9CA, {0x34BB, 0x0, 0x0}, 1},
+ {0x2F9CB, {0x278AE, 0x0, 0x0}, 1},
+ {0x2F9CC, {0x27966, 0x0, 0x0}, 1},
+ {0x2F9CD, {0x46BE, 0x0, 0x0}, 1},
+ {0x2F9CE, {0x46C7, 0x0, 0x0}, 1},
+ {0x2F9CF, {0x8AA0, 0x0, 0x0}, 1},
+ {0x2F9D0, {0x8AED, 0x0, 0x0}, 1},
+ {0x2F9D1, {0x8B8A, 0x0, 0x0}, 1},
+ {0x2F9D2, {0x8C55, 0x0, 0x0}, 1},
+ {0x2F9D3, {0x27CA8, 0x0, 0x0}, 1},
+ {0x2F9D4, {0x8CAB, 0x0, 0x0}, 1},
+ {0x2F9D5, {0x8CC1, 0x0, 0x0}, 1},
+ {0x2F9D6, {0x8D1B, 0x0, 0x0}, 1},
+ {0x2F9D7, {0x8D77, 0x0, 0x0}, 1},
+ {0x2F9D8, {0x27F2F, 0x0, 0x0}, 1},
+ {0x2F9D9, {0x20804, 0x0, 0x0}, 1},
+ {0x2F9DA, {0x8DCB, 0x0, 0x0}, 1},
+ {0x2F9DB, {0x8DBC, 0x0, 0x0}, 1},
+ {0x2F9DC, {0x8DF0, 0x0, 0x0}, 1},
+ {0x2F9DD, {0x208DE, 0x0, 0x0}, 1},
+ {0x2F9DE, {0x8ED4, 0x0, 0x0}, 1},
+ {0x2F9DF, {0x8F38, 0x0, 0x0}, 1},
+ {0x2F9E0, {0x285D2, 0x0, 0x0}, 1},
+ {0x2F9E1, {0x285ED, 0x0, 0x0}, 1},
+ {0x2F9E2, {0x9094, 0x0, 0x0}, 1},
+ {0x2F9E3, {0x90F1, 0x0, 0x0}, 1},
+ {0x2F9E4, {0x9111, 0x0, 0x0}, 1},
+ {0x2F9E5, {0x2872E, 0x0, 0x0}, 1},
+ {0x2F9E6, {0x911B, 0x0, 0x0}, 1},
+ {0x2F9E7, {0x9238, 0x0, 0x0}, 1},
+ {0x2F9E8, {0x92D7, 0x0, 0x0}, 1},
+ {0x2F9E9, {0x92D8, 0x0, 0x0}, 1},
+ {0x2F9EA, {0x927C, 0x0, 0x0}, 1},
+ {0x2F9EB, {0x93F9, 0x0, 0x0}, 1},
+ {0x2F9EC, {0x9415, 0x0, 0x0}, 1},
+ {0x2F9ED, {0x28BFA, 0x0, 0x0}, 1},
+ {0x2F9EE, {0x958B, 0x0, 0x0}, 1},
+ {0x2F9EF, {0x4995, 0x0, 0x0}, 1},
+ {0x2F9F0, {0x95B7, 0x0, 0x0}, 1},
+ {0x2F9F1, {0x28D77, 0x0, 0x0}, 1},
+ {0x2F9F2, {0x49E6, 0x0, 0x0}, 1},
+ {0x2F9F3, {0x96C3, 0x0, 0x0}, 1},
+ {0x2F9F4, {0x5DB2, 0x0, 0x0}, 1},
+ {0x2F9F5, {0x9723, 0x0, 0x0}, 1},
+ {0x2F9F6, {0x29145, 0x0, 0x0}, 1},
+ {0x2F9F7, {0x2921A, 0x0, 0x0}, 1},
+ {0x2F9F8, {0x4A6E, 0x0, 0x0}, 1},
+ {0x2F9F9, {0x4A76, 0x0, 0x0}, 1},
+ {0x2F9FA, {0x97E0, 0x0, 0x0}, 1},
+ {0x2F9FB, {0x2940A, 0x0, 0x0}, 1},
+ {0x2F9FC, {0x4AB2, 0x0, 0x0}, 1},
+ {0x2F9FD, {0x29496, 0x0, 0x0}, 1},
+ {0x2F9FE, {0x980B, 0x0, 0x0}, 1},
+ {0x2F9FF, {0x980B, 0x0, 0x0}, 1},
+ {0x2FA00, {0x9829, 0x0, 0x0}, 1},
+ {0x2FA01, {0x295B6, 0x0, 0x0}, 1},
+ {0x2FA02, {0x98E2, 0x0, 0x0}, 1},
+ {0x2FA03, {0x4B33, 0x0, 0x0}, 1},
+ {0x2FA04, {0x9929, 0x0, 0x0}, 1},
+ {0x2FA05, {0x99A7, 0x0, 0x0}, 1},
+ {0x2FA06, {0x99C2, 0x0, 0x0}, 1},
+ {0x2FA07, {0x99FE, 0x0, 0x0}, 1},
+ {0x2FA08, {0x4BCE, 0x0, 0x0}, 1},
+ {0x2FA09, {0x29B30, 0x0, 0x0}, 1},
+ {0x2FA0A, {0x9B12, 0x0, 0x0}, 1},
+ {0x2FA0B, {0x9C40, 0x0, 0x0}, 1},
+ {0x2FA0C, {0x9CFD, 0x0, 0x0}, 1},
+ {0x2FA0D, {0x4CCE, 0x0, 0x0}, 1},
+ {0x2FA0E, {0x4CED, 0x0, 0x0}, 1},
+ {0x2FA0F, {0x9D67, 0x0, 0x0}, 1},
+ {0x2FA10, {0x2A0CE, 0x0, 0x0}, 1},
+ {0x2FA11, {0x4CF8, 0x0, 0x0}, 1},
+ {0x2FA12, {0x2A105, 0x0, 0x0}, 1},
+ {0x2FA13, {0x2A20E, 0x0, 0x0}, 1},
+ {0x2FA14, {0x2A291, 0x0, 0x0}, 1},
+ {0x2FA15, {0x9EBB, 0x0, 0x0}, 1},
+ {0x2FA16, {0x4D56, 0x0, 0x0}, 1},
+ {0x2FA17, {0x9EF9, 0x0, 0x0}, 1},
+ {0x2FA18, {0x9EFE, 0x0, 0x0}, 1},
+ {0x2FA19, {0x9F05, 0x0, 0x0}, 1},
+ {0x2FA1A, {0x9F0F, 0x0, 0x0}, 1},
+ {0x2FA1B, {0x9F16, 0x0, 0x0}, 1},
+ {0x2FA1C, {0x9F3B, 0x0, 0x0}, 1},
+ {0x2FA1D, {0x2A600, 0x0, 0x0}, 1},
+ {0xE0100, {0x0, 0x0, 0x0}, 0},
+ {0xE0101, {0x0, 0x0, 0x0}, 0},
+ {0xE0102, {0x0, 0x0, 0x0}, 0},
+ {0xE0103, {0x0, 0x0, 0x0}, 0},
+ {0xE0104, {0x0, 0x0, 0x0}, 0},
+ {0xE0105, {0x0, 0x0, 0x0}, 0},
+ {0xE0106, {0x0, 0x0, 0x0}, 0},
+ {0xE0107, {0x0, 0x0, 0x0}, 0},
+ {0xE0108, {0x0, 0x0, 0x0}, 0},
+ {0xE0109, {0x0, 0x0, 0x0}, 0},
+ {0xE010A, {0x0, 0x0, 0x0}, 0},
+ {0xE010B, {0x0, 0x0, 0x0}, 0},
+ {0xE010C, {0x0, 0x0, 0x0}, 0},
+ {0xE010D, {0x0, 0x0, 0x0}, 0},
+ {0xE010E, {0x0, 0x0, 0x0}, 0},
+ {0xE010F, {0x0, 0x0, 0x0}, 0},
+ {0xE0110, {0x0, 0x0, 0x0}, 0},
+ {0xE0111, {0x0, 0x0, 0x0}, 0},
+ {0xE0112, {0x0, 0x0, 0x0}, 0},
+ {0xE0113, {0x0, 0x0, 0x0}, 0},
+ {0xE0114, {0x0, 0x0, 0x0}, 0},
+ {0xE0115, {0x0, 0x0, 0x0}, 0},
+ {0xE0116, {0x0, 0x0, 0x0}, 0},
+ {0xE0117, {0x0, 0x0, 0x0}, 0},
+ {0xE0118, {0x0, 0x0, 0x0}, 0},
+ {0xE0119, {0x0, 0x0, 0x0}, 0},
+ {0xE011A, {0x0, 0x0, 0x0}, 0},
+ {0xE011B, {0x0, 0x0, 0x0}, 0},
+ {0xE011C, {0x0, 0x0, 0x0}, 0},
+ {0xE011D, {0x0, 0x0, 0x0}, 0},
+ {0xE011E, {0x0, 0x0, 0x0}, 0},
+ {0xE011F, {0x0, 0x0, 0x0}, 0},
+ {0xE0120, {0x0, 0x0, 0x0}, 0},
+ {0xE0121, {0x0, 0x0, 0x0}, 0},
+ {0xE0122, {0x0, 0x0, 0x0}, 0},
+ {0xE0123, {0x0, 0x0, 0x0}, 0},
+ {0xE0124, {0x0, 0x0, 0x0}, 0},
+ {0xE0125, {0x0, 0x0, 0x0}, 0},
+ {0xE0126, {0x0, 0x0, 0x0}, 0},
+ {0xE0127, {0x0, 0x0, 0x0}, 0},
+ {0xE0128, {0x0, 0x0, 0x0}, 0},
+ {0xE0129, {0x0, 0x0, 0x0}, 0},
+ {0xE012A, {0x0, 0x0, 0x0}, 0},
+ {0xE012B, {0x0, 0x0, 0x0}, 0},
+ {0xE012C, {0x0, 0x0, 0x0}, 0},
+ {0xE012D, {0x0, 0x0, 0x0}, 0},
+ {0xE012E, {0x0, 0x0, 0x0}, 0},
+ {0xE012F, {0x0, 0x0, 0x0}, 0},
+ {0xE0130, {0x0, 0x0, 0x0}, 0},
+ {0xE0131, {0x0, 0x0, 0x0}, 0},
+ {0xE0132, {0x0, 0x0, 0x0}, 0},
+ {0xE0133, {0x0, 0x0, 0x0}, 0},
+ {0xE0134, {0x0, 0x0, 0x0}, 0},
+ {0xE0135, {0x0, 0x0, 0x0}, 0},
+ {0xE0136, {0x0, 0x0, 0x0}, 0},
+ {0xE0137, {0x0, 0x0, 0x0}, 0},
+ {0xE0138, {0x0, 0x0, 0x0}, 0},
+ {0xE0139, {0x0, 0x0, 0x0}, 0},
+ {0xE013A, {0x0, 0x0, 0x0}, 0},
+ {0xE013B, {0x0, 0x0, 0x0}, 0},
+ {0xE013C, {0x0, 0x0, 0x0}, 0},
+ {0xE013D, {0x0, 0x0, 0x0}, 0},
+ {0xE013E, {0x0, 0x0, 0x0}, 0},
+ {0xE013F, {0x0, 0x0, 0x0}, 0},
+ {0xE0140, {0x0, 0x0, 0x0}, 0},
+ {0xE0141, {0x0, 0x0, 0x0}, 0},
+ {0xE0142, {0x0, 0x0, 0x0}, 0},
+ {0xE0143, {0x0, 0x0, 0x0}, 0},
+ {0xE0144, {0x0, 0x0, 0x0}, 0},
+ {0xE0145, {0x0, 0x0, 0x0}, 0},
+ {0xE0146, {0x0, 0x0, 0x0}, 0},
+ {0xE0147, {0x0, 0x0, 0x0}, 0},
+ {0xE0148, {0x0, 0x0, 0x0}, 0},
+ {0xE0149, {0x0, 0x0, 0x0}, 0},
+ {0xE014A, {0x0, 0x0, 0x0}, 0},
+ {0xE014B, {0x0, 0x0, 0x0}, 0},
+ {0xE014C, {0x0, 0x0, 0x0}, 0},
+ {0xE014D, {0x0, 0x0, 0x0}, 0},
+ {0xE014E, {0x0, 0x0, 0x0}, 0},
+ {0xE014F, {0x0, 0x0, 0x0}, 0},
+ {0xE0150, {0x0, 0x0, 0x0}, 0},
+ {0xE0151, {0x0, 0x0, 0x0}, 0},
+ {0xE0152, {0x0, 0x0, 0x0}, 0},
+ {0xE0153, {0x0, 0x0, 0x0}, 0},
+ {0xE0154, {0x0, 0x0, 0x0}, 0},
+ {0xE0155, {0x0, 0x0, 0x0}, 0},
+ {0xE0156, {0x0, 0x0, 0x0}, 0},
+ {0xE0157, {0x0, 0x0, 0x0}, 0},
+ {0xE0158, {0x0, 0x0, 0x0}, 0},
+ {0xE0159, {0x0, 0x0, 0x0}, 0},
+ {0xE015A, {0x0, 0x0, 0x0}, 0},
+ {0xE015B, {0x0, 0x0, 0x0}, 0},
+ {0xE015C, {0x0, 0x0, 0x0}, 0},
+ {0xE015D, {0x0, 0x0, 0x0}, 0},
+ {0xE015E, {0x0, 0x0, 0x0}, 0},
+ {0xE015F, {0x0, 0x0, 0x0}, 0},
+ {0xE0160, {0x0, 0x0, 0x0}, 0},
+ {0xE0161, {0x0, 0x0, 0x0}, 0},
+ {0xE0162, {0x0, 0x0, 0x0}, 0},
+ {0xE0163, {0x0, 0x0, 0x0}, 0},
+ {0xE0164, {0x0, 0x0, 0x0}, 0},
+ {0xE0165, {0x0, 0x0, 0x0}, 0},
+ {0xE0166, {0x0, 0x0, 0x0}, 0},
+ {0xE0167, {0x0, 0x0, 0x0}, 0},
+ {0xE0168, {0x0, 0x0, 0x0}, 0},
+ {0xE0169, {0x0, 0x0, 0x0}, 0},
+ {0xE016A, {0x0, 0x0, 0x0}, 0},
+ {0xE016B, {0x0, 0x0, 0x0}, 0},
+ {0xE016C, {0x0, 0x0, 0x0}, 0},
+ {0xE016D, {0x0, 0x0, 0x0}, 0},
+ {0xE016E, {0x0, 0x0, 0x0}, 0},
+ {0xE016F, {0x0, 0x0, 0x0}, 0},
+ {0xE0170, {0x0, 0x0, 0x0}, 0},
+ {0xE0171, {0x0, 0x0, 0x0}, 0},
+ {0xE0172, {0x0, 0x0, 0x0}, 0},
+ {0xE0173, {0x0, 0x0, 0x0}, 0},
+ {0xE0174, {0x0, 0x0, 0x0}, 0},
+ {0xE0175, {0x0, 0x0, 0x0}, 0},
+ {0xE0176, {0x0, 0x0, 0x0}, 0},
+ {0xE0177, {0x0, 0x0, 0x0}, 0},
+ {0xE0178, {0x0, 0x0, 0x0}, 0},
+ {0xE0179, {0x0, 0x0, 0x0}, 0},
+ {0xE017A, {0x0, 0x0, 0x0}, 0},
+ {0xE017B, {0x0, 0x0, 0x0}, 0},
+ {0xE017C, {0x0, 0x0, 0x0}, 0},
+ {0xE017D, {0x0, 0x0, 0x0}, 0},
+ {0xE017E, {0x0, 0x0, 0x0}, 0},
+ {0xE017F, {0x0, 0x0, 0x0}, 0},
+ {0xE0180, {0x0, 0x0, 0x0}, 0},
+ {0xE0181, {0x0, 0x0, 0x0}, 0},
+ {0xE0182, {0x0, 0x0, 0x0}, 0},
+ {0xE0183, {0x0, 0x0, 0x0}, 0},
+ {0xE0184, {0x0, 0x0, 0x0}, 0},
+ {0xE0185, {0x0, 0x0, 0x0}, 0},
+ {0xE0186, {0x0, 0x0, 0x0}, 0},
+ {0xE0187, {0x0, 0x0, 0x0}, 0},
+ {0xE0188, {0x0, 0x0, 0x0}, 0},
+ {0xE0189, {0x0, 0x0, 0x0}, 0},
+ {0xE018A, {0x0, 0x0, 0x0}, 0},
+ {0xE018B, {0x0, 0x0, 0x0}, 0},
+ {0xE018C, {0x0, 0x0, 0x0}, 0},
+ {0xE018D, {0x0, 0x0, 0x0}, 0},
+ {0xE018E, {0x0, 0x0, 0x0}, 0},
+ {0xE018F, {0x0, 0x0, 0x0}, 0},
+ {0xE0190, {0x0, 0x0, 0x0}, 0},
+ {0xE0191, {0x0, 0x0, 0x0}, 0},
+ {0xE0192, {0x0, 0x0, 0x0}, 0},
+ {0xE0193, {0x0, 0x0, 0x0}, 0},
+ {0xE0194, {0x0, 0x0, 0x0}, 0},
+ {0xE0195, {0x0, 0x0, 0x0}, 0},
+ {0xE0196, {0x0, 0x0, 0x0}, 0},
+ {0xE0197, {0x0, 0x0, 0x0}, 0},
+ {0xE0198, {0x0, 0x0, 0x0}, 0},
+ {0xE0199, {0x0, 0x0, 0x0}, 0},
+ {0xE019A, {0x0, 0x0, 0x0}, 0},
+ {0xE019B, {0x0, 0x0, 0x0}, 0},
+ {0xE019C, {0x0, 0x0, 0x0}, 0},
+ {0xE019D, {0x0, 0x0, 0x0}, 0},
+ {0xE019E, {0x0, 0x0, 0x0}, 0},
+ {0xE019F, {0x0, 0x0, 0x0}, 0},
+ {0xE01A0, {0x0, 0x0, 0x0}, 0},
+ {0xE01A1, {0x0, 0x0, 0x0}, 0},
+ {0xE01A2, {0x0, 0x0, 0x0}, 0},
+ {0xE01A3, {0x0, 0x0, 0x0}, 0},
+ {0xE01A4, {0x0, 0x0, 0x0}, 0},
+ {0xE01A5, {0x0, 0x0, 0x0}, 0},
+ {0xE01A6, {0x0, 0x0, 0x0}, 0},
+ {0xE01A7, {0x0, 0x0, 0x0}, 0},
+ {0xE01A8, {0x0, 0x0, 0x0}, 0},
+ {0xE01A9, {0x0, 0x0, 0x0}, 0},
+ {0xE01AA, {0x0, 0x0, 0x0}, 0},
+ {0xE01AB, {0x0, 0x0, 0x0}, 0},
+ {0xE01AC, {0x0, 0x0, 0x0}, 0},
+ {0xE01AD, {0x0, 0x0, 0x0}, 0},
+ {0xE01AE, {0x0, 0x0, 0x0}, 0},
+ {0xE01AF, {0x0, 0x0, 0x0}, 0},
+ {0xE01B0, {0x0, 0x0, 0x0}, 0},
+ {0xE01B1, {0x0, 0x0, 0x0}, 0},
+ {0xE01B2, {0x0, 0x0, 0x0}, 0},
+ {0xE01B3, {0x0, 0x0, 0x0}, 0},
+ {0xE01B4, {0x0, 0x0, 0x0}, 0},
+ {0xE01B5, {0x0, 0x0, 0x0}, 0},
+ {0xE01B6, {0x0, 0x0, 0x0}, 0},
+ {0xE01B7, {0x0, 0x0, 0x0}, 0},
+ {0xE01B8, {0x0, 0x0, 0x0}, 0},
+ {0xE01B9, {0x0, 0x0, 0x0}, 0},
+ {0xE01BA, {0x0, 0x0, 0x0}, 0},
+ {0xE01BB, {0x0, 0x0, 0x0}, 0},
+ {0xE01BC, {0x0, 0x0, 0x0}, 0},
+ {0xE01BD, {0x0, 0x0, 0x0}, 0},
+ {0xE01BE, {0x0, 0x0, 0x0}, 0},
+ {0xE01BF, {0x0, 0x0, 0x0}, 0},
+ {0xE01C0, {0x0, 0x0, 0x0}, 0},
+ {0xE01C1, {0x0, 0x0, 0x0}, 0},
+ {0xE01C2, {0x0, 0x0, 0x0}, 0},
+ {0xE01C3, {0x0, 0x0, 0x0}, 0},
+ {0xE01C4, {0x0, 0x0, 0x0}, 0},
+ {0xE01C5, {0x0, 0x0, 0x0}, 0},
+ {0xE01C6, {0x0, 0x0, 0x0}, 0},
+ {0xE01C7, {0x0, 0x0, 0x0}, 0},
+ {0xE01C8, {0x0, 0x0, 0x0}, 0},
+ {0xE01C9, {0x0, 0x0, 0x0}, 0},
+ {0xE01CA, {0x0, 0x0, 0x0}, 0},
+ {0xE01CB, {0x0, 0x0, 0x0}, 0},
+ {0xE01CC, {0x0, 0x0, 0x0}, 0},
+ {0xE01CD, {0x0, 0x0, 0x0}, 0},
+ {0xE01CE, {0x0, 0x0, 0x0}, 0},
+ {0xE01CF, {0x0, 0x0, 0x0}, 0},
+ {0xE01D0, {0x0, 0x0, 0x0}, 0},
+ {0xE01D1, {0x0, 0x0, 0x0}, 0},
+ {0xE01D2, {0x0, 0x0, 0x0}, 0},
+ {0xE01D3, {0x0, 0x0, 0x0}, 0},
+ {0xE01D4, {0x0, 0x0, 0x0}, 0},
+ {0xE01D5, {0x0, 0x0, 0x0}, 0},
+ {0xE01D6, {0x0, 0x0, 0x0}, 0},
+ {0xE01D7, {0x0, 0x0, 0x0}, 0},
+ {0xE01D8, {0x0, 0x0, 0x0}, 0},
+ {0xE01D9, {0x0, 0x0, 0x0}, 0},
+ {0xE01DA, {0x0, 0x0, 0x0}, 0},
+ {0xE01DB, {0x0, 0x0, 0x0}, 0},
+ {0xE01DC, {0x0, 0x0, 0x0}, 0},
+ {0xE01DD, {0x0, 0x0, 0x0}, 0},
+ {0xE01DE, {0x0, 0x0, 0x0}, 0},
+ {0xE01DF, {0x0, 0x0, 0x0}, 0},
+ {0xE01E0, {0x0, 0x0, 0x0}, 0},
+ {0xE01E1, {0x0, 0x0, 0x0}, 0},
+ {0xE01E2, {0x0, 0x0, 0x0}, 0},
+ {0xE01E3, {0x0, 0x0, 0x0}, 0},
+ {0xE01E4, {0x0, 0x0, 0x0}, 0},
+ {0xE01E5, {0x0, 0x0, 0x0}, 0},
+ {0xE01E6, {0x0, 0x0, 0x0}, 0},
+ {0xE01E7, {0x0, 0x0, 0x0}, 0},
+ {0xE01E8, {0x0, 0x0, 0x0}, 0},
+ {0xE01E9, {0x0, 0x0, 0x0}, 0},
+ {0xE01EA, {0x0, 0x0, 0x0}, 0},
+ {0xE01EB, {0x0, 0x0, 0x0}, 0},
+ {0xE01EC, {0x0, 0x0, 0x0}, 0},
+ {0xE01ED, {0x0, 0x0, 0x0}, 0},
+ {0xE01EE, {0x0, 0x0, 0x0}, 0},
+ {0xE01EF, {0x0, 0x0, 0x0}, 0},
+};
+enum { WP_FOLD_N = (int)(sizeof(WP_FOLD) / sizeof(WP_FOLD[0])) };
+
+#endif /* WORDPIECE_UNICODE_H */
diff --git a/src/tokenizer_wordpiece.c b/src/tokenizer_wordpiece.c
new file mode 100644
index 0000000..d8acbbe
--- /dev/null
+++ b/src/tokenizer_wordpiece.c
@@ -0,0 +1,678 @@
+/*
+ * wordpiece_tokenizer.c - BERT-family WordPiece tokenizer.
+ *
+ * Pipeline (matching transformers' BertTokenizer):
+ * BasicTokenizer: clean control/whitespace -> space CJK ideographs ->
+ * whitespace split -> (lowercase + strip accents) -> split on punctuation
+ * WordPiece: greedy longest-match-first against vocab.txt, continuation
+ * pieces marked "##", whole token -> [UNK] when any piece fails to match.
+ *
+ * Unicode handling is full and exact against transformers, driven by generated
+ * tables (wordpiece_unicode.h): punctuation and control by Unicode category,
+ * whitespace by the complete Zs set, the CJK split by the BERT ideograph ranges,
+ * and the do_lower_case fold by a lowercase+NFD+strip-marks table (with Hangul
+ * decomposed by formula). Cased and uncased multilingual encoders (e.g.
+ * bert-base-multilingual-cased / -uncased) match Hugging Face exactly, including
+ * Greek, Cyrillic, Vietnamese and Korean. The fold is per-codepoint, matching
+ * transformers, which lowercases character by character (no context-sensitive
+ * Greek final sigma).
+ */
+
+#include "tokenizer_wordpiece.h"
+
+#include "tokenizer_unicode.h"
+
+#include <stdint.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+
+/* ===================== string -> int open-addressing map ===================== */
+
+typedef struct {
+ const char *key; /* points into tok->id_to_token; not owned */
+ int val;
+} wp_entry_t;
+
+static uint64_t fnv1a_hash(const char *s) {
+ uint64_t h = 1469598103934665603ULL;
+ for (const unsigned char *p = (const unsigned char *)s; *p; p++) {
+ h ^= (uint64_t)*p;
+ h *= 1099511628211ULL;
+ }
+ return h;
+}
+
+static int next_pow2(int x) {
+ int p = 1;
+ while (p < x)
+ p <<= 1;
+ return p;
+}
+
+static void map_put(wp_entry_t *map, int cap, const char *key, int val) {
+ uint64_t mask = (uint64_t)cap - 1;
+ int pos = (int)(fnv1a_hash(key) & mask);
+ while (map[pos].key) {
+ if (!strcmp(map[pos].key, key)) {
+ map[pos].val = val; /* keep the first (lowest) id, like a dict insert */
+ return;
+ }
+ pos = (int)((pos + 1) & (int)mask);
+ }
+ map[pos].key = key;
+ map[pos].val = val;
+}
+
+static int map_get(const wp_entry_t *map, int cap, const char *key) {
+ if (!map)
+ return -1;
+ uint64_t mask = (uint64_t)cap - 1;
+ int pos = (int)(fnv1a_hash(key) & mask);
+ while (map[pos].key) {
+ if (!strcmp(map[pos].key, key))
+ return map[pos].val;
+ pos = (int)((pos + 1) & (int)mask);
+ }
+ return -1;
+}
+
+/* ============================== UTF-8 helpers ================================ */
+
+/* Decode one codepoint. Returns bytes consumed (>=1); on a malformed lead byte
+ * emits U+FFFD and consumes one byte so iteration always advances. */
+static int utf8_decode(const unsigned char *p, const unsigned char *end, uint32_t *cp) {
+ unsigned char c = p[0];
+ if (c < 0x80) {
+ *cp = c;
+ return 1;
+ }
+ int n;
+ uint32_t v;
+ if ((c & 0xE0) == 0xC0) {
+ n = 2;
+ v = c & 0x1F;
+ } else if ((c & 0xF0) == 0xE0) {
+ n = 3;
+ v = c & 0x0F;
+ } else if ((c & 0xF8) == 0xF0) {
+ n = 4;
+ v = c & 0x07;
+ } else {
+ *cp = 0xFFFD;
+ return 1;
+ }
+ if (p + n > end) {
+ *cp = 0xFFFD;
+ return 1;
+ }
+ for (int i = 1; i < n; i++) {
+ if ((p[i] & 0xC0) != 0x80) {
+ *cp = 0xFFFD;
+ return 1;
+ }
+ v = (v << 6) | (p[i] & 0x3F);
+ }
+ *cp = v;
+ return n;
+}
+
+static int utf8_encode(uint32_t cp, char out[4]) {
+ if (cp < 0x80) {
+ out[0] = (char)cp;
+ return 1;
+ }
+ if (cp < 0x800) {
+ out[0] = (char)(0xC0 | (cp >> 6));
+ out[1] = (char)(0x80 | (cp & 0x3F));
+ return 2;
+ }
+ if (cp < 0x10000) {
+ out[0] = (char)(0xE0 | (cp >> 12));
+ out[1] = (char)(0x80 | ((cp >> 6) & 0x3F));
+ out[2] = (char)(0x80 | (cp & 0x3F));
+ return 3;
+ }
+ out[0] = (char)(0xF0 | (cp >> 18));
+ out[1] = (char)(0x80 | ((cp >> 12) & 0x3F));
+ out[2] = (char)(0x80 | ((cp >> 6) & 0x3F));
+ out[3] = (char)(0x80 | (cp & 0x3F));
+ return 4;
+}
+
+/* ========================== Unicode classification ========================== */
+
+static int wp_is_whitespace(uint32_t cp) {
+ if (cp == ' ' || cp == '\t' || cp == '\n' || cp == '\r')
+ return 1;
+ return cp == 0x00A0 || cp == 0x1680 || (cp >= 0x2000 && cp <= 0x200A) || cp == 0x2028 ||
+ cp == 0x2029 || cp == 0x202F || cp == 0x205F || cp == 0x3000;
+}
+
+/* Binary search a sorted, non-overlapping [lo, hi] range table. */
+static int wp_in_ranges(uint32_t cp, const wp_range_t *r, int n) {
+ int lo = 0, hi = n - 1;
+ while (lo <= hi) {
+ int mid = (lo + hi) >> 1;
+ if (cp < r[mid].lo)
+ hi = mid - 1;
+ else if (cp > r[mid].hi)
+ lo = mid + 1;
+ else
+ return 1;
+ }
+ return 0;
+}
+
+/* transformers' _is_control: tab/newline/carriage-return are whitespace, not
+ * control (they fall through to wp_is_whitespace); everything else is Unicode
+ * category Cc, Cf, or Co. */
+static int wp_is_control(uint32_t cp) {
+ if (cp == '\t' || cp == '\n' || cp == '\r')
+ return 0;
+ return wp_in_ranges(cp, WP_CONTROL_RANGES, WP_CONTROL_RANGES_N);
+}
+
+/* transformers' _is_punctuation: the ASCII non-alphanumeric set plus every
+ * Unicode category P* codepoint, both folded into the generated table. */
+static int wp_is_punct(uint32_t cp) { return wp_in_ranges(cp, WP_PUNCT_RANGES, WP_PUNCT_RANGES_N); }
+
+static int wp_is_cjk(uint32_t cp) {
+ return (cp >= 0x4E00 && cp <= 0x9FFF) || (cp >= 0x3400 && cp <= 0x4DBF) ||
+ (cp >= 0x20000 && cp <= 0x2A6DF) || (cp >= 0x2A700 && cp <= 0x2B73F) ||
+ (cp >= 0x2B740 && cp <= 0x2B81F) || (cp >= 0x2B820 && cp <= 0x2CEAF) ||
+ (cp >= 0xF900 && cp <= 0xFAFF) || (cp >= 0x2F800 && cp <= 0x2FA1F);
+}
+
+/* Hangul syllable decomposition constants (the standard algorithm). Hangul
+ * syllables are not cased, so their do_lower_case fold is the canonical NFD into
+ * leading (L), vowel (V), and optional trailing (T) jamo - none combining marks
+ * - which keeps them out of the generated WP_FOLD table. */
+enum {
+ WP_HANGUL_S = 0xAC00,
+ WP_HANGUL_L = 0x1100,
+ WP_HANGUL_V = 0x1161,
+ WP_HANGUL_T = 0x11A7,
+ WP_HANGUL_TCOUNT = 28,
+ WP_HANGUL_NCOUNT = 588,
+ WP_HANGUL_SCOUNT = 11172
+};
+
+/* Apply the do_lower_case fold (Python str.lower then NFD then drop combining
+ * marks) to one codepoint, writing 0..3 output codepoints to out and the count
+ * to *n_out. 0 outputs means the codepoint is a dropped mark. Hangul decomposes
+ * by formula; everything else is the generated WP_FOLD table or an identity. */
+static void wp_fold(uint32_t cp, uint32_t out[3], int *n_out) {
+ if (cp >= WP_HANGUL_S && cp < WP_HANGUL_S + WP_HANGUL_SCOUNT) {
+ int s = (int)(cp - WP_HANGUL_S);
+ out[0] = (uint32_t)(WP_HANGUL_L + s / WP_HANGUL_NCOUNT);
+ out[1] = (uint32_t)(WP_HANGUL_V + (s % WP_HANGUL_NCOUNT) / WP_HANGUL_TCOUNT);
+ int t = s % WP_HANGUL_TCOUNT;
+ if (t == 0) {
+ *n_out = 2;
+ } else {
+ out[2] = (uint32_t)(WP_HANGUL_T + t);
+ *n_out = 3;
+ }
+ return;
+ }
+ int lo = 0, hi = WP_FOLD_N - 1;
+ while (lo <= hi) {
+ int mid = (lo + hi) >> 1;
+ if (cp < WP_FOLD[mid].cp) {
+ hi = mid - 1;
+ } else if (cp > WP_FOLD[mid].cp) {
+ lo = mid + 1;
+ } else {
+ int n = WP_FOLD[mid].n;
+ for (int i = 0; i < n; i++)
+ out[i] = WP_FOLD[mid].out[i];
+ *n_out = n;
+ return;
+ }
+ }
+ out[0] = cp;
+ *n_out = 1;
+}
+
+/* =============================== workspace ================================== */
+
+struct wordpiece_workspace {
+ uint32_t *cps; /* cleaned + CJK-spaced codepoints of the whole input */
+ int cps_cap;
+ uint32_t *norm; /* one word's normalized codepoints */
+ int norm_cap;
+ char *wbuf; /* one sub-word's UTF-8 bytes */
+ int wbuf_cap;
+ int *boff; /* byte offset of each codepoint within wbuf (+1 sentinel) */
+ int boff_cap;
+ char *look; /* "##" + candidate substring, for vocab lookup */
+ int look_cap;
+ int *ids; /* output ids */
+ int ids_cap;
+};
+
+static int grow_u32(uint32_t **buf, int *cap, int need) {
+ if (*cap >= need)
+ return 0;
+ int n = *cap ? *cap : 64;
+ while (n < need)
+ n *= 2;
+ uint32_t *p = (uint32_t *)realloc(*buf, (size_t)n * sizeof(uint32_t));
+ if (!p)
+ return -1;
+ *buf = p;
+ *cap = n;
+ return 0;
+}
+
+static int grow_int(int **buf, int *cap, int need) {
+ if (*cap >= need)
+ return 0;
+ int n = *cap ? *cap : 64;
+ while (n < need)
+ n *= 2;
+ int *p = (int *)realloc(*buf, (size_t)n * sizeof(int));
+ if (!p)
+ return -1;
+ *buf = p;
+ *cap = n;
+ return 0;
+}
+
+static int grow_char(char **buf, int *cap, int need) {
+ if (*cap >= need)
+ return 0;
+ int n = *cap ? *cap : 256;
+ while (n < need)
+ n *= 2;
+ char *p = (char *)realloc(*buf, (size_t)n);
+ if (!p)
+ return -1;
+ *buf = p;
+ *cap = n;
+ return 0;
+}
+
+wordpiece_workspace_t *wordpiece_workspace_new(void) {
+ return (wordpiece_workspace_t *)calloc(1, sizeof(wordpiece_workspace_t));
+}
+
+void wordpiece_workspace_free(wordpiece_workspace_t *ws) {
+ if (!ws)
+ return;
+ free(ws->cps);
+ free(ws->norm);
+ free(ws->wbuf);
+ free(ws->boff);
+ free(ws->look);
+ free(ws->ids);
+ free(ws);
+}
+
+/* ============================== WordPiece core ============================== */
+
+/* Append the WordPiece ids of one BasicTokenizer sub-word (codepoints
+ * word[0..n)) to ws->ids[*n_out]. The whole sub-word maps to [UNK] when it is
+ * too long or any greedy piece misses the vocab. Returns 0 / -1 on OOM. */
+static int wordpiece_subword(const wordpiece_tokenizer_t *tok,
+ wordpiece_workspace_t *ws,
+ const uint32_t *word,
+ int n,
+ int *n_out) {
+ if (n == 0)
+ return 0;
+ if (n > tok->max_chars_per_word) {
+ if (grow_int(&ws->ids, &ws->ids_cap, *n_out + 1) != 0)
+ return -1;
+ ws->ids[(*n_out)++] = tok->unk_id;
+ return 0;
+ }
+
+ /* Materialize the sub-word as UTF-8 with per-codepoint byte offsets. */
+ if (grow_int(&ws->boff, &ws->boff_cap, n + 1) != 0 ||
+ grow_char(&ws->wbuf, &ws->wbuf_cap, n * 4 + 1) != 0)
+ return -1;
+ int bytes = 0;
+ for (int i = 0; i < n; i++) {
+ ws->boff[i] = bytes;
+ bytes += utf8_encode(word[i], ws->wbuf + bytes);
+ }
+ ws->boff[n] = bytes;
+
+ int start_count = *n_out;
+ int start = 0;
+ int bad = 0;
+ while (start < n) {
+ int end = n;
+ int matched = -1;
+ int matched_end = start;
+ while (start < end) {
+ int seg = ws->boff[end] - ws->boff[start];
+ int lp = 0;
+ if (grow_char(&ws->look, &ws->look_cap, seg + 3) != 0)
+ return -1;
+ if (start > 0) {
+ ws->look[lp++] = '#';
+ ws->look[lp++] = '#';
+ }
+ memcpy(ws->look + lp, ws->wbuf + ws->boff[start], (size_t)seg);
+ ws->look[lp + seg] = '\0';
+ int id = map_get((const wp_entry_t *)tok->vocab_map, tok->vocab_map_cap, ws->look);
+ if (id >= 0) {
+ matched = id;
+ matched_end = end;
+ break;
+ }
+ end--;
+ }
+ if (matched < 0) {
+ bad = 1;
+ break;
+ }
+ if (grow_int(&ws->ids, &ws->ids_cap, *n_out + 1) != 0)
+ return -1;
+ ws->ids[(*n_out)++] = matched;
+ start = matched_end;
+ }
+ if (bad) {
+ *n_out = start_count; /* discard partial pieces; emit one [UNK] */
+ if (grow_int(&ws->ids, &ws->ids_cap, *n_out + 1) != 0)
+ return -1;
+ ws->ids[(*n_out)++] = tok->unk_id;
+ }
+ return 0;
+}
+
+/* Run the full BasicTokenizer + WordPiece pipeline into ws->ids. Returns the
+ * token count, or -1 on allocation failure. */
+static int
+wordpiece_run(const wordpiece_tokenizer_t *tok, wordpiece_workspace_t *ws, const char *text) {
+ /* clean_text + tokenize_chinese_chars, in one pass over the input. */
+ const unsigned char *p = (const unsigned char *)text;
+ const unsigned char *end = p + strlen(text);
+ int n_cps = 0;
+ while (p < end) {
+ uint32_t cp;
+ p += utf8_decode(p, end, &cp);
+ if (cp == 0 || cp == 0xFFFD || wp_is_control(cp))
+ continue;
+ if (wp_is_whitespace(cp)) {
+ if (grow_u32(&ws->cps, &ws->cps_cap, n_cps + 1) != 0)
+ return -1;
+ ws->cps[n_cps++] = ' ';
+ continue;
+ }
+ int extra = wp_is_cjk(cp) ? 3 : 1;
+ if (grow_u32(&ws->cps, &ws->cps_cap, n_cps + extra) != 0)
+ return -1;
+ if (extra == 3) {
+ ws->cps[n_cps++] = ' ';
+ ws->cps[n_cps++] = cp;
+ ws->cps[n_cps++] = ' ';
+ } else {
+ ws->cps[n_cps++] = cp;
+ }
+ }
+
+ int n_out = 0;
+ int i = 0;
+ while (i < n_cps) {
+ if (ws->cps[i] == ' ') {
+ i++;
+ continue;
+ }
+ int wstart = i;
+ while (i < n_cps && ws->cps[i] != ' ')
+ i++;
+ int wlen = i - wstart;
+
+ /* lowercase + strip accents; the fold can drop a codepoint (combining
+ * mark) or expand it to up to 3 (Hangul, a few ligatures). */
+ int m = 0;
+ if (grow_u32(&ws->norm, &ws->norm_cap, tok->do_lower_case ? wlen * 3 : wlen) != 0)
+ return -1;
+ for (int k = 0; k < wlen; k++) {
+ uint32_t cp = ws->cps[wstart + k];
+ if (tok->do_lower_case) {
+ uint32_t out[3];
+ int no = 0;
+ wp_fold(cp, out, &no);
+ for (int j = 0; j < no; j++)
+ ws->norm[m++] = out[j];
+ } else {
+ ws->norm[m++] = cp;
+ }
+ }
+
+ /* split_on_punc, then WordPiece each piece. */
+ int run = 0;
+ for (int k = 0; k < m; k++) {
+ if (wp_is_punct(ws->norm[k])) {
+ if (run > 0 && wordpiece_subword(tok, ws, ws->norm + (k - run), run, &n_out) != 0)
+ return -1;
+ run = 0;
+ if (wordpiece_subword(tok, ws, ws->norm + k, 1, &n_out) != 0)
+ return -1;
+ } else {
+ run++;
+ }
+ }
+ if (run > 0 && wordpiece_subword(tok, ws, ws->norm + (m - run), run, &n_out) != 0)
+ return -1;
+ }
+ return n_out;
+}
+
+/* ================================ loading =================================== */
+
+static char *read_file(const char *path, long *out_len) {
+ FILE *f = fopen(path, "rb");
+ if (!f)
+ return NULL;
+ if (fseek(f, 0, SEEK_END) != 0) {
+ fclose(f);
+ return NULL;
+ }
+ long len = ftell(f);
+ if (len < 0 || fseek(f, 0, SEEK_SET) != 0) {
+ fclose(f);
+ return NULL;
+ }
+ char *buf = (char *)malloc((size_t)len + 1);
+ if (!buf) {
+ fclose(f);
+ return NULL;
+ }
+ size_t rd = fread(buf, 1, (size_t)len, f);
+ fclose(f);
+ if (rd != (size_t)len) {
+ free(buf);
+ return NULL;
+ }
+ buf[len] = '\0';
+ if (out_len)
+ *out_len = len;
+ return buf;
+}
+
+/* do_lower_case from tokenizer_config.json: default true (BERT uncased). A
+ * lightweight scan is enough - we only need one boolean and avoid a JSON dep
+ * here, mirroring how the config layer reads small flags. */
+static int read_do_lower_case(const char *model_dir) {
+ char path[2048];
+ snprintf(path, sizeof(path), "%s/tokenizer_config.json", model_dir);
+ char *buf = read_file(path, NULL);
+ if (!buf)
+ return 1;
+ int result = 1;
+ const char *k = strstr(buf, "\"do_lower_case\"");
+ if (k) {
+ const char *c = strchr(k, ':');
+ if (c) {
+ c++;
+ while (*c == ' ' || *c == '\t' || *c == '\n' || *c == '\r')
+ c++;
+ if (!strncmp(c, "false", 5))
+ result = 0;
+ }
+ }
+ free(buf);
+ return result;
+}
+
+wordpiece_tokenizer_t *wordpiece_tokenizer_load(const char *model_dir) {
+ if (!model_dir)
+ return NULL;
+ char path[2048];
+ snprintf(path, sizeof(path), "%s/vocab.txt", model_dir);
+ long len = 0;
+ char *buf = read_file(path, &len);
+ if (!buf) {
+ fprintf(stderr, "wordpiece: cannot read %s\n", path);
+ return NULL;
+ }
+
+ /* Count lines (one token each); a single trailing newline adds no token. */
+ int count = 0;
+ for (long i = 0; i < len; i++)
+ if (buf[i] == '\n')
+ count++;
+ if (len > 0 && buf[len - 1] != '\n')
+ count++;
+
+ wordpiece_tokenizer_t *tok = (wordpiece_tokenizer_t *)calloc(1, sizeof(*tok));
+ char **id_to_token = (char **)calloc((size_t)(count > 0 ? count : 1), sizeof(char *));
+ if (!tok || !id_to_token) {
+ free(buf);
+ free(tok);
+ free(id_to_token);
+ return NULL;
+ }
+
+ int n = 0;
+ char *line = buf;
+ for (long i = 0; i <= len && n < count; i++) {
+ if (i == len || buf[i] == '\n') {
+ char *e = buf + i;
+ if (e > line && e[-1] == '\r')
+ e[-1] = '\0';
+ else
+ *e = '\0';
+ id_to_token[n] = strdup(line);
+ if (!id_to_token[n]) {
+ for (int j = 0; j < n; j++)
+ free(id_to_token[j]);
+ free(id_to_token);
+ free(tok);
+ free(buf);
+ return NULL;
+ }
+ n++;
+ line = buf + i + 1;
+ }
+ }
+ free(buf);
+
+ tok->id_to_token = id_to_token;
+ tok->vocab_size = n;
+ tok->do_lower_case = read_do_lower_case(model_dir);
+ tok->max_chars_per_word = 100;
+
+ int cap = next_pow2(n * 2 < 16 ? 16 : n * 2);
+ wp_entry_t *map = (wp_entry_t *)calloc((size_t)cap, sizeof(wp_entry_t));
+ if (!map) {
+ wordpiece_tokenizer_free(tok);
+ return NULL;
+ }
+ for (int i = 0; i < n; i++)
+ map_put(map, cap, id_to_token[i], i);
+ tok->vocab_map = map;
+ tok->vocab_map_cap = cap;
+
+ tok->unk_id = map_get(map, cap, "[UNK]");
+ if (tok->unk_id < 0) {
+ fprintf(stderr, "wordpiece: vocab.txt has no [UNK] token\n");
+ wordpiece_tokenizer_free(tok);
+ return NULL;
+ }
+ return tok;
+}
+
+/* ============================== public API ================================= */
+
+const char *wordpiece_tokenizer_decode(const wordpiece_tokenizer_t *tok, int id) {
+ if (!tok || id < 0 || id >= tok->vocab_size)
+ return NULL;
+ return tok->id_to_token[id];
+}
+
+int wordpiece_tokenizer_token_id(const wordpiece_tokenizer_t *tok, const char *token) {
+ if (!tok || !token)
+ return -1;
+ return map_get((const wp_entry_t *)tok->vocab_map, tok->vocab_map_cap, token);
+}
+
+int wordpiece_tokenizer_encode_into(const wordpiece_tokenizer_t *tok,
+ wordpiece_workspace_t *ws,
+ const char *text,
+ int *out_ids,
+ int out_cap,
+ int *out_n_tokens) {
+ if (out_n_tokens)
+ *out_n_tokens = 0;
+ if (!tok || !ws || !text)
+ return -1;
+ int n = wordpiece_run(tok, ws, text);
+ if (n < 0)
+ return -1;
+ if (out_n_tokens)
+ *out_n_tokens = n;
+ if (!out_ids || out_cap < n)
+ return out_ids ? -2 : -1;
+ memcpy(out_ids, ws->ids, (size_t)n * sizeof(int));
+ return 0;
+}
+
+int *wordpiece_tokenizer_encode_with_workspace(const wordpiece_tokenizer_t *tok,
+ wordpiece_workspace_t *ws,
+ const char *text,
+ int *out_n_tokens) {
+ if (out_n_tokens)
+ *out_n_tokens = 0;
+ if (!tok || !ws || !text)
+ return NULL;
+ int n = wordpiece_run(tok, ws, text);
+ if (n < 0)
+ return NULL;
+ int *ids = (int *)malloc((size_t)(n > 0 ? n : 1) * sizeof(int));
+ if (!ids)
+ return NULL;
+ memcpy(ids, ws->ids, (size_t)n * sizeof(int));
+ if (out_n_tokens)
+ *out_n_tokens = n;
+ return ids;
+}
+
+int *wordpiece_tokenizer_encode(const wordpiece_tokenizer_t *tok, const char *text, int *out_n) {
+ if (out_n)
+ *out_n = 0;
+ wordpiece_workspace_t *ws = wordpiece_workspace_new();
+ if (!ws)
+ return NULL;
+ int *ids = wordpiece_tokenizer_encode_with_workspace(tok, ws, text, out_n);
+ wordpiece_workspace_free(ws);
+ return ids;
+}
+
+void wordpiece_tokenizer_free(wordpiece_tokenizer_t *tok) {
+ if (!tok)
+ return;
+ if (tok->id_to_token) {
+ for (int i = 0; i < tok->vocab_size; i++)
+ free(tok->id_to_token[i]);
+ free(tok->id_to_token);
+ }
+ free(tok->vocab_map);
+ free(tok);
+}
diff --git a/src/tokenizer_wordpiece.h b/src/tokenizer_wordpiece.h
new file mode 100644
index 0000000..59cb2bb
--- /dev/null
+++ b/src/tokenizer_wordpiece.h
@@ -0,0 +1,79 @@
+/*
+ * wordpiece_tokenizer.h - BERT-family WordPiece tokenizer.
+ *
+ * Implements the BERT tokenization pipeline: a BasicTokenizer (clean, optional
+ * lowercase + accent strip, CJK spacing, whitespace and punctuation splitting)
+ * followed by greedy longest-match WordPiece against a `vocab.txt`. It encodes
+ * text only; the frontend wraps the result with [CLS]/[SEP], exactly as the
+ * byte-level BPE backend leaves terminal/separator tokens to the frontend.
+ *
+ * The public surface mirrors embed_tokenizer.h (load / encode with a reusable
+ * workspace / decode / resolve a named special token / free) so both can sit
+ * behind one tokenizer interface later.
+ */
+
+#ifndef WORDPIECE_TOKENIZER_H
+#define WORDPIECE_TOKENIZER_H
+
+#ifndef EMBED_API
+#if defined(__GNUC__)
+#define EMBED_API __attribute__((visibility("default")))
+#else
+#define EMBED_API
+#endif
+#endif
+
+typedef struct {
+ char **id_to_token; /* [vocab_size] vocab.txt entries, line order = id */
+ int vocab_size;
+ int unk_id; /* [UNK] id, resolved at load */
+ int do_lower_case; /* lowercase + strip accents before WordPiece */
+ int max_chars_per_word; /* words longer than this map to [UNK] (BERT: 100) */
+
+ /* Opaque token-string -> id hash map. */
+ void *vocab_map;
+ int vocab_map_cap;
+} wordpiece_tokenizer_t;
+
+typedef struct wordpiece_workspace wordpiece_workspace_t;
+
+/* Load from <model_dir>/vocab.txt, reading do_lower_case from
+ * <model_dir>/tokenizer_config.json (default: lowercase). Returns NULL on
+ * error (missing vocab.txt, missing [UNK], allocation failure). */
+EMBED_API wordpiece_tokenizer_t *wordpiece_tokenizer_load(const char *model_dir);
+
+/* Decode a single id to its vocab token string (internal pointer), or NULL. */
+EMBED_API const char *wordpiece_tokenizer_decode(const wordpiece_tokenizer_t *tok, int id);
+
+/* Resolve a named token (e.g. "[CLS]") to its id, or -1 when absent. */
+EMBED_API int wordpiece_tokenizer_token_id(const wordpiece_tokenizer_t *tok, const char *token);
+
+/* Encode UTF-8 text into a malloc'd id array; sets *out_n_tokens. NULL on
+ * error (and *out_n_tokens = 0). */
+EMBED_API int *
+wordpiece_tokenizer_encode(const wordpiece_tokenizer_t *tok, const char *text, int *out_n_tokens);
+
+/* Reusable scratch for allocation-light repeated encoding. */
+EMBED_API wordpiece_workspace_t *wordpiece_workspace_new(void);
+EMBED_API void wordpiece_workspace_free(wordpiece_workspace_t *ws);
+
+/* Encode into caller-provided out_ids[0..out_cap-1]. Returns 0 on success, -1
+ * on error, -2 if out_cap is too small. *out_n_tokens (when non-NULL) is set to
+ * the number of tokens needed/emitted in all cases. */
+EMBED_API int wordpiece_tokenizer_encode_into(const wordpiece_tokenizer_t *tok,
+ wordpiece_workspace_t *ws,
+ const char *text,
+ int *out_ids,
+ int out_cap,
+ int *out_n_tokens);
+
+/* Same tokenization as wordpiece_tokenizer_encode(), reusing ws internally and
+ * performing only the final returned int[] allocation. */
+EMBED_API int *wordpiece_tokenizer_encode_with_workspace(const wordpiece_tokenizer_t *tok,
+ wordpiece_workspace_t *ws,
+ const char *text,
+ int *out_n_tokens);
+
+EMBED_API void wordpiece_tokenizer_free(wordpiece_tokenizer_t *tok);
+
+#endif /* WORDPIECE_TOKENIZER_H */