@imperosoft/cris-webui-components 1.1.4-beta.0 → 1.2.0

package/dist/index.d.mts

@@ -64,10 +64,22 @@ interface CrisButtonProps {
     onPress?: () => void;
     /** Custom release handler */
     onRelease?: () => void;
+    /** Clean short press→release before holdMs (not a scroll/cancel, and not after a long-press). Mirrors PushButton ShortPushAction. */
+    onTap?: () => void;
+    /** Fires once when held past holdMs. Mirrors PushButton LargePushAction. */
+    onLongPress?: () => void;
+    /** Long-press threshold in ms (default 2000, matching PushButton LargePushTimeMs). */
+    holdMs?: number;
+    /** Fires repeatedly every repeatMs while held (ramp buttons). */
+    onHoldRepeat?: () => void;
+    /** Repeat interval in ms (default 150); first tick after one interval. */
+    repeatMs?: number;
+    /** Hold progress 0..1 toward holdMs while held; emits 0 on release/cancel. */
+    onHoldProgress?: (progress: number) => void;
     /** Enable debug logging for this button */
     debug?: boolean;
 }
-declare function CrisButton({ join, joinFeedback, joinEnable, joinVisible, text, textPressed, textSelected, icon, iconName, iconClass, iconSize, iconContainerSize, iconStyle, iconPosition, iconNameActive, iconClassActive, iconStyleActive, selected, showControlFeedback, showLocalFeedback, suppressKeyClicks, visible, enabled, smartId, className, classActive, classPressed, classDisabled, children, onPress, onRelease, debug, }: CrisButtonProps): react_jsx_runtime.JSX.Element | null;
+declare function CrisButton({ join, joinFeedback, joinEnable, joinVisible, text, textPressed, textSelected, icon, iconName, iconClass, iconSize, iconContainerSize, iconStyle, iconPosition, iconNameActive, iconClassActive, iconStyleActive, selected, showControlFeedback, showLocalFeedback, suppressKeyClicks, visible, enabled, smartId, className, classActive, classPressed, classDisabled, children, onPress, onRelease, onTap, onLongPress, holdMs, onHoldRepeat, repeatMs, onHoldProgress, debug, }: CrisButtonProps): react_jsx_runtime.JSX.Element | null;
 
 interface CrisTextProps {
     /** Serial join for indirect text */
@@ -118,6 +130,15 @@ interface CrisSliderProps {
     thumbSizePercent?: number;
     /** Delay in ms after drag before updating from feedback (default 1000) */
     delayMsAfterDragUpdateFeedback?: number;
+    /** Controlled value (minValue..maxValue). When set, drives the slider without an analog join. */
+    value?: number;
+    /** Fired during drag with the new value, throttled to changeThrottleMs (trailing). */
+    onChange?: (value: number) => void;
+    /** Fired on drag end with the final value. */
+    onCommit?: (value: number) => void;
+    /** Min ms between onChange calls during a drag (default 100). 0 = every move. The
+     *  thumb still moves smoothly locally; this only rate-limits the outbound onChange. */
+    changeThrottleMs?: number;
     /** Container CSS class */
     className?: string;
     /** Container inline style */
@@ -137,7 +158,7 @@ interface CrisSliderProps {
     /** Class when disabled */
     classDisabled?: string;
 }
-declare function CrisSlider({ join, joinDigital, joinAnalog, joinEnable, joinVisible, minValue, maxValue, horizontal, fillHidden, trackSizePercent, thumbSizePercent, delayMsAfterDragUpdateFeedback, className, style, barClassName, barStyle, fillClassName, fillStyle, thumbClassName, thumbStyle, classDisabled, }: CrisSliderProps): react_jsx_runtime.JSX.Element | null;
+declare function CrisSlider({ join, joinDigital, joinAnalog, joinEnable, joinVisible, minValue, maxValue, horizontal, fillHidden, trackSizePercent, thumbSizePercent, delayMsAfterDragUpdateFeedback, value, onChange, onCommit, changeThrottleMs, className, style, barClassName, barStyle, fillClassName, fillStyle, thumbClassName, thumbStyle, classDisabled, }: CrisSliderProps): react_jsx_runtime.JSX.Element | null;
 
 interface CrisGaugeProps {
     /** Static value (used if no join) */
@@ -481,6 +502,278 @@ interface CrisCoMatrixListsTieProps {
 }
 declare function CrisCoMatrixListsTie({ oid, inputTitle, outputTitle, showChannels, className, style, listClassName, listStyle, headerClassName, headerStyle, itemClassName, itemStyle, itemActiveClassName, itemActiveStyle, itemDisabledClassName, vmText, vmButtonClassName, vmButtonActiveClassName, renderIoIndicator, renderSignalIndicator, }: CrisCoMatrixListsTieProps): react_jsx_runtime.JSX.Element | null;
 
+type CommKind = 'none' | 'native' | 'serial' | 'ir' | 'relay' | 'tcp' | 'udp' | 'ssh' | 'http' | 'ws' | 'tcp_server' | 'ws_server' | 'custom';
+/** Communication state of a device (the `cm` object of a status). */
+interface DeviceComm {
+    /** Communication type (kind). */
+    kd?: CommKind;
+    /** Serial over ethernet. */
+    so?: boolean;
+    /** Connected (ethernet indicator state). */
+    co?: boolean;
+    /** Alive / responds (serial indicator state). */
+    al?: boolean;
+}
+/** A single indicator: whether it shows and whether it is on. */
+interface CommIndicatorState {
+    visible: boolean;
+    on: boolean;
+}
+/** Applies the backend rule and returns the state of both indicators. */
+declare function commIndicators(c?: DeviceComm): {
+    eth: CommIndicatorState;
+    serial: CommIndicatorState;
+};
+interface CrisViewCommClasses {
+    /** Outer flex row. */
+    root?: string;
+    /** Each circular dot. */
+    dot?: string;
+    /** Added to a dot when on. */
+    dotOn?: string;
+    /** Added to a dot when off. */
+    dotOff?: string;
+    /** The icon <img> inside a dot. */
+    icon?: string;
+}
+interface CrisViewCommIcons {
+    /** Ethernet indicator icon — name (getIconUrl) or ReactNode. Default 'ind-ethernet'. */
+    ethernet?: string | ReactNode;
+    /** Serial indicator icon — name (getIconUrl) or ReactNode. Default 'rs232'. */
+    serial?: string | ReactNode;
+}
+interface CrisViewCommProps {
+    comm?: DeviceComm;
+    classes?: CrisViewCommClasses;
+    icons?: CrisViewCommIcons;
+    /** Convenience: appended to the root slot (e.g. positioning). */
+    className?: string;
+}
+declare function CrisViewComm({ comm, classes, icons, className }: CrisViewCommProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * Slot-map for styling CrisViewDspFull and its sub-parts, plus icon config. A
+ * consumer overrides only the slots it cares about; every other slot keeps the
+ * default (which reproduces the original POC look). Final class per slot =
+ * `classes?.slot ?? DEFAULT.slot`.
+ */
+
+interface CrisViewDspClasses {
+    /** Root column. */
+    root?: string;
+    /** Tab bar (relative; presets/comm are positioned within). */
+    header?: string;
+    /** Content area below the tabs. */
+    content?: string;
+    /** Tab button base. */
+    tab?: string;
+    /** Added to the selected tab. */
+    tabActive?: string;
+    /** Connecting / empty-state message. */
+    message?: string;
+    /** Presets wrapper (positioned at the left of the header). */
+    presetWrap?: string;
+    /** "Preset" caption above the buttons. */
+    presetLabel?: string;
+    /** Preset button base. */
+    preset?: string;
+    /** Added to the active preset button. */
+    presetActive?: string;
+    /** Added to a preset button while pressed. */
+    presetPressed?: string;
+    /** "Saved" flash overlay. */
+    savedFlash?: string;
+    /** Strip column. */
+    strip?: string;
+    /** Strip label. */
+    stripLabel?: string;
+    /** Level percentage readout above the fader. */
+    levelReadout?: string;
+    /** Fader bar/track. */
+    faderBar?: string;
+    /** Fader fill. */
+    faderFill?: string;
+    /** Fader thumb. */
+    faderThumb?: string;
+    /** Mute button base. */
+    mute?: string;
+    /** Added to the mute button when muted. */
+    muteActive?: string;
+    /** Mixer fixed corner. */
+    mixerCorner?: string;
+    /** Mixer sticky header/label chrome. */
+    mixerChrome?: string;
+    /** Crosspoint cell base. */
+    cell?: string;
+    /** Crosspoint cell when on. */
+    cellOn?: string;
+    /** Crosspoint cell when off. */
+    cellOff?: string;
+}
+interface CrisViewDspIcons {
+    /** Mixer crosspoint ON icon — name (getIconUrl) or ReactNode. Default 'audio-volume-ok'. */
+    crosspointOn?: string | ReactNode;
+    /** Mute button icon when unmuted. Default 'audio-volume-high'. */
+    muteOff?: string;
+    /** Mute button icon when muted. Default 'audio-volume-mute'. */
+    muteOn?: string;
+    /** CSS filter for the unmuted icon. Default a light-green filter. */
+    muteOffFilter?: string;
+    /** CSS filter for the muted icon. Default white. */
+    muteOnFilter?: string;
+}
+
+interface CrisViewDspPreset {
+    id: number;
+    name: string;
+    /** Which feedback field highlights this button. Default 'device'. */
+    kind?: 'device' | 'local';
+    /**
+     * Whether a long press saves this preset. `true` (default) → short tap recalls,
+     * long press saves. `false` → recall only (the long-press save gesture is not
+     * wired, so it cannot overwrite the preset).
+     */
+    saveAllowed?: boolean;
+}
+
+type DspTab = 'in' | 'mix' | 'out';
+interface CrisViewDspFullProps {
+    /** OID of the DSP custom object; the view subscribes internally. */
+    oid: string;
+    /** Presets shown in the header. Omit → no presets row. */
+    presets?: CrisViewDspPreset[];
+    /** Input channel ids to hide (faders). */
+    skipShowInput?: number[];
+    /** Output channel ids to hide (faders). */
+    skipShowOutput?: number[];
+    /** Hide the whole Mixer tab. */
+    skipCrosspoints?: boolean;
+    /** Whether the active preset stays highlighted after release (default true). */
+    sustainedPresetFeedback?: boolean;
+    classes?: CrisViewDspClasses;
+    icons?: CrisViewDspIcons;
+    /** Convenience: appended to the root slot. */
+    className?: string;
+    /** Initial tab (default 'in'). */
+    initialTab?: DspTab;
+}
+declare function CrisViewDspFull({ oid, presets, skipShowInput, skipShowOutput, skipCrosspoints, sustainedPresetFeedback, classes, icons, className, initialTab, }: CrisViewDspFullProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * DSP custom-object protocol types (the shape exposed by a DSP backend's custom
+ * object, e.g. `DSP1_API` / Dsp.CrisApi.cs). The dynamic DSP view is fed entirely
+ * from a status of this shape — point a view at the object's OID and it renders
+ * whatever the DSP exposes.
+ */
+
+/** Input or output channel. lv = analog level 0..65535, mt = mute. */
+interface DspIo {
+    id: number;
+    lb?: string;
+    lv: number;
+    mt: boolean;
+}
+interface DspOut extends DspIo {
+    /** Crosspoints: input id → routed. In a full status only the TRUE ones arrive. */
+    xp?: Record<number, boolean>;
+    /** Crossgains: input id → gain 0..65535. Out of scope for v1. */
+    xg?: Record<number, number>;
+}
+/**
+ * Linked group. Confirmed against the backend (Dsp.cs `LinkedIo`): serialized as
+ * `lb` (label, omitted when null) and `ch` (member channels).
+ */
+interface DspLinkedGroup {
+    /** Group label. Absent when the backend has it null. */
+    lb?: string;
+    /** Member channel ids. */
+    ch: number[];
+}
+interface DspLinks {
+    ip?: DspLinkedGroup[];
+    op?: DspLinkedGroup[];
+}
+/** Active DSP preset. dv = recovered device preset, lc = local preset. */
+interface DspPreset {
+    dv?: number;
+    lc?: number;
+}
+/** Shape of a DSP custom-object status. */
+interface DspStatus {
+    /** Device communication state (eth/serial indicators). */
+    cm?: DeviceComm;
+    ip: DspIo[];
+    op: DspOut[];
+    ln?: DspLinks;
+    pr?: DspPreset;
+    ps?: DspPreset;
+}
+
+/**
+ * Pure DSP data-model helpers. No React, no effects: they only transform a DSP
+ * custom-object `status` into structures ready to render.
+ */
+
+/** io as the backend expects it in level.set / mute.set. */
+type DspIoDir = 'in' | 'out';
+/** Analog level (0..65535) → percentage 0..100 for display. */
+declare function levelToPercent(lv: number): number;
+/** Ensures a level falls in the valid analog range. */
+declare function clampLevel(lv: number | undefined): number;
+/**
+ * Normalizes a linked group to the UI model. Keys confirmed against the backend
+ * (Dsp.cs `LinkedIo`): `lb` (label) and `ch` (channels). Degrades to empty label
+ * / no channels when missing.
+ */
+declare function normalizeLinked(raw: DspLinkedGroup): {
+    label: string;
+    channels: number[];
+};
+/** A "strip" of the Inputs/Outputs page: a loose channel or a linked group. */
+type DspStrip = {
+    kind: 'single';
+    key: string;
+    label: string;
+    channels: number[];
+    lv: number;
+    mt: boolean;
+} | {
+    kind: 'group';
+    key: string;
+    label: string;
+    channels: number[];
+    lv: number;
+    mt: boolean;
+};
+/**
+ * Collapses the channel list (`ip` or `op`) applying the linked groups:
+ * - each group shows as ONE strip; its member channels are hidden as loose ones.
+ * - the group state (lv/mt/label) is read from its primary member (first channel
+ *   present in the status); if none exists, {lv:0, mt:false} is used.
+ * - channels that belong to no group show as loose ones, in order.
+ */
+declare function collapseStrips(channels: DspIo[], links: DspLinkedGroup[] | undefined): DspStrip[];
+/** Extracts the linked groups from the status for a given direction. */
+declare function linksFor(ln: DspLinks | undefined, io: DspIoDir): DspLinkedGroup[] | undefined;
+/**
+ * Mixer axis (one entry per channel, in order). For linked groups whose channels
+ * are CONSECUTIVE (and therefore adjacent in the grid) it adds the info to paint a
+ * two-level label: common group name (spanning) + per-member channel name (e.g.
+ * L/R). Loose channels or non-consecutive groups remain a single label.
+ */
+interface MixerAxisItem {
+    id: number;
+    /** Own channel name (for groups usually "L"/"R"; for loose ones, the full name). */
+    channelLabel: string;
+    /** Common group name, present only if the channel belongs to a consecutive group. */
+    groupCommon?: string;
+    /** true on the first member of the group (paints the spanning common). */
+    groupStart?: boolean;
+    /** Number of group members (span), only on groupStart. */
+    groupSpan?: number;
+}
+declare function buildMixerAxis(channels: DspIo[], links: DspLinkedGroup[] | undefined): MixerAxisItem[];
+
 /**
  * Icon configuration and utilities for CRIS components
  *
@@ -531,4 +824,4 @@ declare function getIconUrl(name: string): string;
  */
 declare function getIconFilter(active: boolean): string | undefined;
 
-export { CrisButton, type CrisButtonProps, CrisCoDebug, type CrisCoDebugProps, CrisCoList, type CrisCoListProps, CrisCoMatrixListsTie, type CrisCoMatrixListsTieProps, CrisGauge, type CrisGaugeProps, CrisOfflinePage, type CrisOfflinePageProps, CrisSlider, type CrisSliderProps, CrisSpinner, type CrisSpinnerProps, CrisText, CrisTextInput, type CrisTextInputProps, type CrisTextProps, type DebugModule, type IconConfig, type ListItem, type ListStatus, type MatrixItem, type MatrixStatus, type SpinnerSpeed, configureIcons, getIconConfig, getIconFilter, getIconUrl };
+export { type CommIndicatorState, type CommKind, CrisButton, type CrisButtonProps, CrisCoDebug, type CrisCoDebugProps, CrisCoList, type CrisCoListProps, CrisCoMatrixListsTie, type CrisCoMatrixListsTieProps, CrisGauge, type CrisGaugeProps, CrisOfflinePage, type CrisOfflinePageProps, CrisSlider, type CrisSliderProps, CrisSpinner, type CrisSpinnerProps, CrisText, CrisTextInput, type CrisTextInputProps, type CrisTextProps, CrisViewComm, type CrisViewCommClasses, type CrisViewCommIcons, type CrisViewCommProps, type CrisViewDspClasses, CrisViewDspFull, type CrisViewDspFullProps, type CrisViewDspIcons, type CrisViewDspPreset, type DebugModule, type DeviceComm, type DspIo, type DspIoDir, type DspLinkedGroup, type DspLinks, type DspOut, type DspPreset, type DspStatus, type DspStrip, type IconConfig, type ListItem, type ListStatus, type MatrixItem, type MatrixStatus, type MixerAxisItem, type SpinnerSpeed, buildMixerAxis, clampLevel, collapseStrips, commIndicators, configureIcons, getIconConfig, getIconFilter, getIconUrl, levelToPercent, linksFor, normalizeLinked };

package/dist/index.d.ts

@@ -64,10 +64,22 @@ interface CrisButtonProps {
     onPress?: () => void;
     /** Custom release handler */
     onRelease?: () => void;
+    /** Clean short press→release before holdMs (not a scroll/cancel, and not after a long-press). Mirrors PushButton ShortPushAction. */
+    onTap?: () => void;
+    /** Fires once when held past holdMs. Mirrors PushButton LargePushAction. */
+    onLongPress?: () => void;
+    /** Long-press threshold in ms (default 2000, matching PushButton LargePushTimeMs). */
+    holdMs?: number;
+    /** Fires repeatedly every repeatMs while held (ramp buttons). */
+    onHoldRepeat?: () => void;
+    /** Repeat interval in ms (default 150); first tick after one interval. */
+    repeatMs?: number;
+    /** Hold progress 0..1 toward holdMs while held; emits 0 on release/cancel. */
+    onHoldProgress?: (progress: number) => void;
     /** Enable debug logging for this button */
     debug?: boolean;
 }
-declare function CrisButton({ join, joinFeedback, joinEnable, joinVisible, text, textPressed, textSelected, icon, iconName, iconClass, iconSize, iconContainerSize, iconStyle, iconPosition, iconNameActive, iconClassActive, iconStyleActive, selected, showControlFeedback, showLocalFeedback, suppressKeyClicks, visible, enabled, smartId, className, classActive, classPressed, classDisabled, children, onPress, onRelease, debug, }: CrisButtonProps): react_jsx_runtime.JSX.Element | null;
+declare function CrisButton({ join, joinFeedback, joinEnable, joinVisible, text, textPressed, textSelected, icon, iconName, iconClass, iconSize, iconContainerSize, iconStyle, iconPosition, iconNameActive, iconClassActive, iconStyleActive, selected, showControlFeedback, showLocalFeedback, suppressKeyClicks, visible, enabled, smartId, className, classActive, classPressed, classDisabled, children, onPress, onRelease, onTap, onLongPress, holdMs, onHoldRepeat, repeatMs, onHoldProgress, debug, }: CrisButtonProps): react_jsx_runtime.JSX.Element | null;
 
 interface CrisTextProps {
     /** Serial join for indirect text */
@@ -118,6 +130,15 @@ interface CrisSliderProps {
     thumbSizePercent?: number;
     /** Delay in ms after drag before updating from feedback (default 1000) */
     delayMsAfterDragUpdateFeedback?: number;
+    /** Controlled value (minValue..maxValue). When set, drives the slider without an analog join. */
+    value?: number;
+    /** Fired during drag with the new value, throttled to changeThrottleMs (trailing). */
+    onChange?: (value: number) => void;
+    /** Fired on drag end with the final value. */
+    onCommit?: (value: number) => void;
+    /** Min ms between onChange calls during a drag (default 100). 0 = every move. The
+     *  thumb still moves smoothly locally; this only rate-limits the outbound onChange. */
+    changeThrottleMs?: number;
     /** Container CSS class */
     className?: string;
     /** Container inline style */
@@ -137,7 +158,7 @@ interface CrisSliderProps {
     /** Class when disabled */
     classDisabled?: string;
 }
-declare function CrisSlider({ join, joinDigital, joinAnalog, joinEnable, joinVisible, minValue, maxValue, horizontal, fillHidden, trackSizePercent, thumbSizePercent, delayMsAfterDragUpdateFeedback, className, style, barClassName, barStyle, fillClassName, fillStyle, thumbClassName, thumbStyle, classDisabled, }: CrisSliderProps): react_jsx_runtime.JSX.Element | null;
+declare function CrisSlider({ join, joinDigital, joinAnalog, joinEnable, joinVisible, minValue, maxValue, horizontal, fillHidden, trackSizePercent, thumbSizePercent, delayMsAfterDragUpdateFeedback, value, onChange, onCommit, changeThrottleMs, className, style, barClassName, barStyle, fillClassName, fillStyle, thumbClassName, thumbStyle, classDisabled, }: CrisSliderProps): react_jsx_runtime.JSX.Element | null;
 
 interface CrisGaugeProps {
     /** Static value (used if no join) */
@@ -481,6 +502,278 @@ interface CrisCoMatrixListsTieProps {
 }
 declare function CrisCoMatrixListsTie({ oid, inputTitle, outputTitle, showChannels, className, style, listClassName, listStyle, headerClassName, headerStyle, itemClassName, itemStyle, itemActiveClassName, itemActiveStyle, itemDisabledClassName, vmText, vmButtonClassName, vmButtonActiveClassName, renderIoIndicator, renderSignalIndicator, }: CrisCoMatrixListsTieProps): react_jsx_runtime.JSX.Element | null;
 
+type CommKind = 'none' | 'native' | 'serial' | 'ir' | 'relay' | 'tcp' | 'udp' | 'ssh' | 'http' | 'ws' | 'tcp_server' | 'ws_server' | 'custom';
+/** Communication state of a device (the `cm` object of a status). */
+interface DeviceComm {
+    /** Communication type (kind). */
+    kd?: CommKind;
+    /** Serial over ethernet. */
+    so?: boolean;
+    /** Connected (ethernet indicator state). */
+    co?: boolean;
+    /** Alive / responds (serial indicator state). */
+    al?: boolean;
+}
+/** A single indicator: whether it shows and whether it is on. */
+interface CommIndicatorState {
+    visible: boolean;
+    on: boolean;
+}
+/** Applies the backend rule and returns the state of both indicators. */
+declare function commIndicators(c?: DeviceComm): {
+    eth: CommIndicatorState;
+    serial: CommIndicatorState;
+};
+interface CrisViewCommClasses {
+    /** Outer flex row. */
+    root?: string;
+    /** Each circular dot. */
+    dot?: string;
+    /** Added to a dot when on. */
+    dotOn?: string;
+    /** Added to a dot when off. */
+    dotOff?: string;
+    /** The icon <img> inside a dot. */
+    icon?: string;
+}
+interface CrisViewCommIcons {
+    /** Ethernet indicator icon — name (getIconUrl) or ReactNode. Default 'ind-ethernet'. */
+    ethernet?: string | ReactNode;
+    /** Serial indicator icon — name (getIconUrl) or ReactNode. Default 'rs232'. */
+    serial?: string | ReactNode;
+}
+interface CrisViewCommProps {
+    comm?: DeviceComm;
+    classes?: CrisViewCommClasses;
+    icons?: CrisViewCommIcons;
+    /** Convenience: appended to the root slot (e.g. positioning). */
+    className?: string;
+}
+declare function CrisViewComm({ comm, classes, icons, className }: CrisViewCommProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * Slot-map for styling CrisViewDspFull and its sub-parts, plus icon config. A
+ * consumer overrides only the slots it cares about; every other slot keeps the
+ * default (which reproduces the original POC look). Final class per slot =
+ * `classes?.slot ?? DEFAULT.slot`.
+ */
+
+interface CrisViewDspClasses {
+    /** Root column. */
+    root?: string;
+    /** Tab bar (relative; presets/comm are positioned within). */
+    header?: string;
+    /** Content area below the tabs. */
+    content?: string;
+    /** Tab button base. */
+    tab?: string;
+    /** Added to the selected tab. */
+    tabActive?: string;
+    /** Connecting / empty-state message. */
+    message?: string;
+    /** Presets wrapper (positioned at the left of the header). */
+    presetWrap?: string;
+    /** "Preset" caption above the buttons. */
+    presetLabel?: string;
+    /** Preset button base. */
+    preset?: string;
+    /** Added to the active preset button. */
+    presetActive?: string;
+    /** Added to a preset button while pressed. */
+    presetPressed?: string;
+    /** "Saved" flash overlay. */
+    savedFlash?: string;
+    /** Strip column. */
+    strip?: string;
+    /** Strip label. */
+    stripLabel?: string;
+    /** Level percentage readout above the fader. */
+    levelReadout?: string;
+    /** Fader bar/track. */
+    faderBar?: string;
+    /** Fader fill. */
+    faderFill?: string;
+    /** Fader thumb. */
+    faderThumb?: string;
+    /** Mute button base. */
+    mute?: string;
+    /** Added to the mute button when muted. */
+    muteActive?: string;
+    /** Mixer fixed corner. */
+    mixerCorner?: string;
+    /** Mixer sticky header/label chrome. */
+    mixerChrome?: string;
+    /** Crosspoint cell base. */
+    cell?: string;
+    /** Crosspoint cell when on. */
+    cellOn?: string;
+    /** Crosspoint cell when off. */
+    cellOff?: string;
+}
+interface CrisViewDspIcons {
+    /** Mixer crosspoint ON icon — name (getIconUrl) or ReactNode. Default 'audio-volume-ok'. */
+    crosspointOn?: string | ReactNode;
+    /** Mute button icon when unmuted. Default 'audio-volume-high'. */
+    muteOff?: string;
+    /** Mute button icon when muted. Default 'audio-volume-mute'. */
+    muteOn?: string;
+    /** CSS filter for the unmuted icon. Default a light-green filter. */
+    muteOffFilter?: string;
+    /** CSS filter for the muted icon. Default white. */
+    muteOnFilter?: string;
+}
+
+interface CrisViewDspPreset {
+    id: number;
+    name: string;
+    /** Which feedback field highlights this button. Default 'device'. */
+    kind?: 'device' | 'local';
+    /**
+     * Whether a long press saves this preset. `true` (default) → short tap recalls,
+     * long press saves. `false` → recall only (the long-press save gesture is not
+     * wired, so it cannot overwrite the preset).
+     */
+    saveAllowed?: boolean;
+}
+
+type DspTab = 'in' | 'mix' | 'out';
+interface CrisViewDspFullProps {
+    /** OID of the DSP custom object; the view subscribes internally. */
+    oid: string;
+    /** Presets shown in the header. Omit → no presets row. */
+    presets?: CrisViewDspPreset[];
+    /** Input channel ids to hide (faders). */
+    skipShowInput?: number[];
+    /** Output channel ids to hide (faders). */
+    skipShowOutput?: number[];
+    /** Hide the whole Mixer tab. */
+    skipCrosspoints?: boolean;
+    /** Whether the active preset stays highlighted after release (default true). */
+    sustainedPresetFeedback?: boolean;
+    classes?: CrisViewDspClasses;
+    icons?: CrisViewDspIcons;
+    /** Convenience: appended to the root slot. */
+    className?: string;
+    /** Initial tab (default 'in'). */
+    initialTab?: DspTab;
+}
+declare function CrisViewDspFull({ oid, presets, skipShowInput, skipShowOutput, skipCrosspoints, sustainedPresetFeedback, classes, icons, className, initialTab, }: CrisViewDspFullProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * DSP custom-object protocol types (the shape exposed by a DSP backend's custom
+ * object, e.g. `DSP1_API` / Dsp.CrisApi.cs). The dynamic DSP view is fed entirely
+ * from a status of this shape — point a view at the object's OID and it renders
+ * whatever the DSP exposes.
+ */
+
+/** Input or output channel. lv = analog level 0..65535, mt = mute. */
+interface DspIo {
+    id: number;
+    lb?: string;
+    lv: number;
+    mt: boolean;
+}
+interface DspOut extends DspIo {
+    /** Crosspoints: input id → routed. In a full status only the TRUE ones arrive. */
+    xp?: Record<number, boolean>;
+    /** Crossgains: input id → gain 0..65535. Out of scope for v1. */
+    xg?: Record<number, number>;
+}
+/**
+ * Linked group. Confirmed against the backend (Dsp.cs `LinkedIo`): serialized as
+ * `lb` (label, omitted when null) and `ch` (member channels).
+ */
+interface DspLinkedGroup {
+    /** Group label. Absent when the backend has it null. */
+    lb?: string;
+    /** Member channel ids. */
+    ch: number[];
+}
+interface DspLinks {
+    ip?: DspLinkedGroup[];
+    op?: DspLinkedGroup[];
+}
+/** Active DSP preset. dv = recovered device preset, lc = local preset. */
+interface DspPreset {
+    dv?: number;
+    lc?: number;
+}
+/** Shape of a DSP custom-object status. */
+interface DspStatus {
+    /** Device communication state (eth/serial indicators). */
+    cm?: DeviceComm;
+    ip: DspIo[];
+    op: DspOut[];
+    ln?: DspLinks;
+    pr?: DspPreset;
+    ps?: DspPreset;
+}
+
+/**
+ * Pure DSP data-model helpers. No React, no effects: they only transform a DSP
+ * custom-object `status` into structures ready to render.
+ */
+
+/** io as the backend expects it in level.set / mute.set. */
+type DspIoDir = 'in' | 'out';
+/** Analog level (0..65535) → percentage 0..100 for display. */
+declare function levelToPercent(lv: number): number;
+/** Ensures a level falls in the valid analog range. */
+declare function clampLevel(lv: number | undefined): number;
+/**
+ * Normalizes a linked group to the UI model. Keys confirmed against the backend
+ * (Dsp.cs `LinkedIo`): `lb` (label) and `ch` (channels). Degrades to empty label
+ * / no channels when missing.
+ */
+declare function normalizeLinked(raw: DspLinkedGroup): {
+    label: string;
+    channels: number[];
+};
+/** A "strip" of the Inputs/Outputs page: a loose channel or a linked group. */
+type DspStrip = {
+    kind: 'single';
+    key: string;
+    label: string;
+    channels: number[];
+    lv: number;
+    mt: boolean;
+} | {
+    kind: 'group';
+    key: string;
+    label: string;
+    channels: number[];
+    lv: number;
+    mt: boolean;
+};
+/**
+ * Collapses the channel list (`ip` or `op`) applying the linked groups:
+ * - each group shows as ONE strip; its member channels are hidden as loose ones.
+ * - the group state (lv/mt/label) is read from its primary member (first channel
+ *   present in the status); if none exists, {lv:0, mt:false} is used.
+ * - channels that belong to no group show as loose ones, in order.
+ */
+declare function collapseStrips(channels: DspIo[], links: DspLinkedGroup[] | undefined): DspStrip[];
+/** Extracts the linked groups from the status for a given direction. */
+declare function linksFor(ln: DspLinks | undefined, io: DspIoDir): DspLinkedGroup[] | undefined;
+/**
+ * Mixer axis (one entry per channel, in order). For linked groups whose channels
+ * are CONSECUTIVE (and therefore adjacent in the grid) it adds the info to paint a
+ * two-level label: common group name (spanning) + per-member channel name (e.g.
+ * L/R). Loose channels or non-consecutive groups remain a single label.
+ */
+interface MixerAxisItem {
+    id: number;
+    /** Own channel name (for groups usually "L"/"R"; for loose ones, the full name). */
+    channelLabel: string;
+    /** Common group name, present only if the channel belongs to a consecutive group. */
+    groupCommon?: string;
+    /** true on the first member of the group (paints the spanning common). */
+    groupStart?: boolean;
+    /** Number of group members (span), only on groupStart. */
+    groupSpan?: number;
+}
+declare function buildMixerAxis(channels: DspIo[], links: DspLinkedGroup[] | undefined): MixerAxisItem[];
+
 /**
  * Icon configuration and utilities for CRIS components
  *
@@ -531,4 +824,4 @@ declare function getIconUrl(name: string): string;
  */
 declare function getIconFilter(active: boolean): string | undefined;
 
-export { CrisButton, type CrisButtonProps, CrisCoDebug, type CrisCoDebugProps, CrisCoList, type CrisCoListProps, CrisCoMatrixListsTie, type CrisCoMatrixListsTieProps, CrisGauge, type CrisGaugeProps, CrisOfflinePage, type CrisOfflinePageProps, CrisSlider, type CrisSliderProps, CrisSpinner, type CrisSpinnerProps, CrisText, CrisTextInput, type CrisTextInputProps, type CrisTextProps, type DebugModule, type IconConfig, type ListItem, type ListStatus, type MatrixItem, type MatrixStatus, type SpinnerSpeed, configureIcons, getIconConfig, getIconFilter, getIconUrl };
+export { type CommIndicatorState, type CommKind, CrisButton, type CrisButtonProps, CrisCoDebug, type CrisCoDebugProps, CrisCoList, type CrisCoListProps, CrisCoMatrixListsTie, type CrisCoMatrixListsTieProps, CrisGauge, type CrisGaugeProps, CrisOfflinePage, type CrisOfflinePageProps, CrisSlider, type CrisSliderProps, CrisSpinner, type CrisSpinnerProps, CrisText, CrisTextInput, type CrisTextInputProps, type CrisTextProps, CrisViewComm, type CrisViewCommClasses, type CrisViewCommIcons, type CrisViewCommProps, type CrisViewDspClasses, CrisViewDspFull, type CrisViewDspFullProps, type CrisViewDspIcons, type CrisViewDspPreset, type DebugModule, type DeviceComm, type DspIo, type DspIoDir, type DspLinkedGroup, type DspLinks, type DspOut, type DspPreset, type DspStatus, type DspStrip, type IconConfig, type ListItem, type ListStatus, type MatrixItem, type MatrixStatus, type MixerAxisItem, type SpinnerSpeed, buildMixerAxis, clampLevel, collapseStrips, commIndicators, configureIcons, getIconConfig, getIconFilter, getIconUrl, levelToPercent, linksFor, normalizeLinked };