@camstack/types 1.2.408 → 1.2.410

package/dist/capabilities/display-palette.cap.d.ts

@@ -0,0 +1,90 @@
+/**
+ * display-palette — the cluster's one colour table (D939).
+ *
+ * Hub singleton. `getPalette` reports `unknown` when the settings store
+ * cannot be read; it does not pretend the bundled preset was stored.
+ * `setPalette` refuses a palette that fails the ΔE / contrast rule and names
+ * the pairs.
+ */
+import { z } from 'zod';
+import { type InferProvider } from './capability-definition.js';
+export declare const displayPaletteCapability: {
+    readonly name: 'display-palette';
+    readonly scope: 'system';
+    readonly mode: 'singleton';
+    readonly methods: {
+        readonly getPalette: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodDiscriminatedUnion<[z.ZodObject<{
+            status: z.ZodLiteral<"ready">;
+            presetId: z.ZodEnum<{
+                camstack: "camstack";
+                "high-contrast": "high-contrast";
+                "okabe-ito": "okabe-ito";
+            }>;
+            customized: z.ZodBoolean;
+            source: z.ZodEnum<{
+                stored: "stored";
+                unconfigured: "unconfigured";
+            }>;
+            swatches: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+                form: z.ZodLiteral<"solid">;
+                hex: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                form: z.ZodLiteral<"gradient">;
+                hex: z.ZodString;
+                alphas: z.ZodArray<z.ZodNumber>;
+            }, z.core.$strip>], "form">>;
+            fallbacks: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            status: z.ZodLiteral<"unknown">;
+            reason: z.ZodString;
+        }, z.core.$strip>], "status">, import("./capability-definition.js").CapabilityMethodKind>;
+        readonly listPresets: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            swatches: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+                form: z.ZodLiteral<"solid">;
+                hex: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                form: z.ZodLiteral<"gradient">;
+                hex: z.ZodString;
+                alphas: z.ZodArray<z.ZodNumber>;
+            }, z.core.$strip>], "form">>;
+            fallbacks: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+        readonly setPalette: import("./capability-definition.js").CapabilityMethodSchema<z.ZodUnion<readonly [z.ZodObject<{
+            presetId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            presetId: z.ZodString;
+            overrides: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+                form: z.ZodLiteral<"solid">;
+                hex: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                form: z.ZodLiteral<"gradient">;
+                hex: z.ZodString;
+                alphas: z.ZodArray<z.ZodNumber>;
+            }, z.core.$strip>], "form">>;
+        }, z.core.$strip>]>, z.ZodObject<{
+            status: z.ZodLiteral<"ready">;
+            presetId: z.ZodEnum<{
+                camstack: "camstack";
+                "high-contrast": "high-contrast";
+                "okabe-ito": "okabe-ito";
+            }>;
+            customized: z.ZodBoolean;
+            source: z.ZodEnum<{
+                stored: "stored";
+                unconfigured: "unconfigured";
+            }>;
+            swatches: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+                form: z.ZodLiteral<"solid">;
+                hex: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                form: z.ZodLiteral<"gradient">;
+                hex: z.ZodString;
+                alphas: z.ZodArray<z.ZodNumber>;
+            }, z.core.$strip>], "form">>;
+            fallbacks: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>, "mutation">;
+    };
+};
+export type IDisplayPaletteProvider = InferProvider<typeof displayPaletteCapability>;

package/dist/capabilities/index.d.ts

