@photivra/engine 1.5.0 → 2.0.0

package/dist/facade/camera-preset.js

@@ -0,0 +1,102 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Validation of a caller-supplied camera preset for simulateCapture(). A preset object (for example a
+ * modified copy of a resolveGenericEquipmentTierCatalog() entry) must have exactly the preset shape:
+ * unknown fields at the top level, in `body`, in `lens` or in `lens.matchedReference` are rejected,
+ * and every profile is re-checked with its own strict parser, so a misspelled or stale field fails
+ * instead of being silently ignored.
+ * @see docs/QUICK_START.md for the facade contract.
+ */
+import { InvalidConfigurationError } from "../core/configuration-error.js";
+import { parseEvidenceList } from "../core/evidence-provenance.js";
+import { rejectUnknownFields, requireInputObject, requirePublicOpaqueId } from "../core/record-validation.js";
+import { parseGenericBodyExposureCapabilityProfile, parseGenericLensExposureCapabilityProfile } from "../equipment/exposure-capabilities.js";
+import { parseIsoCapabilityProfile } from "../equipment/iso-capabilities.js";
+import { parseGenericReleaseCapabilityProfile } from "../equipment/release-capabilities.js";
+import { parseGenericBodyMeteringCapabilityProfile } from "../equipment/metering-capabilities.js";
+import { parseFocusControlProfile } from "../capture/focus-control.js";
+import { parseWhiteBalanceProfile } from "../color/white-balance.js";
+import { parseStabilizationSystemProfile } from "../stabilization/system.js";
+import { parseSensorReadoutConversionProfile } from "../sensor/raw-readout.js";
+import { parseGenericIsoSignalChainProfile } from "../sensor/iso-signal-chain.js";
+import { parseSensorFixedPatternNoiseProfile } from "../sensor/fixed-pattern-noise.js";
+import { parseExposureMeteringProfile } from "../exposure/metering.js";
+import { parseFlashSyncCapabilityProfile } from "../exposure/flash.js";
+const PRESET_FIELDS = ["tier", "label", "presetId", "presetVersion", "scientificStatus", "evidence", "body", "lens", "tradeoffs"];
+const BODY_FIELDS = ["exposure", "iso", "signalChain", "readout", "readoutTiming", "rollingReadoutTiming", "fixedPatternNoise", "release", "focus",
+    "stabilization", "whiteBalance", "metering", "meteringCapabilities", "flashSync"];
+const LENS_FIELDS = ["form", "exposure", "matchedReference", "profileReferences", "limitations"];
+const MATCHED_REFERENCE_FIELDS = ["focalLengthMm", "aperture", "focusDistanceM", "wavelengthNm", "normalizationRadiusMm", "distortionK1",
+    "lateralCaK1Offset", "vignettingR2", "breathingProjectionScale", "transmission", "correctionGainStrength", "correctionCaFraction",
+    "ghostPowerFraction", "veilPowerFraction", "pupilAmplitudeByField", "pupilOpdMicrometersByDefocus", "pupilThroughputByField"];
+const VERSIONED_ASSET_FIELDS = ["assetId", "assetVersion", "profile"];
+function objectWithFields(value, fields, path) {
+    requireInputObject(value, path);
+    rejectUnknownFields(value, fields, path);
+    return value;
+}
+function stringList(value, path) {
+    if (!Array.isArray(value) || value.some((entry) => typeof entry !== "string"))
+        throw new InvalidConfigurationError(path + " must be an array of strings.");
+}
+function versionedAsset(value, path, parse) {
+    const asset = objectWithFields(value, VERSIONED_ASSET_FIELDS, path);
+    requirePublicOpaqueId(asset.assetId, path + ".assetId is invalid.");
+    if (typeof asset.assetVersion !== "string" || asset.assetVersion.length === 0)
+        throw new InvalidConfigurationError(path + ".assetVersion must be a non-empty string.");
+    requireInputObject(asset.profile, path + ".profile");
+    parse?.(asset.profile);
+}
+function versionedAssetList(value, path, parse) {
+    if (!Array.isArray(value) || value.length === 0)
+        throw new InvalidConfigurationError(path + " must be a non-empty array.");
+    value.forEach((asset, index) => versionedAsset(asset, path + "[" + index + "]", parse));
+}
+/**
+ * Checks a caller-supplied camera preset object and returns it unchanged. Throws InvalidConfigurationError
+ * (or the profile parser's domain error) for a missing or malformed part or an unknown field.
+ * Readout-timing declarations have no standalone parser; they are checked for shape only and are not
+ * read by simulateCapture().
+ */
+export function parseCallerCameraPreset(value) {
+    const preset = objectWithFields(value, PRESET_FIELDS, "camera");
+    if (typeof preset.tier !== "string" || typeof preset.label !== "string")
+        throw new InvalidConfigurationError("camera.tier and camera.label must be strings.");
+    requirePublicOpaqueId(preset.presetId, "camera.presetId is invalid.");
+    if (typeof preset.presetVersion !== "string" || preset.presetVersion.length === 0)
+        throw new InvalidConfigurationError("camera.presetVersion must be a non-empty string.");
+    if (preset.scientificStatus !== "approximation")
+        throw new InvalidConfigurationError("camera.scientificStatus must be \"approximation\".");
+    parseEvidenceList(preset.evidence, "camera.evidence");
+    stringList(preset.tradeoffs, "camera.tradeoffs");
+    const body = objectWithFields(preset.body, BODY_FIELDS, "camera.body");
+    parseGenericBodyExposureCapabilityProfile(body.exposure);
+    parseIsoCapabilityProfile(body.iso);
+    parseGenericIsoSignalChainProfile(body.signalChain);
+    versionedAssetList(body.readout, "camera.body.readout", parseSensorReadoutConversionProfile);
+    versionedAsset(body.readoutTiming, "camera.body.readoutTiming");
+    versionedAsset(body.rollingReadoutTiming, "camera.body.rollingReadoutTiming");
+    versionedAsset(body.fixedPatternNoise, "camera.body.fixedPatternNoise", parseSensorFixedPatternNoiseProfile);
+    parseGenericReleaseCapabilityProfile(body.release);
+    parseFocusControlProfile(body.focus);
+    parseStabilizationSystemProfile(body.stabilization);
+    parseWhiteBalanceProfile(body.whiteBalance);
+    versionedAssetList(body.metering, "camera.body.metering", parseExposureMeteringProfile);
+    parseGenericBodyMeteringCapabilityProfile(body.meteringCapabilities);
+    parseFlashSyncCapabilityProfile(body.flashSync);
+    const lens = objectWithFields(preset.lens, LENS_FIELDS, "camera.lens");
+    if (lens.form !== "prime")
+        throw new InvalidConfigurationError("camera.lens.form must be \"prime\".");
+    parseGenericLensExposureCapabilityProfile(lens.exposure);
+    objectWithFields(lens.matchedReference, MATCHED_REFERENCE_FIELDS, "camera.lens.matchedReference");
+    if (!Array.isArray(lens.profileReferences))
+        throw new InvalidConfigurationError("camera.lens.profileReferences must be an array.");
+    lens.profileReferences.forEach((reference, index) => {
+        const r = objectWithFields(reference, ["profileId", "profileVersion"], "camera.lens.profileReferences[" + index + "]");
+        if (typeof r.profileId !== "string" || typeof r.profileVersion !== "string")
+            throw new InvalidConfigurationError("camera.lens.profileReferences[" + index + "] needs string profileId and profileVersion.");
+    });
+    stringList(lens.limitations, "camera.lens.limitations");
+    return value;
+}
+//# sourceMappingURL=camera-preset.js.map

