Interpret legacy IPTC technical metadata

  Version 0.4.84 is ready:

  - Added technical-image, audio-asset, preview-asset, and rasterized-caption interpretation.
  - Correctly handles decoded IPTC byte values and big-endian preview fields.
  - Keeps IPTC image layout separate from EXIF rotation.
  - Marks technical records source-bound and rendered-transfer unsafe.
  - Updated thin Python bindings, public docs, and OpenMeta/CHANGES.md.

Author: ssh4net

CHANGES.md

@@ -1,5 +1,29 @@
 # OpenMeta Changes
 
+## 0.4.84 - 2026-07-24
+
+Changes compared with `0.4.83`.
+
+### Added
+
+- Added source-bound legacy IPTC technical-image, audio-asset, and
+  preview-asset records with exact `technical_image`, `audio`, and `preview`
+  query semantics.
+- Added normalized image component/layout, audio
+  channel/content/rate/resolution/duration/outcue, preview format/version/data,
+  and rasterized-caption roles.
+- Added matching append-only C++ and thin Python enums.
+
+### Changed
+
+- IPTC concept resolution now consumes the raw byte representation produced by
+  the IPTC-IIM decoder for known textual and date/time datasets.
+- IPTC image layout remains distinct from EXIF rotation orientation, preview
+  format/version values use big-endian decoding, and binary preview identity
+  uses bounded size/hash keys without copying payloads into concept records.
+- Legacy IPTC technical records are source-bound and unsafe for automatic
+  rendered-image transfer.
+
 ## 0.4.83 - 2026-07-24
 
 Changes compared with `0.4.82`.

VERSION

@@ -1 +1 @@
-0.4.83
+0.4.84

docs/api_stability.md

@@ -46,7 +46,11 @@ rights holders, licensors, licensees, licenses, releases, end users, image
 creators, image suppliers, image assets, controlled-vocabulary terms, registry
 entries, image regions, resource references, resource events, manifest items,
 versions, editorial workflows, source software, editorial contacts, and pantry
-items. Sensitivity is a
+items, plus legacy IPTC technical-image, audio-asset, and preview-asset
+records. The IPTC technical records normalize image layout, component count,
+audio channel/rate/resolution/duration, preview format/version, and bounded
+binary payload identity without treating IPTC layout as EXIF rotation.
+Sensitivity is a
 policy signal independent of technical transfer safety; the same fields are
 mirrored in transfer diagnostics and thin Python dictionaries. Hosts must not
 interpret `safe` as approval to publish personal-contact, person-identity,
@@ -58,12 +62,15 @@ references and originating software, IPTC Core accessibility and taxonomy
 fields, IPTC Extension registry and
 image-region entities, resource/document identity and lineage/history, and
 remaining bounded PLUS party, delivered-asset, and license-policy fields.
+Legacy IPTC image, audio, and preview datasets use exact `technical_image`,
+`audio`, and `preview` semantics.
 Equivalent scalar pairs participate in preference/conflict handling; taxonomy,
 resource-identifier, and license-document collections remain additive.
 Document identity/lineage/history, registry, prior-envelope-reference, and
 source-software records are source-bound for rendered transfer; image-region
 records require target image specifications. Editorial contacts carry
 personal-contact sensitivity independently of their technical transfer hint.
+Technical-image, audio-asset, and preview-asset records are source-bound.
 
 The bounded BMFF tiled-image field contract covers `tilC` version 0 tile
 dimensions, up to eight extra dimensions, `dref`/`deti` mapping, internal

docs/development.md

@@ -17,8 +17,8 @@ model should stay compact:
 | Area | Purpose | Readiness |
 | --- | --- | --- |
 | Decoding | Find metadata carriers and decode EXIF, XMP, IPTC, ICC, Photoshop IRB, JUMBF/C2PA, EXR, and related blocks into `MetaStore` entries. | High, about 98-100% for the current target scope. |
