@dejadex/web 0.0.0-stage → 0.1.0

package/dist/usage/meter.js

@@ -0,0 +1,111 @@
+import { randomId } from './store.js';
+/** Reports per batch handed to the host. */
+export const MAX_BATCH_REPORTS = 500;
+/** Sessions whose seen cards are remembered at once; the oldest is forgotten first. */
+const MAX_SESSIONS = 32;
+export class UsageMeter {
+    store;
+    now;
+    newId;
+    /** session → card ids already charged (by either side) in it. */
+    seen = new Map();
+    /** lease id → cards charged under it on this page (device + service). */
+    used = new Map();
+    chain = Promise.resolve();
+    constructor(options) {
+        this.store = options.store;
+        this.now = options.now ?? (() => Date.now());
+        this.newId = options.newId ?? (() => (typeof crypto.randomUUID === 'function' ? crypto.randomUUID() : randomId()));
+    }
+    /** Cards charged under `leaseId` on this page so far. */
+    usedUnder(leaseId) {
+        return this.used.get(leaseId) ?? 0;
+    }
+    /** Whether the lease's allowance is used up. */
+    exhausted(lease) {
+        return this.usedUnder(lease.jti) >= lease.allowance;
+    }
+    /** Tallies one call's answers; resolves once the tally is stored. */
+    record(input) {
+        return this.serial(async () => {
+            const charged = [];
+            let serverCharged = 0;
+            if (input.purpose !== 'retry') {
+                const seen = this.sessionSet(input.session);
+                for (const r of input.results) {
+                    const top = r.candidates[0];
+                    if (r.kind !== 'card' || !r.confident || !top || seen.has(top.cardId))
+                        continue;
+                    seen.add(top.cardId);
+                    if (r.identificationId !== undefined)
+                        serverCharged++;
+                    else
+                        charged.push(top.cardId);
+                }
+            }
+            const leaseId = input.lease.jti;
+            this.used.set(leaseId, this.usedUnder(leaseId) + serverCharged + charged.length);
+            await this.store.tally(leaseId, input.session, charged, 1, this.now());
+            return { charged, serverCharged };
+        });
+    }
+    /**
+     * Seals the open tallies and hands the queued reports to `deliver` in
+     * batches of at most 500, oldest first. Each batch is removed once `deliver`
+     * resolves; a rejection stops the drain, leaves that batch queued, and is
+     * rethrown.
+     */
+    async drain(deliver) {
+        // Sealing goes through the record queue, so a tally being written is not split.
+        await this.serial(() => this.store.seal(this.newId));
+        const deviceId = await this.store.deviceId();
+        let delivered = 0;
+        for (;;) {
+            const reports = await this.store.peek(MAX_BATCH_REPORTS);
+            if (reports.length === 0)
+                break;
+            await deliver({ deviceId, reports });
+            await this.store.remove(reports.map((r) => r.reportId));
+            await this.store.markReported(reports);
+            delivered += reports.length;
+        }
+        return { delivered, pending: await this.store.size() };
+    }
+    pending() {
+        return this.store.size();
+    }
+    /**
+     * Makes sure the lease gets at least one report, even if nothing is ever
+     * identified under it: the service renews a lease only once the previous
+     * one has reported (an empty report counts).
+     */
+    touch(leaseId, session) {
+        return this.serial(() => this.store.tally(leaseId, session, [], 0, this.now()));
+    }
+    /** What the host's lease request carries about the lease being renewed. */
+    async leaseRequest(previousLeaseId) {
+        return {
+            previousLeaseId,
+            usageReportedThrough: previousLeaseId === null ? null : await this.store.reportedThrough(previousLeaseId),
+        };
+    }
+    sessionSet(session) {
+        let set = this.seen.get(session);
+        if (!set) {
+            set = new Set();
+            this.seen.set(session, set);
+            if (this.seen.size > MAX_SESSIONS) {
+                const oldest = this.seen.keys().next().value;
+                if (oldest !== undefined)
+                    this.seen.delete(oldest);
+            }
+        }
+        return set;
+    }
+    serial(task) {
+        const run = this.chain.then(task, task);
+        this.chain = run.catch(() => undefined);
+        return run;
+    }
+}
+//# sourceMappingURL=meter.js.map

package/dist/usage/meter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meter.js","sourceRoot":"","sources":["../../src/usage/meter.ts"],"names":[],"mappings":"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"}

