@comitor/ui 3.11.0 → 3.12.0

package/dist/components/composite/gantt-utils.js

@@ -0,0 +1,196 @@
+const MS_PER_DAY = 864e5;
+function parseDay(value) {
+  if (!value) return null;
+  const match = /^(\d{4})-(\d{2})-(\d{2})/.exec(value);
+  if (!match) return null;
+  const year = Number(match[1]);
+  const month = Number(match[2]);
+  const day = Number(match[3]);
+  const ms = Date.UTC(year, month - 1, day);
+  const check = new Date(ms);
+  if (check.getUTCMonth() !== month - 1 || check.getUTCDate() !== day) return null;
+  return Math.round(ms / MS_PER_DAY);
+}
+function formatDay(day) {
+  const date = new Date(day * MS_PER_DAY);
+  const y = date.getUTCFullYear();
+  const m = String(date.getUTCMonth() + 1).padStart(2, "0");
+  const d = String(date.getUTCDate()).padStart(2, "0");
+  return `${String(y).padStart(4, "0")}-${m}-${d}`;
+}
+function todayDay() {
+  const now = /* @__PURE__ */ new Date();
+  return Math.round(Date.UTC(now.getFullYear(), now.getMonth(), now.getDate()) / MS_PER_DAY);
+}
+function dayToLocalDate(day) {
+  const date = new Date(day * MS_PER_DAY);
+  return new Date(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate(), 12);
+}
+function weekday(day) {
+  return ((day + 4) % 7 + 7) % 7;
+}
+function parts(day) {
+  const date = new Date(day * MS_PER_DAY);
+  return { year: date.getUTCFullYear(), month: date.getUTCMonth(), date: date.getUTCDate() };
+}
+function fromParts(year, month, date) {
+  return Math.round(Date.UTC(year, month, date) / MS_PER_DAY);
+}
+function startOfUnit(day, unit, weekStartsOn = 1) {
+  switch (unit) {
+    case "day":
+      return day;
+    case "week":
+      return day - (weekday(day) - weekStartsOn + 7) % 7;
+    case "month": {
+      const p = parts(day);
+      return fromParts(p.year, p.month, 1);
+    }
+    case "quarter": {
+      const p = parts(day);
+      return fromParts(p.year, p.month - p.month % 3, 1);
+    }
+    case "year":
+      return fromParts(parts(day).year, 0, 1);
+  }
+}
+function addUnit(day, unit, amount) {
+  switch (unit) {
+    case "day":
+      return day + amount;
+    case "week":
+      return day + amount * 7;
+    case "month":
+    case "quarter":
+    case "year": {
+      const months = unit === "month" ? amount : unit === "quarter" ? amount * 3 : amount * 12;
+      const p = parts(day);
+      const target = fromParts(p.year, p.month + months, 1);
+      const lastDay = parts(fromParts(p.year, p.month + months + 1, 0)).date;
+      return target + Math.min(p.date, lastDay) - 1;
+    }
+  }
+}
+const SCALE_CONFIG = {
+  day: { pxPerDay: 36, major: "month", minor: "day", paddingDays: 14, bigStep: "week", shadeDays: true },
+  week: { pxPerDay: 14, major: "month", minor: "week", paddingDays: 42, bigStep: "week", shadeDays: true },
+  month: { pxPerDay: 4.5, major: "year", minor: "month", paddingDays: 120, bigStep: "month", shadeDays: false },
+  quarter: { pxPerDay: 1.6, major: "year", minor: "quarter", paddingDays: 365, bigStep: "month", shadeDays: false },
+  year: { pxPerDay: 0.5, major: null, minor: "year", paddingDays: 730, bigStep: "quarter", shadeDays: false }
+};
+function ticksBetween(from, to, unit, weekStartsOn = 1) {
+  const ticks = [];
+  let day = startOfUnit(from, unit, weekStartsOn);
+  for (let guard = 0; day < to && guard < 2e4; guard++) {
+    const next = addUnit(day, unit, 1);
+    ticks.push({ day, next });
+    day = next;
+  }
+  return ticks;
+}
+function computeRange(days, today, scale, weekStartsOn = 1, override) {
+  const config = SCALE_CONFIG[scale];
+  const align = config.major ?? config.minor;
+  if (override?.start != null && override.end != null && override.end >= override.start) {
+    return {
+      start: startOfUnit(override.start, config.minor, weekStartsOn),
+      end: addUnit(startOfUnit(override.end, config.minor, weekStartsOn), config.minor, 1)
+    };
+  }
+  let min = today;
+  let max = today;
+  for (const day of days) {
+    if (day < min) min = day;
+    if (day > max) max = day;
+  }
+  const start = startOfUnit(min - config.paddingDays, align, weekStartsOn);
+  const end = addUnit(startOfUnit(max + config.paddingDays, align, weekStartsOn), align, 1);
+  return { start, end };
+}
+const GAP = 10;
+const RADIUS = 5;
+function routeDependency(from, to, type, rowHeight) {
+  const fromFinish = type === "finish-to-start" || type === "finish-to-finish";
+  const toStart = type === "finish-to-start" || type === "start-to-start";
+  const sx = fromFinish ? from.x2 : from.x1;
+  const tx = toStart ? to.x1 : to.x2;
+  const exitDir = fromFinish ? 1 : -1;
+  const enterDir = toStart ? 1 : -1;
+  const sy = from.y;
+  const ty = to.y;
+  const points = [[sx, sy]];
+  if (exitDir !== enterDir) {
+    const vx = exitDir > 0 ? Math.max(sx, tx) + GAP : Math.min(sx, tx) - GAP;
+    points.push([vx, sy], [vx, ty], [tx, ty]);
+  } else if ((tx - sx) * exitDir >= GAP * 2 && sy !== ty) {
+    const vx = sx + exitDir * GAP;
+    points.push([vx, sy], [vx, ty], [tx, ty]);
+  } else if ((tx - sx) * exitDir >= GAP * 2) {
+    points.push([tx, ty]);
+  } else {
+    const p1x = sx + exitDir * GAP;
+    const p4x = tx - enterDir * GAP;
+    const midY = sy === ty ? sy + rowHeight / 2 : ty > sy ? ty - rowHeight / 2 : ty + rowHeight / 2;
+    points.push([p1x, sy], [p1x, midY], [p4x, midY], [p4x, ty], [tx, ty]);
+  }
+  return roundedPath(points);
+}
+function roundedPath(points) {
+  const pts = [];
+  for (const point of points) {
+    const prev = pts[pts.length - 1];
+    if (!prev || Math.abs(point[0] - prev[0]) > 0.01 || Math.abs(point[1] - prev[1]) > 0.01) pts.push(point);
+  }
+  if (pts.length < 2) return "";
+  const r = (n) => Math.round(n * 10) / 10;
+  const [x0, y0] = pts[0];
+  let d = `M${r(x0)},${r(y0)}`;
+  for (let i = 1; i < pts.length - 1; i++) {
+    const [px, py] = pts[i - 1];
+    const [cx, cy] = pts[i];
+    const [nx, ny] = pts[i + 1];
+    const inLen = Math.hypot(cx - px, cy - py);
+    const outLen = Math.hypot(nx - cx, ny - cy);
+    const radius = Math.min(RADIUS, inLen / 2, outLen / 2);
+    const ax = cx - (cx - px) / inLen * radius;
+    const ay = cy - (cy - py) / inLen * radius;
+    const bx = cx + (nx - cx) / outLen * radius;
+    const by = cy + (ny - cy) / outLen * radius;
+    d += ` L${r(ax)},${r(ay)} Q${r(cx)},${r(cy)} ${r(bx)},${r(by)}`;
+  }
+  const [xn, yn] = pts[pts.length - 1];
+  d += ` L${r(xn)},${r(yn)}`;
+  return d;
+}
+function isDependencyViolated(from, to, type) {
+  switch (type) {
+    case "finish-to-start":
+      return to.start <= from.end;
+    case "start-to-start":
+      return to.start < from.start;
+    case "finish-to-finish":
+      return to.end < from.end;
+    case "start-to-finish":
+      return to.end < from.start;
+  }
+}
+function shiftByUnit(start, end, unit, direction) {
+  const delta = addUnit(start, unit, direction) - start;
+  return { start: start + delta, end: end + delta };
+}
+export {
+  SCALE_CONFIG,
+  addUnit,
+  computeRange,
+  dayToLocalDate,
+  formatDay,
+  isDependencyViolated,
+  parseDay,
+  routeDependency,
+  shiftByUnit,
+  startOfUnit,
+  ticksBetween,
+  todayDay,
+  weekday
+};
+//# sourceMappingURL=gantt-utils.js.map