@@ -174,6 +174,7 @@ export { type CoverState, CoverStateSchema, type CoverStatus, CoverStatusSchema,
 export { type DayNightMode, DayNightModeSchema, type DayNightOptions, DayNightOptionsSchema, type DayNightSettingsPatch, DayNightSettingsPatchSchema, type DayNightStatus, DayNightStatusSchema, dayNightCapability, type IDayNightProvider, } from './day-night.cap.js';
 export { type DeviceDiscoveryStatus, DeviceDiscoveryStatusSchema, type DiscoveredChildDevice, DiscoveredChildDeviceSchema, type DiscoveredChildStatus, DiscoveredChildStatusSchema, deviceDiscoveryCapability, type IDeviceDiscoveryNativeProvider, type IDeviceDiscoveryProvider, } from './device-discovery.cap.js';
 export { deviceOpsCapability, type IDeviceOpsProvider, type RawStateResult, RawStateResultSchema, } from './device-ops.cap.js';
+export { displayPaletteCapability, type IDisplayPaletteProvider, } from './display-palette.cap.js';
 export { type DeviceStatus, DeviceStatusSchema, deviceStatusCapability, type IDeviceStatusProvider, } from './device-status.cap.js';
 export { type DishwasherAccess, DishwasherAccessSchema, type DishwasherAvailability, DishwasherAvailabilitySchema, type DishwasherOperationState, DishwasherOperationStateSchema, type DishwasherOptionDescriptor, DishwasherOptionDescriptorSchema, type DishwasherOptions, DishwasherOptionsSchema, type DishwasherProgram, DishwasherProgramSchema, type DishwasherState, DishwasherStateSchema, type DishwasherStatus, DishwasherStatusSchema, type DishwasherValue, DishwasherValueSchema, dishwasherCapability, type IDishwasherProvider, } from './dishwasher.cap.js';
 export { DOORBELL_RISE_DEBOUNCE_MS, type DoorbellPressEvent, DoorbellPressEventSchema, type DoorbellStatus, DoorbellStatusSchema, doorbellCapability, type IDoorbellProvider, } from './doorbell.cap.js';
@@ -318,6 +319,7 @@ import type { deviceExportCapability } from './device-export.cap.js';
 import type { deviceExtensionCapability } from './device-extension.cap.js';
 import type { deviceManagerCapability } from './device-manager.cap.js';
 import type { deviceOpsCapability } from './device-ops.cap.js';
+import type { displayPaletteCapability } from './display-palette.cap.js';
 import type { deviceProviderCapability } from './device-provider.cap.js';
 import type { deviceStateCapability } from './device-state.cap.js';
 import type { deviceStatusCapability } from './device-status.cap.js';
@@ -435,6 +437,6 @@ import type { trainingProviderCapability } from './training-provider.cap.js';
 import type { zoneAnalyticsCapability } from './zone-analytics.cap.js';
 import type { zoneRulesCapability } from './zone-rules.cap.js';
 import type { zonesCapability } from './zones.cap.js';
-type AnyCapability = typeof streamSignalsCapability | typeof addonSettingsCapability | typeof alertsCapability | typeof storageCapability | typeof storageMigrationCapability | typeof storageProviderCapability | typeof storageEvictableCapability | typeof storageOccupancyCapability | typeof filesystemBrowseCapability | typeof backupCapability | typeof terminalSessionCapability | typeof settingsStoreCapability | typeof dataStoreProviderCapability | typeof databaseSnapshotCapability | typeof storageAdminCapability | typeof recordsCapability | typeof recordEntriesCapability | typeof deviceHistoryCapability | typeof keychainCapability | typeof keychainAdminCapability | typeof deviceCredentialsCapability | typeof nodeCertificatesCapability | typeof logChannelsCapability | typeof logDestinationCapability | typeof loadContributionCapability | typeof failureContributionCapability | typeof deviceRemovalHookCapability | typeof adminUiCapability | typeof viewerUiCapability | typeof ssoBridgeCapability | typeof userPasskeysCapability | typeof smtpProviderCapability | typeof mqttBrokerCapability | typeof brokerCapability | typeof deviceAdoptionCapability | typeof deviceAdminLinkCapability | typeof deviceExportCapability | typeof addonPagesCapability | typeof addonPagesSourceCapability | typeof addonWidgetsCapability | typeof addonWidgetsSourceCapability | typeof customModelRegistryCapability | typeof modelDistributorCapability | typeof modelConvertCapability | typeof addonRoutesCapability | typeof streamBrokerCapability | typeof decoderCapability | typeof webrtcSessionCapability | typeof cameraStreamsCapability | typeof calendarSourceCapability | typeof calendarsCapability | typeof motionDetectionCapability | typeof pipelineExecutorCapability | typeof detectionPipelineCapability | typeof cameraPipelineConfigCapability | typeof pipelineRunnerCapability | typeof pipelineOrchestratorCapability | typeof audioAnalyzerCapability | typeof audioAnalysisCapability | typeof audioCodecCapability | typeof embeddingEncoderCapability | typeof vectorStoreCapability | typeof deviceProviderCapability | typeof deviceManagerCapability | typeof deviceStateCapability | typeof authProviderCapability | typeof loginMethodCapability | typeof networkAccessCapability | typeof turnProviderCapability | typeof snapshotCapability | typeof llmCapability | typeof llmRuntimeCapability | typeof notificationOutputCapability | typeof composerCapability | typeof coreBlocksCapability | typeof notificationRulesCapability | typeof pipelineAnalyticsCapability | typeof metricsProviderCapability | typeof ptzCapability | typeof ptzAutotrackCapability | typeof navigationCapability | typeof consumablesCapability | typeof connectionTestCapability | typeof runningStateCapability | typeof rebootCapability | typeof deviceDiscoveryCapability | typeof brightnessCapability | typeof colorCapability | typeof climateControlCapability | typeof coverCapability | typeof valveCapability | typeof humidifierCapability | typeof waterHeaterCapability | typeof weatherCapability | typeof imageCapability | typeof lockControlCapability | typeof vacuumControlCapability | typeof petFeederCapability | typeof lawnMowerControlCapability | typeof fanControlCapability | typeof controlCapability | typeof notifierCapability | typeof mediaPlayerCapability | typeof alarmPanelCapability | typeof presenceCapability | typeof scriptRunnerCapability | typeof automationControlCapability | typeof motionTriggerCapability | typeof zonesCapability | typeof zoneRulesCapability | typeof trainingCapability | typeof trainingProviderCapability | typeof zoneAnalyticsCapability | typeof audioMetricsCapability | typeof motionCapability | typeof contactCapability | typeof floodCapability | typeof smokeCapability | typeof carbonMonoxideCapability | typeof gasCapability | typeof tamperCapability | typeof vibrationCapability | typeof connectivityCapability | typeof binaryCapability | typeof temperatureSensorCapability | typeof heatingValveCapability | typeof humiditySensorCapability | typeof ambientLightSensorCapability | typeof pressureSensorCapability | typeof powerMeterCapability | typeof airQualitySensorCapability | typeof numericSensorCapability | typeof enumSensorCapability | typeof recordingCapability | typeof recordingArchiveCapability | typeof recordingExportCapability | typeof recordingSignalCapability | typeof deviceOpsCapability | typeof platformProbeCapability | typeof localNetworkCapability | typeof meshNetworkCapability | typeof userManagementCapability | typeof systemCapability | typeof networkQualityCapability | typeof toastCapability | typeof nodesCapability | typeof serverManagementCapability | typeof integrationsCapability | typeof addonsCapability | typeof oauthIntegrationCapability | typeof oidcConnectionsCapability | typeof streamParamsCapability | typeof streamCatalogCapability | typeof motionZonesCapability | typeof cameraGridLayoutCapability | typeof sceneMonitorCapability | typeof privacyMaskCapability | typeof dayNightCapability | typeof recordingOnboardCapability | typeof imageSettingsCapability | typeof osdCapability | typeof osdManagerCapability | typeof accessoriesCapability | typeof batteryCapability | typeof networkLinkCapability | typeof buttonCapability | typeof cameraCredentialsCapability | typeof deviceStatusCapability | typeof doorbellCapability | typeof eventEmitterCapability | typeof faceGalleryCapability | typeof featureProbeCapability | typeof intercomCapability | typeof nativeObjectDetectionCapability | typeof plateGalleryCapability | typeof switchCapability | typeof updateCapability | typeof videoclipsCapability | typeof deviceExtensionCapability | typeof dishwasherCapability;
+type AnyCapability = typeof streamSignalsCapability | typeof addonSettingsCapability | typeof alertsCapability | typeof storageCapability | typeof storageMigrationCapability | typeof storageProviderCapability | typeof storageEvictableCapability | typeof storageOccupancyCapability | typeof filesystemBrowseCapability | typeof backupCapability | typeof terminalSessionCapability | typeof settingsStoreCapability | typeof dataStoreProviderCapability | typeof databaseSnapshotCapability | typeof storageAdminCapability | typeof recordsCapability | typeof recordEntriesCapability | typeof deviceHistoryCapability | typeof keychainCapability | typeof keychainAdminCapability | typeof deviceCredentialsCapability | typeof nodeCertificatesCapability | typeof logChannelsCapability | typeof logDestinationCapability | typeof loadContributionCapability | typeof failureContributionCapability | typeof deviceRemovalHookCapability | typeof adminUiCapability | typeof viewerUiCapability | typeof ssoBridgeCapability | typeof userPasskeysCapability | typeof smtpProviderCapability | typeof mqttBrokerCapability | typeof brokerCapability | typeof deviceAdoptionCapability | typeof deviceAdminLinkCapability | typeof deviceExportCapability | typeof addonPagesCapability | typeof addonPagesSourceCapability | typeof addonWidgetsCapability | typeof addonWidgetsSourceCapability | typeof customModelRegistryCapability | typeof modelDistributorCapability | typeof modelConvertCapability | typeof addonRoutesCapability | typeof streamBrokerCapability | typeof decoderCapability | typeof webrtcSessionCapability | typeof cameraStreamsCapability | typeof calendarSourceCapability | typeof calendarsCapability | typeof motionDetectionCapability | typeof pipelineExecutorCapability | typeof detectionPipelineCapability | typeof cameraPipelineConfigCapability | typeof pipelineRunnerCapability | typeof pipelineOrchestratorCapability | typeof audioAnalyzerCapability | typeof audioAnalysisCapability | typeof audioCodecCapability | typeof embeddingEncoderCapability | typeof vectorStoreCapability | typeof deviceProviderCapability | typeof deviceManagerCapability | typeof deviceStateCapability | typeof authProviderCapability | typeof loginMethodCapability | typeof networkAccessCapability | typeof turnProviderCapability | typeof snapshotCapability | typeof llmCapability | typeof llmRuntimeCapability | typeof notificationOutputCapability | typeof composerCapability | typeof coreBlocksCapability | typeof notificationRulesCapability | typeof pipelineAnalyticsCapability | typeof metricsProviderCapability | typeof ptzCapability | typeof ptzAutotrackCapability | typeof navigationCapability | typeof consumablesCapability | typeof connectionTestCapability | typeof runningStateCapability | typeof rebootCapability | typeof deviceDiscoveryCapability | typeof brightnessCapability | typeof colorCapability | typeof climateControlCapability | typeof coverCapability | typeof valveCapability | typeof humidifierCapability | typeof waterHeaterCapability | typeof weatherCapability | typeof imageCapability | typeof lockControlCapability | typeof vacuumControlCapability | typeof petFeederCapability | typeof lawnMowerControlCapability | typeof fanControlCapability | typeof controlCapability | typeof notifierCapability | typeof mediaPlayerCapability | typeof alarmPanelCapability | typeof presenceCapability | typeof scriptRunnerCapability | typeof automationControlCapability | typeof motionTriggerCapability | typeof zonesCapability | typeof zoneRulesCapability | typeof trainingCapability | typeof trainingProviderCapability | typeof zoneAnalyticsCapability | typeof audioMetricsCapability | typeof motionCapability | typeof contactCapability | typeof floodCapability | typeof smokeCapability | typeof carbonMonoxideCapability | typeof gasCapability | typeof tamperCapability | typeof vibrationCapability | typeof connectivityCapability | typeof binaryCapability | typeof temperatureSensorCapability | typeof heatingValveCapability | typeof humiditySensorCapability | typeof ambientLightSensorCapability | typeof pressureSensorCapability | typeof powerMeterCapability | typeof airQualitySensorCapability | typeof numericSensorCapability | typeof enumSensorCapability | typeof recordingCapability | typeof recordingArchiveCapability | typeof recordingExportCapability | typeof recordingSignalCapability | typeof deviceOpsCapability | typeof displayPaletteCapability | typeof platformProbeCapability | typeof localNetworkCapability | typeof meshNetworkCapability | typeof userManagementCapability | typeof systemCapability | typeof networkQualityCapability | typeof toastCapability | typeof nodesCapability | typeof serverManagementCapability | typeof integrationsCapability | typeof addonsCapability | typeof oauthIntegrationCapability | typeof oidcConnectionsCapability | typeof streamParamsCapability | typeof streamCatalogCapability | typeof motionZonesCapability | typeof cameraGridLayoutCapability | typeof sceneMonitorCapability | typeof privacyMaskCapability | typeof dayNightCapability | typeof recordingOnboardCapability | typeof imageSettingsCapability | typeof osdCapability | typeof osdManagerCapability | typeof accessoriesCapability | typeof batteryCapability | typeof networkLinkCapability | typeof buttonCapability | typeof cameraCredentialsCapability | typeof deviceStatusCapability | typeof doorbellCapability | typeof eventEmitterCapability | typeof faceGalleryCapability | typeof featureProbeCapability | typeof intercomCapability | typeof nativeObjectDetectionCapability | typeof plateGalleryCapability | typeof switchCapability | typeof updateCapability | typeof videoclipsCapability | typeof deviceExtensionCapability | typeof dishwasherCapability;
 export type CapabilityName = AnyCapability['name'];
 export type ITypedReadinessRegistry = IReadinessRegistry<CapabilityName>;

package/dist/catalogs/display-palette-tables.d.ts

@@ -0,0 +1,169 @@
+/** Frozen palette tables (D939). The spec refuses a table that breaks the rule. */
+export declare const CAMSTACK_HEX: {
+    readonly motion: '#d946ef';
+    readonly audio: '#059eb8';
+    readonly recording: '#ef4444';
+    readonly live: '#8d7a00';
+    readonly heatmapScrub: '#4b32ff';
+    readonly person: '#11a64c';
+    readonly vehicle: '#3b82f6';
+    readonly animal: '#ea6a09';
+    readonly package: '#924667';
+    readonly sensor: '#624bbc';
+    readonly control: '#944d24';
+    readonly face: '#ed4f8d';
+    readonly plate: '#4b7027';
+    readonly car: '#9684cf';
+    readonly truck: '#0f9b89';
+    readonly bus: '#a734a9';
+    readonly motorcycle: '#c1133a';
+    readonly bicycle: '#0e6a9b';
+    readonly airplane: '#7c9928';
+    readonly boat: '#b17933';
+    readonly train: '#ad6ca3';
+    readonly bird: '#0f7c55';
+    readonly dog: '#c82700';
+    readonly cat: '#7268f2';
+    readonly horse: '#cb795e';
+    readonly sheep: '#b8636b';
+    readonly cow: '#cb2969';
+    readonly elephant: '#1158d2';
+    readonly bear: '#8d5e00';
+    readonly zebra: '#0097d6';
+    readonly giraffe: '#8f61bb';
+    readonly 'package-delivered': '#cd3f9b';
+    readonly 'package-picked-up': '#388a08';
+    readonly suitcase: '#666800';
+    readonly backpack: '#ec5022';
+    readonly handbag: '#a76ef8';
+    readonly contact: '#ab5a49';
+    readonly 'motion-sensor': '#b95d1a';
+    readonly smoke: '#dd3858';
+    readonly flood: '#b31e7d';
+    readonly gas: '#5b70b5';
+    readonly 'carbon-monoxide': '#7b4e8e';
+    readonly vibration: '#e65bba';
+    readonly tamper: '#98464b';
+    readonly presence: '#3a9468';
+    readonly 'enum-sensor': '#7885f8';
+    readonly 'device-event': '#8c43c8';
+    readonly lock: '#649653';
+    readonly cover: '#c67597';
+    readonly switch: '#7a812a';
+    readonly siren: '#ac5d7f';
+    readonly button: '#b276cd';
+    readonly doorbell: '#0087ab';
+};
+export declare const CAMSTACK_FALLBACK: readonly ['#b34dc7', '#1d7d34', '#db6b6c', '#a43d29', '#0e6ee6', '#29a10b', '#a98731', '#0181c6'];
+export declare const HIGH_CONTRAST_HEX: {
+    readonly motion: '#964360';
+    readonly audio: '#23a132';
+    readonly recording: '#2494ca';
+    readonly live: '#bd7e2b';
+    readonly heatmapScrub: '#ad6eea';
+    readonly person: '#62611e';
+    readonly vehicle: '#f4534c';
+    readonly animal: '#1556cd';
+    readonly package: '#9c4415';
+    readonly sensor: '#066c48';
+    readonly control: '#f2479f';
+    readonly face: '#139d8a';
+    readonly plate: '#909024';
+    readonly car: '#8e35ab';
+    readonly truck: '#bd0b2b';
+    readonly bus: '#7a88ca';
+    readonly motorcycle: '#e26725';
+    readonly bicycle: '#a6679b';
+    readonly airplane: '#7c5720';
+    readonly boat: '#467a1b';
+    readonly train: '#6f65a4';
+    readonly bird: '#cb717f';
+    readonly dog: '#c62490';
+    readonly cat: '#b36850';
+    readonly horse: '#1872ac';
+    readonly sheep: '#927939';
+    readonly cow: '#428a5c';
+    readonly elephant: '#d41160';
+    readonly bear: '#799453';
+    readonly zebra: '#a85455';
+    readonly giraffe: '#746be8';
+    readonly 'package-delivered': '#824a80';
+    readonly 'package-picked-up': '#614ac1';
+    readonly suitcase: '#2f77f3';
+    readonly backpack: '#fa476d';
+    readonly handbag: '#c14cbe';
+    readonly contact: '#c83921';
+    readonly 'motion-sensor': '#a07ebd';
+    readonly smoke: '#a25b13';
+    readonly flood: '#526bab';
+    readonly gas: '#924938';
+    readonly 'carbon-monoxide': '#bb7e53';
+    readonly vibration: '#b66182';
+    readonly tamper: '#3c6931';
+    readonly presence: '#6c851d';
+    readonly 'enum-sensor': '#ad2d48';
+    readonly 'device-event': '#5e9b04';
+    readonly lock: '#00a062';
+    readonly cover: '#ad8624';
+    readonly switch: '#d05259';
+    readonly siren: '#cd67b3';
+    readonly button: '#c9746a';
+    readonly doorbell: '#338eeb';
+};
+export declare const HIGH_CONTRAST_FALLBACK: readonly ['#817f3b', '#a0733e', '#8658b2', '#956301', '#bc652d', '#647331', '#a14c9e', '#d14e71'];
+export declare const OKABE_ITO_HEX: {
+    readonly motion: '#b88128';
+    readonly audio: '#1096c8';
+    readonly recording: '#009e73';
+    readonly live: '#9c8c22';
+    readonly heatmapScrub: '#0072b2';
+    readonly person: '#d55e00';
+    readonly vehicle: '#c0739f';
+    readonly animal: '#226d18';
+    readonly package: '#91446c';
+    readonly sensor: '#217b56';
+    readonly control: '#648647';
+    readonly face: '#c22998';
+    readonly plate: '#fa4575';
+    readonly car: '#956301';
+    readonly truck: '#2f77f3';
+    readonly bus: '#7a4e86';
+    readonly motorcycle: '#f54597';
+    readonly bicycle: '#bb3e75';
+    readonly airplane: '#e054c0';
+    readonly boat: '#457942';
+    readonly train: '#867afa';
+    readonly bird: '#88914c';
+    readonly dog: '#1556cd';
+    readonly cat: '#71702c';
+    readonly horse: '#9b4fa4';
+    readonly sheep: '#c0559d';
+    readonly cow: '#d14f65';
+    readonly elephant: '#98470f';
+    readonly bear: '#595896';
+    readonly zebra: '#96790e';
+    readonly giraffe: '#cb717b';
+    readonly 'package-delivered': '#139d8a';
+    readonly 'package-picked-up': '#906ead';
+    readonly suitcase: '#d02939';
+    readonly backpack: '#d41160';
+    readonly handbag: '#f64f54';
+    readonly contact: '#7258d2';
+    readonly 'motion-sensor': '#b66182';
+    readonly smoke: '#627abb';
+    readonly flood: '#b86ae4';
+    readonly gas: '#a95261';
+    readonly 'carbon-monoxide': '#c65d3c';
+    readonly vibration: '#7a40b7';
+    readonly tamper: '#914b34';
+    readonly presence: '#9481c3';
+    readonly 'enum-sensor': '#ac6d47';
+    readonly 'device-event': '#7b6fce';
+    readonly lock: '#c67662';
+    readonly cover: '#a6564d';
+    readonly switch: '#ad2c4e';
+    readonly siren: '#348e08';
+    readonly button: '#d27303';
+    readonly doorbell: '#55770f';
+};
+export declare const OKABE_ITO_FALLBACK: readonly ['#9a3784', '#a7392c', '#409d50', '#6987e7', '#ee5b3d', '#c0430d', '#af79b3', '#4b6628'];

package/dist/catalogs/display-palette.d.ts

@@ -0,0 +1,171 @@
+/**
+ * The display palette (D939). One table of colours, three presets, one
+ * validator. Taxonomy colours and every consumer read this — there is no
+ * second hex table.
+ */
+import { z } from 'zod';
+import { AUDIO_GRADIENT_ALPHAS, PALETTE_ENTRY_IDS, PALETTE_PRESET_IDS, type PalettePresetId } from './palette-entries.js';
+import { PALETTE_BACKGROUNDS, PALETTE_MIN_CONTRAST, PALETTE_MIN_DELTA_E, PALETTE_MIN_DELTA_E_MARK, type PaletteBackground } from './palette-cie.js';
+export { AUDIO_GRADIENT_ALPHAS, PALETTE_BACKGROUNDS, PALETTE_ENTRY_IDS, PALETTE_MIN_CONTRAST, PALETTE_MIN_DELTA_E, PALETTE_MIN_DELTA_E_MARK, PALETTE_PRESET_IDS, };
+export type { PaletteBackground } from './palette-cie.js';
+export type { PaletteEntryId, PalettePresetId } from './palette-entries.js';
+export declare const paletteHexSchema: z.ZodString;
+export declare const paletteSolidSchema: z.ZodObject<{
+    form: z.ZodLiteral<"solid">;
+    hex: z.ZodString;
+}, z.core.$strip>;
+export declare const paletteGradientSchema: z.ZodObject<{
+    form: z.ZodLiteral<"gradient">;
+    hex: z.ZodString;
+    alphas: z.ZodArray<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const paletteSwatchSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    form: z.ZodLiteral<"solid">;
+    hex: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    form: z.ZodLiteral<"gradient">;
+    hex: z.ZodString;
+    alphas: z.ZodArray<z.ZodNumber>;
+}, z.core.$strip>], "form">;
+export type PaletteSwatch = z.infer<typeof paletteSwatchSchema>;
+export type PaletteSwatchMap = Readonly<Record<string, PaletteSwatch>>;
+export type PaletteViolation = {
+    readonly code: 'too-close';
+    readonly left: string;
+    readonly right: string;
+    readonly deltaE: number;
+} | {
+    readonly code: 'low-contrast';
+    readonly entry: string;
+    readonly background: PaletteBackground;
+    readonly contrast: number;
+} | {
+    readonly code: 'missing-entry';
+    readonly entry: string;
+} | {
+    readonly code: 'unknown-entry';
+    readonly entry: string;
+} | {
+    readonly code: 'bad-gradient';
+    readonly entry: string;
+} | {
+    readonly code: 'bad-fallbacks';
+} | {
+    readonly code: 'unknown-preset';
+    readonly presetId: string;
+};
+export type PaletteVerdict = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly violations: readonly PaletteViolation[];
+};
+export declare const paletteReadySchema: z.ZodObject<{
+    status: z.ZodLiteral<"ready">;
+    presetId: z.ZodEnum<{
+        camstack: "camstack";
+        "high-contrast": "high-contrast";
+        "okabe-ito": "okabe-ito";
+    }>;
+    customized: z.ZodBoolean;
+    source: z.ZodEnum<{
+        stored: "stored";
+        unconfigured: "unconfigured";
+    }>;
+    swatches: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        form: z.ZodLiteral<"solid">;
+        hex: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        form: z.ZodLiteral<"gradient">;
+        hex: z.ZodString;
+        alphas: z.ZodArray<z.ZodNumber>;
+    }, z.core.$strip>], "form">>;
+    fallbacks: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const paletteUnknownSchema: z.ZodObject<{
+    status: z.ZodLiteral<"unknown">;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export declare const paletteResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"ready">;
+    presetId: z.ZodEnum<{
+        camstack: "camstack";
+        "high-contrast": "high-contrast";
+        "okabe-ito": "okabe-ito";
+    }>;
+    customized: z.ZodBoolean;
+    source: z.ZodEnum<{
+        stored: "stored";
+        unconfigured: "unconfigured";
+    }>;
+    swatches: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        form: z.ZodLiteral<"solid">;
+        hex: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        form: z.ZodLiteral<"gradient">;
+        hex: z.ZodString;
+        alphas: z.ZodArray<z.ZodNumber>;
+    }, z.core.$strip>], "form">>;
+    fallbacks: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"unknown">;
+    reason: z.ZodString;
+}, z.core.$strip>], "status">;
+export type PaletteResult = z.infer<typeof paletteResultSchema>;
+export type PaletteReady = z.infer<typeof paletteReadySchema>;
+export declare const setPaletteInputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    presetId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    presetId: z.ZodString;
+    overrides: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        form: z.ZodLiteral<"solid">;
+        hex: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        form: z.ZodLiteral<"gradient">;
+        hex: z.ZodString;
+        alphas: z.ZodArray<z.ZodNumber>;
+    }, z.core.$strip>], "form">>;
+}, z.core.$strip>]>;
+export type SetPaletteInput = z.infer<typeof setPaletteInputSchema>;
+export declare const storedPaletteSchema: z.ZodObject<{
+    presetId: z.ZodString;
+    overrides: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        form: z.ZodLiteral<"solid">;
+        hex: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        form: z.ZodLiteral<"gradient">;
+        hex: z.ZodString;
+        alphas: z.ZodArray<z.ZodNumber>;
+    }, z.core.$strip>], "form">>;
+}, z.core.$strip>;
+export type StoredPalette = z.infer<typeof storedPaletteSchema>;
+export interface DisplayPreset {
+    readonly id: PalettePresetId;
+    readonly name: string;
+    readonly swatches: PaletteSwatchMap;
+    readonly fallbacks: readonly string[];
+}
+export declare const DISPLAY_PRESETS: readonly DisplayPreset[];
+export declare function presetById(id: string): DisplayPreset | undefined;
+export declare function bundledCamstack(): PaletteReady;
+export declare function swatchHex(swatch: PaletteSwatch): string;
+/** Refuse a palette whose entries are not pairwise distinct on both themes. */
+export declare function validatePalette(swatches: PaletteSwatchMap, fallbacks: readonly string[]): PaletteVerdict;
+export declare function formatPaletteViolation(violation: PaletteViolation): string;
+export declare function formatPaletteViolations(violations: readonly PaletteViolation[]): string;
+export declare class PaletteRejectedError extends Error {
+    readonly violations: readonly PaletteViolation[];
+    constructor(violations: readonly PaletteViolation[]);
+}
+/** Colour a kind paints with. Audio leaves share the audio gradient's hex. */
+export declare function paintHex(swatches: PaletteSwatchMap, fallbacks: readonly string[], kind: string): string;
+export declare function mergeOverrides(base: PaletteSwatchMap, overrides: Readonly<Record<string, PaletteSwatch>>): PaletteSwatchMap;
+/** The palette a `setPalette` input would store. Invalid input is a refusal. */
+export declare function paletteFromInput(input: SetPaletteInput): PaletteReady;
+/**
+ * Interpret a settings blob. A missing row is the bundled preset and says so.
+ * A blob that does not parse, names an unknown preset, or fails the rule is
+ * `unknown` — never the default wearing the stored preset's name.
+ */
+export declare function paletteFromStored(value: unknown): PaletteResult;
+export declare function storedFromReady(ready: PaletteReady, overrides: Readonly<Record<string, PaletteSwatch>>): StoredPalette;