package/dist/facade/camera-preset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-preset.js","sourceRoot":"","sources":["../../src/facade/camera-preset.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Validation of a caller-supplied camera preset for simulateCapture(). A preset object (for example a\n * modified copy of a resolveGenericEquipmentTierCatalog() entry) must have exactly the preset shape:\n * unknown fields at the top level, in `body`, in `lens` or in `lens.matchedReference` are rejected,\n * and every profile is re-checked with its own strict parser, so a misspelled or stale field fails\n * instead of being silently ignored.\n * @see docs/QUICK_START.md for the facade contract.\n */\n\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\nimport { parseEvidenceList } from \"../core/evidence-provenance.js\";\nimport { rejectUnknownFields, requireInputObject, requirePublicOpaqueId } from \"../core/record-validation.js\";\nimport type { GenericEquipmentTierPreset } from \"../equipment/generic-tier-assets.js\";\nimport { parseGenericBodyExposureCapabilityProfile, parseGenericLensExposureCapabilityProfile } from \"../equipment/exposure-capabilities.js\";\nimport { parseIsoCapabilityProfile } from \"../equipment/iso-capabilities.js\";\nimport { parseGenericReleaseCapabilityProfile } from \"../equipment/release-capabilities.js\";\nimport { parseGenericBodyMeteringCapabilityProfile } from \"../equipment/metering-capabilities.js\";\nimport { parseFocusControlProfile } from \"../capture/focus-control.js\";\nimport { parseWhiteBalanceProfile } from \"../color/white-balance.js\";\nimport { parseStabilizationSystemProfile } from \"../stabilization/system.js\";\nimport { parseSensorReadoutConversionProfile } from \"../sensor/raw-readout.js\";\nimport { parseGenericIsoSignalChainProfile } from \"../sensor/iso-signal-chain.js\";\nimport { parseSensorFixedPatternNoiseProfile } from \"../sensor/fixed-pattern-noise.js\";\nimport { parseExposureMeteringProfile } from \"../exposure/metering.js\";\nimport { parseFlashSyncCapabilityProfile } from \"../exposure/flash.js\";\n\nconst PRESET_FIELDS = [\"tier\", \"label\", \"presetId\", \"presetVersion\", \"scientificStatus\", \"evidence\", \"body\", \"lens\", \"tradeoffs\"] as const;\nconst BODY_FIELDS = [\"exposure\", \"iso\", \"signalChain\", \"readout\", \"readoutTiming\", \"rollingReadoutTiming\", \"fixedPatternNoise\", \"release\", \"focus\",\n  \"stabilization\", \"whiteBalance\", \"metering\", \"meteringCapabilities\", \"flashSync\"] as const;\nconst LENS_FIELDS = [\"form\", \"exposure\", \"matchedReference\", \"profileReferences\", \"limitations\"] as const;\nconst MATCHED_REFERENCE_FIELDS = [\"focalLengthMm\", \"aperture\", \"focusDistanceM\", \"wavelengthNm\", \"normalizationRadiusMm\", \"distortionK1\",\n  \"lateralCaK1Offset\", \"vignettingR2\", \"breathingProjectionScale\", \"transmission\", \"correctionGainStrength\", \"correctionCaFraction\",\n  \"ghostPowerFraction\", \"veilPowerFraction\", \"pupilAmplitudeByField\", \"pupilOpdMicrometersByDefocus\", \"pupilThroughputByField\"] as const;\nconst VERSIONED_ASSET_FIELDS = [\"assetId\", \"assetVersion\", \"profile\"] as const;\n\nfunction objectWithFields(value: unknown, fields: readonly string[], path: string): Record<string, unknown> {\n  requireInputObject(value, path);\n  rejectUnknownFields(value as object, fields, path);\n  return value as Record<string, unknown>;\n}\nfunction stringList(value: unknown, path: string): void {\n  if (!Array.isArray(value) || value.some((entry) => typeof entry !== \"string\")) throw new InvalidConfigurationError(path + \" must be an array of strings.\");\n}\nfunction versionedAsset(value: unknown, path: string, parse?: (profile: unknown) => unknown): void {\n  const asset = objectWithFields(value, VERSIONED_ASSET_FIELDS, path);\n  requirePublicOpaqueId(asset.assetId, path + \".assetId is invalid.\");\n  if (typeof asset.assetVersion !== \"string\" || asset.assetVersion.length === 0) throw new InvalidConfigurationError(path + \".assetVersion must be a non-empty string.\");\n  requireInputObject(asset.profile, path + \".profile\");\n  parse?.(asset.profile);\n}\nfunction versionedAssetList(value: unknown, path: string, parse: (profile: unknown) => unknown): void {\n  if (!Array.isArray(value) || value.length === 0) throw new InvalidConfigurationError(path + \" must be a non-empty array.\");\n  value.forEach((asset, index) => versionedAsset(asset, path + \"[\" + index + \"]\", parse));\n}\n\n/**\n * Checks a caller-supplied camera preset object and returns it unchanged. Throws InvalidConfigurationError\n * (or the profile parser's domain error) for a missing or malformed part or an unknown field.\n * Readout-timing declarations have no standalone parser; they are checked for shape only and are not\n * read by simulateCapture().\n */\nexport function parseCallerCameraPreset(value: unknown): GenericEquipmentTierPreset {\n  const preset = objectWithFields(value, PRESET_FIELDS, \"camera\");\n  if (typeof preset.tier !== \"string\" || typeof preset.label !== \"string\") throw new InvalidConfigurationError(\"camera.tier and camera.label must be strings.\");\n  requirePublicOpaqueId(preset.presetId, \"camera.presetId is invalid.\");\n  if (typeof preset.presetVersion !== \"string\" || preset.presetVersion.length === 0) throw new InvalidConfigurationError(\"camera.presetVersion must be a non-empty string.\");\n  if (preset.scientificStatus !== \"approximation\") throw new InvalidConfigurationError(\"camera.scientificStatus must be \\\"approximation\\\".\");\n  parseEvidenceList(preset.evidence, \"camera.evidence\");\n  stringList(preset.tradeoffs, \"camera.tradeoffs\");\n\n  const body = objectWithFields(preset.body, BODY_FIELDS, \"camera.body\");\n  parseGenericBodyExposureCapabilityProfile(body.exposure);\n  parseIsoCapabilityProfile(body.iso);\n  parseGenericIsoSignalChainProfile(body.signalChain);\n  versionedAssetList(body.readout, \"camera.body.readout\", parseSensorReadoutConversionProfile);\n  versionedAsset(body.readoutTiming, \"camera.body.readoutTiming\");\n  versionedAsset(body.rollingReadoutTiming, \"camera.body.rollingReadoutTiming\");\n  versionedAsset(body.fixedPatternNoise, \"camera.body.fixedPatternNoise\", parseSensorFixedPatternNoiseProfile);\n  parseGenericReleaseCapabilityProfile(body.release);\n  parseFocusControlProfile(body.focus);\n  parseStabilizationSystemProfile(body.stabilization);\n  parseWhiteBalanceProfile(body.whiteBalance);\n  versionedAssetList(body.metering, \"camera.body.metering\", parseExposureMeteringProfile);\n  parseGenericBodyMeteringCapabilityProfile(body.meteringCapabilities);\n  parseFlashSyncCapabilityProfile(body.flashSync);\n\n  const lens = objectWithFields(preset.lens, LENS_FIELDS, \"camera.lens\");\n  if (lens.form !== \"prime\") throw new InvalidConfigurationError(\"camera.lens.form must be \\\"prime\\\".\");\n  parseGenericLensExposureCapabilityProfile(lens.exposure);\n  objectWithFields(lens.matchedReference, MATCHED_REFERENCE_FIELDS, \"camera.lens.matchedReference\");\n  if (!Array.isArray(lens.profileReferences)) throw new InvalidConfigurationError(\"camera.lens.profileReferences must be an array.\");\n  lens.profileReferences.forEach((reference, index) => {\n    const r = objectWithFields(reference, [\"profileId\", \"profileVersion\"], \"camera.lens.profileReferences[\" + index + \"]\");\n    if (typeof r.profileId !== \"string\" || typeof r.profileVersion !== \"string\") throw new InvalidConfigurationError(\"camera.lens.profileReferences[\" + index + \"] needs string profileId and profileVersion.\");\n  });\n  stringList(lens.limitations, \"camera.lens.limitations\");\n  return value as GenericEquipmentTierPreset;\n}\n"]}

