codex-pdf 1.3.0__tar.gz → 1.4.0__tar.gz

{codex_pdf-1.3.0 → codex_pdf-1.4.0}/.github/workflows/ci.yml

@@ -13,10 +13,12 @@ jobs:
       - uses: actions/setup-python@v5
         with:
           python-version: "3.12"
-      - name: Install
+      - name: Install codex-pdf with geom + redis extras
         run: |
           python -m pip install --upgrade pip
-          pip install -e . pytest
+          pip install -e ".[redis,geom]" pytest pytest-asyncio httpx
+      - name: Producer-surface audit (codex stays read-only)
+        run: python scripts/produce_surface_audit.py --json reports/audit/produce_surface.json
       - name: Test
         run: pytest
       - name: Parity Gate (Deep Profile)

{codex_pdf-1.3.0 → codex_pdf-1.4.0}/Dockerfile

@@ -43,7 +43,11 @@ COPY tests ./tests
 # container start tries to repair the editable install and fails on
 # `/opt/venv/.../bin/codex-pdf: Permission denied` because the bin
 # entries land outside the dir tree the runtime user can write.
-RUN uv sync --frozen --no-dev \
+# Install the `redis` extra unconditionally so a deploy that wires
+# CODEX_REDIS_URL to a Railway Redis service uses the shared cache,
+# AND a deploy that deletes the redis service still boots cleanly
+# (codex falls back to in-memory; see codex_pdf.api.cache.make_cache).
+RUN uv sync --frozen --no-dev --extra redis \
  && chown -R codex:codex /opt/venv /app
 
 USER codex

{codex_pdf-1.3.0 → codex_pdf-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-pdf
-Version: 1.3.0
+Version: 1.4.0
 Summary: Authoritative, versioned PDF facts contract for Think Neverland tools.
 Author-email: Think Neverland <dev@thinkneverland.com>
 License-Expression: AGPL-3.0-or-later
@@ -13,6 +13,10 @@ Requires-Dist: pydantic>=2.8
 Requires-Dist: pymupdf>=1.24
 Requires-Dist: python-multipart>=0.0.9
 Requires-Dist: uvicorn>=0.30
+Provides-Extra: geom
+Requires-Dist: pyclipr>=0.1.8; extra == 'geom'
+Provides-Extra: redis
+Requires-Dist: redis>=5.0; extra == 'redis'
 Description-Content-Type: text/markdown
 
 ---

{codex_pdf-1.3.0 → codex_pdf-1.4.0}/clients/ts/node_modules/.package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@printwithsynergy/codex-client",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
@@ -380,6 +380,21 @@
         "url": "https://github.com/sindresorhus/execa?sponsor=1"
       }
     },