package/dist/usage/store.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The device's usage queue: what was counted waits here, across reloads,
+ * until the host has delivered it. IndexedDB in the browser; an in-memory
+ * store for tests and for runtimes without IndexedDB (where usage then lives
+ * only as long as the page).
+ *
+ * Two stages:
+ *   - a **tally** per (lease, session) collects the cards first identified in
+ *     that session and the number of calls, as answers come in;
+ *   - `seal` turns every open tally into a `UsageReport` with the lease's next
+ *     `seq` and a fresh `reportId`, atomically. A sealed report never changes,
+ *     so delivering it twice is harmless (the service dedupes by `reportId`).
+ *
+ * Database `dejadex-usage`, version 1:
+ *   tallies  key `<leaseId>\n<sessionId>` → Tally
+ *   reports  keyPath `report.reportId`, index `order` → { order, report }
+ *   meta     `deviceId`, `order`, `seq:<leaseId>`, `reported:<leaseId>`
+ */
+import type { UsageReport } from '../types.js';
+export interface Tally {
+    readonly leaseId: string;
+    readonly sessionId: string;
+    /** Distinct, in first-seen order. */
+    readonly cardIds: readonly string[];
+    readonly calls: number;
+    /** Device clock (ms) of the latest addition. */
+    readonly at: number;
+}
+export interface UsageStore {
+    /** A random per-install id (at least 128 bits), created on first use. */
+    deviceId(): Promise<string>;
+    /** Adds cards (deduplicated) and calls to the open tally of (lease, session). */
+    tally(leaseId: string, sessionId: string, cardIds: readonly string[], calls: number, at: number): Promise<void>;
+    /** Seals every open tally into a queued report; returns how many were sealed. */
+    seal(newReportId: () => string): Promise<number>;
+    /** The oldest `limit` queued reports, in queue order. */
+    peek(limit: number): Promise<readonly UsageReport[]>;
+    remove(reportIds: readonly string[]): Promise<void>;
+    /** Records that these reports were delivered: each lease's highest delivered `seq`. */
+    markReported(reports: readonly UsageReport[]): Promise<void>;
+    /** The highest delivered `seq` of a lease, or null when none was. */
+    reportedThrough(leaseId: string): Promise<number | null>;
+    /** Queued reports plus open tallies. */
+    size(): Promise<number>;
+}
+export declare function randomId(bytes?: number): string;
+export declare function memoryUsageStore(): UsageStore;
+/** The IndexedDB store. `factory` defaults to the global `indexedDB`. */
+export declare function indexedDbUsageStore(factory?: IDBFactory): Promise<UsageStore>;
+/** IndexedDB where it opens, else memory (private windows can refuse it). */
+export declare function defaultUsageStore(): Promise<UsageStore>;
+//# sourceMappingURL=store.d.ts.map

package/dist/usage/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/usage/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,yEAAyE;IACzE,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3B,iFAAiF;IACjF,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/G,iFAAiF;IACjF,IAAI,CAAC,WAAW,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAChD,yDAAyD;IACzD,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAA;IACpD,MAAM,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,uFAAuF;IACvF,YAAY,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,qEAAqE;IACrE,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACxD,wCAAwC;IACxC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CACxB;AAED,wBAAgB,QAAQ,CAAC,KAAK,SAAK,GAAG,MAAM,CAM3C;AAqBD,wBAAgB,gBAAgB,IAAI,UAAU,CA0C7C;AAyBD,yEAAyE;AACzE,wBAAsB,mBAAmB,CAAC,OAAO,GAAE,UAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CA2F9F;AAED,6EAA6E;AAC7E,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,UAAU,CAAC,CAO7D"}

package/dist/usage/store.js

