vault

type AssetMeta struct {
	Path      string `json:"path"`
	Name      string `json:"name"`
	Size      int64  `json:"size"`
	UpdatedAt int64  `json:"updatedAt"`
}

type ComposeTaskFileInput struct {
	Title       string
	Status      string
	Priority    string
	Due         string
	Scheduled   string
	Tags        []string
	DateCreated string
	Body        string
}

type CustomTemplateFile struct {
	SourcePath string `json:"sourcePath"`
	Raw        string `json:"raw"`
}

type DateNotePattern struct {
	Directory    string `json:"directory"`
	TitlePattern string `json:"titlePattern,omitempty"`
	Locale       string `json:"locale,omitempty"`
}

type FolderEntry struct {
	Folder  NoteFolder `json:"folder"`
	Subpath string     `json:"subpath"`
}

type FrontmatterUpdate struct {
	Key   string
	Value *string
}

type NoteComment struct {
	ID          string `json:"id"`
	NotePath    string `json:"notePath"`
	AnchorStart int    `json:"anchorStart"`
	AnchorEnd   int    `json:"anchorEnd"`
	AnchorText  string `json:"anchorText"`
	Body        string `json:"body"`
	CreatedAt   int64  `json:"createdAt"`
	UpdatedAt   int64  `json:"updatedAt"`
	ResolvedAt  *int64 `json:"resolvedAt"`
	Author      string `json:"author,omitempty"`
	ParentID    string `json:"parentId,omitempty"`
}

type NoteCommentThread struct {
	Comment NoteComment
	Replies []NoteComment
}

type NoteContent struct {
	NoteMeta
	Body string `json:"body"`
}

type NoteFolder string

type NoteMeta struct {
	// Path is vault-relative and always POSIX-separated.
	Path string `json:"path"`
	// Link is the `zennotes://open?path=…` URL that focuses the app on the
	// note. Presented to humans; tools are handed Path.
	Link      string     `json:"link"`
	Title     string     `json:"title"`
	Folder    NoteFolder `json:"folder"`
	CreatedAt int64      `json:"createdAt"`
	UpdatedAt int64      `json:"updatedAt"`
	Size      int64      `json:"size"`
	Tags      []string   `json:"tags"`
	Wikilinks []string   `json:"wikilinks"`
	Excerpt   string     `json:"excerpt"`
}

type OutlineItem struct {
	Level int
	Text  string
	// Line is 1-based.
	Line int
}

type ParseTasksOptions struct {
	// IncludeExcluded scans past the vault's excluded-folders list and the
	// note-level frontmatter `tasks:` opt-out. The `--include-excluded`
	// escape hatch; listings never set it on their own.
	IncludeExcluded bool
	Dialect         TaskDialect
}

type PeriodicNotes struct {
	Enabled        bool
	Directory      string
	TitlePattern   string
	Locale         string
	LegacyPatterns []DateNotePattern
	TemplateID     string
	// Daily only.
	TasksDueOnNoteDate      bool
	RolloverUnfinishedTasks bool
}

type PrimaryNotesLocation string

type Task struct {
	// ID is `<path>#<taskIndex>` for a checkbox line and `<path>#task` for a
	// task file. Stable across plain edits, so it is what toggles take.
	ID         string     `json:"id"`
	SourcePath string     `json:"sourcePath"`
	Link       string     `json:"link"`
	NoteTitle  string     `json:"noteTitle"`
	NoteFolder NoteFolder `json:"noteFolder"`
	// LineNumber is zero-based over the whole file, frontmatter included.
	LineNumber int    `json:"lineNumber"`
	TaskIndex  int    `json:"taskIndex"`
	RawText    string `json:"rawText"`
	Content    string `json:"content"`
	Checked    bool   `json:"checked"`
	// Cancelled is a `[-]` line: intentionally abandoned.
	Cancelled bool `json:"cancelled"`
	// InProgress is a `[/]` line: started, not finished. Still open work.
	InProgress bool `json:"inProgress"`
	// Forwarded is a `[>]` record: the task moved to another note.
	Forwarded bool   `json:"forwarded"`
	Due       string `json:"due,omitempty"`
	Priority  string `json:"priority,omitempty"`
	Waiting   bool   `json:"waiting"`
	// Fields holds inline `@key:value` tokens (lower-cased), the note's
	// frontmatter `status:` folded in. Any key can drive a Kanban board.
	Fields map[string]string `json:"fields,omitempty"`
	Status string            `json:"status,omitempty"`
	Tags   []string          `json:"tags"`
	// Kind is "file" for a whole-note task; empty means an inline checkbox.
	Kind          string `json:"kind,omitempty"`
	Scheduled     string `json:"scheduled,omitempty"`
	CompletedDate string `json:"completedDate,omitempty"`
	// DueInferred marks a due date derived from the containing daily note
	// rather than written on the line. Set by the TUI, never by a scan.
	DueInferred bool `json:"dueInferred,omitempty"`
}

type TaskDialect int

type TaskGroups struct {
	Today        []Task
	Upcoming     []Task
	Waiting      []Task
	Done         []Task
	Forwarded    []Task
	Cancelled    []Task
	OverdueCount int
}

type TextSearchMatch struct {
	Path       string     `json:"path"`
	Link       string     `json:"link"`
	Title      string     `json:"title"`
	Folder     NoteFolder `json:"folder"`
	LineNumber int        `json:"lineNumber"`
	LineText   string     `json:"lineText"`
}

type Vault struct {

	// SyncTitleHeading rewrites a note's leading `# Heading` on rename, the
	// desktop's "Sync title heading on rename" preference. On by default.
	SyncTitleHeading bool
	// contains filtered or unexported fields
}

type VaultInfo struct {
	Root string `json:"root"`
	Name string `json:"name"`
}

type VaultSettings struct {
	// ExplicitPrimary is the file's own primaryNotesLocation, empty when the
	// file says nothing. Only an absent value is inferred from the layout; see
	// (*Vault).PrimaryNotesLocation.
	ExplicitPrimary   PrimaryNotesLocation
	DailyNotes        PeriodicNotes
	WeeklyNotes       PeriodicNotes
	MonthlyNotes      PeriodicNotes
	Favorites         []string
	SystemFolderPaths map[string]string
	// TasksExcludedFolders are vault-relative directory paths whose notes
	// never feed the Tasks surfaces.
	TasksExcludedFolders []string
	TypstPreambleFolder  string
	// Raw is the decoded file, kept so a targeted write can preserve every
	// key this process does not model.
	Raw map[string]any
}

type WriteTemplateInput struct {
	Slug               string `json:"slug"`
	Raw                string `json:"raw"`
	PreviousSourcePath string `json:"previousSourcePath,omitempty"`
}