Dependencies module (FS/SS/FF/SF)

Open
#32 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
35/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Quiet
Tech stack
typescript
Domain
api

Research direction

Read parent issue #25 and the module API work in issue #28 first; this issue is blocked by #28. Then inspect CalendarCore and the existing write pipeline to understand where dependency handling belongs. Done means the module meets the listed creation, cycle validation, cascading, validation, and tree-shaking criteria.

Written by the indexing model from the issue text.

Description

enhancement

Parent

https://github.com/TanStack/time/issues/25

What to build

Extract the FS/SS/FF/SF event dependency system into a proper module. When registered, the module adds dependency-aware transformation to the write pipeline: moving a predecessor event automatically cascades the required shift to all dependents in topological order.

This module is the reason the Timeline/Gantt view exists as a product. Extracting it from `CalendarCore` into a module also fixes the current architecture where Gantt semantics are baked into the Calendar kernel.

Acceptance criteria

  • `DependenciesModule` plugs into the kernel via the module API (#28)
  • `createDependency(sourceId, targetId, type)` creates a link and validates it does not form a cycle
  • Moving a predecessor cascades the correct shift to all dependents (FS: finish-to-start, SS: start-to-start, FF: finish-to-finish, SF: start-to-finish)
  • Cascade propagates transitively through the dependency graph in topological order
  • `validateEventDependencies()` checks whether placing an event satisfies its predecessor constraints
  • Circular dependency detection rejects the link with a descriptive error before it is committed
  • Removing the `DependenciesModule` causes dependency code to tree-shake out of the bundle

Blocked by

https://github.com/TanStack/time/issues/28

Dominant language
TypeScript
Stars
621
Forks
6
PR merge metrics
No merged PRs in 30d

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from TanStack/time

All issues in TanStack/time

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.