package/dist/catalogs/event-taxonomy.d.ts

@@ -21,24 +21,13 @@ export interface EventTaxonomyEntry {
     /** English fallback label (UI translates `labelKey` when it can). */
     readonly label: string;
 }
-export declare const TAXONOMY_COLORS: {
-    readonly motion: '#f59e0b';
-    readonly audio: '#06b6d4';
-    readonly person: '#22c55e';
-    readonly vehicle: '#3b82f6';
-    readonly animal: '#f97316';
-    readonly package: '#a855f7';
-    readonly sensor: '#8b5cf6';
-    readonly control: '#10b981';
-    readonly genericDetection: '#64748b';
-};
-/** Global default color when a kind is unknown (matches legacy box-drawer). */
-export declare const DEFAULT_EVENT_COLOR = "#22ff55";
+/** Global default when a kind is unknown — the palette's first fallback. */
+export declare const DEFAULT_EVENT_COLOR: string;
 /** The complete taxonomy dictionary, keyed by kind. */
 export declare const EVENT_TAXONOMY: Readonly<Record<string, EventTaxonomyEntry>>;
 /** Taxonomy entry for a kind, or undefined when unknown. */
 export declare function getTaxonomyEntry(kind: string): EventTaxonomyEntry | undefined;
-/** Color for a kind — dictionary value, else the global default. */
+/** Color for a kind — the bundled palette, else a stable fallback. */
 export declare function colorForKind(kind: string): string;
 /** The sub kinds whose `parentKind` is `macro` (empty for a leaf macro). */
 export declare function subKindsOf(macro: string): readonly EventTaxonomyEntry[];

