@dudousxd/nestjs-catalog-react 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (239) hide show
  1. package/LICENSE-bklit +21 -0
  2. package/README.md +282 -0
  3. package/dist/AccessConsole.d.ts +40 -0
  4. package/dist/AccessConsole.js +160 -0
  5. package/dist/CatalogManager.d.ts +12 -0
  6. package/dist/CatalogManager.js +123 -0
  7. package/dist/ConnectionPanel.d.ts +41 -0
  8. package/dist/ConnectionPanel.js +228 -0
  9. package/dist/CoverageLedger.d.ts +16 -0
  10. package/dist/CoverageLedger.js +16 -0
  11. package/dist/DashboardBoard.d.ts +10 -0
  12. package/dist/DashboardBoard.js +206 -0
  13. package/dist/EditableField.d.ts +18 -0
  14. package/dist/EditableField.js +61 -0
  15. package/dist/FlowView.d.ts +13 -0
  16. package/dist/FlowView.js +93 -0
  17. package/dist/GovernanceTimeline.d.ts +16 -0
  18. package/dist/GovernanceTimeline.js +93 -0
  19. package/dist/ObjectExplorer.d.ts +9 -0
  20. package/dist/ObjectExplorer.js +153 -0
  21. package/dist/PipelineConsole.d.ts +20 -0
  22. package/dist/PipelineConsole.js +272 -0
  23. package/dist/QueryConsole.d.ts +11 -0
  24. package/dist/QueryConsole.js +144 -0
  25. package/dist/SavedQueryPanel.d.ts +16 -0
  26. package/dist/SavedQueryPanel.js +78 -0
  27. package/dist/TraceExplorer.d.ts +54 -0
  28. package/dist/TraceExplorer.js +342 -0
  29. package/dist/TransformEditor.d.ts +23 -0
  30. package/dist/TransformEditor.js +129 -0
  31. package/dist/WorkflowCanvas.d.ts +24 -0
  32. package/dist/WorkflowCanvas.js +701 -0
  33. package/dist/charts/bklit/animation.d.ts +19 -0
  34. package/dist/charts/bklit/animation.js +28 -0
  35. package/dist/charts/bklit/area-chart-loading.d.ts +33 -0
  36. package/dist/charts/bklit/area-chart-loading.js +30 -0
  37. package/dist/charts/bklit/area-chart.d.ts +47 -0
  38. package/dist/charts/bklit/area-chart.js +65 -0
  39. package/dist/charts/bklit/area-gradient-defs.d.ts +28 -0
  40. package/dist/charts/bklit/area-gradient-defs.js +23 -0
  41. package/dist/charts/bklit/area.d.ts +75 -0
  42. package/dist/charts/bklit/area.js +112 -0
  43. package/dist/charts/bklit/bar-chart-loading.d.ts +16 -0
  44. package/dist/charts/bklit/bar-chart-loading.js +22 -0
  45. package/dist/charts/bklit/bar-chart.d.ts +54 -0
  46. package/dist/charts/bklit/bar-chart.js +440 -0
  47. package/dist/charts/bklit/bar-depth-geometry.d.ts +41 -0
  48. package/dist/charts/bklit/bar-depth-geometry.js +46 -0
  49. package/dist/charts/bklit/bar-squares-layout.d.ts +36 -0
  50. package/dist/charts/bklit/bar-squares-layout.js +46 -0
  51. package/dist/charts/bklit/bar-squares.d.ts +48 -0
  52. package/dist/charts/bklit/bar-squares.js +206 -0
  53. package/dist/charts/bklit/bar-x-axis.d.ts +13 -0
  54. package/dist/charts/bklit/bar-x-axis.js +81 -0
  55. package/dist/charts/bklit/bar-y-axis.d.ts +11 -0
  56. package/dist/charts/bklit/bar-y-axis.js +72 -0
  57. package/dist/charts/bklit/bar.d.ts +40 -0
  58. package/dist/charts/bklit/bar.js +207 -0
  59. package/dist/charts/bklit/chart-child-passthrough.d.ts +25 -0
  60. package/dist/charts/bklit/chart-child-passthrough.js +82 -0
  61. package/dist/charts/bklit/chart-config-context.d.ts +34 -0
  62. package/dist/charts/bklit/chart-config-context.js +55 -0
  63. package/dist/charts/bklit/chart-context.d.ts +207 -0
  64. package/dist/charts/bklit/chart-context.js +200 -0
  65. package/dist/charts/bklit/chart-defs.d.ts +21 -0
  66. package/dist/charts/bklit/chart-defs.js +57 -0
  67. package/dist/charts/bklit/chart-formatters.d.ts +16 -0
  68. package/dist/charts/bklit/chart-formatters.js +26 -0
  69. package/dist/charts/bklit/chart-legend-hover.d.ts +21 -0
  70. package/dist/charts/bklit/chart-legend-hover.js +26 -0
  71. package/dist/charts/bklit/chart-loading-label.d.ts +9 -0
  72. package/dist/charts/bklit/chart-loading-label.js +29 -0
  73. package/dist/charts/bklit/chart-phase.d.ts +39 -0
  74. package/dist/charts/bklit/chart-phase.js +20 -0
  75. package/dist/charts/bklit/chart-reveal-clip.d.ts +32 -0
  76. package/dist/charts/bklit/chart-reveal-clip.js +23 -0
  77. package/dist/charts/bklit/dash-tail-stroke.d.ts +17 -0
  78. package/dist/charts/bklit/dash-tail-stroke.js +21 -0
  79. package/dist/charts/bklit/decimate-time-series.d.ts +18 -0
  80. package/dist/charts/bklit/decimate-time-series.js +120 -0
  81. package/dist/charts/bklit/fade-edges.d.ts +42 -0
  82. package/dist/charts/bklit/fade-edges.js +34 -0
  83. package/dist/charts/bklit/filter-data-by-x-domain.d.ts +13 -0
  84. package/dist/charts/bklit/filter-data-by-x-domain.js +50 -0
  85. package/dist/charts/bklit/generate-chart-skeleton-data.d.ts +24 -0
  86. package/dist/charts/bklit/generate-chart-skeleton-data.js +33 -0
  87. package/dist/charts/bklit/grid.d.ts +57 -0
  88. package/dist/charts/bklit/grid.js +88 -0
  89. package/dist/charts/bklit/highlight-segment-bounds.d.ts +26 -0
  90. package/dist/charts/bklit/highlight-segment-bounds.js +35 -0
  91. package/dist/charts/bklit/highlight-segment.d.ts +30 -0
  92. package/dist/charts/bklit/highlight-segment.js +22 -0
  93. package/dist/charts/bklit/indicator-fade.d.ts +23 -0
  94. package/dist/charts/bklit/indicator-fade.js +41 -0
  95. package/dist/charts/bklit/line-chart-loading.d.ts +33 -0
  96. package/dist/charts/bklit/line-chart-loading.js +30 -0
  97. package/dist/charts/bklit/line-chart.d.ts +45 -0
  98. package/dist/charts/bklit/line-chart.js +99 -0
  99. package/dist/charts/bklit/line-loading-pulse.d.ts +19 -0
  100. package/dist/charts/bklit/line-loading-pulse.js +132 -0
  101. package/dist/charts/bklit/line-loading-timing.d.ts +18 -0
  102. package/dist/charts/bklit/line-loading-timing.js +18 -0
  103. package/dist/charts/bklit/line-series-terminal-marker.d.ts +15 -0
  104. package/dist/charts/bklit/line-series-terminal-marker.js +54 -0
  105. package/dist/charts/bklit/line.d.ts +63 -0
  106. package/dist/charts/bklit/line.js +104 -0
  107. package/dist/charts/bklit/loading-sweep.d.ts +65 -0
  108. package/dist/charts/bklit/loading-sweep.js +182 -0
  109. package/dist/charts/bklit/motion-utils.d.ts +17 -0
  110. package/dist/charts/bklit/motion-utils.js +27 -0
  111. package/dist/charts/bklit/path-stroke-utils.d.ts +28 -0
  112. package/dist/charts/bklit/path-stroke-utils.js +64 -0
  113. package/dist/charts/bklit/pattern-area.d.ts +20 -0
  114. package/dist/charts/bklit/pattern-area.js +27 -0
  115. package/dist/charts/bklit/pattern-preset.d.ts +34 -0
  116. package/dist/charts/bklit/pattern-preset.js +82 -0
  117. package/dist/charts/bklit/projection-config.d.ts +19 -0
  118. package/dist/charts/bklit/projection-config.js +88 -0
  119. package/dist/charts/bklit/projection-line-end-marker.d.ts +14 -0
  120. package/dist/charts/bklit/projection-line-end-marker.js +35 -0
  121. package/dist/charts/bklit/projection-line.d.ts +39 -0
  122. package/dist/charts/bklit/projection-line.js +87 -0
  123. package/dist/charts/bklit/projection-utils.d.ts +54 -0
  124. package/dist/charts/bklit/projection-utils.js +252 -0
  125. package/dist/charts/bklit/reference-area-config.d.ts +18 -0
  126. package/dist/charts/bklit/reference-area-config.js +47 -0
  127. package/dist/charts/bklit/reference-area-registration-context.d.ts +7 -0
  128. package/dist/charts/bklit/reference-area-registration-context.js +15 -0
  129. package/dist/charts/bklit/series-bar-layout.d.ts +26 -0
  130. package/dist/charts/bklit/series-bar-layout.js +39 -0
  131. package/dist/charts/bklit/series-dash-tail-overlay.d.ts +16 -0
  132. package/dist/charts/bklit/series-dash-tail-overlay.js +47 -0
  133. package/dist/charts/bklit/series-highlight-layer.d.ts +31 -0
  134. package/dist/charts/bklit/series-highlight-layer.js +20 -0
  135. package/dist/charts/bklit/series-hover-dim.d.ts +28 -0
  136. package/dist/charts/bklit/series-hover-dim.js +34 -0
  137. package/dist/charts/bklit/series-markers.d.ts +13 -0
  138. package/dist/charts/bklit/series-markers.js +106 -0
  139. package/dist/charts/bklit/series-path-utils.d.ts +18 -0
  140. package/dist/charts/bklit/series-path-utils.js +68 -0
  141. package/dist/charts/bklit/series-point-marker.d.ts +47 -0
  142. package/dist/charts/bklit/series-point-marker.js +47 -0
  143. package/dist/charts/bklit/static-chart-preview-context.d.ts +15 -0
  144. package/dist/charts/bklit/static-chart-preview-context.js +20 -0
  145. package/dist/charts/bklit/time-series-chart-shell.d.ts +46 -0
  146. package/dist/charts/bklit/time-series-chart-shell.js +398 -0
  147. package/dist/charts/bklit/tooltip/chart-tooltip.d.ts +75 -0
  148. package/dist/charts/bklit/tooltip/chart-tooltip.js +158 -0
  149. package/dist/charts/bklit/tooltip/date-ticker.d.ts +10 -0
  150. package/dist/charts/bklit/tooltip/date-ticker.js +85 -0
  151. package/dist/charts/bklit/tooltip/index.d.ts +15 -0
  152. package/dist/charts/bklit/tooltip/index.js +15 -0
  153. package/dist/charts/bklit/tooltip/tooltip-box.d.ts +56 -0
  154. package/dist/charts/bklit/tooltip/tooltip-box.js +122 -0
  155. package/dist/charts/bklit/tooltip/tooltip-content.d.ts +26 -0
  156. package/dist/charts/bklit/tooltip/tooltip-content.js +8 -0
  157. package/dist/charts/bklit/tooltip/tooltip-dot.d.ts +27 -0
  158. package/dist/charts/bklit/tooltip/tooltip-dot.js +62 -0
  159. package/dist/charts/bklit/tooltip/tooltip-indicator.d.ts +44 -0
  160. package/dist/charts/bklit/tooltip/tooltip-indicator.js +73 -0
  161. package/dist/charts/bklit/use-animated-series-path.d.ts +18 -0
  162. package/dist/charts/bklit/use-animated-series-path.js +101 -0
  163. package/dist/charts/bklit/use-animated-y-domains.d.ts +13 -0
  164. package/dist/charts/bklit/use-animated-y-domains.js +158 -0
  165. package/dist/charts/bklit/use-chart-interaction.d.ts +40 -0
  166. package/dist/charts/bklit/use-chart-interaction.js +252 -0
  167. package/dist/charts/bklit/use-chart-phase-orchestrator.d.ts +22 -0
  168. package/dist/charts/bklit/use-chart-phase-orchestrator.js +147 -0
  169. package/dist/charts/bklit/use-enter-complete.d.ts +16 -0
  170. package/dist/charts/bklit/use-enter-complete.js +22 -0
  171. package/dist/charts/bklit/use-grid-shimmer.d.ts +15 -0
  172. package/dist/charts/bklit/use-grid-shimmer.js +71 -0
  173. package/dist/charts/bklit/use-highlight-segment.d.ts +22 -0
  174. package/dist/charts/bklit/use-highlight-segment.js +42 -0
  175. package/dist/charts/bklit/use-mount-progress.d.ts +12 -0
  176. package/dist/charts/bklit/use-mount-progress.js +30 -0
  177. package/dist/charts/bklit/use-scheduled-tooltip.d.ts +8 -0
  178. package/dist/charts/bklit/use-scheduled-tooltip.js +84 -0
  179. package/dist/charts/bklit/visx-pattern.d.ts +27 -0
  180. package/dist/charts/bklit/visx-pattern.js +28 -0
  181. package/dist/charts/bklit/x-axis.d.ts +26 -0
  182. package/dist/charts/bklit/x-axis.js +423 -0
  183. package/dist/charts/bklit/y-axis-scales.d.ts +34 -0
  184. package/dist/charts/bklit/y-axis-scales.js +80 -0
  185. package/dist/charts/bklit/y-axis-ticks.d.ts +20 -0
  186. package/dist/charts/bklit/y-axis-ticks.js +32 -0
  187. package/dist/charts/bklit/y-domain-utils.d.ts +26 -0
  188. package/dist/charts/bklit/y-domain-utils.js +96 -0
  189. package/dist/charts/bklit.d.ts +2 -0
  190. package/dist/charts/bklit.js +90 -0
  191. package/dist/charts/components/shimmering-text.d.ts +31 -0
  192. package/dist/charts/components/shimmering-text.js +39 -0
  193. package/dist/charts/css.d.ts +35 -0
  194. package/dist/charts/css.js +64 -0
  195. package/dist/charts/recharts.d.ts +28 -0
  196. package/dist/charts/recharts.js +48 -0
  197. package/dist/charts/registry.d.ts +34 -0
  198. package/dist/charts/registry.js +60 -0
  199. package/dist/charts/skeleton.d.ts +55 -0
  200. package/dist/charts/skeleton.js +66 -0
  201. package/dist/cn.d.ts +10 -0
  202. package/dist/cn.js +13 -0
  203. package/dist/context.d.ts +346 -0
  204. package/dist/context.js +95 -0
  205. package/dist/index.d.ts +30 -0
  206. package/dist/index.js +65 -0
  207. package/dist/routes.d.ts +70 -0
  208. package/dist/routes.js +73 -0
  209. package/dist/source-fields.d.ts +111 -0
  210. package/dist/source-fields.js +204 -0
  211. package/dist/ui/chart.d.ts +54 -0
  212. package/dist/ui/chart.js +122 -0
  213. package/dist/ui/dialog.d.ts +27 -0
  214. package/dist/ui/dialog.js +24 -0
  215. package/dist/ui/field.d.ts +29 -0
  216. package/dist/ui/field.js +31 -0
  217. package/dist/ui/select.d.ts +42 -0
  218. package/dist/ui/select.js +30 -0
  219. package/dist/ui/sheet.d.ts +38 -0
  220. package/dist/ui/sheet.js +37 -0
  221. package/dist/ui/switch.d.ts +17 -0
  222. package/dist/ui/switch.js +14 -0
  223. package/dist/ui/tabs.d.ts +30 -0
  224. package/dist/ui/tabs.js +36 -0
  225. package/dist/ui/tooltip.d.ts +37 -0
  226. package/dist/ui/tooltip.js +43 -0
  227. package/dist/workflow/graph.d.ts +112 -0
  228. package/dist/workflow/graph.js +297 -0
  229. package/dist/workflow/index.d.ts +16 -0
  230. package/dist/workflow/index.js +16 -0
  231. package/dist/workflow/model.d.ts +151 -0
  232. package/dist/workflow/model.js +97 -0
  233. package/dist/workflow/name.d.ts +28 -0
  234. package/dist/workflow/name.js +28 -0
  235. package/dist/workflow/nodes.d.ts +40 -0
  236. package/dist/workflow/nodes.js +86 -0
  237. package/dist/workflow/validate.d.ts +104 -0
  238. package/dist/workflow/validate.js +199 -0
  239. package/package.json +148 -0
