@photivra/engine 1.5.0 → 2.0.0

package/dist/capture/export-tiff.js

@@ -1,23 +1,20 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Module boundary and integration notes.
- * Pack validated unsigned integer tag values into little-endian BYTE, SHORT or LONG payloads; reject
- * values outside the selected storage range.
- * Describe an internal BYTE/UNDEFINED tag using the supplied byte array. The payload is borrowed here;
- * the final TIFF packer copies it into its owned output buffer.
+ * Little-endian TIFF 6.0 writer used for DNG and Exif output: helpers that pack tag values, the Exif
+ * APP1 block for JPEG, and the TIFF file packer (IFD0, Exif IFD and an optional uncompressed strip).
  * @see docs/SIMULATED_CAPTURE.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
 import { InvalidConfigurationError } from "../core/configuration-error.js";
 /**
- * Pack validated unsigned integer tag values into little-endian BYTE, SHORT or LONG payloads; reject
- * values outside the selected storage range.
- * @param id - number. See the linked contract for coordinate, unit and profile binding semantics.
- * @param type - 1 | 3 | 4. See the linked contract for coordinate, unit and profile binding semantics.
- * @param values - readonly number[]. See the linked contract for coordinate, unit and profile binding semantics.
- * @returns ExportTiffTag. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ * Packs unsigned integer tag values as little-endian BYTE, SHORT or LONG. A value outside the
+ * chosen type's range is rejected.
+ * @param id - TIFF tag number.
+ * @param type - TIFF field type: 1 BYTE, 3 SHORT or 4 LONG.
+ * @param values - Unsigned integer values.
+ * @returns The packed tag.
  *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export function exportTiffNumbers(id, type, values) {
     const size = type === 1 ? 1 : type === 3 ? 2 : 4, data = new Uint8Array(values.length * size), view = new DataView(data.buffer);
@@ -34,26 +31,26 @@ export function exportTiffNumbers(id, type, values) {
     return { id, type, count: values.length, data };
 }
 /**
- * Describe an internal BYTE/UNDEFINED tag using the supplied byte array. The payload is borrowed here;
- * the final TIFF packer copies it into its owned output buffer.
- * @param id - number. See the linked contract for coordinate, unit and profile binding semantics.
- * @param type - 1 | 7. See the linked contract for coordinate, unit and profile binding semantics.
- * @param data - Uint8Array. See the linked contract for coordinate, unit and profile binding semantics.
- * @returns ExportTiffTag. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ * Makes a BYTE or UNDEFINED tag from a byte array. The array is not copied here; the final TIFF
+ * packer copies it into its own output buffer.
+ * @param id - TIFF tag number.
+ * @param type - TIFF field type: 1 BYTE or 7 UNDEFINED.
+ * @param data - Tag bytes.
+ * @returns The tag, referring to `data`.
  *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export function exportTiffBytes(id, type, data) {
     return { id, type, count: data.length, data };
 }
 /**
- * Encode printable ASCII with the required NUL terminator; reject unsupported characters instead of
- * silent lossy replacement.
- * @param id - number. See the linked contract for coordinate, unit and profile binding semantics.
- * @param value - string. See the linked contract for coordinate, unit and profile binding semantics.
- * @returns ExportTiffTag. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ * Encodes printable ASCII text with the required NUL terminator. Any other character is rejected,
+ * rather than silently replaced.
+ * @param id - TIFF tag number.
+ * @param value - Printable ASCII text.
+ * @returns The packed ASCII tag.
  *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export function exportTiffAscii(id, value) {
     if (!/^[\x20-\x7e]*$/.test(value))
@@ -61,7 +58,7 @@ export function exportTiffAscii(id, value) {
     const data = new TextEncoder().encode(value + "\0");
     return { id, type: 2, count: data.length, data };
 }
-/** Bounded rational approximation; matrix/metadata precision is explicit, never silent overflow. */
+/** Packs values as TIFF RATIONAL or SRATIONAL (fractions) with a power-of-ten denominator. A value that would overflow or lose all precision is rejected, never silently changed. */
 export function exportTiffRationals(id, signed, values) {
     const data = new Uint8Array(values.length * 8), view = new DataView(data.buffer);
     values.forEach((v, i) => {
@@ -78,7 +75,70 @@ export function exportTiffRationals(id, signed, values) {
     });
     return { id, type: signed ? 10 : 5, count: values.length, data };
 }
-/** Independently authored little-endian TIFF6 IFD0 + EXIF IFD, with optional uncompressed strip. */
+/**
+ * IFD0 tags that Exif 2.32 (CIPA DC-008-2019, Table 17, "Compressed" column) marks J (carried by the JPEG
+ * markers instead) or N (not allowed) for a JPEG-compressed primary image.
+ */
+const JPEG_EXIF_FORBIDDEN_IFD0 = new Set([256, 257, 258, 259, 262, 273, 277, 278, 279, 284, 513, 514, 530]);
+/**
+ * Packs the Exif APP1 TIFF structure for a JPEG-compressed primary image, with every tag that Exif 2.32
+ * (CIPA DC-008-2019 §4.6.8, Tables 17 and 18, "Compressed" column) marks mandatory. Caller tags take
+ * priority. A missing mandatory tag gets the standard's own default:
+ *
+ * - IFD0 XResolution = YResolution = 72/1 and ResolutionUnit = 2 (inches). The standard says "When the image
+ *   resolution is unknown, 72 [dpi] shall be designated"; this is the Exif convention for an unknown
+ *   resolution, not a physical print-size claim. The three tags are written together or not at all.
+ * - IFD0 YCbCrPositioning = 1 (centered, the TIFF default; the baseline encoder codes 4:4:4, so no chroma
+ *   siting is implied).
+ * - Exif ExifVersion "0232", FlashpixVersion "0100", ComponentsConfiguration 1 2 3 0 (Y Cb Cr),
+ *   PixelXDimension/PixelYDimension = the coded image size.
+ *
+ * ColorSpace (40961) is mandatory but has no default, so the caller must supply it. Tags the standard marks
+ * J or N for compressed data (ImageWidth, Compression, StripOffsets, YCbCrSubSampling, ...) are rejected,
+ * and a caller PixelX/YDimension that disagrees with the coded size is rejected.
+ */
+export function packExportJpegExif(main, exif, dimensions) {
+    const { pixelWidth, pixelHeight } = dimensions;
+    if (![pixelWidth, pixelHeight].every((v) => Number.isSafeInteger(v) && v >= 1 && v <= 65535))
+        throw new InvalidConfigurationError("Exif pixel dimensions require integers from 1 to 65535.");
+    if (main.some((t) => JPEG_EXIF_FORBIDDEN_IFD0.has(t.id) || t.id === 34665))
+        throw new InvalidConfigurationError("Exif IFD0 tag is not allowed for a JPEG-compressed primary image.");
+    const mainIds = new Set(main.map((t) => t.id)), exifIds = new Set(exif.map((t) => t.id));
+    const resolution = [282, 283, 296].filter((id) => mainIds.has(id)).length;
+    if (resolution !== 0 && resolution !== 3)
+        throw new InvalidConfigurationError("Exif XResolution, YResolution and ResolutionUnit must be written together.");
+    if (!exifIds.has(40961))
+        throw new InvalidConfigurationError("Exif ColorSpace is mandatory and has no default.");
+    for (const [id, value] of [[40962, pixelWidth], [40963, pixelHeight]]) {
+        const tag = exif.find((t) => t.id === id);
+        if (tag && (tag.count !== 1 || (tag.type === 3 ? new DataView(tag.data.buffer, tag.data.byteOffset).getUint16(0, true) : tag.type === 4 ? new DataView(tag.data.buffer, tag.data.byteOffset).getUint32(0, true) : -1) !== value)) {
+            throw new InvalidConfigurationError("Exif PixelX/YDimension must equal the coded JPEG size.");
+        }
+    }
+    const mainDefaults = [
+        ...(resolution === 0 ? [exportTiffRationals(282, false, [72]), exportTiffRationals(283, false, [72]), exportTiffNumbers(296, 3, [2])] : []),
+        ...(mainIds.has(531) ? [] : [exportTiffNumbers(531, 3, [1])])
+    ];
+    const exifDefaults = [
+        ...(exifIds.has(36864) ? [] : [exportTiffBytes(36864, 7, new TextEncoder().encode("0232"))]),
+        ...(exifIds.has(37121) ? [] : [exportTiffBytes(37121, 7, Uint8Array.of(1, 2, 3, 0))]),
+        ...(exifIds.has(40960) ? [] : [exportTiffBytes(40960, 7, new TextEncoder().encode("0100"))]),
+        ...(exifIds.has(40962) ? [] : [exportTiffNumbers(40962, 4, [pixelWidth])]),
+        ...(exifIds.has(40963) ? [] : [exportTiffNumbers(40963, 4, [pixelHeight])])
+    ];
+    return packExportTiff([...main, ...mainDefaults], [...exif, ...exifDefaults]);
+}
+/** Packs finite numbers as little-endian IEEE-754 doubles (TIFF type 12, DOUBLE). */
+export function exportTiffDoubles(id, values) {
+    const data = new Uint8Array(values.length * 8), view = new DataView(data.buffer);
+    values.forEach((v, i) => {
+        if (!Number.isFinite(v))
+            throw new InvalidConfigurationError("TIFF double must be finite.");
+        view.setFloat64(i * 8, v, true);
+    });
+    return { id, type: 12, count: values.length, data };
+}
+/** Writes a little-endian TIFF 6.0 file: IFD0 plus an EXIF IFD, with an optional uncompressed strip. Written for this project. */
 export function packExportTiff(main, exif, pixels = new Uint8Array()) {
     const pointer = { ...exportTiffNumbers(34665, 4, [0]), pointer: "exif" };
     const lists = [[...main, pointer].sort((a, b) => a.id - b.id), [...exif].sort((a, b) => a.id - b.id)];
@@ -87,10 +147,10 @@ export function packExportTiff(main, exif, pixels = new Uint8Array()) {
             throw new InvalidConfigurationError("Duplicate/oversized TIFF directory.");
     }
     /**
-     * Directories precede their out-of-line payloads. Four-byte alignment applies to
-     * payload addresses; values up to four bytes stay in the directory slot. Pointer
-     * placeholders are resolved only against this newly owned buffer, preventing a
-     * caller-supplied address from becoming an external file/memory reference.
+     * Each directory comes before the tag data stored outside it. That data starts on
+     * four-byte boundaries; values of four bytes or fewer stay in the directory entry.
+     * Pointer placeholders are resolved only within this new buffer, so a caller-supplied
+     * address can never point to another file or memory.
      */
     const exifOffset = 8 + 2 + lists[0].length * 12 + 4;
     let cursor = exifOffset + 2 + lists[1].length * 12 + 4;

package/dist/capture/export-tiff.js.map

@@ -1 +1 @@
-{"version":3,"file":"export-tiff.js","sourceRoot":"","sources":["../../src/capture/export-tiff.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"export-tiff.js","sourceRoot":"","sources":["../../src/capture/export-tiff.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Little-endian TIFF 6.0 writer used for DNG and Exif output: helpers that pack tag values, the Exif\n * APP1 block for JPEG, and the TIFF file packer (IFD0, Exif IFD and an optional uncompressed strip).\n * @see docs/SIMULATED_CAPTURE.md for equations, coordinate/unit conventions, blockers and support\n * limits.\n */\n\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\n\n/** One packed TIFF tag (internal). Pointers are resolved only inside the buffer the packer returns. */\nexport interface ExportTiffTag { id: number; type: number; count: number; data: Uint8Array; pointer?: \"exif\" | \"pixels\" }\n/**\n * Packs unsigned integer tag values as little-endian BYTE, SHORT or LONG. A value outside the\n * chosen type's range is rejected.\n * @param id - TIFF tag number.\n * @param type - TIFF field type: 1 BYTE, 3 SHORT or 4 LONG.\n * @param values - Unsigned integer values.\n * @returns The packed tag.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function exportTiffNumbers(id: number, type: 1 | 3 | 4, values: readonly number[]): ExportTiffTag {\n  const size = type === 1 ? 1 : type === 3 ? 2 : 4, data = new Uint8Array(values.length*size), view = new DataView(data.buffer);\n  values.forEach((v, i) => {\n    if (!Number.isSafeInteger(v) || v < 0 || v > (type === 1 ? 255 : type === 3 ? 65535 : 4294967295)) throw new InvalidConfigurationError(\"TIFF integer is out of range.\");\n    if (size === 1) view.setUint8(i, v); else if (size === 2) view.setUint16(i*size, v, true); else view.setUint32(i*size, v, true);\n  });\n  return { id, type, count: values.length, data };\n}\n/**\n * Makes a BYTE or UNDEFINED tag from a byte array. The array is not copied here; the final TIFF\n * packer copies it into its own output buffer.\n * @param id - TIFF tag number.\n * @param type - TIFF field type: 1 BYTE or 7 UNDEFINED.\n * @param data - Tag bytes.\n * @returns The tag, referring to `data`.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function exportTiffBytes(id: number, type: 1 | 7, data: Uint8Array): ExportTiffTag {\n  return { id, type, count: data.length, data };\n}\n/**\n * Encodes printable ASCII text with the required NUL terminator. Any other character is rejected,\n * rather than silently replaced.\n * @param id - TIFF tag number.\n * @param value - Printable ASCII text.\n * @returns The packed ASCII tag.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function exportTiffAscii(id: number, value: string): ExportTiffTag {\n  if (!/^[\\x20-\\x7e]*$/.test(value)) throw new InvalidConfigurationError(\"TIFF text requires printable ASCII.\");\n  const data = new TextEncoder().encode(value+\"\\0\"); return { id, type: 2, count: data.length, data };\n}\n/** Packs values as TIFF RATIONAL or SRATIONAL (fractions) with a power-of-ten denominator. A value that would overflow or lose all precision is rejected, never silently changed. */\nexport function exportTiffRationals(id: number, signed: boolean, values: readonly number[]): ExportTiffTag {\n  const data = new Uint8Array(values.length*8), view = new DataView(data.buffer);\n  values.forEach((v, i) => {\n    const limit = signed ? 2147483647 : 4294967295;\n    const denominator = Math.min(1000000000, 10**Math.floor(Math.log10(limit/Math.max(1,Math.abs(v))))), numerator = Math.round(v*denominator);\n    if (!Number.isFinite(v) || denominator < 1 || (!signed && v < 0) || Math.abs(numerator) > limit ||\n        (v !== 0 && numerator === 0)) throw new InvalidConfigurationError(\"TIFF rational exceeds supported precision/range.\");\n    if (signed) view.setInt32(i*8, numerator, true); else view.setUint32(i*8, numerator, true);\n    view.setUint32(i*8+4, denominator, true);\n  });\n  return { id, type: signed ? 10 : 5, count: values.length, data };\n}\n/**\n * IFD0 tags that Exif 2.32 (CIPA DC-008-2019, Table 17, \"Compressed\" column) marks J (carried by the JPEG\n * markers instead) or N (not allowed) for a JPEG-compressed primary image.\n */\nconst JPEG_EXIF_FORBIDDEN_IFD0 = new Set([256, 257, 258, 259, 262, 273, 277, 278, 279, 284, 513, 514, 530]);\n/** Pixel dimensions that the compressed primary image's Exif IFD must record (PixelX/YDimension). */\nexport interface ExportJpegExifDimensions { pixelWidth: number; pixelHeight: number }\n/**\n * Packs the Exif APP1 TIFF structure for a JPEG-compressed primary image, with every tag that Exif 2.32\n * (CIPA DC-008-2019 §4.6.8, Tables 17 and 18, \"Compressed\" column) marks mandatory. Caller tags take\n * priority. A missing mandatory tag gets the standard's own default:\n *\n * - IFD0 XResolution = YResolution = 72/1 and ResolutionUnit = 2 (inches). The standard says \"When the image\n *   resolution is unknown, 72 [dpi] shall be designated\"; this is the Exif convention for an unknown\n *   resolution, not a physical print-size claim. The three tags are written together or not at all.\n * - IFD0 YCbCrPositioning = 1 (centered, the TIFF default; the baseline encoder codes 4:4:4, so no chroma\n *   siting is implied).\n * - Exif ExifVersion \"0232\", FlashpixVersion \"0100\", ComponentsConfiguration 1 2 3 0 (Y Cb Cr),\n *   PixelXDimension/PixelYDimension = the coded image size.\n *\n * ColorSpace (40961) is mandatory but has no default, so the caller must supply it. Tags the standard marks\n * J or N for compressed data (ImageWidth, Compression, StripOffsets, YCbCrSubSampling, ...) are rejected,\n * and a caller PixelX/YDimension that disagrees with the coded size is rejected.\n */\nexport function packExportJpegExif(main: readonly ExportTiffTag[], exif: readonly ExportTiffTag[], dimensions: ExportJpegExifDimensions): Uint8Array {\n  const { pixelWidth, pixelHeight } = dimensions;\n  if (![pixelWidth, pixelHeight].every((v) => Number.isSafeInteger(v) && v >= 1 && v <= 65535)) throw new InvalidConfigurationError(\"Exif pixel dimensions require integers from 1 to 65535.\");\n  if (main.some((t) => JPEG_EXIF_FORBIDDEN_IFD0.has(t.id) || t.id === 34665)) throw new InvalidConfigurationError(\"Exif IFD0 tag is not allowed for a JPEG-compressed primary image.\");\n  const mainIds = new Set(main.map((t) => t.id)), exifIds = new Set(exif.map((t) => t.id));\n  const resolution = [282, 283, 296].filter((id) => mainIds.has(id)).length;\n  if (resolution !== 0 && resolution !== 3) throw new InvalidConfigurationError(\"Exif XResolution, YResolution and ResolutionUnit must be written together.\");\n  if (!exifIds.has(40961)) throw new InvalidConfigurationError(\"Exif ColorSpace is mandatory and has no default.\");\n  for (const [id, value] of [[40962, pixelWidth], [40963, pixelHeight]] as const) {\n    const tag = exif.find((t) => t.id === id);\n    if (tag && (tag.count !== 1 || (tag.type === 3 ? new DataView(tag.data.buffer, tag.data.byteOffset).getUint16(0, true) : tag.type === 4 ? new DataView(tag.data.buffer, tag.data.byteOffset).getUint32(0, true) : -1) !== value)) {\n      throw new InvalidConfigurationError(\"Exif PixelX/YDimension must equal the coded JPEG size.\");\n    }\n  }\n  const mainDefaults: ExportTiffTag[] = [\n    ...(resolution === 0 ? [exportTiffRationals(282, false, [72]), exportTiffRationals(283, false, [72]), exportTiffNumbers(296, 3, [2])] : []),\n    ...(mainIds.has(531) ? [] : [exportTiffNumbers(531, 3, [1])])\n  ];\n  const exifDefaults: ExportTiffTag[] = [\n    ...(exifIds.has(36864) ? [] : [exportTiffBytes(36864, 7, new TextEncoder().encode(\"0232\"))]),\n    ...(exifIds.has(37121) ? [] : [exportTiffBytes(37121, 7, Uint8Array.of(1, 2, 3, 0))]),\n    ...(exifIds.has(40960) ? [] : [exportTiffBytes(40960, 7, new TextEncoder().encode(\"0100\"))]),\n    ...(exifIds.has(40962) ? [] : [exportTiffNumbers(40962, 4, [pixelWidth])]),\n    ...(exifIds.has(40963) ? [] : [exportTiffNumbers(40963, 4, [pixelHeight])])\n  ];\n  return packExportTiff([...main, ...mainDefaults], [...exif, ...exifDefaults]);\n}\n/** Packs finite numbers as little-endian IEEE-754 doubles (TIFF type 12, DOUBLE). */\nexport function exportTiffDoubles(id: number, values: readonly number[]): ExportTiffTag {\n  const data = new Uint8Array(values.length*8), view = new DataView(data.buffer);\n  values.forEach((v, i) => {\n    if (!Number.isFinite(v)) throw new InvalidConfigurationError(\"TIFF double must be finite.\");\n    view.setFloat64(i*8, v, true);\n  });\n  return { id, type: 12, count: values.length, data };\n}\n/** Writes a little-endian TIFF 6.0 file: IFD0 plus an EXIF IFD, with an optional uncompressed strip. Written for this project. */\nexport function packExportTiff(main: readonly ExportTiffTag[], exif: readonly ExportTiffTag[], pixels = new Uint8Array()): Uint8Array {\n  const pointer: ExportTiffTag = { ...exportTiffNumbers(34665, 4, [0]), pointer: \"exif\" };\n  const lists = [[...main, pointer].sort((a,b) => a.id-b.id), [...exif].sort((a,b) => a.id-b.id)];\n  for (const tags of lists) {\n    if (tags.length > 128 || new Set(tags.map((t) => t.id)).size !== tags.length) throw new InvalidConfigurationError(\"Duplicate/oversized TIFF directory.\");\n  }\n/**\n * Each directory comes before the tag data stored outside it. That data starts on\n * four-byte boundaries; values of four bytes or fewer stay in the directory entry.\n * Pointer placeholders are resolved only within this new buffer, so a caller-supplied\n * address can never point to another file or memory.\n */\n  const exifOffset = 8+2+lists[0]!.length*12+4;\n  let cursor = exifOffset+2+lists[1]!.length*12+4;\n  const offsets = new Map<ExportTiffTag, number>();\n  for (const tags of lists) for (const t of tags) {\n    if (t.data.length > 4) { cursor = (cursor+3)&~3; offsets.set(t,cursor); cursor += t.data.length; }\n  }\n  const pixelOffset = (cursor+3)&~3, result = new Uint8Array(pixelOffset+pixels.length), view = new DataView(result.buffer);\n  result.set([73,73,42,0,8,0,0,0]);\n  lists.forEach((tags, directory) => {\n    const base = directory === 0 ? 8 : exifOffset; view.setUint16(base,tags.length,true);\n    tags.forEach((t,i) => {\n      const p = base+2+i*12; view.setUint16(p,t.id,true); view.setUint16(p+2,t.type,true); view.setUint32(p+4,t.count,true);\n      if (t.pointer) view.setUint32(p+8,t.pointer === \"exif\" ? exifOffset : pixelOffset,true);\n      else if (t.data.length <= 4) result.set(t.data,p+8);\n      else { view.setUint32(p+8,offsets.get(t)!,true); result.set(t.data,offsets.get(t)!); }\n    });\n  });\n  result.set(pixels,pixelOffset); return result;\n}\n"]}

package/dist/capture/focus-control.d.ts

@@ -29,8 +29,8 @@ interface FocusTargetObservationBase {
 export type FocusTargetObservation = (FocusTargetObservationBase & {
     kind: "finite-surface";
     /**
-     * Longitudinal camera-space/conjugate distance from #103, not renderer
-     * ray length.
+     * Distance along the camera's optical axis (the same convention as
+     * FocusPlane), not the renderer's ray length to the point.
      */
     longitudinalDistanceM: number;
 }) | (FocusTargetObservationBase & {
@@ -40,11 +40,12 @@ export type FocusTargetObservation = (FocusTargetObservationBase & {
     reason: FocusTargetLossReason;
 });
 /**
- * Immutable logical MF/single-AF/continuous-AF state. Resolved focus remains a
- * finite longitudinal distance in metres or explicit infinity. Acquisition, loss,
- * reacquisition and lock records explain why a target is usable; a focus-release
- * gate remains separate from shutter sequencing. The ideal actuator does not model
- * commercial AF measurement accuracy or physical acquisition time.
+ * Immutable focus-controller state for MF, AF-S or AF-C.
+ *
+ * The resolved focus is a finite distance along the optical axis in metres, or infinity.
+ * Acquisition, loss, reacquisition and lock records explain why a target can be used. The
+ * focus-release check is separate from shutter sequencing. The ideal actuator does not model
+ * real AF accuracy or the physical time focusing takes.
  */
 export interface FocusControlState {
     version: typeof FOCUS_CONTROL_STATE_VERSION;
@@ -124,87 +125,63 @@ export interface FocusReleaseGateAssessment {
     exposureModified: false;
 }
 /**
- * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
- * missing required fields and incompatible scientific data fail at this boundary.
+ * Validates an untrusted focus-control profile and returns it normalized. Unknown enum values,
+ * missing required fields and inconsistent scientific data are rejected.
  *
- * Focus is a longitudinal plane or explicit infinity state, never a screen-space distance. The ideal
- * actuator resolves supplied target observations; it does not infer a commercial AF sensor, focus-ring
- * scale or acquisition latency. Target loss, reacquisition, focus lock and release priority remain
- * separate state transitions.
- * @param value - unknown. Treated as untrusted data; static typing alone is not validation.
- * @returns FocusControlProfile. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ * Focus is a distance along the optical axis or infinity, never a distance on screen. The ideal
+ * actuator focuses on the target observations it is given. It does not model a real AF sensor, a
+ * focus-ring scale or focusing time.
+ * @param value - Untrusted data. TypeScript types alone are not validation.
+ * @returns The validated profile. Success does not imply calibration.
  *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export declare function parseFocusControlProfile(value: unknown): FocusControlProfile;
 /**
- * Create the initial ideal focus-controller state from an explicit profile, focus plane and public
- * state identity.
- *
- * Focus is a longitudinal plane or explicit infinity state, never a screen-space distance. The ideal
- * actuator resolves supplied target observations; it does not infer a commercial AF sensor, focus-ring
- * scale or acquisition latency. Target loss, reacquisition, focus lock and release priority remain
- * separate state transitions.
- * @param input - CreateFocusControlStateInput. See the linked contract for coordinate, unit and profile binding semantics.
- * @returns FocusControlState. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ * Creates the initial ideal focus-controller state from a profile, a focus plane and a public
+ * state ID.
+ * @param input - New state ID, profile, focus mode, initial focus plane and optional start time.
+ * @returns The initial state. Success does not imply calibration.
  *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export declare function createFocusControlState(input: CreateFocusControlStateInput): FocusControlState;
 /**
- * Return a manual focus transition to the supplied finite/infinity plane without inventing a lens
- * actuator or focus-ring conversion.
- *
- * Focus is a longitudinal plane or explicit infinity state, never a screen-space distance. The ideal
- * actuator resolves supplied target observations; it does not infer a commercial AF sensor, focus-ring
- * scale or acquisition latency. Target loss, reacquisition, focus lock and release priority remain
- * separate state transitions.
- * @param input - SetManualFocusStateInput. See the linked contract for coordinate, unit and profile binding semantics.
- * @returns FocusControlState. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ * Returns the state after manually focusing on the given finite or infinity plane. No lens
+ * actuator or focus-ring conversion is modelled.
+ * @param input - Current state, new state ID, new focus plane and event time.
+ * @returns The new state. Success does not imply calibration.
  *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export declare function setManualFocusState(input: SetManualFocusStateInput): FocusControlState;
 /**
- * Resolve an explicit available/lost target observation under the selected single/continuous AF
- * policy, retaining acquisition and reacquisition disposition.
+ * Applies one target observation (target available or lost) under the selected AF-S or AF-C
+ * policy, and records whether the target was acquired or reacquired.
  *
- * Focus is a longitudinal plane or explicit infinity state, never a screen-space distance. The ideal
- * actuator resolves supplied target observations; it does not infer a commercial AF sensor, focus-ring
- * scale or acquisition latency. Target loss, reacquisition, focus lock and release priority remain
- * separate state transitions.
- * @param input - ResolveFocusTargetObservationInput. See the linked contract for coordinate, unit and profile binding semantics.
- * @returns FocusTargetResolution. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ * The ideal actuator focuses on the observation as given. Target loss, reacquisition, focus
+ * lock and release priority are separate state changes.
+ * @param input - Current state, new state ID, control event and target observation.
+ * @returns The resolution and new state. Success does not imply calibration.
  *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export declare function resolveFocusTargetObservation(input: ResolveFocusTargetObservationInput): FocusTargetResolution;
 /**
- * Return an explicit lock/unlock transition without changing the underlying physical focus plane.
+ * Locks or unlocks focus. The physical focus plane does not change.
+ * @param input - Current state, new state ID, lock setting and event time.
+ * @returns The new state. Success does not imply calibration.
  *
- * Focus is a longitudinal plane or explicit infinity state, never a screen-space distance. The ideal
- * actuator resolves supplied target observations; it does not infer a commercial AF sensor, focus-ring
- * scale or acquisition latency. Target loss, reacquisition, focus lock and release priority remain
- * separate state transitions.
- * @param input - SetFocusLockInput. See the linked contract for coordinate, unit and profile binding semantics.
- * @returns FocusControlState. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
- *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export declare function setFocusLock(input: SetFocusLockInput): FocusControlState;
 /**
- * Report whether release may proceed under focus-priority or release-priority policy; this does not
- * operate a shutter.
- *
- * Focus is a longitudinal plane or explicit infinity state, never a screen-space distance. The ideal
- * actuator resolves supplied target observations; it does not infer a commercial AF sensor, focus-ring
- * scale or acquisition latency. Target loss, reacquisition, focus lock and release priority remain
- * separate state transitions.
- * @param input - AssessFocusReleaseGateInput. See the linked contract for coordinate, unit and profile binding semantics.
- * @returns FocusReleaseGateAssessment. Read structured blockers before consuming an authorization.
+ * Reports whether the shutter may be released under the focus-priority or release-priority
+ * policy. It does not operate the shutter.
+ * @param input - Current state, profile and release priority.
+ * @returns The assessment. Read its structured blockers before acting on an authorization.
  *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export declare function assessFocusReleaseGate(input: AssessFocusReleaseGateInput): FocusReleaseGateAssessment;
 export {};
-//# sourceMappingURL=focus-control.d.ts.map