@cjlapao/ui-kit-vue 0.2.45 → 0.2.47

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.
@@ -226,6 +226,14 @@ export declare function linkDistance(points: readonly GanttPt[], x: number, y: n
226
226
  export declare function pickLinkAt(paths: readonly GanttLinkPath[], x: number, y: number, radius?: number): GanttLinkPath | null;
227
227
  /** Today marker x for a `today` date within the view. */
228
228
  export declare function todayX(today: number, viewStart: number, pxPerDay: number): number;
229
+ /**
230
+ * Centered, clamped target `scrollLeft` for the body scroller to bring "now"
231
+ * into view. The scroller spans the whole component but its left
232
+ * `fixedLeftWidth` px are covered by the non-scrolling column block, so "now"
233
+ * is centered in the **visible** timeline region — never scrolling past
234
+ * either edge (content narrower than the viewport → 0).
235
+ */
236
+ export declare function todayScrollLeft(todayXPos: number, viewportWidth: number, contentWidth: number, fixedLeftWidth?: number): number;
229
237
  /** Convenience: duration label from a drag state's live dates. */
230
238
  export declare function dragDurationLabel(start: number, end: number): string;
231
239
  export {};
@@ -6,7 +6,7 @@
6
6
  * (month columns have real widths, weeks start on the configured weekday), so
7
7
  * labels never drift from the grid.
8
8
  */
9
- import type { GanttDate, GanttSnap, GanttTimeScaleLevel } from "./types";
9
+ import type { GanttDate, GanttSnap, GanttTimeScaleLevel, GanttZoomTier } from "./types";
10
10
  export declare const MS_PER_DAY = 86400000;
11
11
  export declare const MS_PER_HOUR = 3600000;
12
12
  export declare const MS_PER_WEEK: number;
@@ -78,7 +78,9 @@ export declare function snapDate(ms: number, snap: GanttSnap, pxPerDay?: number)
78
78
  * level (year/month/day) and a fine level whose columns are the grid lines
79
79
  * of the timeline.
80
80
  */
81
- export declare function pickBaseUnit(pxPerDay: number): "hour" | "day" | "week" | "month" | "quarter";
81
+ export declare function pickBaseUnit(pxPerDay: number): GanttZoomTier;
82
+ /** Resolve a named zoom span to its preset px/day value (`GANTT_ZOOM_PRESETS` is the source of truth). */
83
+ export declare function zoomForSpan(span: GanttZoomTier): number;
82
84
  /**
83
85
  * Build the two header levels for the visible range. Columns align to real
84
86
  * calendar boundaries and carry their true widths (a February is narrower
@@ -117,6 +117,8 @@ export interface GANTT_ZOOM_PRESET {
117
117
  }
118
118
  /** Discrete zoom presets for the toolbar. */
119
119
  export declare const GANTT_ZOOM_PRESETS: GANTT_ZOOM_PRESET[];
120
+ /** Named zoom span — the toolbar preset labels, lowercased. */
121
+ export type GanttZoomTier = "hour" | "day" | "week" | "month" | "quarter";
120
122
  /** Inclusive zoom bounds applied to wheel/button zoom. */
121
123
  export declare const GANTT_MIN_ZOOM = 0.4;
122
124
  export declare const GANTT_MAX_ZOOM = 576;
@@ -128,6 +128,17 @@ declare const _default: import("vue").DefineComponent<{
128
128
  loadMoreLabel?: string;
129
129
  /** Shown in the header when the caller knows the true total. */
130
130
  totalCount?: number;
131
+ /**
132
+ * The word that follows the header count. Unset, the count reads
133
+ * `<n> events` — or `<n> of <totalCount> events` while a filter is
134
+ * applied — with the noun singular at one. A string substitutes the noun
135
+ * verbatim, so `countLabel="deprecation"` reads `1 deprecation` and
136
+ * `countLabel="deployments"` reads `9 deployments`; the kit never
137
+ * pluralises your noun, and the `<n> of <total>` form stays available.
138
+ * Pass `""` for the number alone, or `false` to drop the count from the
139
+ * header entirely — the title, tag and link then stand alone.
140
+ */
141
+ countLabel?: string | false;
131
142
  /** Surface, as every card in the kit takes it. @default "outlined" */
132
143
  variant?: SurfaceVariant;
133
144
  /** @default "neutral" */
@@ -211,6 +222,17 @@ declare const _default: import("vue").DefineComponent<{
211
222
  loadMoreLabel?: string;
212
223
  /** Shown in the header when the caller knows the true total. */
213
224
  totalCount?: number;
225
+ /**
226
+ * The word that follows the header count. Unset, the count reads
227
+ * `<n> events` — or `<n> of <totalCount> events` while a filter is
228
+ * applied — with the noun singular at one. A string substitutes the noun
229
+ * verbatim, so `countLabel="deprecation"` reads `1 deprecation` and
230
+ * `countLabel="deployments"` reads `9 deployments`; the kit never
231
+ * pluralises your noun, and the `<n> of <total>` form stays available.
232
+ * Pass `""` for the number alone, or `false` to drop the count from the
233
+ * header entirely — the title, tag and link then stand alone.
234
+ */
235
+ countLabel?: string | false;
214
236
  /** Surface, as every card in the kit takes it. @default "outlined" */
215
237
  variant?: SurfaceVariant;
216
238
  /** @default "neutral" */
@@ -256,6 +278,7 @@ declare const _default: import("vue").DefineComponent<{
256
278
  skeletonRows: number;
257
279
  loadMoreLabel: string;
258
280
  totalCount: number;
281
+ countLabel: string | false;
259
282
  rowVariant: SurfaceVariant;
260
283
  rowTone: SurfaceTone;
261
284
  rowCorner: SurfaceCorner;
@@ -1,8 +1,8 @@
1
1
  import type { SurfaceTone } from "../../theme/Theme";
2
- import type { GanttBarGeometry, GanttColumn, GanttDate, GanttLabels, GanttLane, GanttLink, GanttSnap, GanttTask, TrueColor } from "../../../../common/gantt";
2
+ import type { GanttBarGeometry, GanttColumn, GanttDate, GanttLabels, GanttLane, GanttLink, GanttSnap, GanttTask, GanttZoomTier, TrueColor } from "../../../../common/gantt";
3
3
  import type { VNodeChild } from "vue";
4
4
  import type { PanelCorner, PanelPadding, PanelVariant } from "../Panel.vue";
5
- export type { GanttTask, GanttLink, GanttLane, GanttColumn, GanttSnap, GanttLabels, TrueColor };
5
+ export type { GanttTask, GanttLink, GanttLane, GanttColumn, GanttSnap, GanttLabels, GanttZoomTier, TrueColor };
6
6
  /** The Panel surface variant driving the Gantt chrome (re-exported name). */
7
7
  export type GanttVariant = PanelVariant;
8
8
  /** The shared container radius scale (re-exported Panel `corner` scale). */
@@ -31,6 +31,18 @@ export interface GanttProps {
31
31
  title?: string;
32
32
  /** Right-aligned actions region (e.g. a status pill). */
33
33
  actions?: VNodeChild;
34
+ /**
35
+ * Ad-hoc controls (any Vue/HTML) placed beside the zoom selector — by
36
+ * default between the `actions` pill and the span selector.
37
+ */
38
+ headerActions?: VNodeChild;
39
+ /**
40
+ * Where `headerActions` live. `"end"` (default) pins them to the right
41
+ * zone, immediately before the zoom selector; `"start"` rides the left
42
+ * zone — after the title block, flush left when there is no icon/title.
43
+ * @default "end"
44
+ */
45
+ headerActionsAlign?: "start" | "end";
34
46
  /**
35
47
  * Enable pointer editing (move / resize / reorder / link). Defaults to
36
48
  * `true` when a change listener is provided, or when set explicitly.
@@ -42,8 +54,16 @@ export interface GanttProps {
42
54
  selectedId?: string | null;
43
55
  /** px per day. Controlled when provided with `onZoomChange`. */
44
56
  zoom?: number;
45
- /** Initial px per day when uncontrolled. Defaults to 16 (week). */
57
+ /** Initial px per day when uncontrolled. Defaults to 16 (week). Takes
58
+ * precedence over `initialSpan` when both are given. */
46
59
  initialZoom?: number;
60
+ /**
61
+ * Initial zoom span when uncontrolled — opens at that preset's zoom
62
+ * (`"hour"` … `"quarter"`, resolved via `zoomForSpan` from
63
+ * `GANTT_ZOOM_PRESETS`). Ignored when `zoom` is controlled; numeric
64
+ * `initialZoom` wins when both are given.
65
+ */
66
+ initialSpan?: GanttZoomTier;
47
67
  minZoom?: number;
48
68
  maxZoom?: number;
49
69
  /** Snap for drag edits. Defaults to `"day"`. */
@@ -52,6 +72,16 @@ export interface GanttProps {
52
72
  showToday?: boolean;
53
73
  /** Override the today date (demo/tests). */
54
74
  today?: GanttDate;
75
+ /**
76
+ * Scroll the body to bring "now" into view on open and whenever the header
77
+ * tier changes — Hour↔Day↔Week↔Month↔Quarter, i.e. preset jumps. "Now"
78
+ * centers in the **visible** timeline region (right of the fixed columns),
79
+ * and the open scroll waits for layout if the scroller mounts unmeasured
80
+ * (hidden tab, animating container). Fine zoom or pinch within a tier never
81
+ * re-centers, so manual panning is left alone. Independent of `showToday`.
82
+ * @default true
83
+ */
84
+ autoScrollToToday?: boolean;
55
85
  /** Row height in px. Defaults to 44. */
56
86
  rowHeight?: number;
57
87
  /** Total component height (px or CSS length). Defaults to 520. */
@@ -149,9 +179,10 @@ declare const _default: __VLS_WithSlots<import("vue").DefineComponent<GanttProps
149
179
  resizableColumns: boolean;
150
180
  minZoom: number;
151
181
  maxZoom: number;
152
- initialZoom: number;
182
+ headerActionsAlign: "start" | "end";
153
183
  snap: GanttSnap;
154
184
  showToday: boolean;
185
+ autoScrollToToday: boolean;
155
186
  rowHeight: number;
156
187
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
157
188
  empty?: (props: {}) => any;
@@ -0,0 +1,3 @@
1
+ export declare const Path: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
2
+ [key: string]: any;
3
+ }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -124,6 +124,7 @@ export * from "./components/OpenApp";
124
124
  export * from "./components/Orchestrator";
125
125
  export * from "./components/PaperPlane";
126
126
  export * from "./components/Parameter";
127
+ export * from "./components/Path";
127
128
  export * from "./components/Pause";
128
129
  export * from "./components/PauseCircular";
129
130
  export * from "./components/Pin";
@@ -1,3 +1,3 @@
1
1
  import type { Component } from "vue";
2
- export type IconName = "Accordion" | "Activity" | "Add" | "AgentFlow" | "AiAgent" | "Alarm" | "Apple" | "ArrowChevronLeft" | "ArrowChevronRight" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "ArrowUp" | "Artifactory" | "Attached" | "Attachment" | "Automation" | "Aws" | "Azure" | "Back" | "Backup" | "Blocked" | "BlockerCircular" | "Blueprint" | "Box" | "Brain" | "Bug" | "Cache" | "Calendar" | "CatalogManifest" | "CatalogVersion" | "CentOS" | "ChartLine" | "Chat" | "ChatApproved" | "Check" | "CheckCircle" | "CheckeredFlag" | "CheckmarkSeal" | "ChevronLeft" | "ChevronRight" | "Claim" | "Claims" | "Clean" | "CleanBrush" | "Clone" | "Close" | "Close1" | "CloudOff" | "Code" | "CodeCommit" | "CodeCompare" | "CodeFork" | "CodeMerge" | "Cog" | "Cogs" | "Comments" | "Complete" | "Container" | "Copy" | "CopyClipboard" | "Dashboard" | "Database" | "Debian" | "Details" | "Docker" | "DockerCopy" | "Dots" | "DotsVertical" | "Download" | "Drag" | "Edit" | "Equal" | "Error" | "Export" | "EyeClosed" | "EyeOpen" | "Fedora" | "File" | "FlowChart" | "Folder" | "Gantt" | "Gate" | "Gauge" | "Github" | "Globe" | "GraduationHat" | "Group" | "HalfCogs" | "HandUp" | "HealthCheck" | "Help" | "History" | "Host" | "Idea" | "Image" | "Info" | "Investigator" | "Jobs" | "KaliLinux" | "Key" | "KeyManagement" | "LXC" | "LXCOld" | "Launch" | "Library" | "Link" | "LinkAlt" | "LinkSlash" | "List" | "Live" | "Log" | "Login" | "Logout" | "Map" | "Memory" | "Minio" | "Moon" | "NetworkNodes" | "Notification" | "Official" | "Offline" | "OpenApp" | "Orchestrator" | "PaperPlane" | "Parameter" | "Pause" | "PauseCircular" | "Pin" | "Podman" | "PodmanDesktop" | "Policeman" | "Praise" | "Project" | "Pull" | "Push" | "RedHat" | "Refresh" | "RemoteHost" | "ReportFeedback" | "Reset" | "Restart" | "ReverseProxy" | "ReverseProxyCORS" | "ReverseProxyFrom" | "ReverseProxyHTTP" | "ReverseProxyHeadersRequest" | "ReverseProxyHeadersResponse" | "ReverseProxyRoutes" | "ReverseProxyTCP" | "ReverseProxyTLS" | "ReverseProxyTo" | "Revert" | "Revoke" | "Roadmap" | "Robot" | "RobotSolid" | "Rocket" | "Role" | "Roles" | "Run" | "Save" | "Scale" | "Script" | "Search" | "Send" | "Settings" | "SettingsVertical" | "Shield" | "Shop" | "Snapshot" | "Sorting" | "Stamp" | "Star" | "Stop" | "Sun" | "Suspend" | "Taint" | "Target" | "Task" | "ThemeAuto" | "ThemeDark" | "ThemeLight" | "ThumbsUp" | "Trash" | "UX" | "Ubuntu" | "Unlock" | "User" | "Users" | "Verified" | "ViewGrid" | "ViewRows" | "VirtualMachine" | "Warning" | "Whiteboard" | "Windows" | "Work" | "flow-chart" | (string & {});
2
+ export type IconName = "Accordion" | "Activity" | "Add" | "AgentFlow" | "AiAgent" | "Alarm" | "Apple" | "ArrowChevronLeft" | "ArrowChevronRight" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "ArrowUp" | "Artifactory" | "Attached" | "Attachment" | "Automation" | "Aws" | "Azure" | "Back" | "Backup" | "Blocked" | "BlockerCircular" | "Blueprint" | "Box" | "Brain" | "Bug" | "Cache" | "Calendar" | "CatalogManifest" | "CatalogVersion" | "CentOS" | "ChartLine" | "Chat" | "ChatApproved" | "Check" | "CheckCircle" | "CheckeredFlag" | "CheckmarkSeal" | "ChevronLeft" | "ChevronRight" | "Claim" | "Claims" | "Clean" | "CleanBrush" | "Clone" | "Close" | "Close1" | "CloudOff" | "Code" | "CodeCommit" | "CodeCompare" | "CodeFork" | "CodeMerge" | "Cog" | "Cogs" | "Comments" | "Complete" | "Container" | "Copy" | "CopyClipboard" | "Dashboard" | "Database" | "Debian" | "Details" | "Docker" | "DockerCopy" | "Dots" | "DotsVertical" | "Download" | "Drag" | "Edit" | "Equal" | "Error" | "Export" | "EyeClosed" | "EyeOpen" | "Fedora" | "File" | "FlowChart" | "Folder" | "Gantt" | "Gate" | "Gauge" | "Github" | "Globe" | "GraduationHat" | "Group" | "HalfCogs" | "HandUp" | "HealthCheck" | "Help" | "History" | "Host" | "Idea" | "Image" | "Info" | "Investigator" | "Jobs" | "KaliLinux" | "Key" | "KeyManagement" | "LXC" | "LXCOld" | "Launch" | "Library" | "Link" | "LinkAlt" | "LinkSlash" | "List" | "Live" | "Log" | "Login" | "Logout" | "Map" | "Memory" | "Minio" | "Moon" | "NetworkNodes" | "Notification" | "Official" | "Offline" | "OpenApp" | "Orchestrator" | "PaperPlane" | "Parameter" | "Path" | "Pause" | "PauseCircular" | "Pin" | "Podman" | "PodmanDesktop" | "Policeman" | "Praise" | "Project" | "Pull" | "Push" | "RedHat" | "Refresh" | "RemoteHost" | "ReportFeedback" | "Reset" | "Restart" | "ReverseProxy" | "ReverseProxyCORS" | "ReverseProxyFrom" | "ReverseProxyHTTP" | "ReverseProxyHeadersRequest" | "ReverseProxyHeadersResponse" | "ReverseProxyRoutes" | "ReverseProxyTCP" | "ReverseProxyTLS" | "ReverseProxyTo" | "Revert" | "Revoke" | "Roadmap" | "Robot" | "RobotSolid" | "Rocket" | "Role" | "Roles" | "Run" | "Save" | "Scale" | "Script" | "Search" | "Send" | "Settings" | "SettingsVertical" | "Shield" | "Shop" | "Snapshot" | "Sorting" | "Stamp" | "Star" | "Stop" | "Sun" | "Suspend" | "Taint" | "Target" | "Task" | "ThemeAuto" | "ThemeDark" | "ThemeLight" | "ThumbsUp" | "Trash" | "UX" | "Ubuntu" | "Unlock" | "User" | "Users" | "Verified" | "ViewGrid" | "ViewRows" | "VirtualMachine" | "Warning" | "Whiteboard" | "Windows" | "Work" | "flow-chart" | (string & {});
3
3
  export declare const iconRegistry: Record<IconName, Component>;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cjlapao/ui-kit-vue",
3
- "version": "0.2.45",
3
+ "version": "0.2.47",
4
4
  "repository": {
5
5
  "type": "git",
6
6
  "url": "git+https://github.com/cjlapao/ui-kit.git",