package/dist/components/composite/gantt-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/components/composite/gantt-utils.ts"],"sourcesContent":["/**\n * Phần THUẦN của `Gantt`: toán ngày, thang trục, định tuyến mũi tên phụ thuộc. Không React, không\n * DOM — nên kiểm được bằng Node trần (`scripts/check-gantt.mjs` gọi thẳng file build).\n *\n * KHÔNG nằm trong barrel: đây là nội tạng của component, không phải API.\n *\n * ─ VÌ SAO ĐẾM NGÀY BẰNG SỐ NGUYÊN, KHÔNG BẰNG `Date` ─\n * Mỗi ngày lịch là MỘT số nguyên: số ngày kể từ 1970-01-01 theo UTC. Cộng trừ ngày thành cộng trừ\n * số, không có giờ, không có múi giờ, không có ngày 23/25 tiếng lúc đổi giờ mùa hè. `Date` cục bộ\n * chỉ xuất hiện ở lúc ĐỊNH DẠNG nhãn (xem `dayToLocalDate`).\n */\nimport type { GanttDependencyType, GanttScale } from \"./gantt-constants.js\";\n\nconst MS_PER_DAY = 86_400_000;\n\n/** `\"2026-10-30\"` → số ngày. Chuỗi hỏng → `null` (không ném: dữ liệu bẩn không được làm đổ cả lưới). */\nexport function parseDay(value: string | null | undefined): number | null {\n  if (!value) return null;\n  const match = /^(\\d{4})-(\\d{2})-(\\d{2})/.exec(value);\n  if (!match) return null;\n  const year = Number(match[1]);\n  const month = Number(match[2]);\n  const day = Number(match[3]);\n  const ms = Date.UTC(year, month - 1, day);\n  const check = new Date(ms);\n  if (check.getUTCMonth() !== month - 1 || check.getUTCDate() !== day) return null;\n  return Math.round(ms / MS_PER_DAY);\n}\n\n/** Số ngày → `\"yyyy-MM-dd\"`. */\nexport function formatDay(day: number): string {\n  const date = new Date(day * MS_PER_DAY);\n  const y = date.getUTCFullYear();\n  const m = String(date.getUTCMonth() + 1).padStart(2, \"0\");\n  const d = String(date.getUTCDate()).padStart(2, \"0\");\n  return `${String(y).padStart(4, \"0\")}-${m}-${d}`;\n}\n\n/** Hôm nay theo LỊCH của máy người dùng (không phải theo UTC — 7 giờ sáng ở Hà Nội vẫn là hôm nay). */\nexport function todayDay(): number {\n  const now = new Date();\n  return Math.round(Date.UTC(now.getFullYear(), now.getMonth(), now.getDate()) / MS_PER_DAY);\n}\n\n/** `Date` CỤC BỘ lúc 12 giờ trưa của ngày đó — chỉ để đưa cho `Intl.DateTimeFormat`. */\nexport function dayToLocalDate(day: number): Date {\n  const date = new Date(day * MS_PER_DAY);\n  return new Date(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate(), 12);\n}\n\n/** Thứ trong tuần: 0 = Chủ nhật … 6 = Thứ bảy (khớp `Date#getDay`). 1970-01-01 là thứ năm. */\nexport function weekday(day: number): number {\n  return (((day + 4) % 7) + 7) % 7;\n}\n\nfunction parts(day: number) {\n  const date = new Date(day * MS_PER_DAY);\n  return { year: date.getUTCFullYear(), month: date.getUTCMonth(), date: date.getUTCDate() };\n}\n\nfunction fromParts(year: number, month: number, date: number): number {\n  return Math.round(Date.UTC(year, month, date) / MS_PER_DAY);\n}\n\nexport type GanttUnit = \"day\" | \"week\" | \"month\" | \"quarter\" | \"year\";\n\n/** Ngày đầu của đơn vị chứa `day`. Tuần bắt đầu ở `weekStartsOn` (1 = thứ hai, theo ISO và lịch Việt). */\nexport function startOfUnit(day: number, unit: GanttUnit, weekStartsOn = 1): number {\n  switch (unit) {\n    case \"day\":\n      return day;\n    case \"week\":\n      return day - ((weekday(day) - weekStartsOn + 7) % 7);\n    case \"month\": {\n      const p = parts(day);\n      return fromParts(p.year, p.month, 1);\n    }\n    case \"quarter\": {\n      const p = parts(day);\n      return fromParts(p.year, p.month - (p.month % 3), 1);\n    }\n    case \"year\":\n      return fromParts(parts(day).year, 0, 1);\n  }\n}\n\n/** Cộng `amount` đơn vị. Tháng/quý/năm cộng theo LỊCH (31/1 + 1 tháng = 28 hoặc 29/2, không tràn sang tháng 3). */\nexport function addUnit(day: number, unit: GanttUnit, amount: number): number {\n  switch (unit) {\n    case \"day\":\n      return day + amount;\n    case \"week\":\n      return day + amount * 7;\n    case \"month\":\n    case \"quarter\":\n    case \"year\": {\n      const months = unit === \"month\" ? amount : unit === \"quarter\" ? amount * 3 : amount * 12;\n      const p = parts(day);\n      const target = fromParts(p.year, p.month + months, 1);\n      const lastDay = parts(fromParts(p.year, p.month + months + 1, 0)).date;\n      return target + Math.min(p.date, lastDay) - 1;\n    }\n  }\n}\n\nexport interface ScaleConfig {\n  /** Bề rộng một ngày, px. */\n  pxPerDay: number;\n  /** Đơn vị của hàng trên của đầu trục (`null` = không có hàng trên). */\n  major: GanttUnit | null;\n  /** Đơn vị của hàng dưới — cũng là bước của vạch lưới. */\n  minor: GanttUnit;\n  /** Lề thêm hai đầu dải ngày, tính bằng ngày. */\n  paddingDays: number;\n  /** Bước của Shift+mũi tên. */\n  bigStep: GanttUnit;\n  /** Tô ngày nghỉ hay không — ở bậc tháng trở lên một ngày < 5px, tô ra chỉ thành vệt nhiễu. */\n  shadeDays: boolean;\n}\n\n/**\n * Bề rộng mỗi bậc chọn sao cho ô của hàng dưới ĐỦ chỗ cho nhãn của nó: ngày 36px (số + thứ), tuần\n * 98px (\"26 thg 10\"), tháng ~135px, quý ~146px, năm ~183px. Bộ bậc ngày → năm cùng bộ với Timeline\n * của Linear (docs/gantt.md §1); con số px là của gói, không đo từ Linear.\n */\nexport const SCALE_CONFIG: Record<GanttScale, ScaleConfig> = {\n  day: { pxPerDay: 36, major: \"month\", minor: \"day\", paddingDays: 14, bigStep: \"week\", shadeDays: true },\n  week: { pxPerDay: 14, major: \"month\", minor: \"week\", paddingDays: 42, bigStep: \"week\", shadeDays: true },\n  month: { pxPerDay: 4.5, major: \"year\", minor: \"month\", paddingDays: 120, bigStep: \"month\", shadeDays: false },\n  quarter: { pxPerDay: 1.6, major: \"year\", minor: \"quarter\", paddingDays: 365, bigStep: \"month\", shadeDays: false },\n  year: { pxPerDay: 0.5, major: null, minor: \"year\", paddingDays: 730, bigStep: \"quarter\", shadeDays: false }\n};\n\nexport interface Tick {\n  /** Ngày đầu của ô. */\n  day: number;\n  /** Ngày đầu của ô KẾ TIẾP (= ngày cuối + 1). */\n  next: number;\n}\n\n/** Mọi ô của `unit` giao với `[from, to)`. Ô đầu có thể bắt đầu trước `from`. */\nexport function ticksBetween(from: number, to: number, unit: GanttUnit, weekStartsOn = 1): Tick[] {\n  const ticks: Tick[] = [];\n  let day = startOfUnit(from, unit, weekStartsOn);\n  // Chặn cứng số vòng: dải ngày do dữ liệu quyết định, và một ngày hỏng kiểu năm 9999 ở bậc \"ngày\"\n  // không được treo tab.\n  for (let guard = 0; day < to && guard < 20_000; guard++) {\n    const next = addUnit(day, unit, 1);\n    ticks.push({ day, next });\n    day = next;\n  }\n  return ticks;\n}\n\nexport interface DayRange {\n  start: number;\n  /** Ngày đầu NGOÀI dải (nửa mở). */\n  end: number;\n}\n\n/**\n * Dải ngày của trục: bao mọi thanh + hôm nay, nới hai đầu theo bậc, rồi căn về đầu ô của hàng dưới\n * (và của hàng trên, nếu có) để ô đầu/cuối không bị cắt dở.\n */\nexport function computeRange(\n  days: number[],\n  today: number,\n  scale: GanttScale,\n  weekStartsOn = 1,\n  override?: { start: number | null; end: number | null }\n): DayRange {\n  const config = SCALE_CONFIG[scale];\n  const align = config.major ?? config.minor;\n  if (override?.start != null && override.end != null && override.end >= override.start) {\n    return {\n      start: startOfUnit(override.start, config.minor, weekStartsOn),\n      end: addUnit(startOfUnit(override.end, config.minor, weekStartsOn), config.minor, 1)\n    };\n  }\n  let min = today;\n  let max = today;\n  for (const day of days) {\n    if (day < min) min = day;\n    if (day > max) max = day;\n  }\n  const start = startOfUnit(min - config.paddingDays, align, weekStartsOn);\n  const end = addUnit(startOfUnit(max + config.paddingDays, align, weekStartsOn), align, 1);\n  return { start, end };\n}\n\n/** Một thanh đã đổi ra toạ độ: `x1`/`x2` là mép trái/phải (px, tính từ đầu trục), `y` là tâm dòng. */\nexport interface BarGeometry {\n  x1: number;\n  x2: number;\n  y: number;\n}\n\nconst GAP = 10;\nconst RADIUS = 5;\n\n/**\n * Đường đi của một mũi tên phụ thuộc — các đoạn ngang/dọc, góc bo tròn.\n *\n * Mũi tên RỜI thanh trước ở mép ứng với kiểu quan hệ (`finish` = mép phải, `start` = mép trái) và\n * CHẠM thanh sau cũng vậy. Khi thanh sau nằm đủ xa về phía trước: rời mép, đi ngang một đoạn, đổ dọc\n * xuống dòng đích, rẽ vào. Khi không đủ chỗ (thanh sau bắt đầu trước khi thanh trước xong — chính là\n * ca VI PHẠM): vòng qua khe giữa hai dòng rồi mới quay lại, để mũi tên không cắt ngang qua thanh.\n */\nexport function routeDependency(\n  from: BarGeometry,\n  to: BarGeometry,\n  type: GanttDependencyType,\n  rowHeight: number\n): string {\n  const fromFinish = type === \"finish-to-start\" || type === \"finish-to-finish\";\n  const toStart = type === \"finish-to-start\" || type === \"start-to-start\";\n  const sx = fromFinish ? from.x2 : from.x1;\n  const tx = toStart ? to.x1 : to.x2;\n  const exitDir = fromFinish ? 1 : -1;\n  // Hướng ĐI của mũi tên lúc chạm đích: chạm mép trái thì đang đi sang phải, và ngược lại.\n  const enterDir = toStart ? 1 : -1;\n  const sy = from.y;\n  const ty = to.y;\n  const points: Array<[number, number]> = [[sx, sy]];\n\n  if (exitDir !== enterDir) {\n    // start→start / finish→finish: cùng ra và vào một phía — đi thẳng ra mép ngoài cùng rồi đổ dọc.\n    const vx = exitDir > 0 ? Math.max(sx, tx) + GAP : Math.min(sx, tx) - GAP;\n    points.push([vx, sy], [vx, ty], [tx, ty]);\n  } else if ((tx - sx) * exitDir >= GAP * 2 && sy !== ty) {\n    const vx = sx + exitDir * GAP;\n    points.push([vx, sy], [vx, ty], [tx, ty]);\n  } else if ((tx - sx) * exitDir >= GAP * 2) {\n    points.push([tx, ty]);\n  } else {\n    // Không đủ chỗ: đi ra, vòng qua khe giữa hai dòng, đi lùi, rồi vào.\n    const p1x = sx + exitDir * GAP;\n    const p4x = tx - enterDir * GAP;\n    const midY = sy === ty ? sy + rowHeight / 2 : ty > sy ? ty - rowHeight / 2 : ty + rowHeight / 2;\n    points.push([p1x, sy], [p1x, midY], [p4x, midY], [p4x, ty], [tx, ty]);\n  }\n  return roundedPath(points);\n}\n\n/** Polyline → `d` của SVG với góc bo `RADIUS` (bo nhỏ lại khi đoạn ngắn hơn hai lần bán kính). */\nfunction roundedPath(points: Array<[number, number]>): string {\n  const pts: Array<[number, number]> = [];\n  for (const point of points) {\n    const prev = pts[pts.length - 1];\n    if (!prev || Math.abs(point[0] - prev[0]) > 0.01 || Math.abs(point[1] - prev[1]) > 0.01) pts.push(point);\n  }\n  if (pts.length < 2) return \"\";\n  const r = (n: number) => Math.round(n * 10) / 10;\n  const [x0, y0] = pts[0]!;\n  let d = `M${r(x0)},${r(y0)}`;\n  for (let i = 1; i < pts.length - 1; i++) {\n    const [px, py] = pts[i - 1]!;\n    const [cx, cy] = pts[i]!;\n    const [nx, ny] = pts[i + 1]!;\n    const inLen = Math.hypot(cx - px, cy - py);\n    const outLen = Math.hypot(nx - cx, ny - cy);\n    const radius = Math.min(RADIUS, inLen / 2, outLen / 2);\n    const ax = cx - ((cx - px) / inLen) * radius;\n    const ay = cy - ((cy - py) / inLen) * radius;\n    const bx = cx + ((nx - cx) / outLen) * radius;\n    const by = cy + ((ny - cy) / outLen) * radius;\n    d += ` L${r(ax)},${r(ay)} Q${r(cx)},${r(cy)} ${r(bx)},${r(by)}`;\n  }\n  const [xn, yn] = pts[pts.length - 1]!;\n  d += ` L${r(xn)},${r(yn)}`;\n  return d;\n}\n\n/**\n * Phụ thuộc có đang bị vi phạm không, theo ngày (cả hai đầu BAO GỒM):\n *   finish-to-start  — việc sau phải bắt đầu SAU ngày việc trước xong;\n *   start-to-start   — việc sau không bắt đầu trước việc trước;\n *   finish-to-finish — việc sau không xong trước việc trước;\n *   start-to-finish  — việc sau không xong trước khi việc trước bắt đầu.\n */\nexport function isDependencyViolated(\n  from: { start: number; end: number },\n  to: { start: number; end: number },\n  type: GanttDependencyType\n): boolean {\n  switch (type) {\n    case \"finish-to-start\":\n      return to.start <= from.end;\n    case \"start-to-start\":\n      return to.start < from.start;\n    case \"finish-to-finish\":\n      return to.end < from.end;\n    case \"start-to-finish\":\n      return to.end < from.start;\n  }\n}\n\n/** Dịch cả dải `[start, end]` đi một BƯỚC theo đơn vị, giữ nguyên độ dài theo ngày. */\nexport function shiftByUnit(start: number, end: number, unit: GanttUnit, direction: 1 | -1) {\n  const delta = addUnit(start, unit, direction) - start;\n  return { start: start + delta, end: end + delta };\n}\n"],"mappings":"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","names":[]}

