@imperosoft/cris-webui-components 1.3.0 → 1.4.0

package/dist/index.d.mts

@@ -605,6 +605,8 @@ interface CrisViewDspClasses {
     mute?: string;
     /** Added to the mute button when muted. */
     muteActive?: string;
+    /** Opaque backplate behind the sticky header/label bands (seam guard during drag). */
+    mixerBackplate?: string;
     /** Mixer fixed corner. */
     mixerCorner?: string;
     /** Mixer sticky header/label chrome. */
@@ -700,22 +702,6 @@ interface CrisViewDspOutputsProps extends DspStylingProps {
 }
 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
@@ -884,6 +870,72 @@ interface MixerAxisItem {
 }
 declare function buildMixerAxis(channels: DspIo[], links: DspLinkedGroup[] | undefined): MixerAxisItem[];
 
+/** Track sizes + derived sticky offsets / z-order of the mixer grid. Passed to the
+ *  header render-props so a custom header lands on the same tracks as the cells. */
+interface MixerGeometry {
+    /** Output display-group column width (left, vertical text). */
+    groupW: string;
+    /** Output linked-group column width. */
+    commonW: string;
+    /** Output channel-name column width. groupW+commonW+chanW = label-band width. */
+    chanW: string;
+    /** Input display-group header row height (top). */
+    groupH: string;
+    /** Input linked-group header row height. */
+    commonH: string;
+    /** Input channel-name header row height (toward cells). */
+    chanH: string;
+    /** Crosspoint cell width. */
+    cellW: string;
+    /** Output row height. */
+    rowH: string;
+    /** Sticky `top` of the input link tier (row 2). */
+    topLink: string;
+    /** Sticky `top` of the input channel tier (row 3). */
+    topChan: string;
+    /** Sticky `left` of the output link tier (col 2). */
+    leftLink: string;
+    /** Sticky `left` of the output channel tier (col 3). */
+    leftChan: string;
+    /** z-order: corner > group > link > chan > cells. */
+    z: {
+        corner: number;
+        group: number;
+        link: number;
+        chan: number;
+    };
+    /** Column count = inputs.length; first input column is grid column 4. */
+    inputCount: number;
+    /** Row count = outputs.length; first output row is grid row 4. */
+    outputCount: number;
+}
+/** Caller overrides for the eight grid track sizes (derived offsets are recomputed). */
+type MixerGeometryOverrides = Partial<Pick<MixerGeometry, 'groupW' | 'commonW' | 'chanW' | 'groupH' | 'commonH' | 'chanH' | 'cellW' | 'rowH'>>;
+
+interface CrisViewDspMixerProps extends DspStylingProps {
+    /** OID of the DSP custom object. */
+    oid: string;
+    /** Track-size overrides; the rest of the geometry keeps the em defaults. */
+    geometry?: MixerGeometryOverrides;
+    /** Custom top band (rows 1–3 over the input columns). Default: text tiers. */
+    renderInputHeader?: (inAxis: MixerAxisItem3[], geom: MixerGeometry) => ReactNode;
+    /** Custom left band (cols 1–3 over the output rows). Default: text tiers. */
+    renderOutputHeader?: (outAxis: MixerAxisItem3[], geom: MixerGeometry) => ReactNode;
+    /** Custom fixed-corner content. Default: "OUT \ IN". */
+    renderCorner?: (geom: MixerGeometry) => ReactNode;
+}
+declare function CrisViewDspMixer({ oid, classes, icons, className, geometry, renderInputHeader, renderOutputHeader, renderCorner, }: 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;
+
 interface CrisViewDspChannelsProps extends DspStylingProps {
     /** OID of the DSP custom object. */
     oid: string;
@@ -950,4 +1002,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, 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 };
+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 MixerGeometry, type MixerGeometryOverrides, type SpinnerSpeed, buildIoSections, buildMixerAxis, buildMixerAxisGrouped, clampLevel, collapseStrips, commIndicators, configureIcons, getIconConfig, getIconFilter, getIconUrl, groupsFor, levelToPercent, linksFor, normalizeLinked };

package/dist/index.d.ts

@@ -605,6 +605,8 @@ interface CrisViewDspClasses {
     mute?: string;
     /** Added to the mute button when muted. */
     muteActive?: string;
+    /** Opaque backplate behind the sticky header/label bands (seam guard during drag). */
+    mixerBackplate?: string;
     /** Mixer fixed corner. */
     mixerCorner?: string;
     /** Mixer sticky header/label chrome. */
@@ -700,22 +702,6 @@ interface CrisViewDspOutputsProps extends DspStylingProps {
 }
 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
@@ -884,6 +870,72 @@ interface MixerAxisItem {
 }
 declare function buildMixerAxis(channels: DspIo[], links: DspLinkedGroup[] | undefined): MixerAxisItem[];
 
+/** Track sizes + derived sticky offsets / z-order of the mixer grid. Passed to the
+ *  header render-props so a custom header lands on the same tracks as the cells. */
+interface MixerGeometry {
+    /** Output display-group column width (left, vertical text). */
+    groupW: string;
+    /** Output linked-group column width. */
+    commonW: string;
+    /** Output channel-name column width. groupW+commonW+chanW = label-band width. */
+    chanW: string;
+    /** Input display-group header row height (top). */
+    groupH: string;
+    /** Input linked-group header row height. */
+    commonH: string;
+    /** Input channel-name header row height (toward cells). */
+    chanH: string;
+    /** Crosspoint cell width. */
+    cellW: string;
+    /** Output row height. */
+    rowH: string;
+    /** Sticky `top` of the input link tier (row 2). */
+    topLink: string;
+    /** Sticky `top` of the input channel tier (row 3). */
+    topChan: string;
+    /** Sticky `left` of the output link tier (col 2). */
+    leftLink: string;
+    /** Sticky `left` of the output channel tier (col 3). */
+    leftChan: string;
+    /** z-order: corner > group > link > chan > cells. */
+    z: {
+        corner: number;
+        group: number;
+        link: number;
+        chan: number;
+    };
+    /** Column count = inputs.length; first input column is grid column 4. */
+    inputCount: number;
+    /** Row count = outputs.length; first output row is grid row 4. */
+    outputCount: number;
+}
+/** Caller overrides for the eight grid track sizes (derived offsets are recomputed). */
+type MixerGeometryOverrides = Partial<Pick<MixerGeometry, 'groupW' | 'commonW' | 'chanW' | 'groupH' | 'commonH' | 'chanH' | 'cellW' | 'rowH'>>;
+
+interface CrisViewDspMixerProps extends DspStylingProps {
+    /** OID of the DSP custom object. */
+    oid: string;
+    /** Track-size overrides; the rest of the geometry keeps the em defaults. */
+    geometry?: MixerGeometryOverrides;
+    /** Custom top band (rows 1–3 over the input columns). Default: text tiers. */
+    renderInputHeader?: (inAxis: MixerAxisItem3[], geom: MixerGeometry) => ReactNode;
+    /** Custom left band (cols 1–3 over the output rows). Default: text tiers. */
+    renderOutputHeader?: (outAxis: MixerAxisItem3[], geom: MixerGeometry) => ReactNode;
+    /** Custom fixed-corner content. Default: "OUT \ IN". */
+    renderCorner?: (geom: MixerGeometry) => ReactNode;
+}
+declare function CrisViewDspMixer({ oid, classes, icons, className, geometry, renderInputHeader, renderOutputHeader, renderCorner, }: 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;
+
 interface CrisViewDspChannelsProps extends DspStylingProps {
     /** OID of the DSP custom object. */
     oid: string;
@@ -950,4 +1002,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, 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 };
+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 MixerGeometry, type MixerGeometryOverrides, type SpinnerSpeed, buildIoSections, buildMixerAxis, buildMixerAxisGrouped, clampLevel, collapseStrips, commIndicators, configureIcons, getIconConfig, getIconFilter, getIconUrl, groupsFor, levelToPercent, linksFor, normalizeLinked };