package/dist/facade/chart-radiance-batch.d.ts

@@ -0,0 +1,57 @@
+import { type ChartScene, type ResolvedChartScene } from "./chart-scenes.js";
+import { type CaptureIlluminant, type ResolvedCaptureIlluminant } from "./scene-radiance.js";
+export declare const CHART_RADIANCE_BATCH_SCHEMA_VERSION: "0.1.0";
+export declare const CHART_RADIANCE_BATCH_LIMITS: Readonly<{
+    maximumQueries: 24000000;
+    maximumWavelengths: 256;
+    maximumChannels: 4;
+}>;
+export interface ChartRadianceBatchInput {
+    schemaVersion: typeof CHART_RADIANCE_BATCH_SCHEMA_VERSION;
+    /** An engine chart preset (caller scene functions are not supported here). */
+    scene: ChartScene;
+    illuminant: CaptureIlluminant;
+    illuminanceLux: number;
+    /** Frame height / width. */
+    aspect: number;
+    /** Frame points, interleaved [u0, v0, u1, v1, …]. Finite. */
+    points: Float32Array | Float64Array;
+    /** The wavelengths the queries use, in nanometres (1–256). */
+    wavelengthsNanometers: readonly number[];
+    /** Radiance queries: one wavelength index per point. Exactly one of this and `channelWeights`. */
+    wavelengthIndices?: Uint8Array | Uint16Array;
+    /** Spectral integration: per channel (1–4), one finite weight per wavelength. */
+    channelWeights?: readonly (readonly number[])[];
+}
+/** Validated plan with the resolved chart, illuminant and irradiance scale. Arrays are borrowed. */
+export interface ChartRadianceBatchPlan {
+    chart: ResolvedChartScene;
+    illuminant: ResolvedCaptureIlluminant;
+    irradianceScale: number;
+    queryCount: number;
+    /** Output values per query: 1 for radiance queries, the channel count for spectral integration. */
+    columns: number;
+    mode: "radiance" | "spectral-integral";
+    wavelengthsNanometers: readonly number[];
+    channelWeights: readonly (readonly number[])[] | null;
+    /** Spectral radiance of one material at a wavelength: the provider's own radianceAt for that material. */
+    materialRadiance(material: number, wavelengthNanometers: number): number;
+    /** The reference value of one query and output column (radianceAt, and its wavelength-ordered sum). */
+    queryValue(points: Float32Array | Float64Array, wavelengthIndices: Uint8Array | Uint16Array | undefined, query: number, column: number): number;
+}
+export declare function calculateChartRadianceBatchPlan(input: ChartRadianceBatchInput): ChartRadianceBatchPlan;
+/** Float64 CPU reference: every query's value(s), row-major (query, column). */
+export declare function calculateChartRadianceBatch(input: ChartRadianceBatchInput): {
+    plan: ChartRadianceBatchPlan;
+    values: Float64Array;
+};
+/**
+ * Frame points of environment-direction queries on the chart plane, exactly as the planar provider's
+ * `evaluateRadiance` computes them: look direction l = −o, plane point l·distance/l.z, in frame units.
+ * @param directions - Outgoing unit vectors (scene toward camera), interleaved [x, y, z, …].
+ */
+export declare function mapEnvironmentDirectionsToChartPoints(input: {
+    directions: Float32Array | Float64Array;
+    distanceM: number;
+    metresPerFrameUnit: number;
+}): Float64Array;

