@visactor/vseed 0.4.25 → 0.4.27

package/dist/esm/pipeline/spec/chart/pipes/annotation/annotationDifferenceLineCommon.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline/spec/chart/pipes/annotation/annotationDifferenceLineCommon.js","sources":["../../../../../../../src/pipeline/spec/chart/pipes/annotation/annotationDifferenceLineCommon.ts"],"sourcesContent":["import type { IBarChartSpec, ICartesianSeries } from '@visactor/vchart'\nimport {\n  isDimensionSelector,\n  isFieldSelector,\n  isMeasureSelector,\n  isPartialDatumSelector,\n  isValueSelector,\n  selector,\n} from '../../../../../dataSelector'\nimport { hasMultipleMeasureInSingleView, isBarLikeChart } from 'src/pipeline/utils'\nimport type { AdvancedVSeed, Datum, Selector, Selectors, VSeed } from 'src/types'\nimport { isSubset } from './utils'\n\ntype DifferenceSelectorLabel = 'start' | 'end'\n\nexport type ResolvedDifferenceAnchor = {\n  selectorLabel: DifferenceSelectorLabel\n  coordinateDatum: Datum\n  matchedDatum?: Datum\n  stackGroupDatum?: Datum\n  value: number\n}\n\nconst toArray = <T>(value: T | T[] | undefined | null): T[] => {\n  if (Array.isArray(value)) {\n    return value\n  }\n\n  return value === undefined || value === null ? [] : [value]\n}\n\nconst getDifferenceBandFields = (spec: IBarChartSpec): string[] => {\n  return toArray((spec.direction === 'horizontal' ? spec.yField : spec.xField) as string | string[] | undefined)\n}\n\nconst getDifferenceValueField = (spec: IBarChartSpec): string => {\n  const valueField = toArray(\n    (spec.direction === 'horizontal' ? spec.xField : spec.yField) as string | string[] | undefined,\n  )[0]\n\n  if (!valueField) {\n    throw new Error('annotationDifferenceLine requires a value field in the target chart spec')\n  }\n\n  return valueField\n}\n\nconst normalizeDifferenceValue = (value: unknown, selectorLabel: DifferenceSelectorLabel, field: string): number => {\n  const numberValue = Number(value)\n\n  if (Number.isNaN(numberValue)) {\n    throw new Error(\n      `annotationDifferenceLine ${selectorLabel} selector resolved to a non-numeric value on field \"${field}\"`,\n    )\n  }\n\n  return numberValue\n}\n\nconst buildStackGroupDatum = (datum: Datum, bandFields: string[]) => {\n  return Object.fromEntries(bandFields.map((field) => [field, datum[field]])) as Datum\n}\n\nconst buildFallbackSelectorDatum = (selectorValue: Selector | Selectors): Datum | undefined => {\n  const selectorList = Array.isArray(selectorValue) ? selectorValue : [selectorValue]\n  const fallbackDatum: Datum = {}\n\n  for (const currentSelector of selectorList) {\n    if (isValueSelector(currentSelector) || isFieldSelector(currentSelector)) {\n      return undefined\n    }\n\n    if (isMeasureSelector(currentSelector)) {\n      const operator = currentSelector.operator || currentSelector.op\n      const selectorValues = Array.isArray(currentSelector.value) ? currentSelector.value : [currentSelector.value]\n\n      if (!['=', '=='].includes(operator as string) || selectorValues.length !== 1) {\n        return undefined\n      }\n\n      fallbackDatum[currentSelector.field] = selectorValues[0]\n      continue\n    }\n\n    if (isDimensionSelector(currentSelector)) {\n      const operator = currentSelector.operator || currentSelector.op\n      const selectorValues = Array.isArray(currentSelector.value) ? currentSelector.value : [currentSelector.value]\n\n      if (operator !== 'in' || selectorValues.length !== 1) {\n        return undefined\n      }\n\n      fallbackDatum[currentSelector.field] = selectorValues[0]\n      continue\n    }\n\n    if (isPartialDatumSelector(currentSelector)) {\n      Object.assign(fallbackDatum, currentSelector)\n      continue\n    }\n\n    return undefined\n  }\n\n  return Object.keys(fallbackDatum).length > 0 ? fallbackDatum : undefined\n}\n\nconst inferFallbackValue = (fallbackDatum: Datum, valueField: string, bandFields: string[]) => {\n  if (valueField in fallbackDatum) {\n    return fallbackDatum[valueField]\n  }\n\n  const numericCandidateKeys = Object.keys(fallbackDatum).filter((key) => {\n    if (key === valueField || bandFields.includes(key)) {\n      return false\n    }\n\n    return typeof fallbackDatum[key] === 'number'\n  })\n\n  if (numericCandidateKeys.length !== 1) {\n    return undefined\n  }\n\n  return fallbackDatum[numericCandidateKeys[0]]\n}\n\nconst resolveFallbackAnchor = (options: {\n  selectorLabel: DifferenceSelectorLabel\n  selectorValue: Selector | Selectors\n  valueField: string\n  bandFields: string[]\n}): ResolvedDifferenceAnchor | undefined => {\n  const { selectorLabel, selectorValue, valueField, bandFields } = options\n  const fallbackDatum = buildFallbackSelectorDatum(selectorValue)\n\n  if (!fallbackDatum) {\n    return undefined\n  }\n\n  const inferredValue = inferFallbackValue(fallbackDatum, valueField, bandFields)\n\n  if (inferredValue === undefined) {\n    return undefined\n  }\n\n  const coordinateDatum = {\n    ...fallbackDatum,\n    [valueField]: inferredValue,\n  }\n\n  try {\n    return {\n      selectorLabel,\n      coordinateDatum,\n      matchedDatum: fallbackDatum,\n      value: normalizeDifferenceValue(inferredValue, selectorLabel, valueField),\n    }\n  } catch {\n    return undefined\n  }\n}\n\nconst hasMixedSigns = (values: number[]) => {\n  const nonZeroValues = values.filter((value) => value !== 0)\n\n  return nonZeroValues.some((value) => value > 0) && nonZeroValues.some((value) => value < 0)\n}\n\nexport const isDifferenceLineStacked = (vseed: VSeed, advancedVSeed: AdvancedVSeed) => {\n  return (\n    (vseed.chartType === 'column' || vseed.chartType === 'bar') &&\n    hasMultipleMeasureInSingleView(advancedVSeed.reshapeMeasures ?? [])\n  )\n}\n\nexport const resolveDifferenceAnchor = (options: {\n  dataset: Datum[]\n  selectorLabel: DifferenceSelectorLabel\n  selectorValue: Selector | Selectors\n  spec: IBarChartSpec\n  isStacked: boolean\n}): ResolvedDifferenceAnchor | undefined => {\n  const { dataset, selectorLabel, selectorValue, spec, isStacked } = options\n  const matches = dataset.filter((datum) => selector(datum, selectorValue))\n  const valueField = getDifferenceValueField(spec)\n  const bandFields = getDifferenceBandFields(spec)\n\n  if (matches.length === 0) {\n    return isStacked ? undefined : resolveFallbackAnchor({ selectorLabel, selectorValue, valueField, bandFields })\n  }\n\n  if (!isStacked) {\n    if (matches.length !== 1) {\n      throw new Error(\n        `annotationDifferenceLine ${selectorLabel} selector must resolve to exactly one datum, got ${matches.length}`,\n      )\n    }\n\n    return {\n      selectorLabel,\n      coordinateDatum: matches[0],\n      matchedDatum: matches[0],\n      value: normalizeDifferenceValue(matches[0][valueField], selectorLabel, valueField),\n    }\n  }\n  const stackGroups = new Map<string, Datum>()\n\n  matches.forEach((datum) => {\n    const stackGroupDatum = buildStackGroupDatum(datum, bandFields)\n    stackGroups.set(JSON.stringify(stackGroupDatum), stackGroupDatum)\n  })\n\n  if (stackGroups.size !== 1) {\n    throw new Error(\n      `annotationDifferenceLine ${selectorLabel} selector must resolve to exactly one stack group, got ${stackGroups.size}`,\n    )\n  }\n\n  const stackGroupDatum = Array.from(stackGroups.values())[0]\n  const groupRows = dataset.filter((datum) => isSubset(stackGroupDatum, datum))\n  const groupValues = groupRows.map((datum) => normalizeDifferenceValue(datum[valueField], selectorLabel, valueField))\n\n  if (hasMixedSigns(groupValues)) {\n    throw new Error('annotationDifferenceLine does not support mixed-sign stack totals in v1')\n  }\n\n  return {\n    selectorLabel,\n    coordinateDatum: stackGroupDatum,\n    matchedDatum: matches[0],\n    stackGroupDatum,\n    value: groupValues.reduce((sum, value) => sum + value, 0),\n  }\n}\n\nexport const getStackRuntimeTotal = (runtimeMatches: Datum[]) => {\n  const stackEndValues = runtimeMatches.map((datum) => Number(datum.__VCHART_STACK_END))\n\n  if (stackEndValues.some((value) => Number.isNaN(value))) {\n    return undefined\n  }\n\n  if (hasMixedSigns(stackEndValues)) {\n    throw new Error('annotationDifferenceLine does not support mixed-sign runtime stack totals in v1')\n  }\n\n  return stackEndValues.some((value) => value < 0) ? Math.min(...stackEndValues) : Math.max(...stackEndValues)\n}\n\nexport const buildDifferenceCoordinateDatum = (options: {\n  anchor: ResolvedDifferenceAnchor\n  seriesData: Datum[]\n  relativeSeries: ICartesianSeries\n}) => {\n  const { anchor, seriesData, relativeSeries } = options\n\n  if (!anchor.stackGroupDatum) {\n    const runtimeMatches = anchor.matchedDatum\n      ? seriesData.filter((datum) => isSubset(anchor.matchedDatum as Datum, datum))\n      : []\n\n    return runtimeMatches[0] ?? anchor.coordinateDatum\n  }\n\n  const runtimeMatches = seriesData.filter((datum) => isSubset(anchor.stackGroupDatum as Datum, datum))\n  const runtimeStackTotal = getStackRuntimeTotal(runtimeMatches)\n\n  return {\n    ...(runtimeMatches[0] ?? anchor.coordinateDatum),\n    [relativeSeries.getStackValueField()]: runtimeStackTotal ?? anchor.value,\n  }\n}\n\nexport const buildDifferenceText = (\n  startValue: number,\n  endValue: number,\n  differenceType: 'absolute' | 'percent' = 'absolute',\n) => {\n  if (differenceType === 'percent') {\n    if (startValue === 0) {\n      throw new Error('annotationDifferenceLine percent difference cannot be computed because start value is 0')\n    }\n\n    return `${(((endValue - startValue) / startValue) * 100).toFixed(0)}%`\n  }\n\n  return `${endValue - startValue}`\n}\n\nexport const inferDifferenceConnectDirection = (vseed: VSeed, values: [number, number]) => {\n  const isNegativeSide = values.every((value) => value < 0)\n\n  if (isBarLikeChart(vseed)) {\n    return isNegativeSide ? 'left' : 'right'\n  }\n\n  return isNegativeSide ? 'bottom' : 'top'\n}\n"],"names":["toArray","value","Array","getDifferenceBandFields","spec","getDifferenceValueField","valueField","Error","normalizeDifferenceValue","selectorLabel","field","numberValue","Number","buildStackGroupDatum","datum","bandFields","Object","buildFallbackSelectorDatum","selectorValue","selectorList","fallbackDatum","currentSelector","isValueSelector","isFieldSelector","isMeasureSelector","operator","selectorValues","isDimensionSelector","isPartialDatumSelector","undefined","inferFallbackValue","numericCandidateKeys","key","resolveFallbackAnchor","options","inferredValue","coordinateDatum","hasMixedSigns","values","nonZeroValues","isDifferenceLineStacked","vseed","advancedVSeed","hasMultipleMeasureInSingleView","resolveDifferenceAnchor","dataset","isStacked","matches","selector","stackGroups","Map","stackGroupDatum","JSON","groupRows","isSubset","groupValues","sum","getStackRuntimeTotal","runtimeMatches","stackEndValues","Math","buildDifferenceCoordinateDatum","anchor","seriesData","relativeSeries","runtimeStackTotal","buildDifferenceText","startValue","endValue","differenceType","inferDifferenceConnectDirection","isNegativeSide","isBarLikeChart"],"mappings":"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"}
+{"version":3,"file":"pipeline/spec/chart/pipes/annotation/annotationDifferenceLineCommon.js","sources":["../../../../../../../src/pipeline/spec/chart/pipes/annotation/annotationDifferenceLineCommon.ts"],"sourcesContent":["import type { IAreaChartSpec, IBarChartSpec, ICartesianSeries, ILineChartSpec } from '@visactor/vchart'\nimport {\n  isDimensionSelector,\n  isFieldSelector,\n  isMeasureSelector,\n  isPartialDatumSelector,\n  isValueSelector,\n  selector,\n} from '../../../../../dataSelector'\nimport { hasMultipleMeasureInSingleView, isBarLikeChart } from 'src/pipeline/utils'\nimport type { AdvancedVSeed, Datum, Selector, Selectors, VSeed } from 'src/types'\nimport { isSubset } from './utils'\n\ntype DifferenceSelectorLabel = 'start' | 'end'\ntype DifferenceChartSpec = IBarChartSpec | ILineChartSpec | IAreaChartSpec\nexport type DifferenceStackResolveMode = 'none' | 'stackTotal' | 'auto'\nexport type DifferenceAnchorMode = 'element' | 'stackTotal'\n\nexport type ResolvedDifferenceAnchor = {\n  mode: DifferenceAnchorMode\n  selectorLabel: DifferenceSelectorLabel\n  coordinateDatum: Datum\n  matchedDatum?: Datum\n  stackGroupDatum?: Datum\n  bandDatum: Datum\n  bandIndex?: number\n  value: number\n}\n\nconst STACK_END_FIELD = '__VCHART_STACK_END'\n\nconst toArray = <T>(value: T | T[] | undefined | null): T[] => {\n  if (Array.isArray(value)) {\n    return value\n  }\n\n  return value === undefined || value === null ? [] : [value]\n}\n\nconst getDifferenceBandFields = (spec: DifferenceChartSpec): string[] => {\n  return toArray((spec.direction === 'horizontal' ? spec.yField : spec.xField) as string | string[] | undefined)\n}\n\nconst getDifferenceValueField = (spec: DifferenceChartSpec): string => {\n  const valueField = toArray(\n    (spec.direction === 'horizontal' ? spec.xField : spec.yField) as string | string[] | undefined,\n  )[0]\n\n  if (!valueField) {\n    throw new Error('annotationDifferenceLine requires a value field in the target chart spec')\n  }\n\n  return valueField\n}\n\nconst normalizeDifferenceValue = (value: unknown, selectorLabel: DifferenceSelectorLabel, field: string): number => {\n  const numberValue = Number(value)\n\n  if (Number.isNaN(numberValue)) {\n    throw new Error(\n      `annotationDifferenceLine ${selectorLabel} selector resolved to a non-numeric value on field \"${field}\"`,\n    )\n  }\n\n  return numberValue\n}\n\nconst buildStackGroupDatum = (datum: Datum, bandFields: string[]) => {\n  return Object.fromEntries(bandFields.map((field) => [field, datum[field]])) as Datum\n}\n\nconst resolveBandIndex = (dataset: Datum[], bandDatum: Datum) => {\n  const bandIndex = dataset.findIndex((datum) => isSubset(bandDatum, datum))\n\n  return bandIndex >= 0 ? bandIndex : undefined\n}\n\nconst buildFallbackSelectorDatum = (selectorValue: Selector | Selectors): Datum | undefined => {\n  const selectorList = Array.isArray(selectorValue) ? selectorValue : [selectorValue]\n  const fallbackDatum: Datum = {}\n\n  for (const currentSelector of selectorList) {\n    if (isValueSelector(currentSelector) || isFieldSelector(currentSelector)) {\n      return undefined\n    }\n\n    if (isMeasureSelector(currentSelector)) {\n      const operator = currentSelector.operator || currentSelector.op\n      const selectorValues = Array.isArray(currentSelector.value) ? currentSelector.value : [currentSelector.value]\n\n      if (!['=', '=='].includes(operator as string) || selectorValues.length !== 1) {\n        return undefined\n      }\n\n      fallbackDatum[currentSelector.field] = selectorValues[0]\n      continue\n    }\n\n    if (isDimensionSelector(currentSelector)) {\n      const operator = currentSelector.operator || currentSelector.op\n      const selectorValues = Array.isArray(currentSelector.value) ? currentSelector.value : [currentSelector.value]\n\n      if (operator !== 'in' || selectorValues.length !== 1) {\n        return undefined\n      }\n\n      fallbackDatum[currentSelector.field] = selectorValues[0]\n      continue\n    }\n\n    if (isPartialDatumSelector(currentSelector)) {\n      Object.assign(fallbackDatum, currentSelector)\n      continue\n    }\n\n    return undefined\n  }\n\n  return Object.keys(fallbackDatum).length > 0 ? fallbackDatum : undefined\n}\n\nconst inferFallbackValue = (fallbackDatum: Datum, valueField: string, bandFields: string[]) => {\n  if (valueField in fallbackDatum) {\n    return fallbackDatum[valueField]\n  }\n\n  const numericCandidateKeys = Object.keys(fallbackDatum).filter((key) => {\n    if (key === valueField || bandFields.includes(key)) {\n      return false\n    }\n\n    return typeof fallbackDatum[key] === 'number'\n  })\n\n  if (numericCandidateKeys.length !== 1) {\n    return undefined\n  }\n\n  return fallbackDatum[numericCandidateKeys[0]]\n}\n\nconst resolveFallbackAnchor = (options: {\n  dataset: Datum[]\n  selectorLabel: DifferenceSelectorLabel\n  selectorValue: Selector | Selectors\n  valueField: string\n  bandFields: string[]\n}): ResolvedDifferenceAnchor | undefined => {\n  const { dataset, selectorLabel, selectorValue, valueField, bandFields } = options\n  const fallbackDatum = buildFallbackSelectorDatum(selectorValue)\n\n  if (!fallbackDatum) {\n    return undefined\n  }\n\n  const inferredValue = inferFallbackValue(fallbackDatum, valueField, bandFields)\n\n  if (inferredValue === undefined) {\n    return undefined\n  }\n\n  const coordinateDatum = {\n    ...fallbackDatum,\n    [valueField]: inferredValue,\n  }\n  const bandDatum = buildStackGroupDatum(coordinateDatum, bandFields)\n\n  try {\n    return {\n      mode: 'element',\n      selectorLabel,\n      coordinateDatum,\n      matchedDatum: fallbackDatum,\n      bandDatum,\n      bandIndex: resolveBandIndex(dataset, bandDatum),\n      value: normalizeDifferenceValue(inferredValue, selectorLabel, valueField),\n    }\n  } catch {\n    return undefined\n  }\n}\n\nconst hasMixedSigns = (values: number[]) => {\n  const nonZeroValues = values.filter((value) => value !== 0)\n\n  return nonZeroValues.some((value) => value > 0) && nonZeroValues.some((value) => value < 0)\n}\n\nexport const getDifferenceLineStackResolveMode = (\n  vseed: VSeed,\n  advancedVSeed: AdvancedVSeed,\n): DifferenceStackResolveMode => {\n  const hasMultipleMeasure = hasMultipleMeasureInSingleView(advancedVSeed.reshapeMeasures ?? [])\n\n  if (!hasMultipleMeasure) {\n    return 'none'\n  }\n\n  if (vseed.chartType === 'column') {\n    return 'auto'\n  }\n\n  if (vseed.chartType === 'bar') {\n    return 'auto'\n  }\n\n  return 'none'\n}\n\nexport const usesDifferenceLineElementStackEnd = (vseed: VSeed, advancedVSeed: AdvancedVSeed) => {\n  return vseed.chartType === 'area' && hasMultipleMeasureInSingleView(advancedVSeed.reshapeMeasures ?? [])\n}\n\nexport const resolveDifferenceAnchor = (options: {\n  dataset: Datum[]\n  selectorLabel: DifferenceSelectorLabel\n  selectorValue: Selector | Selectors\n  spec: DifferenceChartSpec\n  stackResolveMode: DifferenceStackResolveMode\n  allowSelectorFallback?: boolean\n}): ResolvedDifferenceAnchor | undefined => {\n  const { dataset, selectorLabel, selectorValue, spec, stackResolveMode, allowSelectorFallback = true } = options\n  const matches = dataset.filter((datum) => selector(datum, selectorValue))\n  const valueField = getDifferenceValueField(spec)\n  const bandFields = getDifferenceBandFields(spec)\n\n  if (matches.length === 0) {\n    return stackResolveMode === 'none' && allowSelectorFallback\n      ? resolveFallbackAnchor({ dataset, selectorLabel, selectorValue, valueField, bandFields })\n      : undefined\n  }\n\n  if (stackResolveMode === 'none' || (stackResolveMode === 'auto' && matches.length === 1)) {\n    if (matches.length !== 1) {\n      throw new Error(\n        `annotationDifferenceLine ${selectorLabel} selector must resolve to exactly one datum, got ${matches.length}`,\n      )\n    }\n\n    const bandDatum = buildStackGroupDatum(matches[0], bandFields)\n\n    return {\n      mode: 'element',\n      selectorLabel,\n      coordinateDatum: matches[0],\n      matchedDatum: matches[0],\n      bandDatum,\n      bandIndex: resolveBandIndex(dataset, bandDatum),\n      value: normalizeDifferenceValue(matches[0][valueField], selectorLabel, valueField),\n    }\n  }\n  const stackGroups = new Map<string, Datum>()\n\n  matches.forEach((datum) => {\n    const stackGroupDatum = buildStackGroupDatum(datum, bandFields)\n    stackGroups.set(JSON.stringify(stackGroupDatum), stackGroupDatum)\n  })\n\n  if (stackGroups.size !== 1) {\n    throw new Error(\n      `annotationDifferenceLine ${selectorLabel} selector must resolve to exactly one stack group, got ${stackGroups.size}`,\n    )\n  }\n\n  const stackGroupDatum = Array.from(stackGroups.values())[0]\n  const groupRows = dataset.filter((datum) => isSubset(stackGroupDatum, datum))\n\n  if (stackResolveMode === 'auto' && groupRows.length !== matches.length) {\n    throw new Error(\n      `annotationDifferenceLine ${selectorLabel} selector must resolve to exactly one stack element or one full stack group`,\n    )\n  }\n  const groupValues = groupRows.map((datum) => normalizeDifferenceValue(datum[valueField], selectorLabel, valueField))\n\n  if (hasMixedSigns(groupValues)) {\n    throw new Error('annotationDifferenceLine does not support mixed-sign stack totals in v1')\n  }\n\n  return {\n    mode: 'stackTotal',\n    selectorLabel,\n    coordinateDatum: stackGroupDatum,\n    matchedDatum: matches[0],\n    stackGroupDatum,\n    bandDatum: stackGroupDatum,\n    bandIndex: resolveBandIndex(dataset, stackGroupDatum),\n    value: groupValues.reduce((sum, value) => sum + value, 0),\n  }\n}\n\nexport const getStackRuntimeTotal = (runtimeMatches: Datum[]) => {\n  if (runtimeMatches.length === 0) {\n    return undefined\n  }\n\n  const stackEndValues = runtimeMatches.map((datum) => Number(datum[STACK_END_FIELD]))\n\n  if (stackEndValues.some((value) => !Number.isFinite(value))) {\n    return undefined\n  }\n\n  if (hasMixedSigns(stackEndValues)) {\n    throw new Error('annotationDifferenceLine does not support mixed-sign runtime stack totals in v1')\n  }\n\n  return stackEndValues.some((value) => value < 0) ? Math.min(...stackEndValues) : Math.max(...stackEndValues)\n}\n\nexport const buildDifferenceCoordinateDatum = (options: {\n  anchor: ResolvedDifferenceAnchor\n  seriesData: Datum[]\n  relativeSeries: ICartesianSeries\n  useElementStackEnd?: boolean\n}) => {\n  const { anchor, seriesData, relativeSeries, useElementStackEnd = false } = options\n\n  if (!anchor.stackGroupDatum) {\n    const runtimeMatches = anchor.matchedDatum\n      ? seriesData.filter((datum) => isSubset(anchor.matchedDatum as Datum, datum))\n      : []\n\n    if (!useElementStackEnd) {\n      return runtimeMatches[0] ?? anchor.coordinateDatum\n    }\n\n    const runtimeMatch = runtimeMatches[0]\n    const runtimeStackEnd = Number(runtimeMatch?.[STACK_END_FIELD])\n\n    return {\n      ...(runtimeMatch ?? anchor.coordinateDatum),\n      [relativeSeries.getStackValueField()]: Number.isFinite(runtimeStackEnd) ? runtimeStackEnd : anchor.value,\n    }\n  }\n\n  const runtimeMatches = seriesData.filter((datum) => isSubset(anchor.stackGroupDatum as Datum, datum))\n  const runtimeStackTotal = getStackRuntimeTotal(runtimeMatches)\n\n  return {\n    ...(runtimeMatches[0] ?? anchor.coordinateDatum),\n    [relativeSeries.getStackValueField()]: runtimeStackTotal ?? anchor.value,\n  }\n}\n\nexport const getRuntimeDifferenceValue = (options: {\n  anchor: ResolvedDifferenceAnchor\n  seriesData: Datum[]\n  useElementStackEnd?: boolean\n}) => {\n  const { anchor, seriesData, useElementStackEnd = false } = options\n\n  if (anchor.stackGroupDatum) {\n    const runtimeMatches = seriesData.filter((datum) => isSubset(anchor.stackGroupDatum as Datum, datum))\n    return getStackRuntimeTotal(runtimeMatches) ?? anchor.value\n  }\n\n  if (!useElementStackEnd || !anchor.matchedDatum) {\n    return anchor.value\n  }\n\n  const runtimeMatch = seriesData.find((datum) => isSubset(anchor.matchedDatum as Datum, datum))\n  const runtimeStackEnd = Number(runtimeMatch?.[STACK_END_FIELD])\n\n  return Number.isFinite(runtimeStackEnd) ? runtimeStackEnd : anchor.value\n}\n\nexport const getDifferenceValue = (\n  startValue: number,\n  endValue: number,\n  differenceType: 'absolute' | 'percent' = 'absolute',\n) => {\n  if (differenceType === 'percent') {\n    if (startValue === 0) {\n      throw new Error('annotationDifferenceLine percent difference cannot be computed because start value is 0')\n    }\n\n    return (endValue - startValue) / startValue\n  }\n\n  return endValue - startValue\n}\n\nexport const buildDifferenceText = (\n  startValue: number,\n  endValue: number,\n  differenceType: 'absolute' | 'percent' = 'absolute',\n  formatter?: (value: number) => string,\n) => {\n  const differenceValue = getDifferenceValue(startValue, endValue, differenceType)\n\n  if (formatter) {\n    return formatter(differenceValue)\n  }\n\n  if (differenceType === 'percent') {\n    return `${(differenceValue * 100).toFixed(2)}%`\n  }\n\n  return `${differenceValue}`\n}\n\nexport const inferDifferenceConnectDirection = (vseed: VSeed, values: [number, number]) => {\n  const isNegativeSide = values.every((value) => value < 0)\n\n  if (isBarLikeChart(vseed)) {\n    return isNegativeSide ? 'left' : 'right'\n  }\n\n  return isNegativeSide ? 'bottom' : 'top'\n}\n\nexport const inferDifferenceBracketDirection = (\n  start: ResolvedDifferenceAnchor,\n  end: ResolvedDifferenceAnchor,\n): 'left' | 'right' => {\n  if (start.bandIndex === undefined || end.bandIndex === undefined) {\n    return 'right'\n  }\n\n  return start.bandIndex <= end.bandIndex ? 'right' : 'left'\n}\n"],"names":["STACK_END_FIELD","toArray","value","Array","getDifferenceBandFields","spec","getDifferenceValueField","valueField","Error","normalizeDifferenceValue","selectorLabel","field","numberValue","Number","buildStackGroupDatum","datum","bandFields","Object","resolveBandIndex","dataset","bandDatum","bandIndex","isSubset","undefined","buildFallbackSelectorDatum","selectorValue","selectorList","fallbackDatum","currentSelector","isValueSelector","isFieldSelector","isMeasureSelector","operator","selectorValues","isDimensionSelector","isPartialDatumSelector","inferFallbackValue","numericCandidateKeys","key","resolveFallbackAnchor","options","inferredValue","coordinateDatum","hasMixedSigns","values","nonZeroValues","getDifferenceLineStackResolveMode","vseed","advancedVSeed","hasMultipleMeasure","hasMultipleMeasureInSingleView","usesDifferenceLineElementStackEnd","resolveDifferenceAnchor","stackResolveMode","allowSelectorFallback","matches","selector","stackGroups","Map","stackGroupDatum","JSON","groupRows","groupValues","sum","getStackRuntimeTotal","runtimeMatches","stackEndValues","Math","buildDifferenceCoordinateDatum","anchor","seriesData","relativeSeries","useElementStackEnd","runtimeMatch","runtimeStackEnd","runtimeStackTotal","getRuntimeDifferenceValue","getDifferenceValue","startValue","endValue","differenceType","buildDifferenceText","formatter","differenceValue","inferDifferenceConnectDirection","isNegativeSide","isBarLikeChart","inferDifferenceBracketDirection","start","end"],"mappings":"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"}