package/dist/components/composite/gantt.d.ts

@@ -0,0 +1,93 @@
+import * as React from 'react';
+import { GanttItem, GanttDependency, GanttScale, GanttItemChange, GanttDependencyDraft, GanttLabels } from './gantt-constants.js';
+
+interface GanttProps extends Omit<React.ComponentProps<"div">, "children" | "onChange"> {
+    /**
+     * Các dòng, ĐÚNG thứ tự hiển thị. Gantt không tự sắp, không tự ẩn con của nhánh đang thu: app giữ
+     * cây, lọc theo `expanded`, rồi đưa danh sách phẳng vào đây (xem `onExpandedChange`).
+     */
+    items: GanttItem[];
+    /** Mũi tên phụ thuộc. Phụ thuộc trỏ tới việc không có trong `items` (hoặc chưa có ngày) thì bỏ qua. */
+    dependencies?: GanttDependency[];
+    /** Bậc phóng (controlled). Bỏ trống thì Gantt tự giữ, bắt đầu từ `defaultScale`. */
+    scale?: GanttScale;
+    /** Bậc phóng ban đầu khi không controlled (mặc định `week`). */
+    defaultScale?: GanttScale;
+    onScaleChange?: (scale: GanttScale) => void;
+    /** Hôm nay `yyyy-MM-dd` (mặc định: theo đồng hồ máy người dùng). Truyền khi cần khớp giờ server. */
+    today?: string;
+    /** Các thứ nghỉ trong tuần, 0 = Chủ nhật … 6 = Thứ bảy (mặc định `[0, 6]`). */
+    weekendDays?: number[];
+    /** Ngày nghỉ lễ / nghỉ bù của workspace, `yyyy-MM-dd`. Tô như cuối tuần. */
+    nonWorkingDays?: string[];
+    /** Ngày đầu tuần: 1 = thứ hai (mặc định, ISO), 0 = chủ nhật. */
+    weekStartsOn?: 0 | 1;
+    /**
+     * Dải ngày cố định của trục. Bỏ trống thì trục tự bao mọi thanh + hôm nay, nới thêm hai đầu theo bậc.
+     */
+    range?: {
+        start: string;
+        end: string;
+    };
+    /** Khoá mọi thao tác sửa (kéo, giãn, phím, nối phụ thuộc). Dòng nào cần khoá riêng: `item.readOnly`. */
+    readOnly?: boolean;
+    /**
+     * Người dùng đổi ngày (kéo, giãn, phím mũi tên, bấm xếp lịch). Gantt KHÔNG tự ghi: app cập nhật dữ
+     * liệu rồi truyền `items` mới. Không truyền = không sửa được.
+     */
+    onItemChange?: (change: GanttItemChange) => void;
+    /** Mở một mục: Enter trên dòng, bấm đúp thanh, bấm tên ở cột trái. */
+    onItemOpen?: (item: GanttItem) => void;
+    /** Bấm nút mở/thu (hoặc Space) trên dòng có `hasChildren`. */
+    onExpandedChange?: (id: string, expanded: boolean) => void;
+    /**
+     * Người dùng kéo từ chấm ở đuôi một thanh sang thanh khác. Truyền mới hiện chấm nối. Chỉ có đường
+     * CHUỘT/CHẠM — app phải có thêm một lối bàn phím (menu "Thêm phụ thuộc") cho cùng việc.
+     */
+    onDependencyCreate?: (dependency: GanttDependencyDraft) => void;
+    /** Bấm vào một mũi tên — vd mở menu xoá phụ thuộc. */
+    onDependencyClick?: (dependency: GanttDependency) => void;
+    /**
+     * Chiều cao dòng, px. Mặc định 36 — và 44 trên thiết bị chạm (`pointer: coarse`), để thanh và tay
+     * giãn đạt vùng chạm 44px.
+     */
+    rowHeight?: number;
+    /** Bề rộng cột trái, px (mặc định 280). */
+    sidebarWidth?: number;
+    /** Tiêu đề cột trái (mặc định: khoá `sidebarTitle`). */
+    sidebarTitle?: React.ReactNode;
+    /** Nội dung cột trái của một dòng — thay cho tên trần (vd thêm mã việc, avatar người phụ trách). */
+    renderSidebarItem?: (item: GanttItem) => React.ReactNode;
+    /**
+     * Thanh công cụ phía trên (chọn bậc + nút Hôm nay). `false` = ẩn (app tự dựng bằng `GANTT_SCALES`);
+     * truyền một node = giữ thanh mặc định và đặt node đó ở đầu bên phải.
+     */
+    toolbar?: boolean | React.ReactNode;
+    /** Đè từng chữ (namespace `gantt` của `ComitorLocaleProvider`). */
+    labels?: Partial<GanttLabels>;
+}
+/**
+ * Trục thời gian / Gantt: cột tên bên trái, thanh theo ngày bên phải, mũi tên phụ thuộc, vạch hôm nay,
+ * tô ngày nghỉ, làm nổi đường găng. Dùng cho Gantt việc (bậc ngày/tuần) lẫn lộ trình dự án (bậc
+ * tháng/quý/năm). Phần lộ trình mượn Timeline dự án của Linear; phần Gantt mức việc Linear KHÔNG có —
+ * nó theo quy ước Gantt thông dụng (docs/gantt.md §1).
+ *
+ * ─ CONTROLLED ─
+ * Gantt không giữ dữ liệu nghiệp vụ. Mọi thay đổi ngày đi ra qua `onItemChange`, mọi phụ thuộc mới
+ * qua `onDependencyCreate`; app ghi rồi truyền `items`/`dependencies` mới. Trong lúc KÉO, thanh chạy
+ * theo một bản nháp nội bộ và chỉ báo ra MỘT lần khi thả — app không nhận 60 lần gọi mỗi giây.
+ *
+ * ─ BÀN PHÍM ─ (một điểm dừng Tab cho cả lưới — dòng đang chọn)
+ *   ↑ ↓ Home End PageUp PageDown — chuyển dòng · ← → — dời một ngày · Shift+← → — dời một bước lớn
+ *   (tuần, hoặc tháng ở bậc tháng trở lên) · Alt+← → — đổi ngày kết thúc · Alt+Shift+← → — đổi ngày
+ *   bắt đầu · Enter — `onItemOpen` · Space — mở/thu nhánh.
+ * Mỗi lần đổi bằng phím là một lần `onItemChange` (app tự gộp nếu cần), kèm lời xướng qua `aria-live`.
+ *
+ * ─ ẢO HOÁ ─
+ * Dòng ảo hoá bằng `@tanstack/react-virtual`; ô của đầu trục, vạch lưới và mũi tên chỉ dựng trong
+ * phần đang nhìn thấy — 1.000 dòng × nhiều năm ở bậc ngày vẫn chỉ vài chục dòng trong DOM. Phía
+ * server chưa có khung để đo nên trả về đầu trục và 0 dòng (cùng hành vi `DataGrid`).
+ */
+declare function Gantt({ items, dependencies, scale: scaleProp, defaultScale, onScaleChange, today: todayProp, weekendDays, nonWorkingDays, weekStartsOn, range: rangeProp, readOnly, onItemChange, onItemOpen, onExpandedChange, onDependencyCreate, onDependencyClick, rowHeight: rowHeightProp, sidebarWidth, sidebarTitle, renderSidebarItem, toolbar, labels, className, "aria-label": ariaLabel, ...props }: GanttProps): React.JSX.Element;
+
+export { Gantt, type GanttProps };