@@ -0,0 +1,198 @@
+export function randomId(bytes = 16) {
+    const b = new Uint8Array(bytes);
+    crypto.getRandomValues(b);
+    let out = '';
+    for (const x of b)
+        out += x.toString(16).padStart(2, '0');
+    return out;
+}
+const tallyKey = (leaseId, sessionId) => `${leaseId}\n${sessionId}`;
+function merge(prev, leaseId, sessionId, cardIds, calls, at) {
+    const cards = [...(prev?.cardIds ?? [])];
+    for (const id of cardIds)
+        if (!cards.includes(id))
+            cards.push(id);
+    return { leaseId, sessionId, cardIds: cards, calls: (prev?.calls ?? 0) + calls, at };
+}
+const toReport = (t, seq, reportId) => ({
+    reportId,
+    leaseId: t.leaseId,
+    seq,
+    sessionId: t.sessionId,
+    distinctCards: t.cardIds.length,
+    cardIds: [...t.cardIds],
+    calls: t.calls,
+    at: t.at,
+});
+export function memoryUsageStore() {
+    let device = null;
+    const seq = new Map();
+    const tallies = new Map();
+    const queue = [];
+    const reported = new Map();
+    return {
+        async deviceId() {
+            device ??= randomId();
+            return device;
+        },
+        async tally(leaseId, sessionId, cardIds, calls, at) {
+            const key = tallyKey(leaseId, sessionId);
+            tallies.set(key, merge(tallies.get(key), leaseId, sessionId, cardIds, calls, at));
+        },
+        async seal(newReportId) {
+            const open = [...tallies.values()];
+            tallies.clear();
+            for (const t of open) {
+                const next = (seq.get(t.leaseId) ?? 0) + 1;
+                seq.set(t.leaseId, next);
+                queue.push(toReport(t, next, newReportId()));
+            }
+            return open.length;
+        },
+        async peek(limit) {
+            return queue.slice(0, limit);
+        },
+        async remove(ids) {
+            const drop = new Set(ids);
+            for (let i = queue.length - 1; i >= 0; i--)
+                if (drop.has(queue[i].reportId))
+                    queue.splice(i, 1);
+        },
+        async markReported(reports) {
+            for (const r of reports)
+                reported.set(r.leaseId, Math.max(reported.get(r.leaseId) ?? 0, r.seq));
+        },
+        async reportedThrough(leaseId) {
+            return reported.get(leaseId) ?? null;
+        },
+        async size() {
+            return queue.length + tallies.size;
+        },
+    };
+}
+const DB_NAME = 'dejadex-usage';
+const DB_VERSION = 1;
+function request(req) {
+    return new Promise((resolve, reject) => {
+        req.onsuccess = () => resolve(req.result);
+        req.onerror = () => reject(req.error ?? new Error('IndexedDB request failed'));
+    });
+}
+function done(tx) {
+    return new Promise((resolve, reject) => {
+        tx.oncomplete = () => resolve();
+        tx.onabort = () => reject(tx.error ?? new Error('IndexedDB transaction aborted'));
+        tx.onerror = () => reject(tx.error ?? new Error('IndexedDB transaction failed'));
+    });
+}
+/** The IndexedDB store. `factory` defaults to the global `indexedDB`. */
+export async function indexedDbUsageStore(factory = indexedDB) {
+    const open = factory.open(DB_NAME, DB_VERSION);
+    open.onupgradeneeded = () => {
+        const db = open.result;
+        if (!db.objectStoreNames.contains('tallies'))
+            db.createObjectStore('tallies');
+        if (!db.objectStoreNames.contains('reports')) {
+            db.createObjectStore('reports', { keyPath: 'report.reportId' }).createIndex('order', 'order', { unique: true });
+        }
+        if (!db.objectStoreNames.contains('meta'))
+            db.createObjectStore('meta');
+    };
+    const db = await request(open);
+    return {
+        async deviceId() {
+            const tx = db.transaction('meta', 'readwrite');
+            const meta = tx.objectStore('meta');
+            let id = (await request(meta.get('deviceId')));
+            if (typeof id !== 'string') {
+                id = randomId();
+                meta.put(id, 'deviceId');
+            }
+            await done(tx);
+            return id;
+        },
+        async tally(leaseId, sessionId, cardIds, calls, at) {
+            const tx = db.transaction('tallies', 'readwrite');
+            const store = tx.objectStore('tallies');
+            const key = tallyKey(leaseId, sessionId);
+            const prev = (await request(store.get(key)));
+            store.put(merge(prev, leaseId, sessionId, cardIds, calls, at), key);
+            await done(tx);
+        },
+        async seal(newReportId) {
+            const tx = db.transaction(['tallies', 'reports', 'meta'], 'readwrite');
+            const tallies = tx.objectStore('tallies');
+            const reports = tx.objectStore('reports');
+            const meta = tx.objectStore('meta');
+            const open = (await request(tallies.getAll()));
+            let order = (await request(meta.get('order'))) ?? 0;
+            const seqs = new Map();
+            for (const t of open) {
+                const key = `seq:${t.leaseId}`;
+                let last = seqs.get(key);
+                if (last === undefined)
+                    last = (await request(meta.get(key))) ?? 0;
+                const next = last + 1;
+                seqs.set(key, next);
+                reports.put({ order: ++order, report: toReport(t, next, newReportId()) });
+            }
+            for (const [key, value] of seqs)
+                meta.put(value, key);
+            meta.put(order, 'order');
+            tallies.clear();
+            await done(tx);
+            return open.length;
+        },
+        async peek(limit) {
+            const tx = db.transaction('reports', 'readonly');
+            const rows = (await request(tx.objectStore('reports').index('order').getAll(null, limit)));
+            await done(tx);
+            return rows.map((r) => r.report);
+        },
+        async remove(ids) {
+            const tx = db.transaction('reports', 'readwrite');
+            const store = tx.objectStore('reports');
+            for (const id of ids)
+                store.delete(id);
+            await done(tx);
+        },
+        async markReported(reports) {
+            const tx = db.transaction('meta', 'readwrite');
+            const meta = tx.objectStore('meta');
+            const top = new Map();
+            for (const r of reports)
+                top.set(r.leaseId, Math.max(top.get(r.leaseId) ?? 0, r.seq));
+            for (const [leaseId, seq] of top) {
+                const key = `reported:${leaseId}`;
+                const prev = (await request(meta.get(key)));
+                if (prev === undefined || seq > prev)
+                    meta.put(seq, key);
+            }
+            await done(tx);
+        },
+        async reportedThrough(leaseId) {
+            const tx = db.transaction('meta', 'readonly');
+            const v = (await request(tx.objectStore('meta').get(`reported:${leaseId}`)));
+            await done(tx);
+            return v ?? null;
+        },
+        async size() {
+            const tx = db.transaction(['reports', 'tallies'], 'readonly');
+            const [a, b] = await Promise.all([request(tx.objectStore('reports').count()), request(tx.objectStore('tallies').count())]);
+            await done(tx);
+            return a + b;
+        },
+    };
+}
+/** IndexedDB where it opens, else memory (private windows can refuse it). */
+export async function defaultUsageStore() {
+    try {
+        if (typeof indexedDB !== 'undefined')
+            return await indexedDbUsageStore();
+    }
+    catch {
+        // fall through to memory
+    }
+    return memoryUsageStore();
+}
+//# sourceMappingURL=store.js.map