package/dist/esm/pipeline/spec/chart/pipes/region/index.d.ts

@@ -1 +1,2 @@
 export * from './addRegionPadding';
+export * from './regionPadding';

package/dist/esm/pipeline/spec/chart/pipes/region/index.js

@@ -1 +1,2 @@
 export * from "./addRegionPadding.js";
+export * from "./regionPadding.js";

package/dist/esm/pipeline/spec/chart/pipes/region/regionPadding.d.ts

@@ -0,0 +1,2 @@
+import type { VChartSpecPipe } from '../../../../../types';
+export declare const regionPadding: VChartSpecPipe;

package/dist/esm/pipeline/spec/chart/pipes/region/regionPadding.js

@@ -0,0 +1,20 @@
+const regionPadding = (spec, context)=>{
+    const chartConfig = context.advancedVSeed.config?.[context.vseed.chartType];
+    const padding = chartConfig?.regionPadding;
+    if (null == padding || !Array.isArray(spec.region)) return spec;
+    const region = spec.region;
+    if (0 === region.length) return spec;
+    return {
+        ...spec,
+        region: [
+            {
+                ...region[0],
+                padding
+            },
+            ...region.slice(1)
+        ]
+    };
+};
+export { regionPadding };
+
+//# sourceMappingURL=regionPadding.js.map

