@konce-pt/roadmap

Rdzeń roadmapy typu Gantt Koncept UI: arytmetyka kalendarzowa (ISO 8601), model osi czasu, układ wierszy z pakowaniem pasów i geometria zależności. Czysty TypeScript, zero zależności runtime, bez wiązania z frameworkiem.

Zwykle nie instalujesz go samodzielnie: używają go @konce-pt/angular/roadmap i @konce-pt/react/roadmap, i oba re-eksportują jego API. Sięgnij po niego wprost, gdy liczysz harmonogram po stronie serwera albo budujesz własny widok na tej samej geometrii.

npm i @konce-pt/roadmap

import { buildTimeline, autoRange, isoWeekNumber } from '@konce-pt/roadmap';

// Numeracja ISO: tydzień 1 zawiera pierwszy czwartek roku.
isoWeekNumber(new Date(2027, 0, 1)); // 53

// Oś wyliczona z danych i wyrównana do pełnych jednostek.
const range = autoRange(items, { zoom: 'week' });

// Kolumny równej szerokości mimo zmiany czasu; span() daje pozycję paska jako ułamek osi.
const timeline = buildTimeline(range, 'week', { weekPrefix: 'W' });
timeline.span(start, end); // { left, width, visible, clippedStart, clippedEnd }

API

• Kalendarz — isoWeekNumber, isoWeekYear, isoWeekday, isoWeeksInYear, startOfIsoWeek, startOfDay, addDays, addHours, addMonths, addUnits, floorToUnit, ceilToUnit, countUnits, diffDays, daysInMonth, isSameDay, toTimestamp
• Oś czasu — buildTimeline
• Wiersze — normalizeItems, buildRows, packLanes, sliceRows, spanOf, rollupProgress
• Zależności — resolveLinks, linkGeometry, roundedPolyline, arrowHead
• Zakres — autoRange, resolveRange
• Typy — KptRoadmapConfig i wszystko, do czego się odwołuje

Pełny opis: llms.txt (EN) i llms-pl.txt (PL).

Testy

pnpm --filter @konce-pt/roadmap exec node --import ../../scripts/test-node-setup.mjs --test "src/**/*.test.ts"

Licencja

MIT © konce.pt