package/dist/usage/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/usage/store.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,66 @@
 {
   "name": "@dejadex/web",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Framework-free browser SDK: on-device card detection, tracking and identification",
+  "license": "UNLICENSED",
+  "homepage": "https://dejadex.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dejadexhq/DejaDex.git",
+    "directory": "sdk/web"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./identify-worker": {
+      "types": "./dist/identify/worker.d.ts",
+      "import": "./dist/identify/worker.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.testutil.ts",
+    "!src/**/__fixtures__",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": [
+    "./dist/identify/worker.js"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepack": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --report-unused-disable-directives --max-warnings 0",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "assets:dev": "node scripts/dev-assets.mjs",
+    "measure:identify": "npm run build && node scripts/measure-identify.mjs"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.5",
+    "eslint": "^9.39.5",
+    "fake-indexeddb": "6.2.6",
+    "globals": "^15.15.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.65.0",
+    "vitest": "^5.0.5"
+  },
+  "dependencies": {
+    "@noble/ed25519": "3.2.0",
+    "onnxruntime-web": "1.30.0"
+  }
+}

package/src/errors.ts

@@ -0,0 +1,24 @@
+/** Machine-readable reasons the scanner refuses or stops. Stable; hosts branch on them. */
+export type ScannerErrorCode =
+  | 'INVALID_OPTIONS'
+  | 'NOT_IMPLEMENTED'
+  | 'LEASE_INVALID'
+  | 'LEASE_EXPIRED'
+  | 'ALLOWANCE_EXHAUSTED'
+  | 'ORIGIN_NOT_ALLOWED'
+  | 'DOMAIN_NOT_ALLOWED'
+  | 'UNSUPPORTED_DEVICE'
+  | 'MODEL_INTEGRITY'
+  | 'NETWORK'
+
+export class ScannerError extends Error {
+  override readonly name = 'ScannerError'
+
+  constructor(
+    readonly code: ScannerErrorCode,
+    message: string,
+    options?: ErrorOptions,
+  ) {
+    super(message, options)
+  }
+}

package/src/geometry/homography.ts

