@dailephd/my-frontend-observer 0.8.1 → 0.9.0

package/dist/domain/visualAnnotation.js

@@ -0,0 +1,584 @@
+/**
+ * v0.9 Batch 1 visual-annotation artifact family (frozen by
+ * docs/plans/v0.9-implementation-plan.md sections 3 and 4). A visual
+ * annotation is structured human intent drawn over exactly one existing
+ * source: a runtime observation screenshot (viewport CSS pixels) or an
+ * external reference image (reference-image pixels). The two coordinate and
+ * identity domains are never collapsed.
+ *
+ * This module owns the types, the one canonical structural validator
+ * (`isValidVisualAnnotationArtifact`, used by both the writer and the
+ * reader), and the one pure deterministic overlay renderer
+ * (`renderVisualAnnotationOverlaySvg`). It never reads the filesystem, never
+ * resolves whether an associated target/region exists in another artifact,
+ * never promotes intent into a contract, and never materializes reference
+ * regions/requirements - those belong to later v0.9 batches.
+ *
+ * Observations and external references remain immutable evidence: this
+ * module adds no field to ObservationArtifact, ExternalReferenceArtifact,
+ * ComparisonArtifact, or any contract artifact.
+ */
+import { PRODUCER_NAME, SCHEMA_VERSION as OBSERVATION_SCHEMA_VERSION } from './schema.js';
+import { EXTERNAL_REFERENCE_SCHEMA_VERSION } from './externalReference.js';
+import { PAIRWISE_RELATIONSHIP_KINDS, PAGE_LEVEL_RELATIONSHIP_KINDS } from './relationships.js';
+import { isAuthoredChangeScopeCategory, isValidExpectedDependentMode, isValidContractPrimitive } from './frontendContracts.js';
+import { isValidReferenceRegions } from './externalReferenceRegions.js';
+import { isValidRawReferenceRequirement } from './externalReferenceRequirements.js';
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+function isFiniteNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value);
+}
+/** Rejects extra keys beyond the given allowlist, keeping every annotation shape closed rather than an open bag of fields. */
+function hasOnlyKeys(value, allowedKeys) {
+    return Object.keys(value).every((key) => allowedKeys.includes(key));
+}
+function isPresent(value, key) {
+    return key in value && value[key] !== undefined;
+}
+/**
+ * A single portable path segment: no separators, no drive/stream colon, no
+ * NUL, never "." or "..". Used for the runtime screenshot reference (same
+ * bare-filename convention as observation `screenshot.path` and
+ * external-reference `image.path`) and for `annotationId`, which names the
+ * artifact's own directory.
+ */
+function isSafeBareSegment(value) {
+    if (!isNonEmptyString(value))
+        return false;
+    if (value === '.' || value === '..')
+        return false;
+    return !value.includes('/') && !value.includes('\\') && !value.includes(':') && !value.includes(String.fromCharCode(0));
+}
+const SHA256_HEX_PATTERN = /^[0-9a-f]{64}$/;
+export const VISUAL_ANNOTATION_ARTIFACT_KIND = 'my-frontend-observer/visual-annotation';
+export const VISUAL_ANNOTATION_SCHEMA_VERSION = '1.0.0';
+export const MAX_VISUAL_ANNOTATION_ITEMS = 100;
+export const MAX_VISUAL_ANNOTATION_NOTE_LENGTH = 2000;
+/** The one owned derived overlay filename (frozen plan section 3.12). */
+export const VISUAL_ANNOTATION_OVERLAY_PATH = 'annotation-overlay.svg';
+const VALID = { valid: true };
+function invalid(reason) {
+    return { valid: false, reason };
+}
+function validateCoordinateSpace(value, expectedKind) {
+    if (!isPlainObject(value) || !hasOnlyKeys(value, ['kind', 'width', 'height']))
+        return invalid('source.coordinateSpace must be { kind, width, height }');
+    if (value.kind !== expectedKind)
+        return invalid(`source.coordinateSpace.kind must be "${expectedKind}" for this source kind`);
+    if (!isFiniteNumber(value.width) || value.width <= 0)
+        return invalid('source.coordinateSpace.width must be a finite number greater than 0');
+    if (!isFiniteNumber(value.height) || value.height <= 0)
+        return invalid('source.coordinateSpace.height must be a finite number greater than 0');
+    return VALID;
+}
+function validateSource(value) {
+    if (!isPlainObject(value))
+        return invalid('source must be an object');
+    if (value.kind === 'runtime-observation') {
+        if (!hasOnlyKeys(value, ['kind', 'observationId', 'requestId', 'observationSchemaVersion', 'screenshot', 'coordinateSpace'])) {
+            return invalid('runtime-observation source contains unsupported fields');
+        }
+        if (!isNonEmptyString(value.observationId))
+            return invalid('source.observationId must be a non-empty string');
+        if (!isNonEmptyString(value.requestId))
+            return invalid('source.requestId must be a non-empty string');
+        if (value.observationSchemaVersion !== OBSERVATION_SCHEMA_VERSION)
+            return invalid(`source.observationSchemaVersion must be "${OBSERVATION_SCHEMA_VERSION}"`);
+        if (!isPlainObject(value.screenshot) || !hasOnlyKeys(value.screenshot, ['path']) || !isSafeBareSegment(value.screenshot.path)) {
+            return invalid('source.screenshot.path must be a safe bare artifact-relative filename');
+        }
+        return validateCoordinateSpace(value.coordinateSpace, 'runtime-css-px');
+    }
+    if (value.kind === 'external-reference') {
+        if (!hasOnlyKeys(value, ['kind', 'referenceId', 'referenceRequestId', 'referenceSchemaVersion', 'lifecycle', 'imageOwnerReferenceId', 'imageSha256', 'coordinateSpace'])) {
+            return invalid('external-reference source contains unsupported fields');
+        }
+        if (!isNonEmptyString(value.referenceId))
+            return invalid('source.referenceId must be a non-empty string');
+        if (!isNonEmptyString(value.referenceRequestId))
+            return invalid('source.referenceRequestId must be a non-empty string');
+        if (value.referenceSchemaVersion !== EXTERNAL_REFERENCE_SCHEMA_VERSION)
+            return invalid(`source.referenceSchemaVersion must be "${EXTERNAL_REFERENCE_SCHEMA_VERSION}"`);
+        if (value.lifecycle !== 'imported' && value.lifecycle !== 'approved')
+            return invalid('source.lifecycle must be "imported" or "approved"');
+        if (!isNonEmptyString(value.imageOwnerReferenceId))
+            return invalid('source.imageOwnerReferenceId must be a non-empty string');
+        // Mirrors the external-reference lifecycle model: an imported reference owns its own image;
+        // an approved reference never owns a copy and points back to the imported artifact that does.
+        if (value.lifecycle === 'imported' && value.imageOwnerReferenceId !== value.referenceId) {
+            return invalid('source.imageOwnerReferenceId must equal source.referenceId for an "imported" reference');
+        }
+        if (value.lifecycle === 'approved' && value.imageOwnerReferenceId === value.referenceId) {
+            return invalid('source.imageOwnerReferenceId must name the owning imported reference, not the approved reference itself');
+        }
+        if (typeof value.imageSha256 !== 'string' || !SHA256_HEX_PATTERN.test(value.imageSha256)) {
+            return invalid('source.imageSha256 must be a lowercase 64-character SHA-256 hex digest');
+        }
+        return validateCoordinateSpace(value.coordinateSpace, 'reference-image-px');
+    }
+    return invalid('source.kind must be "runtime-observation" or "external-reference"');
+}
+/**
+ * Saved annotation geometry must lie inside its source frame (inclusive
+ * edges). Never clamped, rounded, or scaled by devicePixelRatio. This rule
+ * applies to annotation geometry only - existing runtime target evidence may
+ * still legitimately extend outside the captured viewport.
+ */
+function validateCoordinate(x, y, frame, label) {
+    if (!isFiniteNumber(x))
+        return invalid(`${label}.x must be a finite number`);
+    if (!isFiniteNumber(y))
+        return invalid(`${label}.y must be a finite number`);
+    if (x < 0 || x > frame.width)
+        return invalid(`${label}.x must be within 0..${frame.width}`);
+    if (y < 0 || y > frame.height)
+        return invalid(`${label}.y must be within 0..${frame.height}`);
+    return VALID;
+}
+function validatePointObject(value, frame, label) {
+    if (!isPlainObject(value) || !hasOnlyKeys(value, ['x', 'y']))
+        return invalid(`${label} must be { x, y }`);
+    return validateCoordinate(value.x, value.y, frame, label);
+}
+function validateMark(value, frame, label) {
+    if (!isPlainObject(value))
+        return invalid(`${label} must be an object`);
+    switch (value.kind) {
+        case 'point':
+            if (!hasOnlyKeys(value, ['kind', 'x', 'y']))
+                return invalid(`${label} (point) contains unsupported fields`);
+            return validateCoordinate(value.x, value.y, frame, label);
+        case 'rectangle': {
+            if (!hasOnlyKeys(value, ['kind', 'x', 'y', 'width', 'height']))
+                return invalid(`${label} (rectangle) contains unsupported fields`);
+            const origin = validateCoordinate(value.x, value.y, frame, label);
+            if (!origin.valid)
+                return origin;
+            if (!isFiniteNumber(value.width) || value.width <= 0)
+                return invalid(`${label}.width must be a finite number greater than 0`);
+            if (!isFiniteNumber(value.height) || value.height <= 0)
+                return invalid(`${label}.height must be a finite number greater than 0`);
+            if (value.x + value.width > frame.width)
+                return invalid(`${label} right edge must not exceed ${frame.width}`);
+            if (value.y + value.height > frame.height)
+                return invalid(`${label} bottom edge must not exceed ${frame.height}`);
+            return VALID;
+        }
+        case 'line':
+        case 'arrow': {
+            if (!hasOnlyKeys(value, ['kind', 'start', 'end']))
+                return invalid(`${label} (${value.kind}) contains unsupported fields`);
+            const start = validatePointObject(value.start, frame, `${label}.start`);
+            if (!start.valid)
+                return start;
+            return validatePointObject(value.end, frame, `${label}.end`);
+        }
+        case 'note': {
+            if (!hasOnlyKeys(value, ['kind', 'anchor', 'text']))
+                return invalid(`${label} (note) contains unsupported fields`);
+            const anchor = validatePointObject(value.anchor, frame, `${label}.anchor`);
+            if (!anchor.valid)
+                return anchor;
+            if (!isNonEmptyString(value.text))
+                return invalid(`${label}.text must be a non-empty string`);
+            if (value.text.length > MAX_VISUAL_ANNOTATION_NOTE_LENGTH)
+                return invalid(`${label}.text must be at most ${MAX_VISUAL_ANNOTATION_NOTE_LENGTH} characters`);
+            return VALID;
+        }
+        default:
+            return invalid(`${label}.kind must be one of point, rectangle, line, arrow, note`);
+    }
+}
+/**
+ * Structured association shape only. Whether the named target/region exists
+ * in the source artifact is resolved by later viewer/application integration,
+ * never here, and never inferred from geometry or names.
+ */
+function validateRuntimeAssociation(value, label) {
+    if (value.kind === 'runtime-target') {
+        if (!hasOnlyKeys(value, ['kind', 'target']))
+            return invalid(`${label} (runtime-target) contains unsupported fields`);
+        if (!isNonEmptyString(value.target))
+            return invalid(`${label}.target must be a non-empty string`);
+        return VALID;
+    }
+    if (value.kind === 'runtime-relationship') {
+        if (!hasOnlyKeys(value, ['kind', 'relationshipKind', 'subjectTarget', 'relatedTarget']))
+            return invalid(`${label} (runtime-relationship) contains unsupported fields`);
+        const relationshipKind = value.relationshipKind;
+        const hasSubject = isPresent(value, 'subjectTarget');
+        const hasRelated = isPresent(value, 'relatedTarget');
+        if (typeof relationshipKind === 'string' && PAIRWISE_RELATIONSHIP_KINDS.includes(relationshipKind)) {
+            // Mirrors PairwiseLayoutRelationship: two distinct, non-empty target identities.
+            if (!isNonEmptyString(value.subjectTarget) || !isNonEmptyString(value.relatedTarget)) {
+                return invalid(`${label} pairwise relationship requires non-empty subjectTarget and relatedTarget`);
+            }
+            if (value.subjectTarget === value.relatedTarget)
+                return invalid(`${label} pairwise relationship requires two distinct targets`);
+            return VALID;
+        }
+        if (typeof relationshipKind === 'string' && PAGE_LEVEL_RELATIONSHIP_KINDS.includes(relationshipKind)) {
+            // Mirrors PageLevelLayoutRelationship: a page-level relationship has no target pair.
+            if (hasSubject || hasRelated)
+                return invalid(`${label} page-level relationship must not carry subjectTarget/relatedTarget`);
+            return VALID;
+        }
+        return invalid(`${label}.relationshipKind must be an existing pairwise or page-level relationship kind`);
+    }
+    return invalid(`${label}.kind "${String(value.kind)}" is not a runtime association`);
+}
+function validateReferenceAssociation(value, label) {
+    if (value.kind === 'reference-region') {
+        if (!hasOnlyKeys(value, ['kind', 'regionId']))
+            return invalid(`${label} (reference-region) contains unsupported fields`);
+        if (!isNonEmptyString(value.regionId))
+            return invalid(`${label}.regionId must be a non-empty string`);
+        return VALID;
+    }
+    if (value.kind === 'reference-relationship') {
+        if (!hasOnlyKeys(value, ['kind', 'subjectRegion', 'relatedRegion', 'relationship']))
+            return invalid(`${label} (reference-relationship) contains unsupported fields`);
+        if (!isNonEmptyString(value.subjectRegion) || !isNonEmptyString(value.relatedRegion)) {
+            return invalid(`${label} requires non-empty subjectRegion and relatedRegion`);
+        }
+        if (value.subjectRegion === value.relatedRegion)
+            return invalid(`${label} requires two distinct region ids`);
+        if (typeof value.relationship !== 'string' || !PAIRWISE_RELATIONSHIP_KINDS.includes(value.relationship)) {
+            return invalid(`${label}.relationship must be an existing pairwise relationship kind`);
+        }
+        return VALID;
+    }
+    return invalid(`${label}.kind "${String(value.kind)}" is not a reference association`);
+}
+const CHANGE_OPERATIONS = ['move', 'resize', 'remove', 'preserve'];
+function validateIntent(value, source, label) {
+    if (!isPlainObject(value))
+        return invalid(`${label} must be an object`);
+    const isRuntime = source.kind === 'runtime-observation';
+    switch (value.kind) {
+        case 'inspect':
+            if (!hasOnlyKeys(value, ['kind']))
+                return invalid(`${label} (inspect) contains unsupported fields`);
+            return VALID;
+        case 'change': {
+            if (!isRuntime)
+                return invalid(`${label} "change" intent is valid only for a runtime-observation source`);
+            if (!hasOnlyKeys(value, ['kind', 'operation', 'category', 'expectedDependentMode', 'contractPrimitive'])) {
+                return invalid(`${label} (change) contains unsupported fields`);
+            }
+            if (typeof value.operation !== 'string' || !CHANGE_OPERATIONS.includes(value.operation)) {
+                return invalid(`${label}.operation must be one of ${CHANGE_OPERATIONS.join(', ')}`);
+            }
+            // Existing canonical authored vocabulary: 'unexpected' is not a member and can never be authored.
+            if (!isAuthoredChangeScopeCategory(value.category))
+                return invalid(`${label}.category must be an authored change-scope category`);
+            const hasMode = isPresent(value, 'expectedDependentMode');
+            if (value.category === 'expected-dependent') {
+                if (!hasMode || !isValidExpectedDependentMode(value.expectedDependentMode)) {
+                    return invalid(`${label}.expectedDependentMode is required and must be valid when category is "expected-dependent"`);
+                }
+            }
+            else if (hasMode) {
+                return invalid(`${label}.expectedDependentMode must be absent unless category is "expected-dependent"`);
+            }
+            const hasPrimitive = isPresent(value, 'contractPrimitive');
+            if (value.operation === 'remove') {
+                // The current contract vocabulary has no target-absent primitive; never fabricate an equivalent.
+                if (hasPrimitive)
+                    return invalid(`${label} "remove" must not carry a contractPrimitive (not promotable by the current canonical contract vocabulary)`);
+            }
+            else if (hasPrimitive && !isValidContractPrimitive(value.contractPrimitive)) {
+                return invalid(`${label}.contractPrimitive is not a valid ContractPrimitive`);
+            }
+            return VALID;
+        }
+        case 'reference-region': {
+            if (isRuntime)
+                return invalid(`${label} "reference-region" intent is valid only for an external-reference source`);
+            if (!hasOnlyKeys(value, ['kind', 'mode', 'region']))
+                return invalid(`${label} (reference-region) contains unsupported fields`);
+            if (value.mode !== 'create' && value.mode !== 'refine')
+                return invalid(`${label}.mode must be "create" or "refine"`);
+            const regionValidation = isValidReferenceRegions([value.region], source.coordinateSpace.width, source.coordinateSpace.height);
+            if (!regionValidation.valid)
+                return invalid(`${label}.region: ${regionValidation.reason}`);
+            return VALID;
+        }
+        case 'reference-requirement': {
+            if (isRuntime)
+                return invalid(`${label} "reference-requirement" intent is valid only for an external-reference source`);
+            if (!hasOnlyKeys(value, ['kind', 'requirement']))
+                return invalid(`${label} (reference-requirement) contains unsupported fields`);
+            const requirementValidation = isValidRawReferenceRequirement(value.requirement);
+            if (!requirementValidation.valid)
+                return invalid(`${label}.requirement: ${requirementValidation.reason}`);
+            return VALID;
+        }
+        case 'asset-sensitive':
+            if (isRuntime)
+                return invalid(`${label} "asset-sensitive" intent is valid only for an external-reference source`);
+            if (!hasOnlyKeys(value, ['kind', 'regionId']))
+                return invalid(`${label} (asset-sensitive) contains unsupported fields`);
+            if (isPresent(value, 'regionId') && !isNonEmptyString(value.regionId))
+                return invalid(`${label}.regionId must be a non-empty string when present`);
+            return VALID;
+        default:
+            return invalid(`${label}.kind must be one of inspect, change, reference-region, reference-requirement, asset-sensitive`);
+    }
+}
+function validateInterpretation(value, source, label) {
+    if (!isPlainObject(value))
+        return invalid(`${label} must be an object`);
+    switch (value.state) {
+        case 'uninterpreted':
+            if (!hasOnlyKeys(value, ['state']) || isPresent(value, 'intent') || isPresent(value, 'confirmedAt')) {
+                return invalid(`${label} "uninterpreted" must not carry intent or confirmedAt`);
+            }
+            return VALID;
+        case 'candidate':
+            if (!hasOnlyKeys(value, ['state', 'intent']) || isPresent(value, 'confirmedAt'))
+                return invalid(`${label} "candidate" must carry only intent`);
+            return validateIntent(value.intent, source, `${label}.intent`);
+        case 'confirmed':
+            if (!hasOnlyKeys(value, ['state', 'intent', 'confirmedAt']))
+                return invalid(`${label} "confirmed" contains unsupported fields`);
+            if (!isNonEmptyString(value.confirmedAt))
+                return invalid(`${label}.confirmedAt must be a non-empty string`);
+            return validateIntent(value.intent, source, `${label}.intent`);
+        default:
+            return invalid(`${label}.state must be one of uninterpreted, candidate, confirmed`);
+    }
+}
+function validateItem(value, source, label) {
+    if (!isPlainObject(value))
+        return invalid(`${label} must be an object`);
+    if (!hasOnlyKeys(value, ['annotationItemId', 'mark', 'association', 'interpretation']))
+        return invalid(`${label} contains unsupported fields`);
+    if (!isNonEmptyString(value.annotationItemId))
+        return invalid(`${label}.annotationItemId must be a non-empty string`);
+    const markValidation = validateMark(value.mark, source.coordinateSpace, `${label}.mark`);
+    if (!markValidation.valid)
+        return markValidation;
+    if (isPresent(value, 'association')) {
+        const association = value.association;
+        if (!isPlainObject(association))
+            return invalid(`${label}.association must be an object`);
+        const associationValidation = source.kind === 'runtime-observation'
+            ? validateRuntimeAssociation(association, `${label}.association`)
+            : validateReferenceAssociation(association, `${label}.association`);
+        if (!associationValidation.valid)
+            return associationValidation;
+    }
+    return validateInterpretation(value.interpretation, source, `${label}.interpretation`);
+}
+/**
+ * Validates the semantic annotation content (one source plus its bounded,
+ * uniquely identified items) against the source's own coordinate domain.
+ * This is the content half of `isValidVisualAnnotationArtifact`, exposed so
+ * the persistence service can refuse invalid input before deriving identity
+ * or rendering - it is the same validation, never a second rule set.
+ */
+export function isValidVisualAnnotationContent(source, items) {
+    const sourceValidation = validateSource(source);
+    if (!sourceValidation.valid)
+        return sourceValidation;
+    const validSource = source;
+    if (!Array.isArray(items))
+        return invalid('items must be an array');
+    if (items.length > MAX_VISUAL_ANNOTATION_ITEMS)
+        return invalid(`items must contain at most ${MAX_VISUAL_ANNOTATION_ITEMS} entries`);
+    const seenItemIds = new Set();
+    for (let index = 0; index < items.length; index += 1) {
+        const itemValidation = validateItem(items[index], validSource, `items[${index}]`);
+        if (!itemValidation.valid)
+            return itemValidation;
+        const itemId = items[index].annotationItemId;
+        if (seenItemIds.has(itemId))
+            return invalid(`duplicate annotationItemId "${itemId}"`);
+        seenItemIds.add(itemId);
+    }
+    return VALID;
+}
+const ARTIFACT_KEYS = [
+    'artifactKind',
+    'schemaVersion',
+    'annotationRequestId',
+    'annotationId',
+    'supersedesAnnotationId',
+    'producer',
+    'source',
+    'items',
+    'overlay',
+    'provenance',
+];
+/**
+ * Structural validator for VisualAnnotationArtifact. The single gate used by
+ * both the writer and the reader (artifacts/visualAnnotationArtifactWriter.ts
+ * / visualAnnotationArtifactReader.ts) - never a second validator. Fails
+ * closed on an unsupported schemaVersion, cross-domain associations/intents,
+ * out-of-frame geometry, and overlay metadata that disagrees with the source
+ * frame. It never reads overlay bytes (the reader verifies the digest).
+ */
+export function isValidVisualAnnotationArtifact(value) {
+    if (!isPlainObject(value))
+        return invalid('artifact must be an object');
+    if (value.artifactKind !== VISUAL_ANNOTATION_ARTIFACT_KIND)
+        return invalid('artifactKind mismatch');
+    if (value.schemaVersion !== VISUAL_ANNOTATION_SCHEMA_VERSION)
+        return invalid('schemaVersion mismatch');
+    if (!hasOnlyKeys(value, ARTIFACT_KEYS))
+        return invalid('artifact contains unsupported fields');
+    if (!isNonEmptyString(value.annotationRequestId))
+        return invalid('annotationRequestId must be a non-empty string');
+    if (!isSafeBareSegment(value.annotationId))
+        return invalid('annotationId must be a non-empty single path segment');
+    if (isPresent(value, 'supersedesAnnotationId')) {
+        if (!isNonEmptyString(value.supersedesAnnotationId))
+            return invalid('supersedesAnnotationId must be a non-empty string when present');
+        if (value.supersedesAnnotationId === value.annotationId)
+            return invalid('supersedesAnnotationId must not equal annotationId');
+    }
+    if (!isPlainObject(value.producer) ||
+        !hasOnlyKeys(value.producer, ['name', 'version']) ||
+        value.producer.name !== PRODUCER_NAME ||
+        !isNonEmptyString(value.producer.version)) {
+        return invalid('producer must be { name: "my-frontend-observer", version: string }');
+    }
+    const contentValidation = isValidVisualAnnotationContent(value.source, value.items);
+    if (!contentValidation.valid)
+        return contentValidation;
+    const source = value.source;
+    const overlay = value.overlay;
+    if (!isPlainObject(overlay) || !hasOnlyKeys(overlay, ['path', 'format', 'width', 'height', 'sha256']))
+        return invalid('overlay must be { path, format, width, height, sha256 }');
+    if (overlay.path !== VISUAL_ANNOTATION_OVERLAY_PATH)
+        return invalid(`overlay.path must be exactly "${VISUAL_ANNOTATION_OVERLAY_PATH}"`);
+    if (overlay.format !== 'svg')
+        return invalid('overlay.format must be exactly "svg"');
+    if (overlay.width !== source.coordinateSpace.width || overlay.height !== source.coordinateSpace.height) {
+        return invalid('overlay.width/height must exactly match source.coordinateSpace dimensions');
+    }
+    if (typeof overlay.sha256 !== 'string' || !SHA256_HEX_PATTERN.test(overlay.sha256))
+        return invalid('overlay.sha256 must be a lowercase 64-character SHA-256 hex digest');
+    const provenance = value.provenance;
+    if (!isPlainObject(provenance) || !hasOnlyKeys(provenance, ['createdAt', 'origin']))
+        return invalid('provenance must be { createdAt, origin }');
+    if (!isNonEmptyString(provenance.createdAt))
+        return invalid('provenance.createdAt must be a non-empty string');
+    if (provenance.origin !== 'viewer')
+        return invalid('provenance.origin must be exactly "viewer"');
+    return VALID;
+}
+// --- Deterministic overlay SVG --------------------------------------------------------------------
+/** Fixed style constants: independent of annotation state, OS, theme, and locale. */
+const OVERLAY_STROKE_COLOR = '#ff2d55';
+const OVERLAY_STROKE_WIDTH = 2;
+const OVERLAY_POINT_RADIUS = 6;
+const OVERLAY_NOTE_ANCHOR_RADIUS = 4;
+const OVERLAY_NOTE_TEXT_OFFSET = 8;
+const OVERLAY_NOTE_FONT_SIZE = 14;
+const OVERLAY_NOTE_FONT_FAMILY = 'sans-serif';
+const OVERLAY_ARROWHEAD_LENGTH = 12;
+const OVERLAY_ARROWHEAD_HALF_WIDTH = 6;
+const STROKE_ATTRIBUTES = `fill="none" stroke="${OVERLAY_STROKE_COLOR}" stroke-width="${OVERLAY_STROKE_WIDTH}"`;
+const FILL_ATTRIBUTES = `fill="${OVERLAY_STROKE_COLOR}" stroke="none"`;
+/** Locale-independent shortest round-trip number formatting; never emits "-0". */
+function formatNumber(value) {
+    return Object.is(value, -0) ? '0' : String(value);
+}
+/**
+ * XML-escapes user-controlled text so it always remains inert character data.
+ * Characters that are not allowed in XML 1.0 documents are replaced with
+ * U+FFFD in the overlay only (the manifest keeps the authored text verbatim
+ * and remains authoritative).
+ */
+function isXmlDisallowedCodeUnit(code) {
+    if (code < 0x20)
+        return code !== 0x09 && code !== 0x0a && code !== 0x0d;
+    return code === 0xfffe || code === 0xffff;
+}
+function escapeXmlText(text) {
+    let allowed = '';
+    for (let index = 0; index < text.length; index += 1) {
+        allowed += isXmlDisallowedCodeUnit(text.charCodeAt(index)) ? '�' : text.charAt(index);
+    }
+    return allowed
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+function renderArrowhead(start, end) {
+    const dx = end.x - start.x;
+    const dy = end.y - start.y;
+    const length = Math.sqrt(dx * dx + dy * dy);
+    if (length === 0)
+        return undefined;
+    const ux = dx / length;
+    const uy = dy / length;
+    const baseX = end.x - ux * OVERLAY_ARROWHEAD_LENGTH;
+    const baseY = end.y - uy * OVERLAY_ARROWHEAD_LENGTH;
+    const leftX = baseX - uy * OVERLAY_ARROWHEAD_HALF_WIDTH;
+    const leftY = baseY + ux * OVERLAY_ARROWHEAD_HALF_WIDTH;
+    const rightX = baseX + uy * OVERLAY_ARROWHEAD_HALF_WIDTH;
+    const rightY = baseY - ux * OVERLAY_ARROWHEAD_HALF_WIDTH;
+    const points = [
+        [end.x, end.y],
+        [leftX, leftY],
+        [rightX, rightY],
+    ]
+        .map(([px, py]) => `${formatNumber(px)},${formatNumber(py)}`)
+        .join(' ');
+    return `<polygon points="${points}" ${FILL_ATTRIBUTES}/>`;
+}
+function renderMark(mark) {
+    switch (mark.kind) {
+        case 'point':
+            return [`<circle cx="${formatNumber(mark.x)}" cy="${formatNumber(mark.y)}" r="${OVERLAY_POINT_RADIUS}" ${STROKE_ATTRIBUTES}/>`];
+        case 'rectangle':
+            return [
+                `<rect x="${formatNumber(mark.x)}" y="${formatNumber(mark.y)}" width="${formatNumber(mark.width)}" height="${formatNumber(mark.height)}" ${STROKE_ATTRIBUTES}/>`,
+            ];
+        case 'line':
+        case 'arrow': {
+            const line = `<line x1="${formatNumber(mark.start.x)}" y1="${formatNumber(mark.start.y)}" x2="${formatNumber(mark.end.x)}" y2="${formatNumber(mark.end.y)}" ${STROKE_ATTRIBUTES}/>`;
+            if (mark.kind === 'line')
+                return [line];
+            const head = renderArrowhead(mark.start, mark.end);
+            return head === undefined ? [line] : [line, head];
+        }
+        case 'note':
+            return [
+                `<circle cx="${formatNumber(mark.anchor.x)}" cy="${formatNumber(mark.anchor.y)}" r="${OVERLAY_NOTE_ANCHOR_RADIUS}" ${FILL_ATTRIBUTES}/>`,
+                `<text x="${formatNumber(mark.anchor.x + OVERLAY_NOTE_TEXT_OFFSET)}" y="${formatNumber(mark.anchor.y - OVERLAY_NOTE_TEXT_OFFSET)}" font-family="${OVERLAY_NOTE_FONT_FAMILY}" font-size="${OVERLAY_NOTE_FONT_SIZE}" ${FILL_ATTRIBUTES}>${escapeXmlText(mark.text)}</text>`,
+            ];
+    }
+}
+/**
+ * The one pure deterministic overlay renderer. Output depends only on the
+ * source frame dimensions and the marks, in exact persisted `items` order -
+ * never on interpretation state, timestamps, random ids, environment, locale,
+ * or filesystem content. Contains only system-generated SVG elements (no
+ * script, foreignObject, external references, marker ids, CSS imports, or
+ * event handlers) and never embeds the source screenshot/reference image.
+ * Callers must pass content already accepted by
+ * `isValidVisualAnnotationContent`.
+ */
+export function renderVisualAnnotationOverlaySvg(source, items) {
+    const width = formatNumber(source.coordinateSpace.width);
+    const height = formatNumber(source.coordinateSpace.height);
+    const lines = [`<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}">`];
+    for (const item of items) {
+        for (const element of renderMark(item.mark))
+            lines.push(`  ${element}`);
+    }
+    lines.push('</svg>');
+    return `${lines.join('\n')}\n`;
+}
+//# sourceMappingURL=visualAnnotation.js.map

package/dist/domain/visualAnnotation.js.map

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

package/dist/domain/visualAnnotationIdentity.d.ts

@@ -0,0 +1,17 @@
+import type { VisualAnnotationItem, VisualAnnotationSource } from './visualAnnotation.js';
+/**
+ * Pure function of {source, items, supersedes} - the canonical source
+ * identity and coordinate domain/dimensions, every item's mark, association,
+ * and interpretation (in authored array order), and the explicitly
+ * superseded annotation (if any). Never includes createdAt, an output
+ * location, cwd, project root, a mutable alias, a viewer port or HTTP
+ * handle, a temporary path, the overlay digest, or annotationId: saving
+ * identical semantic content twice produces the same request identity.
+ */
+export declare function buildVisualAnnotationRequestIdentity(source: VisualAnnotationSource, items: readonly VisualAnnotationItem[], supersedesAnnotationId?: string): string;
+/**
+ * Fresh, opaque per-persisted-instance identity - never derived from a
+ * timestamp, never collides even when called twice with the same
+ * annotationRequestId within the same millisecond.
+ */
+export declare function buildVisualAnnotationInstanceIdentity(annotationRequestId: string): string;