package/dist/esm/pipeline/spec/chart/pipes/region/regionPadding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline/spec/chart/pipes/region/regionPadding.js","sources":["../../../../../../../src/pipeline/spec/chart/pipes/region/regionPadding.ts"],"sourcesContent":["import type { RegionPadding, VChartSpecPipe } from 'src/types'\n\ntype RegionPaddingConfig = {\n  regionPadding?: RegionPadding\n}\n\nexport const regionPadding: VChartSpecPipe = (spec, context) => {\n  const chartConfig = context.advancedVSeed.config?.[context.vseed.chartType] as RegionPaddingConfig | undefined\n  const padding = chartConfig?.regionPadding\n\n  if (padding == null || !Array.isArray((spec as { region?: unknown }).region)) {\n    return spec\n  }\n\n  const region = (spec as { region: Array<Record<string, unknown>> }).region\n  if (region.length === 0) {\n    return spec\n  }\n\n  return {\n    ...spec,\n    region: [\n      {\n        ...region[0],\n        padding,\n      },\n      ...region.slice(1),\n    ],\n  }\n}\n"],"names":["regionPadding","spec","context","chartConfig","padding","Array","region"],"mappings":"AAMO,MAAMA,gBAAgC,CAACC,MAAMC;IAClD,MAAMC,cAAcD,QAAQ,aAAa,CAAC,MAAM,EAAE,CAACA,QAAQ,KAAK,CAAC,SAAS,CAAC;IAC3E,MAAME,UAAUD,aAAa;IAE7B,IAAIC,AAAW,QAAXA,WAAmB,CAACC,MAAM,OAAO,CAAEJ,KAA8B,MAAM,GACzE,OAAOA;IAGT,MAAMK,SAAUL,KAAoD,MAAM;IAC1E,IAAIK,AAAkB,MAAlBA,OAAO,MAAM,EACf,OAAOL;IAGT,OAAO;QACL,GAAGA,IAAI;QACP,QAAQ;YACN;gBACE,GAAGK,MAAM,CAAC,EAAE;gBACZF;YACF;eACGE,OAAO,KAAK,CAAC;SACjB;IACH;AACF"}