package/dist/facade/chart-radiance-batch.js

@@ -0,0 +1,121 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Batched radiance queries for the engine's procedural chart scenes (#277): many frame points in one
+ * call, each answered with spectral radiance at a declared wavelength, or with the spectral integral of
+ * that radiance against declared channel weights. This is the float64 CPU reference for the
+ * `webgpu-f32` chart-radiance stage (`ImageKernelAccelerator.evaluateChartRadiance`).
+ *
+ * Every value comes from the chart provider's own `radianceAt` (createPlanarSceneRadianceProvider): a
+ * Lambertian reflectance ρ(λ) under the scaled illuminant, L = ρ·k·S(λ)/π. The spectral integral of a
+ * query is Σ_j w_cj·L(u, v, λ_j), summed in wavelength order. Charts are uniform-illuminant Lambertian
+ * patterns, so a query's integral depends only on its material: the GPU stage uses exactly that.
+ *
+ * The query shape mirrors a batched provider (one call, queries in, results in the same order). Points
+ * are frame units (u right, v up; see chart-scenes.ts); `mapEnvironmentDirectionsToChartPoints` converts
+ * environment-direction queries exactly as `evaluateRadiance` does.
+ * @see docs/WEBGPU.md, "Scene radiance on the GPU".
+ */
+import { InvalidConfigurationError } from "../core/configuration-error.js";
+import { requireAllowlistedRecord } from "../core/record-validation.js";
+import { resolveChartScene } from "./chart-scenes.js";
+import { buildPlanarSceneRadianceProvider, calculateIlluminantIrradianceScale, resolveCaptureIlluminant } from "./scene-radiance.js";
+export const CHART_RADIANCE_BATCH_SCHEMA_VERSION = "0.1.0";
+export const CHART_RADIANCE_BATCH_LIMITS = Object.freeze({ maximumQueries: 24_000_000, maximumWavelengths: 256, maximumChannels: 4 });
+export function calculateChartRadianceBatchPlan(input) {
+    const r = requireAllowlistedRecord(input, ["schemaVersion", "scene", "illuminant", "illuminanceLux", "aspect", "points", "wavelengthsNanometers",
+        "wavelengthIndices", "channelWeights"], "Invalid chart radiance batch input.");
+    if (r.schemaVersion !== CHART_RADIANCE_BATCH_SCHEMA_VERSION)
+        throw new InvalidConfigurationError("Unsupported chart radiance batch schema.");
+    if (typeof r.aspect !== "number" || !(r.aspect > 0 && r.aspect <= Number.MAX_VALUE))
+        throw new InvalidConfigurationError("aspect must be positive.");
+    const chart = resolveChartScene({ scene: r.scene, aspect: r.aspect });
+    const illuminant = resolveCaptureIlluminant(r.illuminant);
+    const irradianceScale = calculateIlluminantIrradianceScale(illuminant.shape, r.illuminanceLux);
+    const L = CHART_RADIANCE_BATCH_LIMITS, points = r.points;
+    if (!(points instanceof Float32Array || points instanceof Float64Array) || points.length % 2 !== 0 || points.length / 2 > L.maximumQueries) {
+        throw new InvalidConfigurationError("points must be an interleaved Float32Array or Float64Array of (u, v) pairs.");
+    }
+    for (let i = 0; i < points.length; i++)
+        if (!Number.isFinite(points[i]))
+            throw new InvalidConfigurationError("Chart points must be finite.");
+    const queryCount = points.length / 2, wavelengths = r.wavelengthsNanometers;
+    if (!Array.isArray(wavelengths) || wavelengths.length < 1 || wavelengths.length > L.maximumWavelengths ||
+        wavelengths.some(nm => typeof nm !== "number" || !Number.isFinite(nm) || nm <= 0)) {
+        throw new InvalidConfigurationError("wavelengthsNanometers must list 1 to 256 positive wavelengths.");
+    }
+    const indices = r.wavelengthIndices, weights = r.channelWeights;
+    if ((indices === undefined) === (weights === undefined))
+        throw new InvalidConfigurationError("Give exactly one of wavelengthIndices and channelWeights.");
+    if (indices !== undefined) {
+        if (!(indices instanceof Uint8Array || indices instanceof Uint16Array) || indices.length !== queryCount) {
+            throw new InvalidConfigurationError("wavelengthIndices must hold one index per point.");
+        }
+        for (let i = 0; i < queryCount; i++)
+            if (indices[i] >= wavelengths.length)
+                throw new InvalidConfigurationError("A wavelength index is out of range.");
+    }
+    else if (!Array.isArray(weights) || weights.length < 1 || weights.length > L.maximumChannels ||
+        weights.some(row => !Array.isArray(row) || row.length !== wavelengths.length || row.some(w => typeof w !== "number" || !Number.isFinite(w)))) {
+        throw new InvalidConfigurationError("channelWeights must hold 1 to 4 rows of one finite weight per wavelength.");
+    }
+    // The provider's own radiance function: chart reflectance × scaled illuminant / π, in its float64 order.
+    const provider = buildPlanarSceneRadianceProvider({ scene: chart, sceneId: "chart-radiance-batch", providerProfileId: "chart-radiance-batch", illuminant,
+        irradianceScale, geometry: { distanceM: 1, metresPerFrameUnit: 1 }, evidence: [], limitations: [] });
+    const channelWeights = weights === undefined ? null : weights.map(row => Object.freeze([...row]));
+    const nm = Object.freeze([...wavelengths]);
+    const materialRadiance = (material, wavelength) => {
+        const m = chart.materials[material];
+        const reflectance = m.kind === "neutral" ? m.reflectance : m.spectrum.evaluate(wavelength);
+        if (m.kind === "spectrum" && !(reflectance >= 0 && reflectance <= 1))
+            throw new InvalidConfigurationError("Chart reflectance spectrum left [0, 1].");
+        return reflectance * irradianceScale * illuminant.shape.evaluate(wavelength) / Math.PI;
+    };
+    return Object.freeze({ chart, illuminant, irradianceScale, queryCount, columns: channelWeights === null ? 1 : channelWeights.length,
+        mode: channelWeights === null ? "radiance" : "spectral-integral", wavelengthsNanometers: nm, channelWeights, materialRadiance,
+        queryValue(p, w, query, column) {
+            const u = p[2 * query], v = p[2 * query + 1];
+            if (channelWeights === null)
+                return provider.radianceAt(u, v, nm[w[query]]);
+            let sum = 0;
+            const row = channelWeights[column];
+            for (let j = 0; j < nm.length; j++)
+                sum += row[j] * provider.radianceAt(u, v, nm[j]);
+            return sum;
+        } });
+}
+/** Float64 CPU reference: every query's value(s), row-major (query, column). */
+export function calculateChartRadianceBatch(input) {
+    const plan = calculateChartRadianceBatchPlan(input), values = new Float64Array(plan.queryCount * plan.columns);
+    for (let q = 0; q < plan.queryCount; q++)
+        for (let c = 0; c < plan.columns; c++)
+            values[q * plan.columns + c] = plan.queryValue(input.points, input.wavelengthIndices, q, c);
+    return { plan, values };
+}
+/**
+ * Frame points of environment-direction queries on the chart plane, exactly as the planar provider's
+ * `evaluateRadiance` computes them: look direction l = −o, plane point l·distance/l.z, in frame units.
+ * @param directions - Outgoing unit vectors (scene toward camera), interleaved [x, y, z, …].
+ */
+export function mapEnvironmentDirectionsToChartPoints(input) {
+    const r = requireAllowlistedRecord(input, ["directions", "distanceM", "metresPerFrameUnit"], "Invalid planar direction input.");
+    const d = r.directions, distance = r.distanceM, scale = r.metresPerFrameUnit;
+    if (!(d instanceof Float32Array || d instanceof Float64Array) || d.length % 3 !== 0 || typeof distance !== "number" || !(distance > 0 && distance <= Number.MAX_VALUE) ||
+        typeof scale !== "number" || !(scale > 0 && scale <= Number.MAX_VALUE)) {
+        throw new InvalidConfigurationError("Planar directions need interleaved unit vectors, a positive distance and a positive frame scale.");
+    }
+    const points = new Float64Array(d.length / 3 * 2);
+    for (let i = 0; i < d.length / 3; i++) {
+        const lz = -d[3 * i + 2];
+        if (!(lz > 0))
+            throw new InvalidConfigurationError("Planar scene query does not point toward the scene plane.");
+        const t = distance / lz;
+        const x = -d[3 * i] * t / scale, y = -d[3 * i + 1] * t / scale;
+        // A grazing direction (lz near 0, e.g. 1e-320) or a non-finite component would give ±Infinity or NaN.
+        if (!Number.isFinite(x) || !Number.isFinite(y))
+            throw new InvalidConfigurationError("Planar scene query maps to a non-finite chart point (grazing or non-finite direction).");
+        points[2 * i] = x;
+        points[2 * i + 1] = y;
+    }
+    return points;
+}
+//# sourceMappingURL=chart-radiance-batch.js.map