package/dist/catalogs/palette-cie.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CIEDE2000 and WCAG contrast for the display palette (D939).
+ *
+ * One implementation, shared by the hub validator, the admin editor and
+ * (phase 2) the viewer. The arithmetic matches the viewer's `src/theme/cie.ts`.
+ */
+/** Page backgrounds the contrast rule is measured against. */
+export declare const PALETTE_BACKGROUNDS: {
+    readonly dark: '#0c0a09';
+    readonly light: '#fafaf9';
+};
+export type PaletteBackground = keyof typeof PALETTE_BACKGROUNDS;
+/** Two entries closer than this read as one mark. */
+export declare const PALETTE_MIN_DELTA_E = 7;
+/**
+ * The live cursor and the heatmap handle sit next to each other as small
+ * swatches. ΔE 7 still lets two olives read as one (the old CamStack pair
+ * was 12.8 on the same hue). The global floor stays 7 — the presets' closest
+ * pairs are 7.30, 7.49 and 7.01 — and these two marks must clear 20.
+ */
+export declare const PALETTE_MIN_DELTA_E_MARK = 20;
+/** Marks that are not event kinds and share the raised distance floor. */
+export declare const PALETTE_MARK_PAIR: readonly ['live', 'heatmapScrub'];
+/** Minimum WCAG contrast of an entry against either theme background. */
+export declare const PALETTE_MIN_CONTRAST = 3;
+/** WCAG contrast ratio of two `#rrggbb` colours. Non-hex returns 0. */
+export declare function contrastRatio(a: string, b: string): number;
+/** CIEDE2000. Non-hex returns 0 so a bad swatch fails the distinctness rule. */
+export declare function deltaE00(hex1: string, hex2: string): number;

