@imperosoft/cris-webui-components 1.2.1 → 1.3.0

package/dist/index.d.mts

@@ -583,6 +583,12 @@ interface CrisViewDspClasses {
     presetPressed?: string;
     /** "Saved" flash overlay. */
     savedFlash?: string;
+    /** Group-name header above a section of faders. */
+    groupHeader?: string;
+    /** Mixer display-group chrome (top input tier). */
+    mixerGroup?: string;
+    /** Mixer display-group chrome (left output tier; rendered with vertical text). */
+    mixerGroupV?: string;
     /** Strip column. */
     strip?: string;
     /** Strip label. */
@@ -659,6 +665,57 @@ interface CrisViewDspFullProps {
 }
 declare function CrisViewDspFull({ oid, presets, skipShowInput, skipShowOutput, skipCrosspoints, sustainedPresetFeedback, classes, icons, className, initialTab, }: CrisViewDspFullProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Shared prop shape for the standalone, self-subscribing DSP view pieces
+ * (CrisViewDspInputs / Outputs / Mixer / Presets / Channels). Each piece accepts
+ * styling overrides identical to CrisViewDspFull and an extra root className.
+ */
+
+interface DspStylingProps {
+    /** Class slot overrides (see CrisViewDspClasses); unset slots use the defaults. */
+    classes?: CrisViewDspClasses;
+    /** Icon overrides (see CrisViewDspIcons). */
+    icons?: CrisViewDspIcons;
+    /** Appended to the wrapper root. */
+    className?: string;
+}
+
+interface CrisViewDspInputsProps extends DspStylingProps {
+    /** OID of the DSP custom object. */
+    oid: string;
+    /** Input channel ids to hide. */
+    skip?: number[];
+    /** Message shown when there are no inputs. Default 'Sin entradas'. */
+    emptyLabel?: string;
+}
+declare function CrisViewDspInputs({ oid, skip, emptyLabel, classes, icons, className, }: CrisViewDspInputsProps): react_jsx_runtime.JSX.Element;
+
+interface CrisViewDspOutputsProps extends DspStylingProps {
+    /** OID of the DSP custom object. */
+    oid: string;
+    /** Output channel ids to hide. */
+    skip?: number[];
+    /** Message shown when there are no outputs. Default 'Sin salidas'. */
+    emptyLabel?: string;
+}
+declare function CrisViewDspOutputs({ oid, skip, emptyLabel, classes, icons, className, }: CrisViewDspOutputsProps): react_jsx_runtime.JSX.Element;
+
+interface CrisViewDspMixerProps extends DspStylingProps {
+    /** OID of the DSP custom object. */
+    oid: string;
+}
+declare function CrisViewDspMixer({ oid, classes, icons, className }: CrisViewDspMixerProps): react_jsx_runtime.JSX.Element;
+
+interface CrisViewDspPresetsProps extends Pick<DspStylingProps, 'classes' | 'className'> {
+    /** OID of the DSP custom object. */
+    oid: string;
+    /** Presets to show (the backend does not dictate the count). */
+    presets: CrisViewDspPreset[];
+    /** Keep the active preset highlighted after release. Default true. */
+    sustainedPresetFeedback?: boolean;
+}
+declare function CrisViewDspPresets({ oid, presets, sustainedPresetFeedback, classes, className, }: CrisViewDspPresetsProps): 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
@@ -693,6 +750,20 @@ interface DspLinks {
     ip?: DspLinkedGroup[];
     op?: DspLinkedGroup[];
 }
+/**
+ * Display group (backend `dg`). A higher-level, presentation-only grouping of
+ * channels, orthogonal to linked groups (`ln`) and able to overlap them. `id` is
+ * the group NAME (e.g. "Mic Diadema"); `ch` its member channel ids. Channels carry
+ * a short `lb` ("1", "L", "17") and the group supplies the prefix.
+ */
+interface DspDisplayGroup {
+    id: string;
+    ch: number[];
+}
+interface DspDisplayGroups {
+    ip?: DspDisplayGroup[];
+    op?: DspDisplayGroup[];
+}
 /** Active DSP preset. dv = recovered device preset, lc = local preset. */
 interface DspPreset {
     dv?: number;
@@ -705,6 +776,8 @@ interface DspStatus {
     ip: DspIo[];
     op: DspOut[];
     ln?: DspLinks;
+    /** Display groups (presentation grouping/ordering of channels). */
+    dg?: DspDisplayGroups;
     pr?: DspPreset;
     ps?: DspPreset;
 }
@@ -755,6 +828,43 @@ type DspStrip = {
 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;
+/** Extracts the display groups from the status for a given direction. */
+declare function groupsFor(dg: DspDisplayGroups | undefined, io: DspIoDir): DspDisplayGroup[] | undefined;
+/** A section of the Inputs/Outputs page: a display group (named) or the trailing ungrouped channels. */
+interface DspSection {
+    /** Display-group name (header). Absent for the trailing ungrouped section. */
+    groupName?: string;
+    strips: DspStrip[];
+}
+/**
+ * Builds the ordered, sectioned fader layout. With no `groups`, returns a single
+ * header-less section equal to `collapseStrips` (current behavior). Otherwise emits
+ * one section per display group (groups in order, channels in group order, linked
+ * pairs collapsed), then a trailing header-less section for every channel in no
+ * group, in status-array order.
+ */
+declare function buildIoSections(channels: DspIo[], links: DspLinkedGroup[] | undefined, groups: DspDisplayGroup[] | undefined): DspSection[];
+/**
+ * Mixer axis with up to three tiers per channel: display group (tier 1, dg),
+ * linked group (tier 2, ln), channel name (tier 3). Channels are ordered by dg
+ * (groups in order, then ungrouped in array order); every channel keeps its own
+ * column. `*Start`/`*Span` mark the first cell of a spanning run. With no `groups`,
+ * only the link + channel tiers are populated (same labels as `buildMixerAxis`).
+ */
+interface MixerAxisItem3 {
+    id: number;
+    /** Tier 3: own channel name. */
+    channelLabel: string;
+    /** Tier 2: linked-group label (present on every member of a consecutive run). */
+    linkCommon?: string;
+    linkStart?: boolean;
+    linkSpan?: number;
+    /** Tier 1: display-group name (present on every member of the group). */
+    groupName?: string;
+    groupStart?: boolean;
+    groupSpan?: number;
+}
+declare function buildMixerAxisGrouped(channels: DspIo[], links: DspLinkedGroup[] | undefined, groups: DspDisplayGroup[] | undefined): MixerAxisItem3[];
 /**
  * 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
@@ -774,6 +884,22 @@ interface MixerAxisItem {
 }
 declare function buildMixerAxis(channels: DspIo[], links: DspLinkedGroup[] | undefined): MixerAxisItem[];
 
+interface CrisViewDspChannelsProps extends DspStylingProps {
+    /** OID of the DSP custom object. */
+    oid: string;
+    /** Direction: 'in' (inputs) or 'out' (outputs). */
+    io: DspIoDir;
+    /** Channel ids to show. Omit → all channels of this io. */
+    show?: number[];
+    /** Wrap in a horizontal-scroll container instead of a plain flex row. Default false. */
+    scroll?: boolean;
+    /** Show the empty-state message when no channels match. Default false (render nothing). */
+    showEmpty?: boolean;
+    /** Empty-state message (only when showEmpty). */
+    emptyLabel?: string;
+}
+declare function CrisViewDspChannels({ oid, io, show, scroll, showEmpty, emptyLabel, classes, icons, className, }: CrisViewDspChannelsProps): react_jsx_runtime.JSX.Element | null;
+
 /**
  * Icon configuration and utilities for CRIS components
  *
@@ -824,4 +950,4 @@ declare function getIconUrl(name: string): string;
  */
 declare function getIconFilter(active: boolean): string | undefined;
 
-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 };
+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, CrisViewDspChannels, type CrisViewDspChannelsProps, type CrisViewDspClasses, CrisViewDspFull, type CrisViewDspFullProps, type CrisViewDspIcons, CrisViewDspInputs, type CrisViewDspInputsProps, CrisViewDspMixer, type CrisViewDspMixerProps, CrisViewDspOutputs, type CrisViewDspOutputsProps, type CrisViewDspPreset, CrisViewDspPresets, type CrisViewDspPresetsProps, type DebugModule, type DeviceComm, type DspDisplayGroup, type DspDisplayGroups, type DspIo, type DspIoDir, type DspLinkedGroup, type DspLinks, type DspOut, type DspPreset, type DspSection, type DspStatus, type DspStrip, type DspStylingProps, type IconConfig, type ListItem, type ListStatus, type MatrixItem, type MatrixStatus, type MixerAxisItem, type MixerAxisItem3, type SpinnerSpeed, buildIoSections, buildMixerAxis, buildMixerAxisGrouped, clampLevel, collapseStrips, commIndicators, configureIcons, getIconConfig, getIconFilter, getIconUrl, groupsFor, levelToPercent, linksFor, normalizeLinked };

package/dist/index.d.ts

@@ -583,6 +583,12 @@ interface CrisViewDspClasses {
     presetPressed?: string;
     /** "Saved" flash overlay. */
     savedFlash?: string;
+    /** Group-name header above a section of faders. */
+    groupHeader?: string;
+    /** Mixer display-group chrome (top input tier). */
+    mixerGroup?: string;
+    /** Mixer display-group chrome (left output tier; rendered with vertical text). */
+    mixerGroupV?: string;
     /** Strip column. */
     strip?: string;
     /** Strip label. */
@@ -659,6 +665,57 @@ interface CrisViewDspFullProps {
 }
 declare function CrisViewDspFull({ oid, presets, skipShowInput, skipShowOutput, skipCrosspoints, sustainedPresetFeedback, classes, icons, className, initialTab, }: CrisViewDspFullProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Shared prop shape for the standalone, self-subscribing DSP view pieces
+ * (CrisViewDspInputs / Outputs / Mixer / Presets / Channels). Each piece accepts
+ * styling overrides identical to CrisViewDspFull and an extra root className.
+ */
+
+interface DspStylingProps {
+    /** Class slot overrides (see CrisViewDspClasses); unset slots use the defaults. */
+    classes?: CrisViewDspClasses;
+    /** Icon overrides (see CrisViewDspIcons). */
+    icons?: CrisViewDspIcons;
+    /** Appended to the wrapper root. */
+    className?: string;
+}
+
+interface CrisViewDspInputsProps extends DspStylingProps {
+    /** OID of the DSP custom object. */
+    oid: string;
+    /** Input channel ids to hide. */
+    skip?: number[];
+    /** Message shown when there are no inputs. Default 'Sin entradas'. */
+    emptyLabel?: string;
+}
+declare function CrisViewDspInputs({ oid, skip, emptyLabel, classes, icons, className, }: CrisViewDspInputsProps): react_jsx_runtime.JSX.Element;
+
+interface CrisViewDspOutputsProps extends DspStylingProps {
+    /** OID of the DSP custom object. */
+    oid: string;
+    /** Output channel ids to hide. */
+    skip?: number[];
+    /** Message shown when there are no outputs. Default 'Sin salidas'. */
+    emptyLabel?: string;
+}
+declare function CrisViewDspOutputs({ oid, skip, emptyLabel, classes, icons, className, }: CrisViewDspOutputsProps): react_jsx_runtime.JSX.Element;
+
+interface CrisViewDspMixerProps extends DspStylingProps {
+    /** OID of the DSP custom object. */
+    oid: string;
+}
+declare function CrisViewDspMixer({ oid, classes, icons, className }: CrisViewDspMixerProps): react_jsx_runtime.JSX.Element;
+
+interface CrisViewDspPresetsProps extends Pick<DspStylingProps, 'classes' | 'className'> {
+    /** OID of the DSP custom object. */
+    oid: string;
+    /** Presets to show (the backend does not dictate the count). */
+    presets: CrisViewDspPreset[];
+    /** Keep the active preset highlighted after release. Default true. */
+    sustainedPresetFeedback?: boolean;
+}
+declare function CrisViewDspPresets({ oid, presets, sustainedPresetFeedback, classes, className, }: CrisViewDspPresetsProps): 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
@@ -693,6 +750,20 @@ interface DspLinks {
     ip?: DspLinkedGroup[];
     op?: DspLinkedGroup[];
 }
+/**
+ * Display group (backend `dg`). A higher-level, presentation-only grouping of
+ * channels, orthogonal to linked groups (`ln`) and able to overlap them. `id` is
+ * the group NAME (e.g. "Mic Diadema"); `ch` its member channel ids. Channels carry
+ * a short `lb` ("1", "L", "17") and the group supplies the prefix.
+ */
+interface DspDisplayGroup {
+    id: string;
+    ch: number[];
+}
+interface DspDisplayGroups {
+    ip?: DspDisplayGroup[];
+    op?: DspDisplayGroup[];
+}
 /** Active DSP preset. dv = recovered device preset, lc = local preset. */
 interface DspPreset {
     dv?: number;
@@ -705,6 +776,8 @@ interface DspStatus {
     ip: DspIo[];
     op: DspOut[];
     ln?: DspLinks;
+    /** Display groups (presentation grouping/ordering of channels). */
+    dg?: DspDisplayGroups;
     pr?: DspPreset;
     ps?: DspPreset;
 }
@@ -755,6 +828,43 @@ type DspStrip = {
 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;
+/** Extracts the display groups from the status for a given direction. */
+declare function groupsFor(dg: DspDisplayGroups | undefined, io: DspIoDir): DspDisplayGroup[] | undefined;
+/** A section of the Inputs/Outputs page: a display group (named) or the trailing ungrouped channels. */
+interface DspSection {
+    /** Display-group name (header). Absent for the trailing ungrouped section. */
+    groupName?: string;
+    strips: DspStrip[];
+}
+/**
+ * Builds the ordered, sectioned fader layout. With no `groups`, returns a single
+ * header-less section equal to `collapseStrips` (current behavior). Otherwise emits
+ * one section per display group (groups in order, channels in group order, linked
+ * pairs collapsed), then a trailing header-less section for every channel in no
+ * group, in status-array order.
+ */
+declare function buildIoSections(channels: DspIo[], links: DspLinkedGroup[] | undefined, groups: DspDisplayGroup[] | undefined): DspSection[];
+/**
+ * Mixer axis with up to three tiers per channel: display group (tier 1, dg),
+ * linked group (tier 2, ln), channel name (tier 3). Channels are ordered by dg
+ * (groups in order, then ungrouped in array order); every channel keeps its own
+ * column. `*Start`/`*Span` mark the first cell of a spanning run. With no `groups`,
+ * only the link + channel tiers are populated (same labels as `buildMixerAxis`).
+ */
+interface MixerAxisItem3 {
+    id: number;
+    /** Tier 3: own channel name. */
+    channelLabel: string;
+    /** Tier 2: linked-group label (present on every member of a consecutive run). */
+    linkCommon?: string;
+    linkStart?: boolean;
+    linkSpan?: number;
+    /** Tier 1: display-group name (present on every member of the group). */
+    groupName?: string;
+    groupStart?: boolean;
+    groupSpan?: number;
+}
+declare function buildMixerAxisGrouped(channels: DspIo[], links: DspLinkedGroup[] | undefined, groups: DspDisplayGroup[] | undefined): MixerAxisItem3[];
 /**
  * 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
@@ -774,6 +884,22 @@ interface MixerAxisItem {
 }
 declare function buildMixerAxis(channels: DspIo[], links: DspLinkedGroup[] | undefined): MixerAxisItem[];
 
+interface CrisViewDspChannelsProps extends DspStylingProps {
+    /** OID of the DSP custom object. */
+    oid: string;
+    /** Direction: 'in' (inputs) or 'out' (outputs). */
+    io: DspIoDir;
+    /** Channel ids to show. Omit → all channels of this io. */
+    show?: number[];
+    /** Wrap in a horizontal-scroll container instead of a plain flex row. Default false. */
+    scroll?: boolean;
+    /** Show the empty-state message when no channels match. Default false (render nothing). */
+    showEmpty?: boolean;
+    /** Empty-state message (only when showEmpty). */
+    emptyLabel?: string;
+}
+declare function CrisViewDspChannels({ oid, io, show, scroll, showEmpty, emptyLabel, classes, icons, className, }: CrisViewDspChannelsProps): react_jsx_runtime.JSX.Element | null;
+
 /**
  * Icon configuration and utilities for CRIS components
  *
@@ -824,4 +950,4 @@ declare function getIconUrl(name: string): string;
  */
 declare function getIconFilter(active: boolean): string | undefined;
 
-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 };
+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, CrisViewDspChannels, type CrisViewDspChannelsProps, type CrisViewDspClasses, CrisViewDspFull, type CrisViewDspFullProps, type CrisViewDspIcons, CrisViewDspInputs, type CrisViewDspInputsProps, CrisViewDspMixer, type CrisViewDspMixerProps, CrisViewDspOutputs, type CrisViewDspOutputsProps, type CrisViewDspPreset, CrisViewDspPresets, type CrisViewDspPresetsProps, type DebugModule, type DeviceComm, type DspDisplayGroup, type DspDisplayGroups, type DspIo, type DspIoDir, type DspLinkedGroup, type DspLinks, type DspOut, type DspPreset, type DspSection, type DspStatus, type DspStrip, type DspStylingProps, type IconConfig, type ListItem, type ListStatus, type MatrixItem, type MatrixStatus, type MixerAxisItem, type MixerAxisItem3, type SpinnerSpeed, buildIoSections, buildMixerAxis, buildMixerAxisGrouped, clampLevel, collapseStrips, commIndicators, configureIcons, getIconConfig, getIconFilter, getIconUrl, groupsFor, levelToPercent, linksFor, normalizeLinked };