import assert from "node:assert/strict"; import { HoverIntent, sameScope, processorMatches, preparationQueue, selectSuccessfulAnnotationJobs, mergeCachedAnnotationEntries, } from "../src/work.js"; const oldProcessor = { key: "processor-v1:scope" }; assert(processorMatches(oldProcessor, "processor-v1")); assert( !processorMatches(oldProcessor, "processor-v2"), "A checked processor edit invalidates saved results even when document and feature settings are unchanged", ); assert(!processorMatches({ key: "processor-v10:scope" }, "processor-v1")); const feature = { processor: "definition", generation: "focus", scope: "word", reveal: "hover", configRevision: 2, enabled: true, }; assert( sameScope( { sourceRevision: "s", configuration: "compute", featureRevision: 2, start: 0, end: 2, status: "ready" }, "s", "compute", { start: 0, end: 2, }, ), ); assert( !sameScope( { sourceRevision: "s", configuration: "different", featureRevision: 1, start: 0, end: 2, status: "ready" }, "s", "compute", { start: 0, end: 2, }, ), ); const intent = new HoverIntent(10); let calls: string[] = []; intent.schedule(() => calls.push("old")); intent.schedule(() => calls.push("new")); await new Promise((resolve) => setTimeout(resolve, 30)); assert.deepEqual(calls, ["new"]); intent.schedule(() => calls.push("left")); intent.cancel(); await new Promise((resolve) => setTimeout(resolve, 30)); assert.deepEqual(calls, ["new"]); intent.schedule(() => calls.push("unmounted")); intent.cancel(); console.log("PASS heavy hover intent, cancellation, scopes and stale cache guards"); const scope = (key: string, configuration: string, start: number, local = false) => ({ key, configuration, range: { start, end: start + 10 }, local, }); const empty = new Set(); const a = scope("a", "pinyin", 0), b = scope("b", "pinyin", 10), c = scope("c", "pinyin", 20); assert.deepEqual( preparationQueue([a, b, c], { start: 0, end: 30 }, 0, empty, empty).admit, [a, b], "Independent sections of the same annotator can use both model slots", ); const d = scope("d", "names", 0); assert.deepEqual( preparationQueue([a, b, c, d], { start: 0, end: 30 }, 0, empty, empty).admit, [a, d], "Features take turns when their scopes are equally close", ); const full = preparationQueue([a, b, c], { start: 0, end: 30 }, 2, empty, empty); assert.deepEqual(full.admit, []); assert.deepEqual(full.waiting, [a, b, c], "Unadmitted scopes remain available for queued outlines"); assert.deepEqual( preparationQueue([a, a, b, c], { start: 0, end: 30 }, 0, new Set(["b"]), new Set(["a"])).waiting, [c], "Cached ready or failed scopes, admitted intents and shared-computation duplicates do not get queued outlines", ); assert.deepEqual( preparationQueue([a, b, c], { start: 10, end: 20 }, 1, empty, empty).admit, [b], "Visible work takes the released slot before neighboring scopes", ); const local = scope("local", "local", 20, true); assert.deepEqual( preparationQueue([a, local], { start: 0, end: 30 }, 2, empty, empty).admit, [local], "Local annotations do not wait for inference slots", ); console.log("PASS queued outlines, bounded independent scope admission, fair features and cache exclusion"); import { presentAnnotations } from "../src/annotation-display.js"; const readings = [ { start: 0, end: 2, text: "Běijīng", tag: "hsk:3" }, { start: 2, end: 4, text: "xīngqīliù", tag: "hsk:1" }, ]; assert.equal(presentAnnotations("pinyin", readings, { minimumLevel: "2" }).length, 1); assert.equal(presentAnnotations("pinyin", readings, { minimumLevel: "0" }).length, 2); assert.equal( presentAnnotations("pinyinWord", readings, { minimumLevel: "8" }).length, 2, "Hover includes easy words too", ); assert.equal( presentAnnotations("names", [{ ...readings[0], tag: "place" }], { placeColor: "#123456" })[0].color, "#123456", ); console.log("PASS local HSK filtering, all-word hover pinyin and category recoloring from raw cache"); import { renderAnnotations } from "../src/render-hooks.js"; import type { Annotation } from "../src/canvas/types.js"; const source = "🙂 Un mot littéraire."; const semantic: Annotation = { id: "item", feature: "source", start: 6, end: 9, text: "word", style: "replace", color: "#123456", }; const outputs = renderAnnotations(semantic, source, [ { style: "replace", reveal: "always" }, { style: "color", reveal: "always" }, { style: "tooltip", reveal: "hover", content: "source" }, ]); assert.deepEqual( outputs.map(({ style, text, reveal }) => ({ style, text, reveal })), [ { style: "replace", text: "word", reveal: "always" }, { style: "color", text: "word", reveal: "always" }, { style: "tooltip", text: "mot", reveal: "hover" }, ], ); assert.equal(new Set(outputs.map((output) => output.id)).size, 3); assert(outputs.every((output) => output.feature === semantic.feature && output.start === 6 && output.end === 9)); assert.equal(semantic.text, "word", "Rendering never mutates cached semantic data"); assert.deepEqual(renderAnnotations(semantic, source, undefined), [semantic]); console.log("PASS one source rendered as replacement, color and original-text hover tooltip"); assert( sameScope( { sourceRevision: "doc@1", featureRevision: 4, start: 0, end: 6, status: "ready", configuration: JSON.stringify({ processor: "pinyin", scope: "word", generation: "section", options: {} }), }, "doc@1", JSON.stringify({ processor: "pinyin", scope: "word", options: {} }), { start: 0, end: 6 }, ), "Changing preparation timing reuses a persisted semantic result", ); assert(processorMatches({ key: "verified-previous:light-fast:result" }, "current", ["verified-previous"])); assert(!processorMatches({ key: "unknown:light-fast:result" }, "current", ["verified-previous"])); const scopeConfiguration = JSON.stringify({ processor: "pinyin", scope: "word", options: {} }); const savedJob = (object: string, createdAt: string, items: unknown[], key = "current:scope") => ({ _camino: { ref: { object } }, configuration: scopeConfiguration, data: { key, kind: "annotation", status: "ready", sourceRevision: "doc@1", start: 0, end: 6, createdAt, output: JSON.stringify({ items }), }, }); const oldFacts = savedJob("old", "2026-10-01", [ { start: 0, end: 2 }, { start: 2, end: 4 }, ]), clearedFacts = savedJob("cleared", "2026-10-02", []), narrowedFacts = savedJob("narrowed", "2026-10-03", [{ start: 0, end: 2 }]), failedFacts = { ...savedJob("failed", "2026-10-04", []), data: { ...oldFacts.data, status: "failed", createdAt: "2026-10-04" }, }; const accepts = (job: typeof oldFacts) => processorMatches(job.data, "current", ["verified-previous"]); assert.deepEqual( selectSuccessfulAnnotationJobs([oldFacts, clearedFacts], accepts), [clearedFacts], "An empty successful regeneration clears its old items", ); assert.deepEqual( selectSuccessfulAnnotationJobs([oldFacts, clearedFacts, narrowedFacts, failedFacts], accepts), [narrowedFacts], "A smaller successful output replaces the whole scope; failure does not erase success", ); const oldAlias = { ...oldFacts, data: { ...oldFacts.data, key: "verified-previous:light-fast:legacy" }, configuration: JSON.stringify({ processor: "pinyin", scope: "word", generation: "section", options: {} }), }; const unknown = savedJob("unknown", "2026-10-05", [{ start: 4, end: 6 }], "unknown:scope"); assert.deepEqual( selectSuccessfulAnnotationJobs([oldAlias, clearedFacts, unknown], accepts), [clearedFacts], "Verified revision aliases and old generation formatting describe the same semantic scope; unknown revisions cannot replace it", ); const anotherRange = { ...oldFacts, data: { ...oldFacts.data, start: 6, end: 8 } }, anotherSource = { ...oldFacts, data: { ...oldFacts.data, sourceRevision: "doc@2" } }, anotherInput = { ...oldFacts, configuration: JSON.stringify({ processor: "pinyin", scope: "word", options: { targetLanguage: "French" } }), }; assert.equal( selectSuccessfulAnnotationJobs([clearedFacts, anotherRange, anotherSource, anotherInput], accepts).length, 4, "Different semantic inputs, ranges and sources retain independent results", ); const canonical = mergeCachedAnnotationEntries([{ node: oldFacts }], [{ node: narrowedFacts }, { node: failedFacts }]); assert.deepEqual( canonical.map(({ node }) => node._camino.ref.object), ["old", "failed"], "Indexed success takes precedence over newer attempt history for its exact key", ); assert.deepEqual( selectSuccessfulAnnotationJobs( canonical.map(({ node }) => node), accepts, ), [oldFacts], ); assert.deepEqual( mergeCachedAnnotationEntries([{ node: clearedFacts }, { node: oldFacts }], []), [{ node: clearedFacts }], "Overlapping pagination snapshots retain one canonical pointer per key", ); assert.deepEqual( JSON.parse(oldFacts.data.output).items, [ { start: 0, end: 2 }, { start: 2, end: 4 }, ], "Selection never mutates retained historical output", ); console.log( "PASS canonical cache pointers and whole-scope replacement, including empty/narrowed successes, aliases and failed retries", );