-| Interpretation | Normalize names and values, group entries by meaning, and classify source-bound data such as RAW crop, exposure adjustment, color/profile/source-color-transform evidence, RAW curves/linearity metadata with descriptor-backed compressed-storage applicability, lens-correction, sensor, BMFF brand/item-property associations and rollups including `avio` AVIF brands, item groups, item semantic counts, whole-scene policy hints, graph-component summaries with per-component roles, member item IDs, semantic composition, typed relation counts, bounded `grid`/`iovl`/`iden` construction semantics with recursive item-offset descriptors and graph-cycle/source validation, bounded complete `tili` configuration/reference/offset-table interpretation, `container_graph` concepts, primary item properties, primary metadata-carrier flags, primary sidecar and scene summaries, and display-transform summaries, JUMBF labels, Photoshop IRB embedded carriers plus fixed-layout, XML/text, working-path and numbered clipping-path records, byte-count, descriptor-header, scalar/class/alias/enum/reference, and bounded nested list/object summaries, EXIF 3.1 correction/noise labels, version/firmware-style value formatting for selected EXIF/Nikon/Olympus/native RAF contexts, selected Sony ILCE-7RM6 correction-offset routing, Fujifilm flash white-balance naming, Apple/FLIR/JVC/GE/Reconyx/Microsoft/Nintendo/Sanyo scalar MakerNote labels, current Canon RF/Nikon Z lens labels, an ambiguous Pentax Sigma/Samsung/Tokina lens-family label, EXIF/XMP GPS timestamp composites, EXIF `OffsetTime*`/`SubSecTime*` date composition with normalized-instant conflict checks, separate camera/destination/shown/created GPS roles with scope-aware structured-location conflicts, language-aware descriptive roles, legacy editorial duplicate reconciliation, non-equivalent IPTC taxonomy/workflow fields, content-location and prior-envelope scopes, editorial release/expiration date-time pairs, source software and editorial contacts, accessibility/taxonomy/registry/image-region/document-identity/lineage/history semantics, structured creator-contact/event/person/organization/product/artwork/rights/license/release/end-user/image-creator/image-supplier/image-asset/controlled-vocabulary/registry/image-region/image-region-boundary/resource-reference/resource-event/manifest-item/version/editorial-workflow/source-software/editorial-contact/pantry records, explicit image-region shape and coordinate-unit contracts, independent privacy/policy sensitivity, computational, thermal, stitch/panorama capture state, and vendor-private fields. | High, about 98-99%. |
-| Query | Find entries by name, fuzzy term, or semantic group, then expose normalized query candidates, structured interpretation records, bounded cross-family concept resolutions, transfer hints, sensitivity, and conflict flags for crop/border/active-area, exposure/gain, color/WB/profile/source-color-transform, orientation, date/time, GPS, descriptive fields including contact/event/person/organization/product/artwork/rights/license/release, editorial, accessibility, taxonomy, registry, image-region, document-identity, document-lineage, and document-history semantics, lens-correction, computational/thermal/stitch, RAW/source-processing fields, and BMFF derived-image construction and tiled-image configuration evidence across standard and vendor metadata. | High, about 98-99%. |
+| Interpretation | Normalize names and values, group entries by meaning, and classify source-bound data such as RAW crop, exposure adjustment, color/profile/source-color-transform evidence, RAW curves/linearity metadata with descriptor-backed compressed-storage applicability, lens-correction, sensor, BMFF brand/item-property associations and rollups including `avio` AVIF brands, item groups, item semantic counts, whole-scene policy hints, graph-component summaries with per-component roles, member item IDs, semantic composition, typed relation counts, bounded `grid`/`iovl`/`iden` construction semantics with recursive item-offset descriptors and graph-cycle/source validation, bounded complete `tili` configuration/reference/offset-table interpretation, `container_graph` concepts, primary item properties, primary metadata-carrier flags, primary sidecar and scene summaries, and display-transform summaries, JUMBF labels, Photoshop IRB embedded carriers plus fixed-layout, XML/text, working-path and numbered clipping-path records, byte-count, descriptor-header, scalar/class/alias/enum/reference, and bounded nested list/object summaries, EXIF 3.1 correction/noise labels, version/firmware-style value formatting for selected EXIF/Nikon/Olympus/native RAF contexts, selected Sony ILCE-7RM6 correction-offset routing, Fujifilm flash white-balance naming, Apple/FLIR/JVC/GE/Reconyx/Microsoft/Nintendo/Sanyo scalar MakerNote labels, current Canon RF/Nikon Z lens labels, an ambiguous Pentax Sigma/Samsung/Tokina lens-family label, EXIF/XMP GPS timestamp composites, EXIF `OffsetTime*`/`SubSecTime*` date composition with normalized-instant conflict checks, separate camera/destination/shown/created GPS roles with scope-aware structured-location conflicts, language-aware descriptive roles, legacy editorial duplicate reconciliation, non-equivalent IPTC taxonomy/workflow fields, content-location and prior-envelope scopes, editorial release/expiration date-time pairs, source software and editorial contacts, source-bound IPTC technical-image/audio/preview records, accessibility/taxonomy/registry/image-region/document-identity/lineage/history semantics, structured creator-contact/event/person/organization/product/artwork/rights/license/release/end-user/image-creator/image-supplier/image-asset/controlled-vocabulary/registry/image-region/image-region-boundary/resource-reference/resource-event/manifest-item/version/editorial-workflow/source-software/editorial-contact/technical-image/audio-asset/preview-asset/pantry records, explicit image-region shape and coordinate-unit contracts, independent privacy/policy sensitivity, computational, thermal, stitch/panorama capture state, and vendor-private fields. | High, about 99%. |
+| Query | Find entries by name, fuzzy term, or semantic group, then expose normalized query candidates, structured interpretation records, bounded cross-family concept resolutions, transfer hints, sensitivity, and conflict flags for crop/border/active-area, exposure/gain, color/WB/profile/source-color-transform, orientation, date/time, GPS, descriptive fields including contact/event/person/organization/product/artwork/rights/license/release, editorial, accessibility, taxonomy, registry, image-region, document-identity, document-lineage, document-history, technical-image, audio, and preview semantics, lens-correction, computational/thermal/stitch, RAW/source-processing fields, and BMFF derived-image construction and tiled-image configuration evidence across standard and vendor metadata. | High, about 99%. |
 | Creation | Build fresh metadata entries from host-provided values. | Medium, about 55-65%. |
 | Editing | Modify existing logical metadata entries while preserving valid surrounding structure. | Medium, about 60-70%. |
 | Transfer | Move metadata between files using explicit compatible-file or rendered-image safety policies. | Medium-high, about 80-85%. |
@@ -102,7 +102,8 @@ structured-location scope, normalized descriptive language, additive
 collection preference, structured record kinds and scopes for editorial,
 rights, license, release, end-user, image-creator, image-supplier, and
 image-asset, controlled-vocabulary, registry, image-region,
-resource-reference, resource-event, and pantry records, independent policy
+resource-reference, resource-event, technical-image, audio-asset,
+preview-asset, and pantry records, independent policy
 sensitivity,
 canonical geometry origin/size/rect/margins,
 normalized exposure values, full normalized value vectors for grouped