@@ -0,0 +1,178 @@
+/**
+ * Planar homographies for AR labels: the projective map from a card's own
+ * unit rectangle to the four corners the detector found on screen, and its
+ * CSS `matrix3d` form, so a host page can lay a DOM element on the card's
+ * plane with nothing but `transform`.
+ *
+ * Conventions, fixed for every consumer:
+ *
+ * - Card space is the unit square: (0,0) top-left, (1,0) top-right, (1,1)
+ *   bottom-right, (0,1) bottom-left of the card as printed (portrait).
+ * - Screen space is CSS pixels of the element the corners were measured in,
+ *   y pointing down.
+ * - A `Quad` lists the screen corners in that same order: TL, TR, BR, BL.
+ * - A `Homography` is a 3×3 matrix in ROW-MAJOR order, normalised so the
+ *   bottom-right entry is 1. It maps (u, v, 1) to (x·w, y·w, w).
+ *
+ * The square-to-quad solution is the closed form from P. Heckbert,
+ * "Fundamentals of Texture Mapping and Image Warping" (1989), §2.2.3: no
+ * linear solve, exact for any convex quad, and cheap enough to run per track
+ * per frame.
+ */
+
+export interface Point {
+  readonly x: number
+  readonly y: number
+}
+
+/** Screen corners in card order: top-left, top-right, bottom-right, bottom-left. */
+export type Quad = readonly [Point, Point, Point, Point]
+
+/** Row-major 3×3 matrix, `[a, b, c, d, e, f, g, h, i]` with i = 1 once normalised. */
+export type Homography = readonly [number, number, number, number, number, number, number, number, number]
+
+export const IDENTITY: Homography = [1, 0, 0, 0, 1, 0, 0, 0, 1]
+
+/** The unit card rectangle's corners, in `Quad` order. */
+export const UNIT_QUAD: Quad = [
+  { x: 0, y: 0 },
+  { x: 1, y: 0 },
+  { x: 1, y: 1 },
+  { x: 0, y: 1 },
+]
+
+/** Relative tolerance below which a quad or a matrix counts as degenerate. */
+const DEGENERATE_EPS = 1e-12
+
+const isFiniteQuad = (q: Quad): boolean => q.every((p) => Number.isFinite(p.x) && Number.isFinite(p.y))
+
+/**
+ * The homography that maps the unit card rectangle onto `quad`.
+ *
+ * Throws `RangeError` when no proper homography exists: a non-finite corner,
+ * three collinear corners (zero area), or a quad that is not convex — a
+ * concave or self-crossing quad would need the projective plane to fold, and
+ * the label would be drawn through the horizon.
+ */
+export function unitSquareToQuad(quad: Quad): Homography {
+  if (!isFiniteQuad(quad)) throw new RangeError('quad has a non-finite corner')
+  const [p0, p1, p2, p3] = quad
+
+  const dx1 = p1.x - p2.x
+  const dx2 = p3.x - p2.x
+  const dy1 = p1.y - p2.y
+  const dy2 = p3.y - p2.y
+  const sx = p0.x - p1.x + p2.x - p3.x
+  const sy = p0.y - p1.y + p2.y - p3.y
+
+  const span = Math.max(
+    ...quad.map((p) => Math.abs(p.x - p0.x)),
+    ...quad.map((p) => Math.abs(p.y - p0.y)),
+  )
+  const den = dx1 * dy2 - dx2 * dy1
+  if (span === 0 || Math.abs(den) <= DEGENERATE_EPS * span * span) {
+    throw new RangeError('quad is degenerate (zero area or collinear corners)')
+  }
+
+  const g = (sx * dy2 - dx2 * sy) / den
+  const h = (dx1 * sy - sx * dy1) / den
+
+  // w at each corner: (0,0) → 1, (1,0) → 1+g, (1,1) → 1+g+h, (0,1) → 1+h.
+  // All must share a sign, or the quad is not the image of a convex square.
+  if (1 + g <= DEGENERATE_EPS || 1 + h <= DEGENERATE_EPS || 1 + g + h <= DEGENERATE_EPS) {
+    throw new RangeError('quad is not convex')
+  }
+
+  return [
+    p1.x - p0.x + g * p1.x,
+    p3.x - p0.x + h * p3.x,
+    p0.x,
+    p1.y - p0.y + g * p1.y,
+    p3.y - p0.y + h * p3.y,
+    p0.y,
+    g,
+    h,
+    1,
+  ]
+}
+
+/** Maps a point through `m`. Throws `RangeError` for a point on the vanishing line. */
+export function applyHomography(m: Homography, p: Point): Point {
+  const [a, b, c, d, e, f, g, h, i] = m
+  const w = g * p.x + h * p.y + i
+  if (Math.abs(w) <= DEGENERATE_EPS) throw new RangeError('point maps to infinity')
+  return { x: (a * p.x + b * p.y + c) / w, y: (d * p.x + e * p.y + f) / w }
+}
+
+/** `a · b` (apply `b` first, then `a`), normalised. */
+export function multiplyHomography(a: Homography, b: Homography): Homography {
+  const r = (row: number, col: number): number =>
+    a[row * 3]! * b[col]! + a[row * 3 + 1]! * b[3 + col]! + a[row * 3 + 2]! * b[6 + col]!
+  return normalise([r(0, 0), r(0, 1), r(0, 2), r(1, 0), r(1, 1), r(1, 2), r(2, 0), r(2, 1), r(2, 2)])
+}
+
+/** The inverse map, normalised. Throws `RangeError` for a singular matrix. */
+export function invertHomography(m: Homography): Homography {
+  const [a, b, c, d, e, f, g, h, i] = m
+  const A = e * i - f * h
+  const B = -(d * i - f * g)
+  const C = d * h - e * g
+  const det = a * A + b * B + c * C
+  const scale = Math.max(...m.map(Math.abs))
+  if (!Number.isFinite(det) || Math.abs(det) <= DEGENERATE_EPS * scale * scale * scale) {
+    throw new RangeError('homography is singular')
+  }
+  // Adjugate (transposed cofactors); the 1/det factor cancels in normalise().
+  return normalise([A, -(b * i - c * h), b * f - c * e, B, a * i - c * g, -(a * f - c * d), C, -(a * h - b * g), a * e - b * d])
+}
+
+/** Scales `m` so its bottom-right entry is 1. */
+export function normalise(m: readonly number[]): Homography {
+  const k = m[8]!
+  if (Math.abs(k) <= DEGENERATE_EPS) throw new RangeError('homography cannot be normalised (h33 = 0)')
+  return m.map((v) => v / k) as unknown as Homography
+}
+
+export interface ElementSize {
+  /** The label element's layout width in CSS pixels (its `offsetWidth`). */
+  readonly width: number
+  /** The label element's layout height in CSS pixels (its `offsetHeight`). */
+  readonly height: number
+}
+
+/**
+ * The CSS `matrix3d(...)` that draws an element of `size` onto the quad that
+ * `m` maps the unit card to.
+ *
+ * The element must be absolutely positioned at the origin of the coordinate
+ * space the corners were measured in, with `transform-origin: 0 0`. Its own
+ * box (0..width, 0..height) is first scaled to the unit square, then sent
+ * through `m`. The 3×3 homography becomes the 4×4
+ *
+ *     | a b 0 c |
+ *     | d e 0 f |
+ *     | 0 0 1 0 |
+ *     | g h 0 i |
+ *
+ * which leaves z alone, and CSS takes it in COLUMN-major order.
+ */
+export function toCssMatrix3d(m: Homography, size: ElementSize = { width: 1, height: 1 }): string {
+  if (!(size.width > 0) || !(size.height > 0)) throw new RangeError('element size must be positive')
+  const scaled = multiplyHomography(m, [1 / size.width, 0, 0, 0, 1 / size.height, 0, 0, 0, 1])
+  const [a, b, c, d, e, f, g, h, i] = scaled
+  const columnMajor = [a, d, 0, g, b, e, 0, h, 0, 0, 1, 0, c, f, 0, i]
+  return `matrix3d(${columnMajor.map(formatCssNumber).join(', ')})`
+}
+
+/** Fixed precision, no `-0`, no exponent: what every engine parses identically. */
+function formatCssNumber(v: number): string {
+  if (!Number.isFinite(v)) throw new RangeError('non-finite matrix entry')
+  const fixed = Number(v.toFixed(12))
+  if (fixed === 0) return '0'
+  return fixed.toFixed(12).replace(/\.?0+$/, '')
+}
+
+/** Convenience for the common case: corners in, CSS transform out. */
+export function quadToCssMatrix3d(quad: Quad, size?: ElementSize): string {
+  return toCssMatrix3d(unitSquareToQuad(quad), size)
+}