package/dist/esm/types/chartType/area/area.d.ts

@@ -1,5 +1,5 @@
 import type { Locale } from '../../i18n';
-import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, AreaStyle, BackgroundColor, Brush, Color, Dataset, Label, Legend, LineStyle, PointStyle, Theme, Tooltip, XBandAxis, YLinearAxis, CrosshairLine, Sort, SortLegend, DimensionLinkage, ColumnDimension, ColumnMeasure, Page } from '../../properties';
+import type { AnnotationArea, AnnotationDifferenceLine, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, AreaStyle, BackgroundColor, Brush, Color, Dataset, Label, Legend, LineStyle, PointStyle, Theme, Tooltip, XBandAxis, YLinearAxis, CrosshairLine, Sort, SortLegend, DimensionLinkage, ColumnDimension, ColumnMeasure, Page, RegionPadding } from '../../properties';
 /**
  * @recommend
  * - 推荐字段配置: `1`个指标, `2`个维度
@@ -85,6 +85,11 @@ export interface Area {
      * @description 图例配置, 用于定义图表的图例, 包括图例的位置, 格式, 样式等.
      */
     legend?: Legend;
+    /**
+     * 绘图区内边距
+     * @description 映射到 VChart 的 region[0].padding，用于为标注、标签等绘图区外扩元素预留空间。
+     */
+    regionPadding?: RegionPadding;
     /**
      * 提示信息
      * @description 提示信息配置, 用于定义图表的提示信息, 包括提示信息的位置, 格式, 样式等.
@@ -184,6 +189,11 @@ export interface Area {
      * @description 标注区域配置, 根据选择的数据, 定义图表的标注区域, 包括标注区域的位置, 样式等.
      */
     annotationArea?: AnnotationArea | AnnotationArea[];