package/dist/facade/chart-radiance-batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-radiance-batch.js","sourceRoot":"","sources":["../../src/facade/chart-radiance-batch.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Batched radiance queries for the engine's procedural chart scenes (#277): many frame points in one\n * call, each answered with spectral radiance at a declared wavelength, or with the spectral integral of\n * that radiance against declared channel weights. This is the float64 CPU reference for the\n * `webgpu-f32` chart-radiance stage (`ImageKernelAccelerator.evaluateChartRadiance`).\n *\n * Every value comes from the chart provider's own `radianceAt` (createPlanarSceneRadianceProvider): a\n * Lambertian reflectance ρ(λ) under the scaled illuminant, L = ρ·k·S(λ)/π. The spectral integral of a\n * query is Σ_j w_cj·L(u, v, λ_j), summed in wavelength order. Charts are uniform-illuminant Lambertian\n * patterns, so a query's integral depends only on its material: the GPU stage uses exactly that.\n *\n * The query shape mirrors a batched provider (one call, queries in, results in the same order). Points\n * are frame units (u right, v up; see chart-scenes.ts); `mapEnvironmentDirectionsToChartPoints` converts\n * environment-direction queries exactly as `evaluateRadiance` does.\n * @see docs/WEBGPU.md, \"Scene radiance on the GPU\".\n */\n\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\nimport { requireAllowlistedRecord } from \"../core/record-validation.js\";\nimport { resolveChartScene, type ChartScene, type ResolvedChartScene } from \"./chart-scenes.js\";\nimport { buildPlanarSceneRadianceProvider, calculateIlluminantIrradianceScale, resolveCaptureIlluminant, type CaptureIlluminant,\n  type ResolvedCaptureIlluminant } from \"./scene-radiance.js\";\n\nexport const CHART_RADIANCE_BATCH_SCHEMA_VERSION = \"0.1.0\" as const;\nexport const CHART_RADIANCE_BATCH_LIMITS = Object.freeze({ maximumQueries: 24_000_000, maximumWavelengths: 256, maximumChannels: 4 });\n\nexport interface ChartRadianceBatchInput {\n  schemaVersion: typeof CHART_RADIANCE_BATCH_SCHEMA_VERSION;\n  /** An engine chart preset (caller scene functions are not supported here). */\n  scene: ChartScene;\n  illuminant: CaptureIlluminant;\n  illuminanceLux: number;\n  /** Frame height / width. */\n  aspect: number;\n  /** Frame points, interleaved [u0, v0, u1, v1, …]. Finite. */\n  points: Float32Array | Float64Array;\n  /** The wavelengths the queries use, in nanometres (1–256). */\n  wavelengthsNanometers: readonly number[];\n  /** Radiance queries: one wavelength index per point. Exactly one of this and `channelWeights`. */\n  wavelengthIndices?: Uint8Array | Uint16Array;\n  /** Spectral integration: per channel (1–4), one finite weight per wavelength. */\n  channelWeights?: readonly (readonly number[])[];\n}\n\n/** Validated plan with the resolved chart, illuminant and irradiance scale. Arrays are borrowed. */\nexport interface ChartRadianceBatchPlan {\n  chart: ResolvedChartScene;\n  illuminant: ResolvedCaptureIlluminant;\n  irradianceScale: number;\n  queryCount: number;\n  /** Output values per query: 1 for radiance queries, the channel count for spectral integration. */\n  columns: number;\n  mode: \"radiance\" | \"spectral-integral\";\n  wavelengthsNanometers: readonly number[];\n  channelWeights: readonly (readonly number[])[] | null;\n  /** Spectral radiance of one material at a wavelength: the provider's own radianceAt for that material. */\n  materialRadiance(material: number, wavelengthNanometers: number): number;\n  /** The reference value of one query and output column (radianceAt, and its wavelength-ordered sum). */\n  queryValue(points: Float32Array | Float64Array, wavelengthIndices: Uint8Array | Uint16Array | undefined, query: number, column: number): number;\n}\n\nexport function calculateChartRadianceBatchPlan(input: ChartRadianceBatchInput): ChartRadianceBatchPlan {\n  const r = requireAllowlistedRecord(input, [\"schemaVersion\", \"scene\", \"illuminant\", \"illuminanceLux\", \"aspect\", \"points\", \"wavelengthsNanometers\",\n    \"wavelengthIndices\", \"channelWeights\"], \"Invalid chart radiance batch input.\");\n  if (r.schemaVersion !== CHART_RADIANCE_BATCH_SCHEMA_VERSION) throw new InvalidConfigurationError(\"Unsupported chart radiance batch schema.\");\n  if (typeof r.aspect !== \"number\" || !(r.aspect > 0 && r.aspect <= Number.MAX_VALUE)) throw new InvalidConfigurationError(\"aspect must be positive.\");\n  const chart = resolveChartScene({ scene: r.scene as ChartScene, aspect: r.aspect });\n  const illuminant = resolveCaptureIlluminant(r.illuminant as CaptureIlluminant);\n  const irradianceScale = calculateIlluminantIrradianceScale(illuminant.shape, r.illuminanceLux as number);\n  const L = CHART_RADIANCE_BATCH_LIMITS, points = r.points;\n  if (!(points instanceof Float32Array || points instanceof Float64Array) || points.length % 2 !== 0 || points.length / 2 > L.maximumQueries) {\n    throw new InvalidConfigurationError(\"points must be an interleaved Float32Array or Float64Array of (u, v) pairs.\");\n  }\n  for (let i = 0; i < points.length; i++) if (!Number.isFinite(points[i]!)) throw new InvalidConfigurationError(\"Chart points must be finite.\");\n  const queryCount = points.length / 2, wavelengths = r.wavelengthsNanometers;\n  if (!Array.isArray(wavelengths) || wavelengths.length < 1 || wavelengths.length > L.maximumWavelengths ||\n      wavelengths.some(nm => typeof nm !== \"number\" || !Number.isFinite(nm) || nm <= 0)) {\n    throw new InvalidConfigurationError(\"wavelengthsNanometers must list 1 to 256 positive wavelengths.\");\n  }\n  const indices = r.wavelengthIndices, weights = r.channelWeights;\n  if ((indices === undefined) === (weights === undefined)) throw new InvalidConfigurationError(\"Give exactly one of wavelengthIndices and channelWeights.\");\n  if (indices !== undefined) {\n    if (!(indices instanceof Uint8Array || indices instanceof Uint16Array) || indices.length !== queryCount) {\n      throw new InvalidConfigurationError(\"wavelengthIndices must hold one index per point.\");\n    }\n    for (let i = 0; i < queryCount; i++) if (indices[i]! >= wavelengths.length) throw new InvalidConfigurationError(\"A wavelength index is out of range.\");\n  } else if (!Array.isArray(weights) || weights.length < 1 || weights.length > L.maximumChannels ||\n      weights.some(row => !Array.isArray(row) || row.length !== wavelengths.length || row.some(w => typeof w !== \"number\" || !Number.isFinite(w)))) {\n    throw new InvalidConfigurationError(\"channelWeights must hold 1 to 4 rows of one finite weight per wavelength.\");\n  }\n  // The provider's own radiance function: chart reflectance × scaled illuminant / π, in its float64 order.\n  const provider = buildPlanarSceneRadianceProvider({ scene: chart, sceneId: \"chart-radiance-batch\", providerProfileId: \"chart-radiance-batch\", illuminant,\n    irradianceScale, geometry: { distanceM: 1, metresPerFrameUnit: 1 }, evidence: [], limitations: [] });\n  const channelWeights = weights === undefined ? null : (weights as number[][]).map(row => Object.freeze([...row]));\n  const nm = Object.freeze([...(wavelengths as number[])]);\n  const materialRadiance = (material: number, wavelength: number): number => {\n    const m = chart.materials[material]!;\n    const reflectance = m.kind === \"neutral\" ? m.reflectance : m.spectrum.evaluate(wavelength);\n    if (m.kind === \"spectrum\" && !(reflectance >= 0 && reflectance <= 1)) throw new InvalidConfigurationError(\"Chart reflectance spectrum left [0, 1].\");\n    return reflectance * irradianceScale * illuminant.shape.evaluate(wavelength) / Math.PI;\n  };\n  return Object.freeze({ chart, illuminant, irradianceScale, queryCount, columns: channelWeights === null ? 1 : channelWeights.length,\n    mode: channelWeights === null ? \"radiance\" as const : \"spectral-integral\" as const, wavelengthsNanometers: nm, channelWeights, materialRadiance,\n    queryValue(p: Float32Array | Float64Array, w: Uint8Array | Uint16Array | undefined, query: number, column: number): number {\n      const u = p[2 * query]!, v = p[2 * query + 1]!;\n      if (channelWeights === null) return provider.radianceAt(u, v, nm[w![query]!]!);\n      let sum = 0;\n      const row = channelWeights[column]!;\n      for (let j = 0; j < nm.length; j++) sum += row[j]! * provider.radianceAt(u, v, nm[j]!);\n      return sum;\n    } });\n}\n\n/** Float64 CPU reference: every query's value(s), row-major (query, column). */\nexport function calculateChartRadianceBatch(input: ChartRadianceBatchInput): { plan: ChartRadianceBatchPlan; values: Float64Array } {\n  const plan = calculateChartRadianceBatchPlan(input), values = new Float64Array(plan.queryCount * plan.columns);\n  for (let q = 0; q < plan.queryCount; q++) for (let c = 0; c < plan.columns; c++) values[q * plan.columns + c] = plan.queryValue(input.points, input.wavelengthIndices, q, c);\n  return { plan, values };\n}\n\n/**\n * Frame points of environment-direction queries on the chart plane, exactly as the planar provider's\n * `evaluateRadiance` computes them: look direction l = −o, plane point l·distance/l.z, in frame units.\n * @param directions - Outgoing unit vectors (scene toward camera), interleaved [x, y, z, …].\n */\nexport function mapEnvironmentDirectionsToChartPoints(input: { directions: Float32Array | Float64Array; distanceM: number; metresPerFrameUnit: number }): Float64Array {\n  const r = requireAllowlistedRecord(input, [\"directions\", \"distanceM\", \"metresPerFrameUnit\"], \"Invalid planar direction input.\");\n  const d = r.directions, distance = r.distanceM, scale = r.metresPerFrameUnit;\n  if (!(d instanceof Float32Array || d instanceof Float64Array) || d.length % 3 !== 0 || typeof distance !== \"number\" || !(distance > 0 && distance <= Number.MAX_VALUE) ||\n      typeof scale !== \"number\" || !(scale > 0 && scale <= Number.MAX_VALUE)) {\n    throw new InvalidConfigurationError(\"Planar directions need interleaved unit vectors, a positive distance and a positive frame scale.\");\n  }\n  const points = new Float64Array(d.length / 3 * 2);\n  for (let i = 0; i < d.length / 3; i++) {\n    const lz = -d[3 * i + 2]!;\n    if (!(lz > 0)) throw new InvalidConfigurationError(\"Planar scene query does not point toward the scene plane.\");\n    const t = distance / lz;\n    const x = -d[3 * i]! * t / scale, y = -d[3 * i + 1]! * t / scale;\n    // A grazing direction (lz near 0, e.g. 1e-320) or a non-finite component would give ±Infinity or NaN.\n    if (!Number.isFinite(x) || !Number.isFinite(y)) throw new InvalidConfigurationError(\"Planar scene query maps to a non-finite chart point (grazing or non-finite direction).\");\n    points[2 * i] = x;\n    points[2 * i + 1] = y;\n  }\n  return points;\n}\n"]}

package/dist/facade/chart-scenes.d.ts

@@ -0,0 +1,177 @@
+import { type ColorimetricSpectrum, type PreparedColorimetricSpectrum } from "../color/color-matching-functions.js";
+/** A neutral (spectrally flat) reflectance in [0, 1], or a caller reflectance spectrum (values in [0, 1]). */
+export type ChartReflectance = number | ColorimetricSpectrum;
+export interface UniformChartScene {
+    preset: "uniform";
+    reflectance?: ChartReflectance;
+}
+export interface SlantedEdgeChartScene {
+    preset: "slanted-edge";
+    /** Clockwise tilt of the edge from vertical, degrees, in (-45, 45). Default 5. */
+    angleDegrees?: number;
+    /** Left (dark) side reflectance. Default 0.15. */
+    darkReflectance?: number;
+    /** Right (light) side reflectance. Default 0.6 (4:1 with the default dark side). */
+    lightReflectance?: number;
+}
+export interface SiemensStarChartScene {
+    preset: "siemens-star";
+    /** Light/dark sector pairs around the star, 2..360. Default 36. */
+    cycles?: number;
+    /** Star radius as a fraction of the frame half-height, (0, 1]. Default 0.9. */
+    radiusFraction?: number;
+    darkReflectance?: number;
+    lightReflectance?: number;
+    /** Reflectance outside the star. Default 0.18. */
+    backgroundReflectance?: number;
+}
+export interface StepWedgeChartScene {
+    preset: "step-wedge";
+    /** Number of equal-width vertical steps from left (minimum) to right (maximum), 2..64. Default 11. */
+    steps?: number;
+    minimumReflectance?: number;
+    maximumReflectance?: number;
+    /** `equal-density` (geometric, default) or `linear` reflectance spacing. */
+    spacing?: "equal-density" | "linear";
+}
+export interface GreyRampChartScene {
+    preset: "grey-ramp";
+    /** Continuous ramp, linear in reflectance from left (minimum) to right (maximum). */
+    minimumReflectance?: number;
+    maximumReflectance?: number;
+}
+export interface CheckerboardChartScene {
+    preset: "checkerboard";
+    /** Squares across the frame width, 2..256. Default 8. */
+    squaresAcross?: number;
+    darkReflectance?: number;
+    lightReflectance?: number;
+}
+export interface PointGridChartScene {
+    preset: "point-grid";
+    /** Grid columns and rows of small disks centred in equal cells. Defaults 5 × 3. */
+    columns?: number;
+    rows?: number;
+    /** Disk radius in frame units (fraction of the frame half-width). Default 0.01. */
+    radius?: number;
+    pointReflectance?: number;
+    backgroundReflectance?: number;
+}
+export interface PatchChartScene {
+    preset: "patches";
+    /** Caller reflectance per patch, row-major; the facade bundles no colour-chart data. 1..1024 patches. */
+    patches: readonly {
+        patchId: string;
+        reflectance: ChartReflectance;
+    }[];
+    /** Patches per row. Default ceil(sqrt(patch count)). */
+    columns?: number;
+    /** Gap between patches as a fraction of the cell size, [0, 0.5). Default 0.1. */
+    gapFraction?: number;
+    backgroundReflectance?: number;
+}
+export type ChartScene = UniformChartScene | SlantedEdgeChartScene | SiemensStarChartScene | StepWedgeChartScene | GreyRampChartScene | CheckerboardChartScene | PointGridChartScene | PatchChartScene;
+export type ChartScenePresetId = ChartScene["preset"];
+export declare const CHART_SCENE_PRESETS: readonly ChartScenePresetId[];
+/** Engine-chosen chart parameters, each reported when the caller omitted it. */
+export declare const CHART_SCENE_DEFAULTS: Readonly<{
+    uniform: Readonly<{
+        reflectance: 0.18;
+    }>;
+    "slanted-edge": Readonly<{
+        angleDegrees: 5;
+        darkReflectance: 0.15;
+        lightReflectance: 0.6;
+    }>;
+    "siemens-star": Readonly<{
+        cycles: 36;
+        radiusFraction: 0.9;
+        darkReflectance: 0.05;
+        lightReflectance: 0.8;
+        backgroundReflectance: 0.18;
+    }>;
+    "step-wedge": Readonly<{
+        steps: 11;
+        minimumReflectance: 0.03;
+        maximumReflectance: 0.9;
+        spacing: "equal-density";
+    }>;
+    "grey-ramp": Readonly<{
+        minimumReflectance: 0.03;
+        maximumReflectance: 0.9;
+    }>;
+    checkerboard: Readonly<{
+        squaresAcross: 8;
+        darkReflectance: 0.05;
+        lightReflectance: 0.8;
+    }>;
+    "point-grid": Readonly<{
+        columns: 5;
+        rows: 3;
+        radius: 0.01;
+        pointReflectance: 0.9;
+        backgroundReflectance: 0.02;
+    }>;
+    patches: Readonly<{
+        gapFraction: 0.1;
+        backgroundReflectance: 0.18;
+    }>;
+}>;
+/** A validated chart: every parameter resolved, plus which ones came from {@link CHART_SCENE_DEFAULTS}. */
+export interface ResolvedChartScene {
+    preset: ChartScenePresetId;
+    /** Fully resolved parameters (spectra are reported as `"caller-spectrum"`). */
+    parameters: Readonly<Record<string, unknown>>;
+    /** Names of parameters filled from defaults. */
+    defaultedParameters: readonly string[];
+    /** Frame aspect (height / width) the chart was resolved for. */
+    aspect: number;
+    /**
+     * Material index at a frame point (u right, v up). The index points into `materials`, starting at 0.
+     * Points outside the framed rectangle still evaluate (the pattern continues as defined), so blur and
+     * small framing differences stay well defined.
+     */
+    materialAt(u: number, v: number): number;
+    /** Reflectance materials: a neutral number or a prepared caller spectrum. */
+    materials: readonly ({
+        kind: "neutral";
+        reflectance: number;
+    } | {
+        kind: "spectrum";
+        spectrum: PreparedColorimetricSpectrum;
+    })[];
+    /** Reflectance in [0, 1] at a frame point and wavelength (nm). */
+    reflectanceAt(u: number, v: number, wavelengthNanometers: number): number;
+}
+/** Wavelength range every chart spectrum must cover (the facade's sensor quadrature range). */
+export declare const CHART_SPECTRAL_RANGE_NANOMETERS: Readonly<{
+    minimum: 380;
+    maximum: 780;
+}>;
+/**
+ * Validates a chart description and resolves every default. `aspect` is the frame height/width. Unknown
+ * fields are rejected so that a mistyped parameter never silently falls back to a default.
+ */
+export declare function resolveChartScene(input: {
+    scene: ChartScene;
+    aspect: number;
+}): ResolvedChartScene;
+/**
+ * Step reflectances of a step wedge. `equal-density` spaces optical density D = -log10(R) evenly, which
+ * gives geometric reflectance steps, as on a photographic step tablet. `linear` spaces reflectance evenly.
+ */
+export declare function calculateStepWedgeReflectances(input: {
+    steps: number;
+    minimumReflectance: number;
+    maximumReflectance: number;
+    spacing: "equal-density" | "linear";
+}): number[];
+/** Centres (frame units) of a point grid: one disk centred in each of columns × rows equal cells, row-major from the top-left. */
+export declare function calculatePointGridCenters(input: {
+    columns: number;
+    rows: number;
+    aspect: number;
+}): {
+    u: number;
+    v: number;
+}[];