Class TaskList

constructor

• new TaskList(
      calendar$: BehaviorSubject<WorkingCalendar>,
      projectTimeline$: BehaviorSubject<DateRange>,
      locale$?: BehaviorSubject<TimelineKitLocale>,
  ): TaskList

  Parameters

  • calendar$: BehaviorSubject<WorkingCalendar>
  • projectTimeline$: BehaviorSubject<DateRange>
  • Optionallocale$: BehaviorSubject<TimelineKitLocale>

  Returns TaskList

complexOperationFinished$

filterChanged$

linkAdded$

linkRemoved$

resourceAdding$

taskAdded$

taskCollapsedChanged$

taskChanged$

taskRemoved$

taskTypeChanged$

evaluatingDependencies

• get evaluatingDependencies(): boolean

  Whether link dependencies are currently being evaluated (prevents re-entrant updates).

  Returns boolean

evaluatingDependenciesFinished$

• get evaluatingDependenciesFinished$(): Subject<void>

  Emitted after dependency evaluation completes.

  Returns Subject<void>

filter

• get filter(): TaskFilterFn | null

  Active task filter function. Set to null to show all tasks.

  Returns TaskFilterFn | null

• set filter(value: TaskFilterFn | null): void

  Parameters

  • value: TaskFilterFn | null

  Returns void

length

• get length(): number

  Total number of tasks (including Empty rows).

  Returns number

linksLength

• get linksLength(): number

  Total number of links.

  Returns number

maxEndTime

• get maxEndTime(): Date | null

  Latest end time across all non-empty tasks, or null if no tasks exist.

  Returns Date | null

minStartTime

• get minStartTime(): Date | null

  Earliest start time across all non-empty tasks, or null if no tasks exist.

  Returns Date | null

addEmptyTask

• addEmptyTask(): Task

  Append an empty placeholder row at the end of the list.

  Returns Task

addLink

• addLink(from: Task, to: Task, type: TaskLinkType, lag?: Lag): TaskLink

  Create a dependency link between two tasks. Validates against cycles, self-links, and parent-child links.

  Parameters

  • from: Task
  • to: Task
  • type: TaskLinkType
  • Optionallag: Lag

  Returns TaskLink

addTask

• addTask(task: Task): Task

  Add a task to the end of the list.

  Parameters

  • task: Task

  Returns Task

assign

• assign(tasks: Task[], links: TaskLink[]): void

  Replace all tasks and links with a new set (bulk load).

  Parameters

  • tasks: Task[]
  • links: TaskLink[]

  Returns void

clear

• clear(): void

  Remove all tasks and links.

  Returns void

createTask

• createTask(id?: string): Task

  Create a new Task instance wired to this list's calendar and project timeline, without adding it to the list.

  Parameters

  • Optionalid: string

  Returns Task

existsLinkBetween

• existsLinkBetween(task1: Task, task2: Task): boolean

  Check whether a link exists between two tasks (in either direction).

  Parameters

  • task1: Task
  • task2: Task

  Returns boolean

getFirstTaskIndex

• getFirstTaskIndex(tasks: Task[]): number | null

  Get the lowest index among the given tasks, or null if empty.

  Parameters

  • tasks: Task[]

  Returns number | null

getLastDescendant

• getLastDescendant(task: Task): Task

  Get the deepest last descendant of a task (used for move operations).

  Parameters

  • task: Task

  Returns Task

getLastNonEmpty

• getLastNonEmpty(includeHidden?: boolean): Task | null

  Get the last non-empty task in the list.

  Parameters

  • includeHidden: boolean = true

  Returns Task | null

getLink

• getLink(index: number): TaskLink

  Get a link by index.

  Parameters

  • index: number

  Returns TaskLink

getNextAtLevel

• getNextAtLevel(task: Task, level: number): Task | null

  Get the next non-empty task at the specified hierarchy level.

  Parameters

  • task: Task
  • level: number

  Returns Task | null

getNextNonEmpty

• getNextNonEmpty(task: Task): Task | null

  Get the next non-empty task after the given task.

  Parameters

  • task: Task

  Returns Task | null

getNextSibling

• getNextSibling(task: Task): Task | null

  Get the next sibling at the same hierarchy level.

  Parameters

  • task: Task

  Returns Task | null

getNextSiblings

• getNextSiblings(task: Task): Task[]

  Get all subsequent siblings at the same hierarchy level.

  Parameters

  • task: Task

  Returns Task[]

getNextVisible

• getNextVisible(task: Task): Task | null

  Get the next visible (not hidden) task after the given task.

  Parameters

  • task: Task

  Returns Task | null

getPreviousNonEmpty

• getPreviousNonEmpty(task: Task, level: number | null): Task | null

  Get the previous non-empty task at the given level, or any level if null.

  Parameters

  • task: Task
  • level: number | null

  Returns Task | null

getPreviousVisible

• getPreviousVisible(task: Task): Task | null

  Get the previous visible (not hidden) task before the given task.

  Parameters

  • task: Task

  Returns Task | null

getTask

• getTask(index: number): Task

  Get a task by index.

  Parameters

  • index: number

  Returns Task

getTaskById

• getTaskById(id: string): Task | null

  Find a task by ID, or null if not found.

  Parameters

  • id: string

  Returns Task | null

getTaskNumber

• getTaskNumber(task: Task): number

  Get the 1-based row number of a task.

  Parameters

  • task: Task

  Returns number

getTasksUsingResource

• getTasksUsingResource(resource: Resource): Task[]

  Get all tasks that have the given resource assigned.

  Parameters

  • resource: Resource

  Returns Task[]

indent

• indent(tasks: Task[]): void

  Indent tasks one level deeper (make them subtasks of the previous sibling).

  Parameters

  • tasks: Task[]

  Returns void

indexOf

• indexOf(task: Task): number

  Get the index of a task in the list.

  Parameters

  • task: Task

  Returns number

insertEmptyTask

• insertEmptyTask(index: number): Task

  Insert an empty placeholder row at the given index.

  Parameters

  • index: number

  Returns Task

insertTask

• insertTask(index: number, task: Task): Task

  Insert a task at the given index.

  Parameters

  • index: number
  • task: Task

  Returns Task

isValidTypeForLink

• isValidTypeForLink(task: Task): boolean

  Check whether a task type supports links (only Task and Milestone).

  Parameters

  • task: Task

  Returns boolean

moveDown

• moveDown(tasks: Task[]): void

  Move tasks down one position in the list.

  Parameters

  • tasks: Task[]

  Returns void

moveUp

• moveUp(tasks: Task[]): void

  Move tasks up one position in the list.

  Parameters

  • tasks: Task[]

  Returns void

outdent

• outdent(tasks: Task[]): void

  Outdent tasks one level (move them out of their parent summary).

  Parameters

  • tasks: Task[]

  Returns void

removeLink

• removeLink(link: TaskLink): void

  Remove a dependency link. Restores the successor's base start time if available.

  Parameters

  • link: TaskLink

  Returns void

removeTask

• removeTask(task: Task): void

  Remove a task and all its links.

  Parameters

  • task: Task

  Returns void

removeTasks

• removeTasks(tasks: Task[]): void

  Remove multiple tasks.

  Parameters

  • tasks: Task[]

  Returns void

renameTaskProperty

• renameTaskProperty(oldName: string, newName: string): void

  Rename a custom property across all tasks.

  Parameters

  • oldName: string
  • newName: string

  Returns void

wouldCreateCycle

• wouldCreateCycle(from: Task, to: Task): boolean

  Check whether adding a link from → to would create a dependency cycle.

  Parameters

  • from: Task
  • to: Task

  Returns boolean