+    /**
+     * 差异标注线
+     * @description 根据两个选中的数据点，绘制差异标注线并自动计算差异文本。
+     */
+    annotationDifferenceLine?: AnnotationDifferenceLine | AnnotationDifferenceLine[];
     /**
      * @description 当图表开启透视功能或者指标组合的是否，是否开启维度联动功能
      * 当hover 到某个维度值时，联动高亮其他图表中相同维度值的数据

package/dist/esm/types/chartType/area/zArea.d.ts

@@ -422,6 +422,12 @@ export declare const zArea: z.ZodObject<{
         labelFontSize: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         labelFontWeight: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>>;
     }, z.core.$strip>>>;
+    regionPadding: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodObject<{
+        top: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+        right: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+        bottom: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+        left: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    }, z.core.$strip>]>>>;
     tooltip: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         enable: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodBoolean>>>;
         borderColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -2357,6 +2363,309 @@ export declare const zArea: z.ZodObject<{
         areaLineDash: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNumber>>>;
         outerPadding: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
     }, z.core.$strip>]>>>;
+    annotationDifferenceLine: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodArray<z.ZodObject<{
+        start: z.ZodObject<{
+            selector: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>, z.ZodObject<{
+                field: z.ZodString;
+                operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    "=": "=";
+                    "==": "==";
+                    "!=": "!=";
+                    ">": ">";
+                    "<": "<";
+                    ">=": ">=";
+                    "<=": "<=";
+                    between: "between";
+                }>>>;
+                op: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    "=": "=";
+                    "==": "==";
+                    "!=": "!=";
+                    ">": ">";
+                    "<": "<";
+                    ">=": ">=";
+                    "<=": "<=";
+                    between: "between";
+                }>>>;
+                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
+            }, z.core.$strip>, z.ZodObject<{
+                field: z.ZodString;
+                operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    in: "in";
+                    "not in": "not in";
+                }>>>;
+                op: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    in: "in";
+                    "not in": "not in";
+                }>>>;
+                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
+            }, z.core.$strip>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>, z.ZodObject<{
+                field: z.ZodString;
+                operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    "=": "=";
+                    "==": "==";
+                    "!=": "!=";
+                    ">": ">";
+                    "<": "<";
+                    ">=": ">=";
+                    "<=": "<=";
+                    between: "between";
+                }>>>;
+                op: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    "=": "=";
+                    "==": "==";
+                    "!=": "!=";
+                    ">": ">";
+                    "<": "<";
+                    ">=": ">=";
+                    "<=": "<=";
+                    between: "between";
+                }>>>;
+                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
+            }, z.core.$strip>, z.ZodObject<{
+                field: z.ZodString;
+                operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    in: "in";
+                    "not in": "not in";
+                }>>>;
+                op: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    in: "in";
+                    "not in": "not in";
+                }>>>;
+                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
+            }, z.core.$strip>]>>]>;
+        }, z.core.$strip>;
+        end: z.ZodObject<{
+            selector: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>, z.ZodObject<{
+                field: z.ZodString;
+                operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    "=": "=";
+                    "==": "==";
+                    "!=": "!=";
+                    ">": ">";
+                    "<": "<";
+                    ">=": ">=";
+                    "<=": "<=";
+                    between: "between";
+                }>>>;
+                op: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    "=": "=";
+                    "==": "==";
+                    "!=": "!=";
+                    ">": ">";
+                    "<": "<";
+                    ">=": ">=";
+                    "<=": "<=";
+                    between: "between";
+                }>>>;
+                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
+            }, z.core.$strip>, z.ZodObject<{
+                field: z.ZodString;
+                operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    in: "in";
+                    "not in": "not in";
+                }>>>;
+                op: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    in: "in";
+                    "not in": "not in";
+                }>>>;
+                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
+            }, z.core.$strip>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>, z.ZodObject<{
+                field: z.ZodString;
+                operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    "=": "=";
+                    "==": "==";
+                    "!=": "!=";
+                    ">": ">";
+                    "<": "<";
+                    ">=": ">=";
+                    "<=": "<=";
+                    between: "between";
+                }>>>;
+                op: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    "=": "=";
+                    "==": "==";
+                    "!=": "!=";
+                    ">": ">";
+                    "<": "<";
+                    ">=": ">=";
+                    "<=": "<=";
+                    between: "between";
+                }>>>;
+                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
+            }, z.core.$strip>, z.ZodObject<{
+                field: z.ZodString;
+                operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    in: "in";
+                    "not in": "not in";
+                }>>>;
+                op: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    in: "in";
+                    "not in": "not in";
+                }>>>;
+                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
+            }, z.core.$strip>]>>]>;
+        }, z.core.$strip>;
+        differenceType: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            percent: "percent";
+            absolute: "absolute";
+        }>>>;
+        textFontSize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        textColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        textBackgroundColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        lineColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>, z.ZodObject<{
+        start: z.ZodObject<{
+            selector: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>, z.ZodObject<{
+                field: z.ZodString;
+                operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    "=": "=";
+                    "==": "==";
+                    "!=": "!=";
+                    ">": ">";
+                    "<": "<";
+                    ">=": ">=";
+                    "<=": "<=";
+                    between: "between";
+                }>>>;
+                op: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    "=": "=";
+                    "==": "==";
+                    "!=": "!=";
+                    ">": ">";
+                    "<": "<";
+                    ">=": ">=";
+                    "<=": "<=";
+                    between: "between";
+                }>>>;
+                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
+            }, z.core.$strip>, z.ZodObject<{
+                field: z.ZodString;
+                operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    in: "in";
+                    "not in": "not in";
+                }>>>;
+                op: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    in: "in";
+                    "not in": "not in";
+                }>>>;
+                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
+            }, z.core.$strip>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>, z.ZodObject<{
+                field: z.ZodString;
+                operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    "=": "=";
+                    "==": "==";
+                    "!=": "!=";
+                    ">": ">";
+                    "<": "<";
+                    ">=": ">=";
+                    "<=": "<=";
+                    between: "between";
+                }>>>;
+                op: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    "=": "=";
+                    "==": "==";
+                    "!=": "!=";
+                    ">": ">";
+                    "<": "<";
+                    ">=": ">=";
+                    "<=": "<=";
+                    between: "between";
+                }>>>;
+                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
+            }, z.core.$strip>, z.ZodObject<{
+                field: z.ZodString;
+                operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    in: "in";
+                    "not in": "not in";
+                }>>>;
+                op: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    in: "in";
+                    "not in": "not in";
+                }>>>;
+                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
+            }, z.core.$strip>]>>]>;
+        }, z.core.$strip>;
+        end: z.ZodObject<{
+            selector: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>, z.ZodObject<{
+                field: z.ZodString;
+                operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    "=": "=";
+                    "==": "==";
+                    "!=": "!=";
+                    ">": ">";
+                    "<": "<";
+                    ">=": ">=";
+                    "<=": "<=";
+                    between: "between";
+                }>>>;
+                op: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    "=": "=";
+                    "==": "==";
+                    "!=": "!=";
+                    ">": ">";
+                    "<": "<";
+                    ">=": ">=";
+                    "<=": "<=";
+                    between: "between";
+                }>>>;
+                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
+            }, z.core.$strip>, z.ZodObject<{
+                field: z.ZodString;
+                operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    in: "in";
+                    "not in": "not in";
+                }>>>;
+                op: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    in: "in";
+                    "not in": "not in";
+                }>>>;
+                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
+            }, z.core.$strip>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>, z.ZodObject<{
+                field: z.ZodString;
+                operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    "=": "=";
+                    "==": "==";
+                    "!=": "!=";
+                    ">": ">";
+                    "<": "<";
+                    ">=": ">=";
+                    "<=": "<=";
+                    between: "between";
+                }>>>;
+                op: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    "=": "=";
+                    "==": "==";
+                    "!=": "!=";
+                    ">": ">";
+                    "<": "<";
+                    ">=": ">=";
+                    "<=": "<=";
+                    between: "between";
+                }>>>;
+                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
+            }, z.core.$strip>, z.ZodObject<{
+                field: z.ZodString;
+                operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    in: "in";
+                    "not in": "not in";
+                }>>>;
+                op: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    in: "in";
+                    "not in": "not in";
+                }>>>;
+                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
+            }, z.core.$strip>]>>]>;
+        }, z.core.$strip>;
+        differenceType: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            percent: "percent";
+            absolute: "absolute";
+        }>>>;
+        textFontSize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        textColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        textBackgroundColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        lineColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>]>>>;
     dimensionLinkage: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         enable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         showTooltip: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;

package/dist/esm/types/chartType/area/zArea.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { zLocale } from "../../i18n/index.js";
-import { zAnnotationArea, zAnnotationHorizontalLine, zAnnotationPoint, zAnnotationVerticalLine, zAreaStyle, zBackgroundColor, zBrush, zColor, zCrosshairLine, zDataset, zDimensionLinkage, zDimensions, zEncoding, zLabel, zLegend, zLineStyle, zMeasures, zPage, zPointStyle, zTheme, zTooltip, zXBandAxis, zYLinearAxis } from "../../properties/index.js";
+import { zAnnotationArea, zAnnotationDifferenceLine, zAnnotationHorizontalLine, zAnnotationPoint, zAnnotationVerticalLine, zAreaStyle, zBackgroundColor, zBrush, zColor, zCrosshairLine, zDataset, zDimensionLinkage, zDimensions, zEncoding, zLabel, zLegend, zLineStyle, zMeasures, zPage, zPointStyle, zRegionPadding, zTheme, zTooltip, zXBandAxis, zYLinearAxis } from "../../properties/index.js";
 const zArea = z.object({
     chartType: z.literal('area'),
     dataset: zDataset.nullish(),
@@ -12,6 +12,7 @@ const zArea = z.object({
     color: zColor.nullish(),
     label: zLabel.nullish(),
     legend: zLegend.nullish(),
+    regionPadding: zRegionPadding.nullish(),
     tooltip: zTooltip.nullish(),
     brush: zBrush.nullish(),
     xAxis: zXBandAxis.nullish(),
@@ -25,6 +26,7 @@ const zArea = z.object({
     annotationVerticalLine: z.array(zAnnotationVerticalLine).or(zAnnotationVerticalLine).nullish(),
     annotationHorizontalLine: z.array(zAnnotationHorizontalLine).or(zAnnotationHorizontalLine).nullish(),
     annotationArea: z.array(zAnnotationArea).or(zAnnotationArea).nullish(),
+    annotationDifferenceLine: z.array(zAnnotationDifferenceLine).or(zAnnotationDifferenceLine).nullish(),
     dimensionLinkage: zDimensionLinkage.nullish(),
     locale: zLocale.nullish()
 });

package/dist/esm/types/chartType/area/zArea.js.map

@@ -1 +1 @@
-{"version":3,"file":"types/chartType/area/zArea.js","sources":["../../../../../src/types/chartType/area/zArea.ts"],"sourcesContent":["import { z } from 'zod'\nimport { zLocale } from '../../i18n'\nimport {\n  zAnnotationArea,\n  zAnnotationHorizontalLine,\n  zAnnotationPoint,\n  zAnnotationVerticalLine,\n  zAreaStyle,\n  zBackgroundColor,\n  zColor,\n  zCrosshairLine,\n  zDataset,\n  zDimensionLinkage,\n  zDimensions,\n  zEncoding,\n  zLabel,\n  zLegend,\n  zLineStyle,\n  zMeasures,\n  zPointStyle,\n  zTheme,\n  zTooltip,\n  zBrush,\n  zXBandAxis,\n  zYLinearAxis,\n  zPage,\n} from '../../properties'\n\nexport const zArea = z.object({\n  chartType: z.literal('area'),\n  dataset: zDataset.nullish(),\n  encoding: zEncoding.nullish(),\n  dimensions: zDimensions.nullish(),\n  measures: zMeasures.nullish(),\n  page: zPage.nullish(),\n\n  backgroundColor: zBackgroundColor.nullish(),\n  color: zColor.nullish(),\n  label: zLabel.nullish(),\n  legend: zLegend.nullish(),\n  tooltip: zTooltip.nullish(),\n  brush: zBrush.nullish(),\n  xAxis: zXBandAxis.nullish(),\n  yAxis: zYLinearAxis.nullish(),\n  crosshairLine: zCrosshairLine.nullish(),\n  theme: zTheme.nullish(),\n  pointStyle: z.array(zPointStyle).or(zPointStyle).nullish(),\n  lineStyle: z.array(zLineStyle).or(zLineStyle).nullish(),\n  areaStyle: z.array(zAreaStyle).or(zAreaStyle).nullish(),\n  annotationPoint: z.array(zAnnotationPoint).or(zAnnotationPoint).nullish(),\n  annotationVerticalLine: z.array(zAnnotationVerticalLine).or(zAnnotationVerticalLine).nullish(),\n  annotationHorizontalLine: z.array(zAnnotationHorizontalLine).or(zAnnotationHorizontalLine).nullish(),\n  annotationArea: z.array(zAnnotationArea).or(zAnnotationArea).nullish(),\n  dimensionLinkage: zDimensionLinkage.nullish(),\n  locale: zLocale.nullish(),\n})\n"],"names":["zArea","z","zDataset","zEncoding","zDimensions","zMeasures","zPage","zBackgroundColor","zColor","zLabel","zLegend","zTooltip","zBrush","zXBandAxis","zYLinearAxis","zCrosshairLine","zTheme","zPointStyle","zLineStyle","zAreaStyle","zAnnotationPoint","zAnnotationVerticalLine","zAnnotationHorizontalLine","zAnnotationArea","zDimensionLinkage","zLocale"],"mappings":";;;AA4BO,MAAMA,QAAQC,EAAE,MAAM,CAAC;IAC5B,WAAWA,EAAE,OAAO,CAAC;IACrB,SAASC,SAAS,OAAO;IACzB,UAAUC,UAAU,OAAO;IAC3B,YAAYC,YAAY,OAAO;IAC/B,UAAUC,UAAU,OAAO;IAC3B,MAAMC,MAAM,OAAO;IAEnB,iBAAiBC,iBAAiB,OAAO;IACzC,OAAOC,OAAO,OAAO;IACrB,OAAOC,OAAO,OAAO;IACrB,QAAQC,QAAQ,OAAO;IACvB,SAASC,SAAS,OAAO;IACzB,OAAOC,OAAO,OAAO;IACrB,OAAOC,WAAW,OAAO;IACzB,OAAOC,aAAa,OAAO;IAC3B,eAAeC,eAAe,OAAO;IACrC,OAAOC,OAAO,OAAO;IACrB,YAAYf,EAAE,KAAK,CAACgB,aAAa,EAAE,CAACA,aAAa,OAAO;IACxD,WAAWhB,EAAE,KAAK,CAACiB,YAAY,EAAE,CAACA,YAAY,OAAO;IACrD,WAAWjB,EAAE,KAAK,CAACkB,YAAY,EAAE,CAACA,YAAY,OAAO;IACrD,iBAAiBlB,EAAE,KAAK,CAACmB,kBAAkB,EAAE,CAACA,kBAAkB,OAAO;IACvE,wBAAwBnB,EAAE,KAAK,CAACoB,yBAAyB,EAAE,CAACA,yBAAyB,OAAO;IAC5F,0BAA0BpB,EAAE,KAAK,CAACqB,2BAA2B,EAAE,CAACA,2BAA2B,OAAO;IAClG,gBAAgBrB,EAAE,KAAK,CAACsB,iBAAiB,EAAE,CAACA,iBAAiB,OAAO;IACpE,kBAAkBC,kBAAkB,OAAO;IAC3C,QAAQC,QAAQ,OAAO;AACzB"}
+{"version":3,"file":"types/chartType/area/zArea.js","sources":["../../../../../src/types/chartType/area/zArea.ts"],"sourcesContent":["import { z } from 'zod'\nimport { zLocale } from '../../i18n'\nimport {\n  zAnnotationArea,\n  zAnnotationDifferenceLine,\n  zAnnotationHorizontalLine,\n  zAnnotationPoint,\n  zAnnotationVerticalLine,\n  zAreaStyle,\n  zBackgroundColor,\n  zColor,\n  zCrosshairLine,\n  zDataset,\n  zDimensionLinkage,\n  zDimensions,\n  zEncoding,\n  zLabel,\n  zLegend,\n  zLineStyle,\n  zMeasures,\n  zPointStyle,\n  zRegionPadding,\n  zTheme,\n  zTooltip,\n  zBrush,\n  zXBandAxis,\n  zYLinearAxis,\n  zPage,\n} from '../../properties'\n\nexport const zArea = z.object({\n  chartType: z.literal('area'),\n  dataset: zDataset.nullish(),\n  encoding: zEncoding.nullish(),\n  dimensions: zDimensions.nullish(),\n  measures: zMeasures.nullish(),\n  page: zPage.nullish(),\n\n  backgroundColor: zBackgroundColor.nullish(),\n  color: zColor.nullish(),\n  label: zLabel.nullish(),\n  legend: zLegend.nullish(),\n  regionPadding: zRegionPadding.nullish(),\n  tooltip: zTooltip.nullish(),\n  brush: zBrush.nullish(),\n  xAxis: zXBandAxis.nullish(),\n  yAxis: zYLinearAxis.nullish(),\n  crosshairLine: zCrosshairLine.nullish(),\n  theme: zTheme.nullish(),\n  pointStyle: z.array(zPointStyle).or(zPointStyle).nullish(),\n  lineStyle: z.array(zLineStyle).or(zLineStyle).nullish(),\n  areaStyle: z.array(zAreaStyle).or(zAreaStyle).nullish(),\n  annotationPoint: z.array(zAnnotationPoint).or(zAnnotationPoint).nullish(),\n  annotationVerticalLine: z.array(zAnnotationVerticalLine).or(zAnnotationVerticalLine).nullish(),\n  annotationHorizontalLine: z.array(zAnnotationHorizontalLine).or(zAnnotationHorizontalLine).nullish(),\n  annotationArea: z.array(zAnnotationArea).or(zAnnotationArea).nullish(),\n  annotationDifferenceLine: z.array(zAnnotationDifferenceLine).or(zAnnotationDifferenceLine).nullish(),\n  dimensionLinkage: zDimensionLinkage.nullish(),\n  locale: zLocale.nullish(),\n})\n"],"names":["zArea","z","zDataset","zEncoding","zDimensions","zMeasures","zPage","zBackgroundColor","zColor","zLabel","zLegend","zRegionPadding","zTooltip","zBrush","zXBandAxis","zYLinearAxis","zCrosshairLine","zTheme","zPointStyle","zLineStyle","zAreaStyle","zAnnotationPoint","zAnnotationVerticalLine","zAnnotationHorizontalLine","zAnnotationArea","zAnnotationDifferenceLine","zDimensionLinkage","zLocale"],"mappings":";;;AA8BO,MAAMA,QAAQC,EAAE,MAAM,CAAC;IAC5B,WAAWA,EAAE,OAAO,CAAC;IACrB,SAASC,SAAS,OAAO;IACzB,UAAUC,UAAU,OAAO;IAC3B,YAAYC,YAAY,OAAO;IAC/B,UAAUC,UAAU,OAAO;IAC3B,MAAMC,MAAM,OAAO;IAEnB,iBAAiBC,iBAAiB,OAAO;IACzC,OAAOC,OAAO,OAAO;IACrB,OAAOC,OAAO,OAAO;IACrB,QAAQC,QAAQ,OAAO;IACvB,eAAeC,eAAe,OAAO;IACrC,SAASC,SAAS,OAAO;IACzB,OAAOC,OAAO,OAAO;IACrB,OAAOC,WAAW,OAAO;IACzB,OAAOC,aAAa,OAAO;IAC3B,eAAeC,eAAe,OAAO;IACrC,OAAOC,OAAO,OAAO;IACrB,YAAYhB,EAAE,KAAK,CAACiB,aAAa,EAAE,CAACA,aAAa,OAAO;IACxD,WAAWjB,EAAE,KAAK,CAACkB,YAAY,EAAE,CAACA,YAAY,OAAO;IACrD,WAAWlB,EAAE,KAAK,CAACmB,YAAY,EAAE,CAACA,YAAY,OAAO;IACrD,iBAAiBnB,EAAE,KAAK,CAACoB,kBAAkB,EAAE,CAACA,kBAAkB,OAAO;IACvE,wBAAwBpB,EAAE,KAAK,CAACqB,yBAAyB,EAAE,CAACA,yBAAyB,OAAO;IAC5F,0BAA0BrB,EAAE,KAAK,CAACsB,2BAA2B,EAAE,CAACA,2BAA2B,OAAO;IAClG,gBAAgBtB,EAAE,KAAK,CAACuB,iBAAiB,EAAE,CAACA,iBAAiB,OAAO;IACpE,0BAA0BvB,EAAE,KAAK,CAACwB,2BAA2B,EAAE,CAACA,2BAA2B,OAAO;IAClG,kBAAkBC,kBAAkB,OAAO;IAC3C,QAAQC,QAAQ,OAAO;AACzB"}

package/dist/esm/types/chartType/areaPercent/areaPercent.d.ts

@@ -1,5 +1,5 @@
 import type { Locale } from '../../i18n';
-import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, AreaStyle, BackgroundColor, Brush, Color, Dataset, Label, Legend, LineStyle, PointStyle, Theme, Tooltip, XBandAxis, YLinearAxis, CrosshairLine, Sort, SortLegend, DimensionLinkage, ColumnDimension, ColumnMeasure, Page } from '../../properties';
+import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, AreaStyle, BackgroundColor, Brush, Color, Dataset, Label, Legend, LineStyle, PointStyle, Theme, Tooltip, XBandAxis, YLinearAxis, CrosshairLine, Sort, SortLegend, DimensionLinkage, ColumnDimension, ColumnMeasure, Page, RegionPadding } from '../../properties';
 /**
  * @description 百分比面积图，适用于展示多类别占比随时间变化的趋势，Y轴以百分比形式展示占比关系
  * 适用场景:
@@ -77,6 +77,11 @@ export interface AreaPercent {
      * @description 图例配置, 用于定义图表的图例, 包括图例的位置, 格式, 样式等.
      */
     legend?: Legend;
