waveform-analysis 0.1.73 → 0.1.74

package/dist/types/components/core/layout.d.ts

@@ -10,7 +10,7 @@ export interface ResolvedYAxisTicks {
 }
 export declare function resolveYAxisTicks(domain: [number, number], tickCount?: number, nice?: boolean): ResolvedYAxisTicks;
 export declare function formatYAxisTickLabel(value: number, domain: [number, number], tickValues: readonly number[], unit?: string, side?: 'left' | 'right'): string;
-/** Scientific multipliers retain their rendered position but do not reserve horizontal space. */
+/** Name spacing excludes scientific multipliers; outer clearance measures the full label. */
 export declare function formatYAxisTickLayoutLabel(value: number, domain: [number, number], tickValues: readonly number[], unit?: string): string;
 export interface YAxisSeriesGroup {
     index: number;
@@ -33,6 +33,7 @@ export declare function resolveYAxisSeriesGroups(track: DisplayTrack, overlayMod
 export declare function resolveRenderedYAxisSeriesGroups(track: DisplayTrack, overlayMode: WaveformOverlayMode, yDomain?: WaveformYDomain, yDomains?: Record<string, WaveformYDomain>, viewportYDomains?: Record<string, [number, number]>, padding?: YAxisPaddingOptions | number): YAxisSeriesGroup[];
 export declare function axisTextMetrics(domain: [number, number], nice?: boolean, tickValues?: number[], unit?: string, tickCount?: number, includeWithoutLastTick?: boolean, measureTextWidth?: (text: string) => number, maximumTick?: number, minimumTick?: number): {
     tickTextWidth: number;
+    titleTextWidth: number;
 };
 export declare function measureYAxisGroupClearance(group: YAxisSeriesGroup, tickCount?: number, nice?: boolean): number;
 export declare function measureTrackYAxisClearance(track: DisplayTrack, overlayMode: WaveformOverlayMode, yDomain?: WaveformYDomain, yDomains?: Record<string, WaveformYDomain>, tickCount?: number, nice?: boolean): {

package/dist/types/components/core/yAxisTitleLayout.d.ts

@@ -7,5 +7,5 @@ interface TitleLayoutOptions {
     measureTextWidth?: (text: string) => number;
 }
 type TitleTrack = Pick<TrackLayout, 'height' | 'column' | 'yAxes'>;
-export declare function alignLeftYAxisTitles(layouts: TitleTrack[], yLabel?: string, options?: TitleLayoutOptions): void;
+export declare function alignLeftYAxisTitles(layouts: TitleTrack[], _yLabel?: string, options?: TitleLayoutOptions): void;
 export {};

package/dist/types/components/interaction/useExtremaTickViewport.d.ts

@@ -2,4 +2,4 @@ import { type ComputedRef, type ShallowRef } from 'vue';
 import type { ZoomTransform } from 'd3';
 import type { TrackLayout } from '../core/types';
 /** Keep X coordinates stable when toggling extrema changes the reserved Y-label width. */
-export declare function useExtremaTickViewport(visible: () => boolean, innerWidth: ComputedRef<number>, tracks: ComputedRef<TrackLayout[]>, sharedTransform: ShallowRef<ZoomTransform>, independentTransforms: ShallowRef<ZoomTransform[]>): void;
+export declare function useExtremaTickViewport(visible: () => number, innerWidth: ComputedRef<number>, tracks: ComputedRef<TrackLayout[]>, sharedTransform: ShallowRef<ZoomTransform>, independentTransforms: ShallowRef<ZoomTransform[]>): void;

package/dist/types/demo/types.d.ts

@@ -35,7 +35,8 @@ export interface DemoControlPanelModel {
     yAxisLineVisible: boolean;
     upperPaddingEnabled: boolean;
     lowerPaddingEnabled: boolean;
-    extremaTicksVisible: boolean;
+    maximumTickVisible: boolean;
+    minimumTickVisible: boolean;
     upperPaddingPercent: number;
     lowerPaddingPercent: number;
     xAxisLabelFormatterEnabled: boolean;

package/dist/types/types/chart.d.ts

@@ -250,8 +250,10 @@ export interface WaveformAxesOptions {
         splitNumber?: number;
         /** Expands Y-axis domains to equal, human-friendly intervals. Defaults to true. */
         nice?: boolean;
-        /** Shows extra ticks for the full data extrema, independently of padding. Defaults to true. */
-        extremaTicksVisible?: boolean;
+        /** Shows the full data maximum's extra tick and label. Defaults to true. */
+        maximumTickVisible?: boolean;
+        /** Shows the full data minimum's extra tick and label. Defaults to true. */
+        minimumTickVisible?: boolean;
         /** Fraction of the automatic Y span added above its maximum. Defaults to 0. */
         upperPaddingRatio?: number;
         /** Fraction of the automatic Y span added below its minimum. Defaults to 0. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "waveform-analysis",
-  "version": "0.1.73",
+  "version": "0.1.74",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/types/index.d.ts",

package/src/App.vue

@@ -56,7 +56,8 @@ const xAxisLineVisible = ref(false)
 const yAxisLineVisible = ref(false)
 const upperPaddingEnabled = ref(true)
 const lowerPaddingEnabled = ref(true)
-const extremaTicksVisible = ref(true)
+const maximumTickVisible = ref(true)
+const minimumTickVisible = ref(true)
 const upperPaddingPercent = ref(10)
 const lowerPaddingPercent = ref(10)
 const { controlModel: xAxisLabelControlModel, xAxisLabelFormatter } = useDemoXAxisLabelControls()
@@ -145,7 +146,8 @@ const axes = computed<WaveformAxesOptions>(() => ({
     lineVisible: yAxisLineVisible.value,
     upperPaddingEnabled: upperPaddingEnabled.value,
     lowerPaddingEnabled: lowerPaddingEnabled.value,
-    extremaTicksVisible: extremaTicksVisible.value,
+    maximumTickVisible: maximumTickVisible.value,
+    minimumTickVisible: minimumTickVisible.value,
     upperPaddingRatio: upperPaddingPercent.value / 100,
     lowerPaddingRatio: lowerPaddingPercent.value / 100,
   },
@@ -367,7 +369,8 @@ const controlPanelModel = reactive({
   yAxisLineVisible,
   upperPaddingEnabled,
   lowerPaddingEnabled,
-  extremaTicksVisible,
+  maximumTickVisible,
+  minimumTickVisible,
   upperPaddingPercent,
   lowerPaddingPercent,
   ...xAxisLabelControlModel,

package/src/components/core/layout.ts

@@ -83,7 +83,7 @@ export function formatYAxisTickLabel(
   return label
 }
 
-/** Scientific multipliers retain their rendered position but do not reserve horizontal space. */
+/** Name spacing excludes scientific multipliers; outer clearance measures the full label. */
 export function formatYAxisTickLayoutLabel(
   value: number,
   domain: [number, number],
@@ -215,7 +215,7 @@ export function axisTextMetrics(
   measureTextWidth?: (text: string) => number,
   maximumTick?: number,
   minimumTick?: number,
-): { tickTextWidth: number } {
+): { tickTextWidth: number; titleTextWidth: number } {
   const resolvedTicks = tickValues
     ? { domain, values: tickValues }
     : resolveYAxisTicks(domain, tickCount, nice)
@@ -229,17 +229,26 @@ export function axisTextMetrics(
   if (includeWithoutLastTick && resolvedTicks.values.length > 1) {
     tickValueSets.push(resolvedTicks.values.slice(0, -1))
   }
-  const maximumTickWidth = Math.max(
-    Y_AXIS_CHARACTER_WIDTH,
-    ...tickValueSets.flatMap((values) =>
-      values.map((value) => {
-        const text = formatYAxisTickLayoutLabel(value, resolvedTicks.domain, values, unit)
-        return measureTextWidth ? measureTextWidth(text) : text.length * Y_AXIS_CHARACTER_WIDTH
-      }),
-    ),
+  const width = (text: string) =>
+    measureTextWidth ? measureTextWidth(text) : text.length * Y_AXIS_CHARACTER_WIDTH
+  const labels = tickValueSets.flatMap((values) =>
+    values.map((value) => ({
+      full: width(formatYAxisTickLabel(value, resolvedTicks.domain, values, unit)),
+      title: width(formatYAxisTickLayoutLabel(value, resolvedTicks.domain, values, unit)),
+    })),
   )
+  // Collision handling can move metadata to any surviving tick in compact layouts.
+  if (includeWithoutLastTick) {
+    tickValueSets[0]!.forEach((value) => {
+      labels.push({
+        full: width(formatYAxisTickLabel(value, resolvedTicks.domain, [value], unit)),
+        title: width(formatYAxisTickLayoutLabel(value, resolvedTicks.domain, [value], unit)),
+      })
+    })
+  }
   return {
-    tickTextWidth: maximumTickWidth,
+    tickTextWidth: Math.max(Y_AXIS_CHARACTER_WIDTH, ...labels.map((label) => label.full)),
+    titleTextWidth: Math.max(Y_AXIS_CHARACTER_WIDTH, ...labels.map((label) => label.title)),
   }
 }
 
@@ -248,12 +257,16 @@ export function measureYAxisGroupClearance(
   tickCount?: number,
   nice = true,
 ): number {
+  const { tickTextWidth, titleTextWidth } = axisTextMetrics(
+    group.domain,
+    nice,
+    undefined,
+    group.seriesList[0]?.unit,
+    tickCount,
+  )
   return (
-    axisTextMetrics(group.domain, nice, undefined, group.seriesList[0]?.unit, tickCount)
-      .tickTextWidth +
+    Math.max(tickTextWidth, titleTextWidth + Y_AXIS_LABEL_GAP + Y_AXIS_LABEL_BAND_WIDTH) +
     Y_AXIS_TICK_PADDING +
-    Y_AXIS_LABEL_GAP +
-    Y_AXIS_LABEL_BAND_WIDTH +
     Y_AXIS_OUTER_PADDING
   )
 }
@@ -312,6 +325,7 @@ export function buildYAxisSlots(
     typeof padding === 'object' ? padding.labelTextStyle : undefined,
   )
   const widths = new Map<string, number>()
+  const titleWidths = new Map<string, number>()
   tracks.forEach((track) => {
     const sideIndexes = { left: 0, right: 0 }
     resolveRenderedYAxisSeriesGroups(
@@ -324,7 +338,7 @@ export function buildYAxisSlots(
     ).forEach((group) => {
       const sideIndex = sideIndexes[group.side]++
       const key = `${group.side}:${sideIndex}`
-      const width = axisTextMetrics(
+      const { tickTextWidth, titleTextWidth } = axisTextMetrics(
         group.domain,
         nice,
         undefined,
@@ -334,8 +348,9 @@ export function buildYAxisSlots(
         measureTextWidth,
         group.maximumTick,
         group.minimumTick,
-      ).tickTextWidth
-      widths.set(key, Math.max(widths.get(key) ?? Y_AXIS_CHARACTER_WIDTH, width))
+      )
+      widths.set(key, Math.max(widths.get(key) ?? Y_AXIS_CHARACTER_WIDTH, tickTextWidth))
+      titleWidths.set(key, Math.max(titleWidths.get(key) ?? Y_AXIS_CHARACTER_WIDTH, titleTextWidth))
     })
   })
 
@@ -348,15 +363,14 @@ export function buildYAxisSlots(
       .sort((first, second) => first - second)
     sideIndexes.forEach((sideIndex) => {
       const tickTextWidth = widths.get(`${side}:${sideIndex}`) ?? Y_AXIS_CHARACTER_WIDTH
+      const titleTextWidth = titleWidths.get(`${side}:${sideIndex}`) ?? Y_AXIS_CHARACTER_WIDTH
       const axisOffset = side === 'left' && clearance.left > 0 ? -clearance.left : clearance[side]
       const labelDistance =
-        tickTextWidth + Y_AXIS_TICK_PADDING + Y_AXIS_LABEL_GAP + labelBandWidth / 2
+        titleTextWidth + Y_AXIS_TICK_PADDING + Y_AXIS_LABEL_GAP + labelBandWidth / 2
       const labelOffset = axisOffset + labelDistance * (side === 'left' ? -1 : 1)
       const fullClearance =
-        tickTextWidth +
+        Math.max(tickTextWidth, titleTextWidth + Y_AXIS_LABEL_GAP + labelBandWidth) +
         Y_AXIS_TICK_PADDING +
-        Y_AXIS_LABEL_GAP +
-        labelBandWidth +
         Y_AXIS_OUTER_PADDING
       slots.push({ side, sideIndex, axisOffset, labelOffset, clearance: fullClearance })
       clearance[side] += fullClearance

package/src/components/core/trackLayoutBuilder.ts

@@ -170,7 +170,7 @@ export function buildTrackLayouts(options: BuildTrackLayoutsOptions): TrackLayou
           ? group.minimumTick
           : undefined
       const tickValues = withMaximumTick(majorTicks, maximumTick, minimumTick)
-      const { tickTextWidth } = axisTextMetrics(
+      const { tickTextWidth, titleTextWidth } = axisTextMetrics(
         scale.domain() as [number, number],
         false,
         tickValues,
@@ -178,10 +178,13 @@ export function buildTrackLayouts(options: BuildTrackLayoutsOptions): TrackLayou
         tickCount,
       )
       const clearance =
-        tickTextWidth +
+        Math.max(
+          tickTextWidth,
+          titleTextWidth +
+            Y_AXIS_LABEL_GAP +
+            resolveYAxisLabelBandWidth(options.yAxisPadding?.labelTextStyle),
+        ) +
         Y_AXIS_TICK_PADDING +
-        Y_AXIS_LABEL_GAP +
-        resolveYAxisLabelBandWidth(options.yAxisPadding?.labelTextStyle) +
         Y_AXIS_OUTER_PADDING
       const slot = options.yAxisSlots?.find(
         (candidate) => candidate.side === group.side && candidate.sideIndex === sideIndex,
@@ -192,7 +195,7 @@ export function buildTrackLayouts(options: BuildTrackLayoutsOptions): TrackLayou
           ? -sideOffsets.left
           : cell.width + sideOffsets.right
       const labelDistance =
-        tickTextWidth +
+        titleTextWidth +
         Y_AXIS_TICK_PADDING +
         Y_AXIS_LABEL_GAP +
         resolveYAxisLabelBandWidth(options.yAxisPadding?.labelTextStyle) / 2

package/src/components/core/useWaveformLayout.ts

@@ -281,7 +281,9 @@ export function useWaveformLayout(context: LayoutContext) {
     }),
   )
   useExtremaTickViewport(
-    () => props.axes?.y?.extremaTicksVisible !== false,
+    () =>
+      Number(props.axes?.y?.maximumTickVisible !== false) * 2 +
+      Number(props.axes?.y?.minimumTickVisible !== false),
     innerWidth,
     trackLayouts,
     sharedTransform,

package/src/components/core/yAxisLayoutMetrics.ts

@@ -60,29 +60,37 @@ export function resolveYAxisLayoutMetrics(
         padding,
       ),
     )
-    .map(
-      (group) =>
-        axisTextMetrics(
-          group.domain,
-          nice,
-          undefined,
-          showUnits ? group.seriesList[0]?.unit : undefined,
-          tickCount,
-          compact,
-          measureTextWidth,
-          group.maximumTick,
-          group.minimumTick,
-        ).tickTextWidth,
+    .map((group) =>
+      axisTextMetrics(
+        group.domain,
+        nice,
+        undefined,
+        showUnits ? group.seriesList[0]?.unit : undefined,
+        tickCount,
+        compact,
+        measureTextWidth,
+        group.maximumTick,
+        group.minimumTick,
+      ),
     )
-  const tickTextWidth = Math.max(Y_AXIS_CHARACTER_WIDTH, ...axisText)
+  const tickTextWidth = Math.max(
+    Y_AXIS_CHARACTER_WIDTH,
+    ...axisText.map((text) => text.tickTextWidth),
+  )
+  const titleTextWidth = Math.max(
+    Y_AXIS_CHARACTER_WIDTH,
+    ...axisText.map((text) => text.titleTextWidth),
+  )
   const tickClearance = tickTextWidth + Y_AXIS_TICK_PADDING + Y_AXIS_OUTER_PADDING
   const labelCenterX = -(
     Y_AXIS_TICK_PADDING +
-    tickTextWidth +
+    titleTextWidth +
     Y_AXIS_LABEL_GAP +
     labelBandWidth / 2
   )
   const fullClearance =
-    tickTextWidth + Y_AXIS_TICK_PADDING + Y_AXIS_LABEL_GAP + labelBandWidth + Y_AXIS_OUTER_PADDING
+    Math.max(tickTextWidth, titleTextWidth + Y_AXIS_LABEL_GAP + labelBandWidth) +
+    Y_AXIS_TICK_PADDING +
+    Y_AXIS_OUTER_PADDING
   return { tickClearance, fullClearance, labelCenterX }
 }

package/src/components/core/yAxisPadding.ts

@@ -15,7 +15,7 @@ export function applyYAxisPadding(
   options: YAxisPaddingOptions | number,
 ): YAxisSeriesGroup {
   const config = typeof options === 'number' ? { upperPaddingRatio: options } : options
-  if (group.fixed) return withYAxisExtremaTicks(group, config?.extremaTicksVisible)
+  if (group.fixed) return withYAxisExtremaTicks(group, config)
   const upper = paddingRatio(config?.upperPaddingEnabled, config?.upperPaddingRatio)
   const lower = paddingRatio(config?.lowerPaddingEnabled, config?.lowerPaddingRatio)
   const [a, b] = group.domain
@@ -27,11 +27,14 @@ export function applyYAxisPadding(
       ...group,
       domain: viewport ?? [Number.isFinite(min) ? min : a, Number.isFinite(max) ? max : b],
     },
-    config?.extremaTicksVisible,
+    config,
   )
 }
 
-function withYAxisExtremaTicks(group: YAxisSeriesGroup, visible = true): YAxisSeriesGroup {
+function withYAxisExtremaTicks(
+  group: YAxisSeriesGroup,
+  options: YAxisPaddingOptions,
+): YAxisSeriesGroup {
   const maxima = group.seriesList.flatMap((series) =>
     Number.isFinite(series.rawYMaximum) ? [series.rawYMaximum!] : [],
   )
@@ -40,8 +43,10 @@ function withYAxisExtremaTicks(group: YAxisSeriesGroup, visible = true): YAxisSe
   )
   return {
     ...group,
-    maximumTick: visible && maxima.length ? Math.max(...maxima) : undefined,
-    minimumTick: visible && minima.length ? Math.min(...minima) : undefined,
+    maximumTick:
+      options?.maximumTickVisible !== false && maxima.length ? Math.max(...maxima) : undefined,
+    minimumTick:
+      options?.minimumTickVisible !== false && minima.length ? Math.min(...minima) : undefined,
   }
 }
 

package/src/components/core/yAxisTitleLayout.ts

@@ -1,13 +1,9 @@
 import { formatYAxisTickLayoutLabel } from './layout'
 import type { TrackLayout, WaveformYAxisLayout } from './types'
 import type { WaveformYAxisLabelTextStyle } from '../../types'
-import { resolveYAxisLabelBandWidth, resolveYAxisLabelFontSize } from './yAxisLabelStyle'
+import { resolveYAxisLabelBandWidth } from './yAxisLabelStyle'
 import { Y_AXIS_CHARACTER_WIDTH, Y_AXIS_TICK_PADDING } from './yAxisConstants'
 
-// Match the 11px ticks in WaveformTrack.css.
-const TICK_FONT_SIZE = 11
-const TEXT_GAP = 2
-
 interface TitleLayoutOptions {
   labelTextStyle?: WaveformYAxisLabelTextStyle
   showUnits?: boolean
@@ -15,52 +11,20 @@ interface TitleLayoutOptions {
   measureTextWidth?: (text: string) => number
 }
 
-function estimateTitleWidth(title: string, fontSize: number): number {
-  return Array.from(title).reduce((width, character) => {
-    // Latin labels average well below one em; full-width characters occupy one em.
-    const em = /[\u2e80-\u9fff\uf900-\ufaff\uff01-\uff60]/u.test(character)
-      ? 1
-      : /[MW@%]/u.test(character)
-        ? 0.95
-        : /[ilI1., :;|'!]/u.test(character)
-          ? 0.4
-          : 0.65
-    return width + em * fontSize
-  }, 0)
-}
-
 type TitleTrack = Pick<TrackLayout, 'height' | 'column' | 'yAxes'>
 
-function titleDistance(
-  track: TitleTrack,
-  axis: WaveformYAxisLayout,
-  yLabel: string | undefined,
-  options: TitleLayoutOptions,
-): number {
+function titleDistance(axis: WaveformYAxisLayout, options: TitleLayoutOptions): number {
   const series = axis.seriesList[0]
-  const title = series?.name.trim() || yLabel || ''
-  const halfTitleHeight =
-    estimateTitleWidth(title, resolveYAxisLabelFontSize(options.labelTextStyle)) / 2
-  const titleTop = track.height / 2 - halfTitleHeight - TEXT_GAP
-  const titleBottom = track.height / 2 + halfTitleHeight + TEXT_GAP
-  const lowestTick = Math.min(...axis.tickValues)
-  const highestTick = Math.max(...axis.tickValues)
-  const tickWidths = axis.tickValues.flatMap((value) => {
-    // D3 places ticks at scale(value) + 0.5. The lowest label is bottom-aligned;
-    // all other labels are vertically centered using dy="0.32em".
-    const y = axis.scale(value) + 0.5
-    const isTopAligned = options.compact && value === highestTick
-    const top = y - (value === lowestTick ? TICK_FONT_SIZE : isTopAligned ? 0 : TICK_FONT_SIZE / 2)
-    const bottom =
-      value === lowestTick ? y : y + (isTopAligned ? TICK_FONT_SIZE : TICK_FONT_SIZE / 2)
-    if (bottom < titleTop || top > titleBottom) return []
+  // Reserve the widest tick, including extrema, regardless of the frame height.
+  // The layout formatter excludes scientific multipliers but retains the numeric label.
+  const tickWidths = axis.tickValues.map((value) => {
     const text = formatYAxisTickLayoutLabel(
       value,
       axis.scale.domain() as [number, number],
       axis.tickValues,
       options.showUnits === false ? undefined : series?.unit,
     )
-    return [options.measureTextWidth?.(text) ?? text.length * Y_AXIS_CHARACTER_WIDTH]
+    return options.measureTextWidth?.(text) ?? text.length * Y_AXIS_CHARACTER_WIDTH
   })
   // The title band leaves 4px beside each glyph.
   return (
@@ -72,7 +36,7 @@ function titleDistance(
 
 export function alignLeftYAxisTitles(
   layouts: TitleTrack[],
-  yLabel?: string,
+  _yLabel?: string,
   options: TitleLayoutOptions = {},
 ): void {
   const distances = new Map<string, number>()
@@ -81,11 +45,8 @@ export function alignLeftYAxisTitles(
     for (const axis of track.yAxes) {
       if (axis.side !== 'left') continue
       const key = `${track.column}:${leftIndex++}`
-      const distance = titleDistance(track, axis, yLabel, options)
-      // Compact slots already reserve every tick. Only move names inward, so
-      // alignment can never push them beyond the space reserved at the chart edge.
-      const boundedDistance = options.compact ? Math.min(axis.x - axis.labelX, distance) : distance
-      distances.set(key, Math.max(distances.get(key) ?? 0, boundedDistance))
+      const distance = titleDistance(axis, options)
+      distances.set(key, Math.max(distances.get(key) ?? 0, distance))
     }
   }
   for (const track of layouts) {

package/src/components/interaction/useExtremaTickViewport.ts

@@ -5,7 +5,7 @@ import type { TrackLayout } from '../core/types'
 
 /** Keep X coordinates stable when toggling extrema changes the reserved Y-label width. */
 export function useExtremaTickViewport(
-  visible: () => boolean,
+  visible: () => number,
   innerWidth: ComputedRef<number>,
   tracks: ComputedRef<TrackLayout[]>,
   sharedTransform: ShallowRef<ZoomTransform>,

package/src/demo/DemoYAxisPaddingControls.vue

@@ -24,9 +24,17 @@ const model = defineModel<DemoControlPanelModel>('model', { required: true })
         :aria-label="side === 'upper' ? '上方留白比例' : '下方留白比例'"
       />
     </div>
-    <div class="y-axis-padding-control extrema-control">
-      <span>显示最值刻度</span>
-      <Switch v-model:checked="model.extremaTicksVisible" size="small" aria-label="显示最值刻度" />
+    <div
+      v-for="side in ['maximum', 'minimum'] as const"
+      :key="side"
+      class="y-axis-padding-control extrema-control"
+    >
+      <span>{{ side === 'maximum' ? '显示最大值刻度' : '显示最小值刻度' }}</span>
+      <Switch
+        v-model:checked="model[`${side}TickVisible`]"
+        size="small"
+        :aria-label="side === 'maximum' ? '显示最大值刻度' : '显示最小值刻度'"
+      />
     </div>
     <small>仅作用于自动 Y 范围；刻度取整可能增加实际留白。</small>
   </section>

package/src/demo/types.ts

@@ -53,7 +53,8 @@ export interface DemoControlPanelModel {
   yAxisLineVisible: boolean
   upperPaddingEnabled: boolean
   lowerPaddingEnabled: boolean
-  extremaTicksVisible: boolean
+  maximumTickVisible: boolean
+  minimumTickVisible: boolean
   upperPaddingPercent: number
   lowerPaddingPercent: number
   xAxisLabelFormatterEnabled: boolean

package/src/index.ts

@@ -40,7 +40,7 @@ export type {
   WaveformXAxisLabelKind,
   WaveformXAxisLabelFormatterContext,
   WaveformXAxisLabelFormatter,
-  // Includes axes.y.extremaTicksVisible for independent extrema tick visibility.
+  // Includes axes.y.maximumTickVisible and minimumTickVisible for independent extrema ticks.
   WaveformAxesOptions,
   WaveformYAxisLabelTextStyle,
   WaveformZeroLineOptions,

package/src/types/chart.ts

@@ -289,8 +289,10 @@ export interface WaveformAxesOptions {
     splitNumber?: number
     /** Expands Y-axis domains to equal, human-friendly intervals. Defaults to true. */
     nice?: boolean
-    /** Shows extra ticks for the full data extrema, independently of padding. Defaults to true. */
-    extremaTicksVisible?: boolean
+    /** Shows the full data maximum's extra tick and label. Defaults to true. */
+    maximumTickVisible?: boolean
+    /** Shows the full data minimum's extra tick and label. Defaults to true. */
+    minimumTickVisible?: boolean
     /** Fraction of the automatic Y span added above its maximum. Defaults to 0. */
     upperPaddingRatio?: number
     /** Fraction of the automatic Y span added below its minimum. Defaults to 0. */