@@ -0,0 +1,39 @@
1
+ import { type ProjectionCurveKind, type ProjectionPoint } from './projection-utils';
2
+ type CurveFactory = any;
3
+ export type ProjectionStrokeStyle = 'solid' | 'gradient';
4
+ export interface ProjectionLineProps {
5
+ /** Projection path points — anchor (last data row) + horizon end. */
6
+ data: ProjectionPoint[];
7
+ /** Y-scale group id. Default: `"left"`. */
8
+ yAxisId?: string | number;
9
+ /** Solid stroke color. Default: var(--chart-3) */
10
+ stroke?: string;
11
+ /** Solid or path-aligned gradient stroke. Default: solid */
12
+ strokeStyle?: ProjectionStrokeStyle;
13
+ /** Gradient start color when `strokeStyle` is gradient. Default: `stroke` */
14
+ gradientStart?: string;
15
+ /** Gradient end color when `strokeStyle` is gradient. Default: var(--chart-5) */
16
+ gradientEnd?: string;
17
+ /** Stroke width. Default: 2 */
18
+ strokeWidth?: number;
19
+ /** Straight segment or horizontal-tangent S-curve. Default: linear */
20
+ curveKind?: ProjectionCurveKind;
21
+ /** Advanced curve override (used when `curveKind` is omitted). */
22
+ curve?: CurveFactory;
23
+ /** Dash pattern. Default: "6,4" */
24
+ strokeDasharray?: string;
25
+ /** Stroke opacity. Default: 1 */
26
+ strokeOpacity?: number;
27
+ /** Show horizon endpoint marker. Default: true */
28
+ showEndMarker?: boolean;
29
+ /** @deprecated Use `showEndMarker`. */
30
+ showEndpoints?: boolean;
31
+ /** Endpoint marker radius. Default: 5 */
32
+ endpointRadius?: number;
33
+ className?: string;
34
+ }
35
+ export declare function ProjectionLine({ data, yAxisId, stroke, strokeStyle, gradientStart, gradientEnd, strokeWidth, curveKind, curve, strokeDasharray, strokeOpacity, showEndMarker, showEndpoints, endpointRadius, className, }: ProjectionLineProps): import("react/jsx-runtime").JSX.Element | null;
36
+ export declare namespace ProjectionLine {
37
+ var displayName: string;
38
+ }
39
+ export default ProjectionLine;
@@ -0,0 +1,87 @@
1
+ 'use client';
2
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ /**
4
+ * Vendored from bklit-ui — https://github.com/bklit/bklit-ui
5
+ * Copyright (c) 2026 uixmat. Released under the MIT licence; the full text is in
6
+ * LICENSE-bklit at the root of this package.
7
+ *
8
+ * Local change: the `@/lib/utils` import was repointed at this package's own
9
+ * `cn`, which is the same function. Nothing else is modified, so re-syncing
10
+ * with upstream stays a diff rather than a merge.
11
+ */
12
+ import { curveLinear } from '@visx/curve';
13
+ import { LinePath } from '@visx/shape';
14
+ import { useCallback, useId, useMemo } from 'react';
15
+ import { useChartStable, useYScale } from './chart-context';
16
+ import { buildHorizontalTangentBezierPath, } from './projection-utils';
17
+ function resolveVisibleEndX(endX, innerWidth, endpointRadius, strokeWidth) {
18
+ const edgePadding = endpointRadius + strokeWidth * 0.5 + 1;
19
+ return Math.min(endX, Math.max(0, innerWidth - edgePadding));
20
+ }
21
+ function renderProjectionStroke({ bezierPath, curve, curveKind, data, getX, getY, linearPath, strokeProps, }) {
22
+ if (curveKind === 'bezier' && bezierPath) {
23
+ return _jsx("path", { d: bezierPath, fill: "none", ...strokeProps });
24
+ }
25
+ if (curveKind === 'linear' && linearPath) {
26
+ return _jsx("path", { d: linearPath, fill: "none", ...strokeProps });
27
+ }
28
+ return _jsx(LinePath, { curve: curve ?? curveLinear, data: data, ...strokeProps, x: getX, y: getY });
29
+ }
30
+ export function ProjectionLine({ data, yAxisId, stroke = 'var(--chart-3)', strokeStyle = 'solid', gradientStart, gradientEnd = 'var(--chart-5)', strokeWidth = 2, curveKind = 'linear', curve, strokeDasharray = '6,4', strokeOpacity = 1, showEndMarker, showEndpoints, endpointRadius = 5, className, }) {
31
+ const { xScale, chartPhase, innerWidth } = useChartStable();
32
+ const yScale = useYScale(yAxisId);
33
+ const gradientId = useId().replace(/:/g, '');
34
+ const showMarker = showEndMarker ?? showEndpoints ?? true;
35
+ const resolvedGradientStart = gradientStart ?? stroke;
36
+ const getX = useCallback((point) => xScale(point.date) ?? 0, [xScale]);
37
+ const getY = useCallback((point) => yScale(point.value) ?? 0, [yScale]);
38
+ const startPoint = data[0];
39
+ const endPoint = data.at(-1);
40
+ const geometry = useMemo(() => {
41
+ if (!(startPoint && endPoint)) {
42
+ return null;
43
+ }
44
+ const startX = getX(startPoint);
45
+ const startY = getY(startPoint);
46
+ const endX = getX(endPoint);
47
+ const endY = getY(endPoint);
48
+ const visibleEndX = resolveVisibleEndX(endX, innerWidth, showMarker ? endpointRadius : 0, strokeWidth);
49
+ return { startX, startY, visibleEndX, endY };
50
+ }, [endPoint, endpointRadius, getX, getY, innerWidth, showMarker, startPoint, strokeWidth]);
51
+ const bezierPath = useMemo(() => {
52
+ if (curveKind !== 'bezier' || !geometry) {
53
+ return null;
54
+ }
55
+ return buildHorizontalTangentBezierPath(geometry.startX, geometry.startY, geometry.visibleEndX, geometry.endY);
56
+ }, [curveKind, geometry]);
57
+ const linearPath = useMemo(() => {
58
+ if (curveKind !== 'linear' || !geometry) {
59
+ return null;
60
+ }
61
+ return `M ${geometry.startX},${geometry.startY} L ${geometry.visibleEndX},${geometry.endY}`;
62
+ }, [curveKind, geometry]);
63
+ const showStroke = chartPhase === 'revealing' || chartPhase === 'ready' || chartPhase === 'exitingReady';
64
+ if (data.length < 2 || !geometry) {
65
+ return null;
66
+ }
67
+ const resolvedStroke = strokeStyle === 'gradient' && geometry ? `url(#${gradientId})` : stroke;
68
+ const strokeProps = {
69
+ stroke: showStroke ? resolvedStroke : 'transparent',
70
+ strokeDasharray,
71
+ strokeLinecap: 'round',
72
+ strokeOpacity,
73
+ strokeWidth,
74
+ };
75
+ return (_jsxs("g", { className: className ?? 'chart-projection-line', children: [strokeStyle === 'gradient' && geometry ? (_jsx("defs", { children: _jsxs("linearGradient", { gradientUnits: "userSpaceOnUse", id: gradientId, x1: geometry.startX, x2: geometry.visibleEndX, y1: geometry.startY, y2: geometry.endY, children: [_jsx("stop", { offset: "0%", stopColor: resolvedGradientStart }), _jsx("stop", { offset: "100%", stopColor: gradientEnd })] }) })) : null, renderProjectionStroke({
76
+ bezierPath,
77
+ curve,
78
+ curveKind,
79
+ data,
80
+ getX,
81
+ getY,
82
+ linearPath,
83
+ strokeProps,
84
+ })] }));
85
+ }
86
+ ProjectionLine.displayName = 'ProjectionLine';
87
+ export default ProjectionLine;
@@ -0,0 +1,54 @@
1
+ /**
2
+ * Vendored from bklit-ui — https://github.com/bklit/bklit-ui
3
+ * Copyright (c) 2026 uixmat. Released under the MIT licence; the full text is in
4
+ * LICENSE-bklit at the root of this package.
5
+ *
6
+ * Local change: the `@/lib/utils` import was repointed at this package's own
7
+ * `cn`, which is the same function. Nothing else is modified, so re-syncing
8
+ * with upstream stays a diff rather than a merge.
9
+ */
10
+ export type ProjectionMode = 'auto' | 'target' | 'manual';
11
+ export type ProjectionAutoMethod = 'linearRegression' | 'lastSegment';
12
+ /** How the projection segment is drawn between anchor and horizon. */
13
+ export type ProjectionCurveKind = 'linear' | 'bezier';
14
+ /** @deprecated Stepped density removed — projections always anchor → horizon. */
15
+ export type ProjectionPathDensity = 'stepped' | 'endpoints';
16
+ export interface ProjectionPoint {
17
+ date: Date;
18
+ value: number;
19
+ }
20
+ export interface BuildProjectionPathOptions {
21
+ sourceData: Record<string, unknown>[];
22
+ seriesKey: string;
23
+ xDataKey?: string;
24
+ mode: ProjectionMode;
25
+ autoMethod?: ProjectionAutoMethod;
26
+ /** Auto mode: stepped points per interval, or anchor + end only. Default: stepped */
27
+ pathDensity?: ProjectionPathDensity;
28
+ /** Index in sourceData where projection anchors (default: last point). */
29
+ startIndex?: number;
30
+ /** How many future points to generate (matches source cadence). */
31
+ horizonPoints?: number;
32
+ /** Target Y at the final projected date (target mode). */
33
+ endValue?: number;
34
+ /** Full manual path — anchor + future points (manual mode). */
35
+ points?: ProjectionPoint[];
36
+ }
37
+ /** Slope (value change per ms) at the projection anchor from the last data segment. */
38
+ export declare function computeProjectionAnchorTangentSlope(sourceData: Record<string, unknown>[], seriesKey: string, xDataKey?: string, startIndexProp?: number): number;
39
+ /** Cubic bezier with horizontal tangents at start and end (price-target S-curve). */
40
+ export declare function buildHorizontalTangentBezierPath(x0: number, y0: number, x1: number, y1: number,
41
+ /** How far control points sit along the x span (0–0.5). Default: 0.45 */
42
+ tension?: number): string;
43
+ /** Build a projection path from historical chart data or explicit points. */
44
+ export declare function buildProjectionPath(options: BuildProjectionPathOptions): ProjectionPoint[];
45
+ /** Collect numeric Y extents from projection point arrays. */
46
+ export declare function projectionValueExtents(paths: ProjectionPoint[][]): {
47
+ minValue: number;
48
+ maxValue: number;
49
+ } | null;
50
+ /** Collect date extents from projection point arrays. */
51
+ export declare function projectionDateExtents(paths: ProjectionPoint[][]): {
52
+ minTime: number;
53
+ maxTime: number;
54
+ } | null;
@@ -0,0 +1,252 @@
1
+ function readDate(row, xDataKey) {
2
+ const raw = row[xDataKey];
3
+ if (raw instanceof Date && !Number.isNaN(raw.getTime())) {
4
+ return raw;
5
+ }
6
+ if (typeof raw === 'number' && Number.isFinite(raw)) {
7
+ const date = new Date(raw);
8
+ return Number.isNaN(date.getTime()) ? null : date;
9
+ }
10
+ if (typeof raw === 'string') {
11
+ const date = new Date(raw);
12
+ return Number.isNaN(date.getTime()) ? null : date;
13
+ }
14
+ return null;
15
+ }
16
+ function readValue(row, seriesKey) {
17
+ const raw = row[seriesKey];
18
+ return typeof raw === 'number' && Number.isFinite(raw) ? raw : null;
19
+ }
20
+ function resolveStartIndex(sourceData, startIndex) {
21
+ if (startIndex == null || !Number.isFinite(startIndex)) {
22
+ return Math.max(0, sourceData.length - 1);
23
+ }
24
+ return Math.min(Math.max(0, Math.floor(startIndex)), sourceData.length - 1);
25
+ }
26
+ function intervalFromAdjacentRows(sourceData, xDataKey, startIndex) {
27
+ if (startIndex < 1) {
28
+ return null;
29
+ }
30
+ const prevRow = sourceData[startIndex - 1];
31
+ const currentRow = sourceData[startIndex];
32
+ const prev = prevRow ? readDate(prevRow, xDataKey) : null;
33
+ const current = currentRow ? readDate(currentRow, xDataKey) : null;
34
+ if (!(prev && current)) {
35
+ return null;
36
+ }
37
+ const delta = current.getTime() - prev.getTime();
38
+ return delta > 0 ? delta : null;
39
+ }
40
+ function intervalFromSeriesSpan(sourceData, xDataKey) {
41
+ if (sourceData.length < 2) {
42
+ return null;
43
+ }
44
+ const firstRow = sourceData[0];
45
+ const lastRow = sourceData.at(-1);
46
+ const first = firstRow ? readDate(firstRow, xDataKey) : null;
47
+ const last = lastRow ? readDate(lastRow, xDataKey) : null;
48
+ if (!(first && last)) {
49
+ return null;
50
+ }
51
+ const span = last.getTime() - first.getTime();
52
+ return span > 0 ? span / (sourceData.length - 1) : null;
53
+ }
54
+ function resolveIntervalMs(sourceData, xDataKey, startIndex) {
55
+ return (intervalFromAdjacentRows(sourceData, xDataKey, startIndex) ??
56
+ intervalFromSeriesSpan(sourceData, xDataKey) ??
57
+ 86_400_000);
58
+ }
59
+ function linearRegressionSlope(points) {
60
+ if (points.length < 2) {
61
+ return 0;
62
+ }
63
+ const n = points.length;
64
+ let sumT = 0;
65
+ let sumY = 0;
66
+ let sumTY = 0;
67
+ let sumTT = 0;
68
+ for (const { t, y } of points) {
69
+ sumT += t;
70
+ sumY += y;
71
+ sumTY += t * y;
72
+ sumTT += t * t;
73
+ }
74
+ const denom = n * sumTT - sumT * sumT;
75
+ if (Math.abs(denom) < 1e-12) {
76
+ return 0;
77
+ }
78
+ return (n * sumTY - sumT * sumY) / denom;
79
+ }
80
+ function buildAutoFutureValues(options) {
81
+ const { anchorTime, anchorValue, autoMethod, historyPoints, horizonPoints, intervalMs, pathDensity, } = options;
82
+ const slope = autoMethod === 'lastSegment' && historyPoints.length >= 2
83
+ ? (() => {
84
+ const prev = historyPoints.at(-2);
85
+ const last = historyPoints.at(-1);
86
+ if (!(prev && last)) {
87
+ return 0;
88
+ }
89
+ const dt = last.t - prev.t;
90
+ return dt === 0 ? 0 : (last.y - prev.y) / dt;
91
+ })()
92
+ : linearRegressionSlope(historyPoints);
93
+ if (pathDensity === 'endpoints') {
94
+ const endTime = anchorTime + intervalMs * horizonPoints;
95
+ const endValue = anchorValue + slope * intervalMs * horizonPoints;
96
+ return [
97
+ { date: new Date(anchorTime), value: anchorValue },
98
+ { date: new Date(endTime), value: endValue },
99
+ ];
100
+ }
101
+ const result = [{ date: new Date(anchorTime), value: anchorValue }];
102
+ for (let i = 1; i <= horizonPoints; i++) {
103
+ const t = anchorTime + intervalMs * i;
104
+ const value = anchorValue + slope * intervalMs * i;
105
+ result.push({ date: new Date(t), value });
106
+ }
107
+ return result;
108
+ }
109
+ /** Slope (value change per ms) at the projection anchor from the last data segment. */
110
+ export function computeProjectionAnchorTangentSlope(sourceData, seriesKey, xDataKey = 'date', startIndexProp) {
111
+ if (sourceData.length < 2) {
112
+ return 0;
113
+ }
114
+ const startIndex = resolveStartIndex(sourceData, startIndexProp);
115
+ const historyPoints = [];
116
+ for (let i = 0; i <= startIndex; i++) {
117
+ const row = sourceData[i];
118
+ if (!row) {
119
+ continue;
120
+ }
121
+ const date = readDate(row, xDataKey);
122
+ const value = readValue(row, seriesKey);
123
+ if (date && value != null) {
124
+ historyPoints.push({ t: date.getTime(), y: value });
125
+ }
126
+ }
127
+ if (historyPoints.length < 2) {
128
+ return 0;
129
+ }
130
+ const prev = historyPoints.at(-2);
131
+ const last = historyPoints.at(-1);
132
+ if (!(prev && last)) {
133
+ return 0;
134
+ }
135
+ const dt = last.t - prev.t;
136
+ return dt === 0 ? 0 : (last.y - prev.y) / dt;
137
+ }
138
+ /** Cubic bezier with horizontal tangents at start and end (price-target S-curve). */
139
+ export function buildHorizontalTangentBezierPath(x0, y0, x1, y1,
140
+ /** How far control points sit along the x span (0–0.5). Default: 0.45 */
141
+ tension = 0.45) {
142
+ const dx = x1 - x0;
143
+ if (Math.abs(dx) < 1e-6) {
144
+ return `M ${x0},${y0} L ${x1},${y1}`;
145
+ }
146
+ const t = Math.min(0.5, Math.max(0.05, tension));
147
+ const c1x = x0 + dx * t;
148
+ const c2x = x1 - dx * t;
149
+ return `M ${x0},${y0} C ${c1x},${y0} ${c2x},${y1} ${x1},${y1}`;
150
+ }
151
+ function buildTargetPath(options) {
152
+ const { anchorTime, anchorValue, endValue, horizonPoints, intervalMs } = options;
153
+ const endTime = anchorTime + intervalMs * horizonPoints;
154
+ return [
155
+ { date: new Date(anchorTime), value: anchorValue },
156
+ { date: new Date(endTime), value: endValue },
157
+ ];
158
+ }
159
+ /** Build a projection path from historical chart data or explicit points. */
160
+ export function buildProjectionPath(options) {
161
+ const { sourceData, seriesKey, xDataKey = 'date', mode, autoMethod = 'linearRegression', pathDensity = 'endpoints', startIndex: startIndexProp, horizonPoints = 6, endValue, points, } = options;
162
+ if (mode === 'manual' && points && points.length >= 2) {
163
+ return points.map((point) => ({
164
+ date: new Date(point.date),
165
+ value: point.value,
166
+ }));
167
+ }
168
+ if (sourceData.length === 0) {
169
+ return [];
170
+ }
171
+ const startIndex = resolveStartIndex(sourceData, startIndexProp);
172
+ const anchorRow = sourceData[startIndex];
173
+ if (!anchorRow) {
174
+ return [];
175
+ }
176
+ const anchorDate = readDate(anchorRow, xDataKey);
177
+ const anchorValue = readValue(anchorRow, seriesKey);
178
+ if (!anchorDate || anchorValue == null) {
179
+ return [];
180
+ }
181
+ const intervalMs = resolveIntervalMs(sourceData, xDataKey, startIndex);
182
+ const anchorTime = anchorDate.getTime();
183
+ const historyPoints = [];
184
+ for (let i = 0; i <= startIndex; i++) {
185
+ const row = sourceData[i];
186
+ if (!row) {
187
+ continue;
188
+ }
189
+ const date = readDate(row, xDataKey);
190
+ const value = readValue(row, seriesKey);
191
+ if (date && value != null) {
192
+ historyPoints.push({ t: date.getTime(), y: value });
193
+ }
194
+ }
195
+ if (mode === 'target' && endValue != null && Number.isFinite(endValue)) {
196
+ return buildTargetPath({
197
+ anchorTime,
198
+ anchorValue,
199
+ endValue,
200
+ horizonPoints,
201
+ intervalMs,
202
+ });
203
+ }
204
+ return buildAutoFutureValues({
205
+ anchorTime,
206
+ anchorValue,
207
+ autoMethod,
208
+ historyPoints,
209
+ horizonPoints,
210
+ intervalMs,
211
+ pathDensity,
212
+ });
213
+ }
214
+ /** Collect numeric Y extents from projection point arrays. */
215
+ export function projectionValueExtents(paths) {
216
+ let minValue = Number.POSITIVE_INFINITY;
217
+ let maxValue = Number.NEGATIVE_INFINITY;
218
+ for (const path of paths) {
219
+ for (const point of path) {
220
+ if (point.value < minValue) {
221
+ minValue = point.value;
222
+ }
223
+ if (point.value > maxValue) {
224
+ maxValue = point.value;
225
+ }
226
+ }
227
+ }
228
+ if (minValue === Number.POSITIVE_INFINITY) {
229
+ return null;
230
+ }
231
+ return { minValue, maxValue };
232
+ }
233
+ /** Collect date extents from projection point arrays. */
234
+ export function projectionDateExtents(paths) {
235
+ let minTime = Number.POSITIVE_INFINITY;
236
+ let maxTime = Number.NEGATIVE_INFINITY;
237
+ for (const path of paths) {
238
+ for (const point of path) {
239
+ const time = point.date.getTime();
240
+ if (time < minTime) {
241
+ minTime = time;
242
+ }
243
+ if (time > maxTime) {
244
+ maxTime = time;
245
+ }
246
+ }
247
+ }
248
+ if (minTime === Number.POSITIVE_INFINITY) {
249
+ return null;
250
+ }
251
+ return { minTime, maxTime };
252
+ }
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Vendored from bklit-ui — https://github.com/bklit/bklit-ui
3
+ * Copyright (c) 2026 uixmat. Released under the MIT licence; the full text is in
4
+ * LICENSE-bklit at the root of this package.
5
+ *
6
+ * Local change: the `@/lib/utils` import was repointed at this package's own
7
+ * `cn`, which is the same function. Nothing else is modified, so re-syncing
8
+ * with upstream stays a diff rather than a merge.
9
+ */
10
+ import { type ReactNode } from 'react';
11
+ export interface ReferenceAreaConfig {
12
+ yAxisId: string;
13
+ y1?: number;
14
+ y2?: number;
15
+ axisLabelColor?: string;
16
+ }
17
+ /** Collect {@link ReferenceArea} props from chart children for axis label styling. */
18
+ export declare function extractReferenceAreaConfigs(children: ReactNode): ReferenceAreaConfig[];
@@ -0,0 +1,47 @@
1
+ /**
2
+ * Vendored from bklit-ui — https://github.com/bklit/bklit-ui
3
+ * Copyright (c) 2026 uixmat. Released under the MIT licence; the full text is in
4
+ * LICENSE-bklit at the root of this package.
5
+ *
6
+ * Local change: the `@/lib/utils` import was repointed at this package's own
7
+ * `cn`, which is the same function. Nothing else is modified, so re-syncing
8
+ * with upstream stays a diff rather than a merge.
9
+ */
10
+ import { Children, isValidElement } from 'react';
11
+ import { normalizeYAxisId } from './y-axis-scales';
12
+ function getChildComponentName(child) {
13
+ const childType = child.type;
14
+ return typeof child.type === 'function' ? childType.displayName || childType.name || '' : '';
15
+ }
16
+ function isReferenceAreaElement(child) {
17
+ return getChildComponentName(child) === 'ReferenceArea';
18
+ }
19
+ /** Collect {@link ReferenceArea} props from chart children for axis label styling. */
20
+ export function extractReferenceAreaConfigs(children) {
21
+ const configs = [];
22
+ const visit = (node) => {
23
+ Children.forEach(node, (child) => {
24
+ if (!isValidElement(child)) {
25
+ return;
26
+ }
27
+ if (isReferenceAreaElement(child)) {
28
+ const props = child.props;
29
+ if (props) {
30
+ configs.push({
31
+ yAxisId: normalizeYAxisId(props.yAxisId),
32
+ y1: props.y1,
33
+ y2: props.y2,
34
+ axisLabelColor: props.axisLabelColor,
35
+ });
36
+ }
37
+ return;
38
+ }
39
+ const childProps = child.props;
40
+ if (childProps?.children) {
41
+ visit(childProps.children);
42
+ }
43
+ });
44
+ };
45
+ visit(children);
46
+ return configs;
47
+ }
@@ -0,0 +1,7 @@
1
+ import type { ReferenceAreaConfig } from './reference-area-config';
2
+ export interface ReferenceAreaRegistrationContextValue {
3
+ registerReferenceArea: (id: string, config: ReferenceAreaConfig) => void;
4
+ unregisterReferenceArea: (id: string) => void;
5
+ }
6
+ export declare const ReferenceAreaRegistrationContext: import("react").Context<ReferenceAreaRegistrationContextValue | null>;
7
+ export declare function useReferenceAreaRegistration(): ReferenceAreaRegistrationContextValue | null;
@@ -0,0 +1,15 @@
1
+ 'use client';
2
+ /**
3
+ * Vendored from bklit-ui — https://github.com/bklit/bklit-ui
4
+ * Copyright (c) 2026 uixmat. Released under the MIT licence; the full text is in
5
+ * LICENSE-bklit at the root of this package.
6
+ *
7
+ * Local change: the `@/lib/utils` import was repointed at this package's own
8
+ * `cn`, which is the same function. Nothing else is modified, so re-syncing
9
+ * with upstream stays a diff rather than a merge.
10
+ */
11
+ import { createContext, useContext } from 'react';
12
+ export const ReferenceAreaRegistrationContext = createContext(null);
13
+ export function useReferenceAreaRegistration() {
14
+ return useContext(ReferenceAreaRegistrationContext);
15
+ }
@@ -0,0 +1,26 @@
1
+ /**
2
+ * Vendored from bklit-ui — https://github.com/bklit/bklit-ui
3
+ * Copyright (c) 2026 uixmat. Released under the MIT licence; the full text is in
4
+ * LICENSE-bklit at the root of this package.
5
+ *
6
+ * Local change: the `@/lib/utils` import was repointed at this package's own
7
+ * `cn`, which is the same function. Nothing else is modified, so re-syncing
8
+ * with upstream stays a diff rather than a merge.
9
+ */
10
+ export declare function computeSeriesBarWidth(input: {
11
+ innerWidth: number;
12
+ dataLength: number;
13
+ columnWidth: number;
14
+ seriesCount: number;
15
+ composedBarSize?: number;
16
+ composedMaxBarSize?: number;
17
+ composedBarGap?: number;
18
+ stacked?: boolean;
19
+ }): number;
20
+ /** Half-width of the bar group at each x — used to pad reveal clips. */
21
+ export declare function computeSeriesBarRevealClipPadding(input: {
22
+ barWidth: number;
23
+ seriesCount: number;
24
+ gap?: number;
25
+ stacked?: boolean;
26
+ }): number;
@@ -0,0 +1,39 @@
1
+ /**
2
+ * Vendored from bklit-ui — https://github.com/bklit/bklit-ui
3
+ * Copyright (c) 2026 uixmat. Released under the MIT licence; the full text is in
4
+ * LICENSE-bklit at the root of this package.
5
+ *
6
+ * Local change: the `@/lib/utils` import was repointed at this package's own
7
+ * `cn`, which is the same function. Nothing else is modified, so re-syncing
8
+ * with upstream stays a diff rather than a merge.
9
+ */
10
+ export function computeSeriesBarWidth(input) {
11
+ const { innerWidth, dataLength, columnWidth, seriesCount, composedBarSize, composedMaxBarSize, composedBarGap = 4, stacked = false, } = input;
12
+ const gap = composedBarGap;
13
+ const groupCount = stacked ? 1 : Math.max(1, seriesCount);
14
+ let slot = columnWidth;
15
+ if (slot <= 0) {
16
+ slot = dataLength < 2 ? innerWidth : innerWidth / (dataLength - 1);
17
+ }
18
+ let width = composedBarSize ?? Math.min(slot * 0.88, composedMaxBarSize ?? Number.POSITIVE_INFINITY);
19
+ if (composedMaxBarSize != null) {
20
+ width = Math.min(width, composedMaxBarSize);
21
+ }
22
+ if (groupCount > 1) {
23
+ const maxGroup = slot * 0.92;
24
+ const needed = groupCount * width + (groupCount - 1) * gap;
25
+ if (needed > maxGroup && maxGroup > 0) {
26
+ width = Math.max(4, (maxGroup - (groupCount - 1) * gap) / groupCount);
27
+ }
28
+ }
29
+ return Math.max(2, width);
30
+ }
31
+ /** Half-width of the bar group at each x — used to pad reveal clips. */
32
+ export function computeSeriesBarRevealClipPadding(input) {
33
+ const { barWidth, seriesCount, gap = 4, stacked = false } = input;
34
+ if (stacked || seriesCount <= 1) {
35
+ return Math.ceil(barWidth / 2);
36
+ }
37
+ const groupWidth = seriesCount * barWidth + (seriesCount - 1) * gap;
38
+ return Math.ceil(groupWidth / 2);
39
+ }
@@ -0,0 +1,16 @@
1
+ interface SeriesDashTailOverlayProps {
2
+ dashFromIndex?: number;
3
+ dashArray: string;
4
+ data: Record<string, unknown>[];
5
+ pathD: string | null;
6
+ pathLength: number;
7
+ innerWidth: number;
8
+ innerHeight: number;
9
+ stroke: string;
10
+ strokeWidth: number;
11
+ xScale: (value: Date | number) => number | undefined;
12
+ xAccessor: (datum: Record<string, unknown>) => Date | number;
13
+ }
14
+ declare function SeriesDashTailOverlayImpl({ dashFromIndex, dashArray, data, pathD, pathLength, innerWidth, innerHeight, stroke, strokeWidth, xScale, xAccessor, }: SeriesDashTailOverlayProps): import("react/jsx-runtime").JSX.Element | null;
15
+ export declare const SeriesDashTailOverlay: import("react").MemoExoticComponent<typeof SeriesDashTailOverlayImpl>;
16
+ export {};
@@ -0,0 +1,47 @@
1
+ 'use client';
2
+ import { jsx as _jsx } from "react/jsx-runtime";
3
+ /**
4
+ * Vendored from bklit-ui — https://github.com/bklit/bklit-ui
5
+ * Copyright (c) 2026 uixmat. Released under the MIT licence; the full text is in
6
+ * LICENSE-bklit at the root of this package.
7
+ *
8
+ * Local change: the `@/lib/utils` import was repointed at this package's own
9
+ * `cn`, which is the same function. Nothing else is modified, so re-syncing
10
+ * with upstream stays a diff rather than a merge.
11
+ */
12
+ import { memo, useMemo } from 'react';
13
+ import { DashTailStroke } from './dash-tail-stroke';
14
+ import { resolveDashStartX, resolveDashTailBounds } from './path-stroke-utils';
15
+ function SeriesDashTailOverlayImpl({ dashFromIndex, dashArray, data, pathD, pathLength, innerWidth, innerHeight, stroke, strokeWidth, xScale, xAccessor, }) {
16
+ const hasDashTail = resolveDashTailBounds(dashFromIndex, data.length);
17
+ const dashStartX = useMemo(() => {
18
+ if (!hasDashTail || dashFromIndex == null) {
19
+ return 0;
20
+ }
21
+ return resolveDashStartX(data, dashFromIndex, xScale, xAccessor);
22
+ }, [hasDashTail, dashFromIndex, data, xScale, xAccessor]);
23
+ // Linear (index-based) approximation of the path length at `dashFromIndex`.
24
+ // The accurate version (`findPathLengthAtX` binary search via
25
+ // `getPointAtLength`) is exact but cost ~40 ms per series on a 365-point
26
+ // bezier — for charts with ~10 series that synchronously blocks the main
27
+ // thread for ~400 ms on the post-measurement re-render, swallowing the first
28
+ // second of the entrance animation.
29
+ //
30
+ // For evenly-spaced time-series data — the standard case — this is exact at
31
+ // flat regions of the curve and only differs by a pixel or two where the
32
+ // curve has steep y-variation, which is imperceptible at the dash boundary.
33
+ const dashStartLength = useMemo(() => {
34
+ if (!hasDashTail || dashFromIndex == null || pathLength <= 0) {
35
+ return 0;
36
+ }
37
+ return (dashFromIndex / Math.max(1, data.length - 1)) * pathLength;
38
+ }, [hasDashTail, dashFromIndex, data.length, pathLength]);
39
+ if (!hasDashTail || dashFromIndex == null || pathLength <= 0) {
40
+ return null;
41
+ }
42
+ return (_jsx(DashTailStroke, { dashArray: dashArray, dashStartLength: dashStartLength, dashStartX: dashStartX, innerHeight: innerHeight, innerWidth: innerWidth, pathD: pathD, pathLength: pathLength, stroke: stroke, strokeWidth: strokeWidth }));
43
+ }
44
+ // All props originate from the chart's stable context slice (data, xScale,
45
+ // xAccessor, …) or are mount-stable strings (gradient `url(#…)` ids). Shallow
46
+ // compare lets us skip the path-length binary search on every cursor move.
47
+ export const SeriesDashTailOverlay = memo(SeriesDashTailOverlayImpl);