+    /**
+     * 绘图区内边距
+     * @description 映射到 VChart 的 region[0].padding，用于为标注、标签等绘图区外扩元素预留空间。
+     */
+    regionPadding?: RegionPadding;
     /**
      * 提示信息
      * @description 提示信息配置, 用于定义图表的提示信息, 包括提示信息的位置, 格式, 样式等.

package/dist/esm/types/chartType/areaPercent/zAreaPercent.d.ts

@@ -422,6 +422,12 @@ export declare const zAreaPercent: z.ZodObject<{
         labelFontSize: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         labelFontWeight: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>>;
     }, z.core.$strip>>>;
+    regionPadding: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodObject<{
+        top: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+        right: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+        bottom: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+        left: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    }, z.core.$strip>]>>>;
     tooltip: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         enable: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodBoolean>>>;
         borderColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/esm/types/chartType/areaPercent/zAreaPercent.js

@@ -1,5 +1,5 @@
 import { zLocale } from "../../i18n/index.js";
-import { zAnnotationArea, zAnnotationHorizontalLine, zAnnotationPoint, zAnnotationVerticalLine, zAreaStyle, zBackgroundColor, zBrush, zColor, zCrosshairLine, zDataset, zDimensionLinkage, zDimensions, zEncoding, zLabel, zLegend, zLineStyle, zMeasures, zPage, zPointStyle, zTheme, zTooltip, zXBandAxis, zYLinearAxis } from "../../properties/index.js";
+import { zAnnotationArea, zAnnotationHorizontalLine, zAnnotationPoint, zAnnotationVerticalLine, zAreaStyle, zBackgroundColor, zBrush, zColor, zCrosshairLine, zDataset, zDimensionLinkage, zDimensions, zEncoding, zLabel, zLegend, zLineStyle, zMeasures, zPage, zPointStyle, zRegionPadding, zTheme, zTooltip, zXBandAxis, zYLinearAxis } from "../../properties/index.js";
 import { z } from "zod";
 const zAreaPercent = z.object({
     chartType: z.literal('areaPercent'),
@@ -12,6 +12,7 @@ const zAreaPercent = z.object({
     color: zColor.nullish(),
     label: zLabel.nullish(),
     legend: zLegend.nullish(),
+    regionPadding: zRegionPadding.nullish(),
     tooltip: zTooltip.nullish(),
     brush: zBrush.nullish(),
     xAxis: zXBandAxis.nullish(),

package/dist/esm/types/chartType/areaPercent/zAreaPercent.js.map

@@ -1 +1 @@
-{"version":3,"file":"types/chartType/areaPercent/zAreaPercent.js","sources":["../../../../../src/types/chartType/areaPercent/zAreaPercent.ts"],"sourcesContent":["import { zLocale } from '../../i18n'\nimport {\n  zAnnotationArea,\n  zAnnotationHorizontalLine,\n  zAnnotationPoint,\n  zAnnotationVerticalLine,\n  zAreaStyle,\n  zBackgroundColor,\n  zColor,\n  zCrosshairLine,\n  zDataset,\n  zDimensionLinkage,\n  zDimensions,\n  zEncoding,\n  zLabel,\n  zLegend,\n  zLineStyle,\n  zMeasures,\n  zPointStyle,\n  zTheme,\n  zTooltip,\n  zBrush,\n  zXBandAxis,\n  zYLinearAxis,\n  zPage,\n} from '../../properties'\n\nimport { z } from 'zod'\n\nexport const zAreaPercent = z.object({\n  chartType: z.literal('areaPercent'),\n  dataset: zDataset.nullish(),\n  encoding: zEncoding.nullish(),\n  dimensions: zDimensions.nullish(),\n  measures: zMeasures.nullish(),\n  page: zPage.nullish(),\n\n  backgroundColor: zBackgroundColor.nullish(),\n  color: zColor.nullish(),\n  label: zLabel.nullish(),\n  legend: zLegend.nullish(),\n  tooltip: zTooltip.nullish(),\n  brush: zBrush.nullish(),\n  xAxis: zXBandAxis.nullish(),\n  yAxis: zYLinearAxis.nullish(),\n  crosshairLine: zCrosshairLine.nullish(),\n  theme: zTheme.nullish(),\n  pointStyle: z.array(zPointStyle).or(zPointStyle).nullish(),\n  lineStyle: z.array(zLineStyle).or(zLineStyle).nullish(),\n  areaStyle: z.array(zAreaStyle).or(zAreaStyle).nullish(),\n  annotationPoint: z.array(zAnnotationPoint).or(zAnnotationPoint).nullish(),\n  annotationVerticalLine: z.array(zAnnotationVerticalLine).or(zAnnotationVerticalLine).nullish(),\n  annotationHorizontalLine: z.array(zAnnotationHorizontalLine).or(zAnnotationHorizontalLine).nullish(),\n  annotationArea: z.array(zAnnotationArea).or(zAnnotationArea).nullish(),\n  dimensionLinkage: zDimensionLinkage.nullish(),\n  locale: zLocale.nullish(),\n})\n"],"names":["zAreaPercent","z","zDataset","zEncoding","zDimensions","zMeasures","zPage","zBackgroundColor","zColor","zLabel","zLegend","zTooltip","zBrush","zXBandAxis","zYLinearAxis","zCrosshairLine","zTheme","zPointStyle","zLineStyle","zAreaStyle","zAnnotationPoint","zAnnotationVerticalLine","zAnnotationHorizontalLine","zAnnotationArea","zDimensionLinkage","zLocale"],"mappings":";;;AA6BO,MAAMA,eAAeC,EAAE,MAAM,CAAC;IACnC,WAAWA,EAAE,OAAO,CAAC;IACrB,SAASC,SAAS,OAAO;IACzB,UAAUC,UAAU,OAAO;IAC3B,YAAYC,YAAY,OAAO;IAC/B,UAAUC,UAAU,OAAO;IAC3B,MAAMC,MAAM,OAAO;IAEnB,iBAAiBC,iBAAiB,OAAO;IACzC,OAAOC,OAAO,OAAO;IACrB,OAAOC,OAAO,OAAO;IACrB,QAAQC,QAAQ,OAAO;IACvB,SAASC,SAAS,OAAO;IACzB,OAAOC,OAAO,OAAO;IACrB,OAAOC,WAAW,OAAO;IACzB,OAAOC,aAAa,OAAO;IAC3B,eAAeC,eAAe,OAAO;IACrC,OAAOC,OAAO,OAAO;IACrB,YAAYf,EAAE,KAAK,CAACgB,aAAa,EAAE,CAACA,aAAa,OAAO;IACxD,WAAWhB,EAAE,KAAK,CAACiB,YAAY,EAAE,CAACA,YAAY,OAAO;IACrD,WAAWjB,EAAE,KAAK,CAACkB,YAAY,EAAE,CAACA,YAAY,OAAO;IACrD,iBAAiBlB,EAAE,KAAK,CAACmB,kBAAkB,EAAE,CAACA,kBAAkB,OAAO;IACvE,wBAAwBnB,EAAE,KAAK,CAACoB,yBAAyB,EAAE,CAACA,yBAAyB,OAAO;IAC5F,0BAA0BpB,EAAE,KAAK,CAACqB,2BAA2B,EAAE,CAACA,2BAA2B,OAAO;IAClG,gBAAgBrB,EAAE,KAAK,CAACsB,iBAAiB,EAAE,CAACA,iBAAiB,OAAO;IACpE,kBAAkBC,kBAAkB,OAAO;IAC3C,QAAQC,QAAQ,OAAO;AACzB"}
+{"version":3,"file":"types/chartType/areaPercent/zAreaPercent.js","sources":["../../../../../src/types/chartType/areaPercent/zAreaPercent.ts"],"sourcesContent":["import { zLocale } from '../../i18n'\nimport {\n  zAnnotationArea,\n  zAnnotationHorizontalLine,\n  zAnnotationPoint,\n  zAnnotationVerticalLine,\n  zAreaStyle,\n  zBackgroundColor,\n  zColor,\n  zCrosshairLine,\n  zDataset,\n  zDimensionLinkage,\n  zDimensions,\n  zEncoding,\n  zLabel,\n  zLegend,\n  zLineStyle,\n  zMeasures,\n  zPointStyle,\n  zRegionPadding,\n  zTheme,\n  zTooltip,\n  zBrush,\n  zXBandAxis,\n  zYLinearAxis,\n  zPage,\n} from '../../properties'\n\nimport { z } from 'zod'\n\nexport const zAreaPercent = z.object({\n  chartType: z.literal('areaPercent'),\n  dataset: zDataset.nullish(),\n  encoding: zEncoding.nullish(),\n  dimensions: zDimensions.nullish(),\n  measures: zMeasures.nullish(),\n  page: zPage.nullish(),\n\n  backgroundColor: zBackgroundColor.nullish(),\n  color: zColor.nullish(),\n  label: zLabel.nullish(),\n  legend: zLegend.nullish(),\n  regionPadding: zRegionPadding.nullish(),\n  tooltip: zTooltip.nullish(),\n  brush: zBrush.nullish(),\n  xAxis: zXBandAxis.nullish(),\n  yAxis: zYLinearAxis.nullish(),\n  crosshairLine: zCrosshairLine.nullish(),\n  theme: zTheme.nullish(),\n  pointStyle: z.array(zPointStyle).or(zPointStyle).nullish(),\n  lineStyle: z.array(zLineStyle).or(zLineStyle).nullish(),\n  areaStyle: z.array(zAreaStyle).or(zAreaStyle).nullish(),\n  annotationPoint: z.array(zAnnotationPoint).or(zAnnotationPoint).nullish(),\n  annotationVerticalLine: z.array(zAnnotationVerticalLine).or(zAnnotationVerticalLine).nullish(),\n  annotationHorizontalLine: z.array(zAnnotationHorizontalLine).or(zAnnotationHorizontalLine).nullish(),\n  annotationArea: z.array(zAnnotationArea).or(zAnnotationArea).nullish(),\n  dimensionLinkage: zDimensionLinkage.nullish(),\n  locale: zLocale.nullish(),\n})\n"],"names":["zAreaPercent","z","zDataset","zEncoding","zDimensions","zMeasures","zPage","zBackgroundColor","zColor","zLabel","zLegend","zRegionPadding","zTooltip","zBrush","zXBandAxis","zYLinearAxis","zCrosshairLine","zTheme","zPointStyle","zLineStyle","zAreaStyle","zAnnotationPoint","zAnnotationVerticalLine","zAnnotationHorizontalLine","zAnnotationArea","zDimensionLinkage","zLocale"],"mappings":";;;AA8BO,MAAMA,eAAeC,EAAE,MAAM,CAAC;IACnC,WAAWA,EAAE,OAAO,CAAC;IACrB,SAASC,SAAS,OAAO;IACzB,UAAUC,UAAU,OAAO;IAC3B,YAAYC,YAAY,OAAO;IAC/B,UAAUC,UAAU,OAAO;IAC3B,MAAMC,MAAM,OAAO;IAEnB,iBAAiBC,iBAAiB,OAAO;IACzC,OAAOC,OAAO,OAAO;IACrB,OAAOC,OAAO,OAAO;IACrB,QAAQC,QAAQ,OAAO;IACvB,eAAeC,eAAe,OAAO;IACrC,SAASC,SAAS,OAAO;IACzB,OAAOC,OAAO,OAAO;IACrB,OAAOC,WAAW,OAAO;IACzB,OAAOC,aAAa,OAAO;IAC3B,eAAeC,eAAe,OAAO;IACrC,OAAOC,OAAO,OAAO;IACrB,YAAYhB,EAAE,KAAK,CAACiB,aAAa,EAAE,CAACA,aAAa,OAAO;IACxD,WAAWjB,EAAE,KAAK,CAACkB,YAAY,EAAE,CAACA,YAAY,OAAO;IACrD,WAAWlB,EAAE,KAAK,CAACmB,YAAY,EAAE,CAACA,YAAY,OAAO;IACrD,iBAAiBnB,EAAE,KAAK,CAACoB,kBAAkB,EAAE,CAACA,kBAAkB,OAAO;IACvE,wBAAwBpB,EAAE,KAAK,CAACqB,yBAAyB,EAAE,CAACA,yBAAyB,OAAO;IAC5F,0BAA0BrB,EAAE,KAAK,CAACsB,2BAA2B,EAAE,CAACA,2BAA2B,OAAO;IAClG,gBAAgBtB,EAAE,KAAK,CAACuB,iBAAiB,EAAE,CAACA,iBAAiB,OAAO;IACpE,kBAAkBC,kBAAkB,OAAO;IAC3C,QAAQC,QAAQ,OAAO;AACzB"}

package/dist/esm/types/chartType/bar/bar.d.ts

@@ -1,5 +1,5 @@
 import { type Locale } from '../../i18n';
-import type { BarDimension, BarMaxWidth, BarMeasure, DimensionLinkage, Sort, SortLegend } from '../../properties';
+import type { BarDimension, BarMaxWidth, BarMeasure, DimensionLinkage, RegionPadding, Sort, SortLegend } from '../../properties';
 import { type AnnotationArea, type AnnotationDifferenceLine, type AnnotationHorizontalLine, type AnnotationPoint, type AnnotationVerticalLine, type BackgroundColor, type Brush, type BarStyle, type Color, type CrosshairRect, type Dataset, type Label, type Legend, type StackCornerRadius, type Theme, type Tooltip, type XLinearAxis, type YBandAxis, type Page } from '../../properties';
 /**
  * @description 条形图，适用于横向数据对比场景，Y轴为类目轴（分类数据），X轴为数值轴（连续数据），柱子横向排列
@@ -72,6 +72,11 @@ export interface Bar {
      * @description 图例配置, 用于定义图表的图例, 包括图例的位置, 格式, 样式等.
      */
     legend?: Legend;
+    /**
+     * 绘图区内边距
+     * @description 映射到 VChart 的 region[0].padding，用于为标注、标签等绘图区外扩元素预留空间。
+     */
+    regionPadding?: RegionPadding;
     /**
      * @description 提示信息配置, 用于定义图表的提示信息, 包括提示信息的位置, 格式, 样式等.
      */