+    "node_modules/fsevents": {
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+      }
+    },
     "node_modules/get-func-name": {
       "version": "2.0.2",
       "resolved": "https://registry.npmjs.org/get-func-name/-/get-func-name-2.0.2.tgz",

{codex_pdf-1.3.0 → codex_pdf-1.4.0}/clients/ts/node_modules/.vite/vitest/results.json

@@ -1 +1 @@
-{"version":"1.6.1","results":[[":src/index.test.ts",{"duration":1015,"failed":false}]]}
+{"version":"1.6.1","results":[[":src/index.test.ts",{"duration":1021,"failed":false}]]}

codex_pdf-1.4.0/clients/ts/node_modules/fsevents/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+-----------
+
+Copyright (C) 2010-2020 by Philipp Dunkel, Ben Noordhuis, Elan Shankar, Paul Miller
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

codex_pdf-1.4.0/clients/ts/node_modules/fsevents/README.md

@@ -0,0 +1,89 @@
+# fsevents
+
+Native access to MacOS FSEvents in [Node.js](https://nodejs.org/)
+
+The FSEvents API in MacOS allows applications to register for notifications of
+changes to a given directory tree. It is a very fast and lightweight alternative
+to kqueue.
+
+This is a low-level library. For a cross-platform file watching module that
+uses fsevents, check out [Chokidar](https://github.com/paulmillr/chokidar).
+
+## Usage
+
+```sh
+npm install fsevents
+```
+
+Supports only **Node.js v8.16 and higher**.
+
+```js
+const fsevents = require('fsevents');
+
+// To start observation
+const stop = fsevents.watch(__dirname, (path, flags, id) => {
+  const info = fsevents.getInfo(path, flags);
+});
+
+// To end observation
+stop();
+```
+
+> **Important note:** The API behaviour is slightly different from typical JS APIs. The `stop` function **must** be
+> retrieved and stored somewhere, even if you don't plan to stop the watcher. If you forget it, the garbage collector
+> will eventually kick in, the watcher will be unregistered, and your callbacks won't be called anymore.
+
+The callback passed as the second parameter to `.watch` get's called whenever the operating system detects a
+a change in the file system. It takes three arguments:
+
+###### `fsevents.watch(dirname: string, (path: string, flags: number, id: string) => void): () => Promise<undefined>`
+
+ * `path: string` - the item in the filesystem that have been changed
+ * `flags: number` - a numeric value describing what the change was
+ * `id: string` - an unique-id identifying this specific event
+
+ Returns closer callback which when called returns a Promise resolving when the watcher process has been shut down.
+
+###### `fsevents.getInfo(path: string, flags: number, id: string): FsEventInfo`
+
+The `getInfo` function takes the `path`, `flags` and `id` arguments and converts those parameters into a structure
+that is easier to digest to determine what the change was.
+
+The `FsEventsInfo` has the following shape:
+
+```js
+/**
+ * @typedef {'created'|'modified'|'deleted'|'moved'|'root-changed'|'cloned'|'unknown'} FsEventsEvent
+ * @typedef {'file'|'directory'|'symlink'} FsEventsType
+ */
+{
+  "event": "created", // {FsEventsEvent}
+  "path": "file.txt",
+  "type": "file",    // {FsEventsType}
+  "changes": {
+    "inode": true,   // Had iNode Meta-Information changed
+    "finder": false, // Had Finder Meta-Data changed
+    "access": false, // Had access permissions changed
+    "xattrs": false  // Had xAttributes changed
+  },
+  "flags": 0x100000000
+}
+```
+
+## Changelog
+
+- v2.3 supports Apple Silicon ARM CPUs
+- v2 supports node 8.16+ and reduces package size massively
+- v1.2.8 supports node 6+
+- v1.2.7 supports node 4+
+
+## Troubleshooting
+
+- I'm getting `EBADPLATFORM` `Unsupported platform for fsevents` error.
+- It's fine, nothing is broken. fsevents is macos-only. Other platforms are skipped. If you want to hide this warning, report a bug to NPM bugtracker asking them to hide ebadplatform warnings by default.
+
+## License
+
+The MIT License Copyright (C) 2010-2020 by Philipp Dunkel, Ben Noordhuis, Elan Shankar, Paul Miller — see LICENSE file.
+
+Visit our [GitHub page](https://github.com/fsevents/fsevents) and [NPM Page](https://npmjs.org/package/fsevents)

codex_pdf-1.4.0/clients/ts/node_modules/fsevents/fsevents.d.ts

@@ -0,0 +1,46 @@
+declare type Event = "created" | "cloned" | "modified" | "deleted" | "moved" | "root-changed" | "unknown";
+declare type Type = "file" | "directory" | "symlink";
+declare type FileChanges = {
+  inode: boolean;
+  finder: boolean;
+  access: boolean;
+  xattrs: boolean;
+};
+declare type Info = {
+  event: Event;
+  path: string;
+  type: Type;
+  changes: FileChanges;
+  flags: number;
+};
+declare type WatchHandler = (path: string, flags: number, id: string) => void;
+export declare function watch(path: string, handler: WatchHandler): () => Promise<void>;
+export declare function watch(path: string, since: number, handler: WatchHandler): () => Promise<void>;
+export declare function getInfo(path: string, flags: number): Info;
+export declare const constants: {
+  None: 0x00000000;
+  MustScanSubDirs: 0x00000001;
+  UserDropped: 0x00000002;
+  KernelDropped: 0x00000004;
+  EventIdsWrapped: 0x00000008;
+  HistoryDone: 0x00000010;
+  RootChanged: 0x00000020;
+  Mount: 0x00000040;
+  Unmount: 0x00000080;
+  ItemCreated: 0x00000100;
+  ItemRemoved: 0x00000200;
+  ItemInodeMetaMod: 0x00000400;
+  ItemRenamed: 0x00000800;
+  ItemModified: 0x00001000;
+  ItemFinderInfoMod: 0x00002000;
+  ItemChangeOwner: 0x00004000;
+  ItemXattrMod: 0x00008000;
+  ItemIsFile: 0x00010000;
+  ItemIsDir: 0x00020000;
+  ItemIsSymlink: 0x00040000;
+  ItemIsHardlink: 0x00100000;
+  ItemIsLastHardlink: 0x00200000;
+  OwnEvent: 0x00080000;
+  ItemCloned: 0x00400000;
+};
+export {};

codex_pdf-1.4.0/clients/ts/node_modules/fsevents/fsevents.js

@@ -0,0 +1,83 @@
+/*
+ ** © 2020 by Philipp Dunkel, Ben Noordhuis, Elan Shankar, Paul Miller
+ ** Licensed under MIT License.
+ */
+
+/* jshint node:true */
+"use strict";
+
+if (process.platform !== "darwin") {
+  throw new Error(`Module 'fsevents' is not compatible with platform '${process.platform}'`);
+}
+
+const Native = require("./fsevents.node");
+const events = Native.constants;
+
+function watch(path, since, handler) {
+  if (typeof path !== "string") {
+    throw new TypeError(`fsevents argument 1 must be a string and not a ${typeof path}`);
+  }
+  if ("function" === typeof since && "undefined" === typeof handler) {
+    handler = since;
+    since = Native.flags.SinceNow;
+  }
+  if (typeof since !== "number") {
+    throw new TypeError(`fsevents argument 2 must be a number and not a ${typeof since}`);
+  }
+  if (typeof handler !== "function") {
+    throw new TypeError(`fsevents argument 3 must be a function and not a ${typeof handler}`);
+  }
+
+  let instance = Native.start(Native.global, path, since, handler);
+  if (!instance) throw new Error(`could not watch: ${path}`);
+  return () => {
+    const result = instance ? Promise.resolve(instance).then(Native.stop) : Promise.resolve(undefined);
+    instance = undefined;
+    return result;
+  };
+}
+
+function getInfo(path, flags) {
+  return {
+    path,
+    flags,
+    event: getEventType(flags),
+    type: getFileType(flags),
+    changes: getFileChanges(flags),
+  };
+}
+
+function getFileType(flags) {
+  if (events.ItemIsFile & flags) return "file";
+  if (events.ItemIsDir & flags) return "directory";
+  if (events.MustScanSubDirs & flags) return "directory"; 
+  if (events.ItemIsSymlink & flags) return "symlink";
+}
+function anyIsTrue(obj) {
+  for (let key in obj) {
+    if (obj[key]) return true;
+  }
+  return false;
+}
+function getEventType(flags) {
+  if (events.ItemRemoved & flags) return "deleted";
+  if (events.ItemRenamed & flags) return "moved";
+  if (events.ItemCreated & flags) return "created";
+  if (events.ItemModified & flags) return "modified";
+  if (events.RootChanged & flags) return "root-changed";
+  if (events.ItemCloned & flags) return "cloned";
+  if (anyIsTrue(flags)) return "modified";
+  return "unknown";
+}
+function getFileChanges(flags) {
+  return {
+    inode: !!(events.ItemInodeMetaMod & flags),
+    finder: !!(events.ItemFinderInfoMod & flags),
+    access: !!(events.ItemChangeOwner & flags),
+    xattrs: !!(events.ItemXattrMod & flags),
+  };
+}
+
+exports.watch = watch;
+exports.getInfo = getInfo;
+exports.constants = events;

codex_pdf-1.4.0/clients/ts/node_modules/fsevents/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "fsevents",
+  "version": "2.3.3",
+  "description": "Native Access to MacOS FSEvents",
+  "main": "fsevents.js",
+  "types": "fsevents.d.ts",
+  "os": [
+    "darwin"
+  ],
+  "files": [
+    "fsevents.d.ts",
+    "fsevents.js",
+    "fsevents.node"
+  ],
+  "engines": {
+    "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+  },
+  "scripts": {
+    "clean": "node-gyp clean && rm -f fsevents.node",
+    "build": "node-gyp clean && rm -f fsevents.node && node-gyp rebuild && node-gyp clean",
+    "test": "/bin/bash ./test.sh 2>/dev/null",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fsevents/fsevents.git"
+  },
+  "keywords": [
+    "fsevents",
+    "mac"
+  ],
+  "contributors": [
+    {
+      "name": "Philipp Dunkel",
+      "email": "pip@pipobscure.com"
+    },
+    {
+      "name": "Ben Noordhuis",
+      "email": "info@bnoordhuis.nl"
+    },
+    {
+      "name": "Elan Shankar",
+      "email": "elan.shanker@gmail.com"
+    },
+    {
+      "name": "Miroslav Bajtoš",
+      "email": "mbajtoss@gmail.com"
+    },
+    {
+      "name": "Paul Miller",
+      "url": "https://paulmillr.com"
+    }
+  ],
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/fsevents/fsevents/issues"
+  },
+  "homepage": "https://github.com/fsevents/fsevents",
+  "devDependencies": {
+    "node-gyp": "^9.4.0"
+  }
+}

{codex_pdf-1.3.0 → codex_pdf-1.4.0}/clients/ts/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@printwithsynergy/codex-client",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@printwithsynergy/codex-client",
-      "version": "1.2.0",
+      "version": "1.4.0",
       "license": "AGPL-3.0-or-later",
       "devDependencies": {
         "@types/node": "^20.0.0",

{codex_pdf-1.3.0 → codex_pdf-1.4.0}/clients/ts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@printwithsynergy/codex-client",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "TypeScript client for the codex-pdf HTTP API. Mirrors the Python codex_pdf.client surface.",
   "type": "module",
   "license": "AGPL-3.0-or-later",

codex_pdf-1.4.0/clients/ts/src/color.ts

@@ -0,0 +1,176 @@
+/**
+ * Browser-side colour-math helpers that mirror
+ * :mod:`codex_pdf.color.color_math` byte-for-byte. Used by loupe-pdf's
+ * `resolveSpotSwatchColor` adapter so chip swatches don't require a
+ * network round-trip when host/codex/curated paths already have
+ * enough information.
+ *
+ * @public
+ */
+
+export type LabTriplet = [number, number, number];
+export type CmykQuad = [number, number, number, number];
+export type RgbTriplet = [number, number, number];
+
+const XYZ_D65_FROM_LINEAR_SRGB = [
+  [0.4124564, 0.3575761, 0.1804375],
+  [0.2126729, 0.7151522, 0.0721750],
+  [0.0193339, 0.1191920, 0.9503041],
+] as const;
+
+const LINEAR_SRGB_FROM_XYZ_D65 = [
+  [3.2404542, -1.5371385, -0.4985314],
+  [-0.9692660, 1.8760108, 0.0415560],
+  [0.0556434, -0.2040259, 1.0572252],
+] as const;
+
+const D50_TO_D65 = [
+  [0.9555766, -0.0230393, 0.0631636],
+  [-0.0282895, 1.0099416, 0.0210077],
+  [0.0122982, -0.0204830, 1.3299098],
+] as const;
+
+const D50_WHITE: readonly [number, number, number] = [0.9642, 1.0, 0.8249];
+
+function matMul3(
+  triple: readonly [number, number, number],
+  matrix: readonly (readonly [number, number, number])[],
+): [number, number, number] {
+  const [a, b, c] = triple;
+  return [
+    matrix[0]![0] * a + matrix[0]![1] * b + matrix[0]![2] * c,
+    matrix[1]![0] * a + matrix[1]![1] * b + matrix[1]![2] * c,
+    matrix[2]![0] * a + matrix[2]![1] * b + matrix[2]![2] * c,
+  ];
+}
+
+function srgbEncode(linear: number): number {
+  const v = Math.max(0, Math.min(1, linear));
+  if (v <= 0.0031308) return 12.92 * v;
+  return 1.055 * Math.pow(v, 1 / 2.4) - 0.055;
+}
+
+export function srgbDecode(channel: number): number {
+  const v = Math.max(0, Math.min(1, channel));
+  if (v <= 0.04045) return v / 12.92;
+  return Math.pow((v + 0.055) / 1.055, 2.4);
+}
+
+function clamp255(v: number): number {
+  return Math.max(0, Math.min(255, Math.round(v)));
+}
+
+/**
+ * Convert CIE Lab (D50, 2° observer) to an sRGB triplet on [0, 255].
+ * Out-of-gamut values are clamped per channel.
+ */
+export function labD50ToSrgb([L, a, b]: LabTriplet): RgbTriplet {
+  const fy = (L + 16) / 116;
+  const fx = a / 500 + fy;
+  const fz = fy - b / 200;
+  const eps = 216 / 24389;
+  const kappa = 24389 / 27;
+  const fxC = fx * fx * fx;
+  const fzC = fz * fz * fz;
+  const xr = fxC > eps ? fxC : (116 * fx - 16) / kappa;
+  const yr = L > kappa * eps ? Math.pow((L + 16) / 116, 3) : L / kappa;
+  const zr = fzC > eps ? fzC : (116 * fz - 16) / kappa;
+  const x50 = xr * D50_WHITE[0];
+  const y50 = yr * D50_WHITE[1];
+  const z50 = zr * D50_WHITE[2];
+  const [X, Y, Z] = matMul3([x50, y50, z50] as const, D50_TO_D65);
+  const [lr, lg, lb] = matMul3([X, Y, Z] as const, LINEAR_SRGB_FROM_XYZ_D65);
+  return [
+    clamp255(srgbEncode(lr) * 255),
+    clamp255(srgbEncode(lg) * 255),
+    clamp255(srgbEncode(lb) * 255),
+  ];
+}
+
+/**
+ * Convert CMYK (channels in 0–1 or 0–100, auto-detected) to a naïve
+ * subtractive sRGB triplet on [0, 255]. Approximation only — preserve
+ * for swatch chips, never press readouts.
+ */
+export function cmykToSrgbNaive([c, m, y, k]: CmykQuad): RgbTriplet {
+  const isPercent = c > 1 || m > 1 || y > 1 || k > 1;
+  const div = isPercent ? 100 : 1;
+  const cn = c / div;
+  const mn = m / div;
+  const yn = y / div;
+  const kn = k / div;
+  const r = (1 - cn) * (1 - kn);
+  const g = (1 - mn) * (1 - kn);
+  const b = (1 - yn) * (1 - kn);
+  return [clamp255(r * 255), clamp255(g * 255), clamp255(b * 255)];
+}
+
+const SPACE_COLLAPSE = /\s+/g;
+const SUFFIX_WITH_SPACE = /^(PANTONE\s+.+?)\s+([CUMV])$/;
+const SUFFIX_NO_SPACE = /^(PANTONE\s+.+\S)([CUMV])$/;
+const PMS_PREFIX = /^\s*(?:PMS|P\.M\.S\.|P\s*M\s*S)\s+/i;
+
+/**
+ * Canonicalise a Pantone-style name to UPPERCASE + collapsed spaces.
+ * Mirrors :func:`codex_pdf.color.normalize_pantone_name` (Python).
+ */
+export function normalizePantoneName(name: string): string {
+  return name.trim().replace(PMS_PREFIX, "PANTONE ").toUpperCase().replace(SPACE_COLLAPSE, " ");
+}
+
+/**
+ * Try alternate spacing around a trailing finish suffix (C/U/M/V).
+ * Returns null when the input doesn't carry a recognised suffix.
+ */
+export function alternatePantoneKey(key: string): string | null {
+  const ws = SUFFIX_WITH_SPACE.exec(key);
+  if (ws) return `${ws[1]}${ws[2]}`;
+  const ns = SUFFIX_NO_SPACE.exec(key);
+  if (ns) return `${ns[1]} ${ns[2]}`;
+  return null;
+}
+
+/**
+ * Stable hash-of-name → HSL → sRGB. Identical to the Python
+ * resolver's `hash_hue_rgb` so existing visual identities don't
+ * shuffle between the in-process and HTTP paths.
+ */
+export function hashHueRgb(name: string): RgbTriplet {
+  let hash = 0;
+  for (let i = 0; i < name.length; i++) {
+    hash = (name.charCodeAt(i) + ((hash << 5) - hash)) | 0;
+  }
+  const hue = Math.abs(hash) % 360;
+  const s = 0.7;
+  const l = 0.45;
+  const c = (1 - Math.abs(2 * l - 1)) * s;
+  const x = c * (1 - Math.abs(((hue / 60) % 2) - 1));
+  const m = l - c / 2;
+  let r = 0;
+  let g = 0;
+  let b = 0;
+  if (hue < 60) {
+    r = c;
+    g = x;
+  } else if (hue < 120) {
+    r = x;
+    g = c;
+  } else if (hue < 180) {
+    g = c;
+    b = x;
+  } else if (hue < 240) {
+    g = x;
+    b = c;
+  } else if (hue < 300) {
+    r = x;
+    b = c;
+  } else {
+    r = c;
+    b = x;
+  }
+  return [
+    Math.max(0, Math.min(255, Math.round((r + m) * 255))),
+    Math.max(0, Math.min(255, Math.round((g + m) * 255))),
+    Math.max(0, Math.min(255, Math.round((b + m) * 255))),
+  ];
+}

{codex_pdf-1.3.0 → codex_pdf-1.4.0}/clients/ts/src/index.test.ts

@@ -1,6 +1,13 @@
 import { describe, expect, it } from "vitest";
 
-import { CodexClientError, HttpClient } from "./index.js";
+import {
+  CodexClientError,
+  HttpClient,
+  alternatePantoneKey,
+  hashHueRgb,
+  labD50ToSrgb,
+  normalizePantoneName,
+} from "./index.js";
 
 describe("HttpClient", () => {
   it("requires baseUrl from options or env", () => {
@@ -65,6 +72,69 @@ describe("HttpClient", () => {
     expect(calls).toBe(1);
   });
 
+  it("normalises Pantone names and alternates", () => {
+    expect(normalizePantoneName("Pantone 485 c")).toBe("PANTONE 485 C");
+    expect(normalizePantoneName("PMS 485 C")).toBe("PANTONE 485 C");
+    expect(alternatePantoneKey("PANTONE 485 C")).toBe("PANTONE 485C");
+    expect(alternatePantoneKey("PANTONE 485C")).toBe("PANTONE 485 C");
+  });
+
+  it("converts Lab D50 white to clamped sRGB white", () => {
+    expect(labD50ToSrgb([100, 0, 0])).toEqual([255, 255, 255]);
+  });
+
+  it("hash-hue is stable across calls", () => {
+    expect(hashHueRgb("custom-spot")).toEqual(hashHueRgb("custom-spot"));
+  });
+
+  it("calls the codex color resolve endpoint", async () => {
+    let captured: string | undefined;
+    const fakeFetch: typeof fetch = async (_url, init) => {
+      captured = init?.body as string | undefined;
+      return new Response(
+        JSON.stringify({
+          schema_version: "1.0.0",
+          rgb: [200, 30, 30],
+          source: "pantone",
+          lab: [50, 70, 30],
+          cmyk: null,
+          pantone_name: "PANTONE 485 C",
+        }),
+        { status: 200, headers: { "Content-Type": "application/json" } },
+      );
+    };
+    const client = new HttpClient({ baseUrl: "http://codex.local", fetch: fakeFetch });
+    const result = await client.resolveSpotColor({ name: "PANTONE 485 C" });
+    expect(result.source).toBe("pantone");
+    expect(result.pantone_name).toBe("PANTONE 485 C");
+    expect(captured).toBe(JSON.stringify({ name: "PANTONE 485 C" }));
+  });
+
+  it("calls the codex tile endpoint", async () => {
+    const fakeFetch: typeof fetch = async () =>
+      new Response(
+        JSON.stringify({
+          schema_version: "1.0.0",
+          rows: 2,
+          cols: 2,
+          cells: [[0, 0, 80, 80]],
+          used: [0, 0, 80, 80],
+          waste: [0, 0, 200, 200],
+        }),
+        { status: 200, headers: { "Content-Type": "application/json" } },
+      );
+    const client = new HttpClient({ baseUrl: "http://codex.local", fetch: fakeFetch });
+    const result = await client.geomTile({
+      sheet: { x0: 0, y0: 0, x1: 200, y1: 200 },
+      cellWidth: 80,
+      cellHeight: 80,
+      gutterX: 20,
+      gutterY: 20,
+    });
+    expect(result.rows).toBe(2);
+    expect(result.cells.length).toBeGreaterThan(0);
+  });
+
   it("parses heatmap header runs", async () => {
     const png = new Uint8Array([0x89, 0x50, 0x4e, 0x47]);
     const fakeFetch: typeof fetch = async () =>