package/dist/catalogs/palette-entries.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Palette entry ids (D939). Audio is the one gradient; `audio-*` leaves are
+ * not entries. `heatmapScrub` is a mark, not an event kind.
+ */
+export declare const PALETTE_ENTRY_IDS: readonly ['motion', 'audio', 'recording', 'live', 'heatmapScrub', 'person', 'vehicle', 'animal', 'package', 'sensor', 'control', 'face', 'plate', 'car', 'truck', 'bus', 'motorcycle', 'bicycle', 'airplane', 'boat', 'train', 'bird', 'dog', 'cat', 'horse', 'sheep', 'cow', 'elephant', 'bear', 'zebra', 'giraffe', 'package-delivered', 'package-picked-up', 'suitcase', 'backpack', 'handbag', 'contact', 'motion-sensor', 'smoke', 'flood', 'gas', 'carbon-monoxide', 'vibration', 'tamper', 'presence', 'enum-sensor', 'device-event', 'lock', 'cover', 'switch', 'siren', 'button', 'doorbell'];
+export type PaletteEntryId = (typeof PALETTE_ENTRY_IDS)[number];
+export declare const AUDIO_ENTRY_ID = "audio";
+export declare const AUDIO_LEAF_PREFIX = "audio-";
+/** Six rungs, quiet → loud. The opaque end is the entry's hex. */
+export declare const AUDIO_GRADIENT_ALPHAS: readonly [0.3, 0.42, 0.55, 0.7, 0.85, 1];
+export declare const PALETTE_FALLBACK_COUNT = 8;
+export declare const PALETTE_PRESET_IDS: readonly ['camstack', 'high-contrast', 'okabe-ito'];
+export type PalettePresetId = (typeof PALETTE_PRESET_IDS)[number];
+export declare function isPaletteEntryId(id: string): id is PaletteEntryId;
+export declare function isPalettePresetId(id: string): id is PalettePresetId;

package/dist/catalogs/palette-legend.d.ts

@@ -0,0 +1,13 @@
+import { type PaletteEntryId } from './palette-entries.js';
+export interface PaletteLegendItem {
+    readonly id: PaletteEntryId;
+    readonly label: string;
+}
+export interface PaletteLegendGroup {
+    readonly id: PaletteEntryId;
+    readonly label: string;
+    readonly children: readonly PaletteLegendItem[];
+}
+export declare function paletteEntryLabel(id: string): string;
+/** One row per root, subclasses underneath. Every palette entry appears once. */
+export declare function paletteLegend(): readonly PaletteLegendGroup[];