@photivra/engine 0.6.0 → 1.0.1

package/dist/color/sensor-color-development.js.map

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

package/dist/color/white-balance.d.ts

@@ -0,0 +1,175 @@
+import { type EvidenceBackedFact, type EvidenceProvenance } from "../core/evidence-provenance.js";
+export declare const WHITE_BALANCE_PROFILE_SCHEMA_VERSION: "0.1.0";
+export declare const WHITE_BALANCE_STATE_VERSION: "0.1.0";
+export declare const COLOR_TEMPERATURE_WHITE_BALANCE_INTENT_VERSION: "0.1.0";
+export type WhiteBalanceInputDomain = "relative-pre-wb-camera-linear-rgb";
+export interface WhiteBalanceChannelGains {
+    red: number;
+    green: number;
+    blue: number;
+}
+export type WhiteBalanceAwbIntent = "neutral-priority" | "standard" | "ambience-preserving";
+export interface WhiteBalancePresetDefinition {
+    presetId: string;
+    label: string;
+    channelGains: EvidenceBackedFact<WhiteBalanceChannelGains>;
+    nominalColorTemperatureKelvin?: number;
+    nominalTint?: number;
+    limitations?: readonly string[];
+}
+export interface WhiteBalanceAwbPolicy {
+    policyId: string;
+    intent: WhiteBalanceAwbIntent;
+    /**
+     * Fraction of a gray-world neutralizing correction applied in logarithmic
+     * gain space. 1 is full neutral-priority correction; lower values preserve
+     * more of the observed cast.
+     */
+    correctionStrength: EvidenceBackedFact<number>;
+    limitations?: readonly string[];
+}
+export interface WhiteBalanceProfile {
+    schemaVersion: typeof WHITE_BALANCE_PROFILE_SCHEMA_VERSION;
+    profileId: string;
+    profileVersion: string;
+    scientificStatus: "approximation";
+    inputDomain: WhiteBalanceInputDomain;
+    presets: readonly WhiteBalancePresetDefinition[];
+    awbPolicies: readonly WhiteBalanceAwbPolicy[];
+    evidence: readonly EvidenceProvenance[];
+    limitations: readonly string[];
+}
+export interface PreWhiteBalanceRgbSample {
+    sampleId: string;
+    red: number;
+    green: number;
+    blue: number;
+    weight: number;
+    clipped: boolean;
+}
+export interface PreWhiteBalanceRgbSampleSet {
+    imageStateId: string;
+    inputDomain: WhiteBalanceInputDomain;
+    samples: readonly PreWhiteBalanceRgbSample[];
+}
+export interface ResolvedWhiteBalanceState {
+    version: typeof WHITE_BALANCE_STATE_VERSION;
+    stateId: string;
+    inputDomain: WhiteBalanceInputDomain;
+    source: "preset" | "manual-gains" | "custom-measurement" | "auto-white-balance";
+    channelGains: WhiteBalanceChannelGains;
+    locked: boolean;
+    sourceProfile?: {
+        profileId: string;
+        profileVersion: string;
+    };
+    presetId?: string;
+    awbPolicy?: {
+        policyId: string;
+        intent: WhiteBalanceAwbIntent;
+        correctionStrength: number;
+    };
+    measurement?: {
+        imageStateId: string;
+        usableSampleCount: number;
+        rejectedClippedSampleCount: number;
+        weightedMeanPreWbSignal: {
+            red: number;
+            green: number;
+            blue: number;
+        };
+    };
+    sourceStateId?: string;
+    trueIlluminantMetadataUsed: false;
+    sceneIlluminationModified: false;
+    rawCaptureDestructivelyModified: false;
+    physicalExposureModified: false;
+    focusModified: false;
+    limitations: readonly string[];
+}
+export interface ColorTemperatureWhiteBalanceIntent {
+    version: typeof COLOR_TEMPERATURE_WHITE_BALANCE_INTENT_VERSION;
+    intentId: string;
+    colorTemperatureKelvin: number;
+    tint: number;
+    channelGainsResolved: false;
+    requiresCameraProfileColorimetry: true;
+    sceneIlluminationModified: false;
+}
+export interface ResolvePresetWhiteBalanceInput {
+    stateId: string;
+    profile: WhiteBalanceProfile;
+    presetId: string;
+}
+export interface ResolveManualWhiteBalanceInput {
+    stateId: string;
+    channelGains: WhiteBalanceChannelGains;
+}
+export interface CreateColorTemperatureWhiteBalanceIntentInput {
+    intentId: string;
+    colorTemperatureKelvin: number;
+    tint: number;
+}
+export interface ResolveCustomWhiteBalanceInput {
+    stateId: string;
+    sampleSet: PreWhiteBalanceRgbSampleSet;
+}
+export interface EstimateAutoWhiteBalanceInput {
+    stateId: string;
+    profile: WhiteBalanceProfile;
+    policyId: string;
+    sampleSet: PreWhiteBalanceRgbSampleSet;
+}
+export interface CreateLockedWhiteBalanceStateInput {
+    stateId: string;
+    sourceState: ResolvedWhiteBalanceState;
+}
+/**
+ * Parses generic WB presets and AWB policies.
+ *
+ * Preset gains and AWB correction strength are profile-owned. Labels are not
+ * treated as universal Kelvin aliases or manufacturer-specific behavior.
+ */
+export declare function parseWhiteBalanceProfile(value: unknown): WhiteBalanceProfile;
+/** Resolves a profile-owned WB preset without universal label/Kelvin rules. */
+export declare function resolvePresetWhiteBalance(input: ResolvePresetWhiteBalanceInput): ResolvedWhiteBalanceState;
+/** Resolves explicit manual camera-linear channel gains. */
+export declare function resolveManualWhiteBalance(input: ResolveManualWhiteBalanceInput): ResolvedWhiteBalanceState;
+/**
+ * Records independent color-temperature and tint intent.
+ *
+ * No channel gains are fabricated here; mapping CCT+tint into a camera's
+ * channel/color space belongs to a profile/colorimetry contract.
+ */
+export declare function createColorTemperatureWhiteBalanceIntent(input: CreateColorTemperatureWhiteBalanceIntentInput): ColorTemperatureWhiteBalanceIntent;
+/**
+ * Resolves a user-declared neutral/gray custom-WB measurement.
+ *
+ * The engine validates and reduces the selected pre-WB sample, but it does not
+ * claim the selected object is spectrally neutral in the real scene.
+ */
+export declare function resolveCustomWhiteBalance(input: ResolveCustomWhiteBalanceInput): ResolvedWhiteBalanceState;
+/**
+ * Estimates one global AWB state from declared pre-WB camera-linear samples.
+ *
+ * It intentionally does not accept true illuminant metadata. A gray-world
+ * neutralizing estimate is softened by the profile's correctionStrength so
+ * different generic AWB priorities can preserve different amounts of cast.
+ */
+export declare function estimateAutoWhiteBalance(input: EstimateAutoWhiteBalanceInput): ResolvedWhiteBalanceState;
+/**
+ * Freezes a resolved WB state under a new stable identity.
+ *
+ * Locking changes neither the scene nor the gains; later AWB estimates may
+ * differ while this locked state remains unchanged.
+ */
+export declare function createLockedWhiteBalanceState(input: CreateLockedWhiteBalanceStateInput): ResolvedWhiteBalanceState;
+/**
+ * Parses a committed resolved white-balance state from an untrusted JSON
+ * boundary without re-estimating WB.
+ *
+ * This is intentionally a state parser, not an AWB estimator. It preserves the
+ * resolved gains/policy/measurement identity that a capture committed earlier.
+ */
+export declare function parseResolvedWhiteBalanceState(value: unknown): ResolvedWhiteBalanceState;
+//# sourceMappingURL=white-balance.d.ts.map

package/dist/color/white-balance.d.ts.map

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