Skip to content

Build your personal knowledge base with Trilium Notes

28.5 KB
Raw Blame
import { type LabelType } from "./promoted_attribute_definition_parser.js";

/**
 * Every attribute name Trilium itself gives a meaning to, as opposed to the ones a user invents.
 *
 * This is the single source of truth for that vocabulary: the {@link LabelNames} / {@link RelationNames}
 * types are derived from the array below, so a name cannot be known to the type system while being
 * missing from the runtime list (the drift that previously let system attributes go unrecognised).
 * Adding a name here is all that is needed to make it type-checkable and recognised at runtime alike.
 */

/**
 * What every label carries regardless of the kind of value it holds; see {@link BuiltinLabel}, which
 * pairs this with the value type and whatever that type needs alongside it.
 */
interface BuiltinLabelCommon {
    type: "label";
    name: string;
    /**
     * Whether the attribute executes or embeds content, and so must be neutralised on import.
     * Dangerous attributes can be deactivated by prefixing them with `disabled:`, which is where the
     * `disabled:*` members of {@link LabelNames} / {@link RelationNames} come from.
     */
    isDangerous?: boolean;
    /**
     * Whether the label can be switched off by a `disabled:` prefix, keeping its value, although it
     * is not dangerous. Gives it a `disabled:*` member of {@link LabelNames}, as a dangerous one has.
     */
    canBeDisabled?: boolean;
    /**
     * Whether the *value* may contain user data, even though the *name* is system-defined. The name of
     * such an attribute is safe to keep in an anonymized database dump, its value is not — see
     * `anonymization.ts`, which preserves builtin attributes wholesale except for these.
     */
    hasUserValue?: boolean;
}

/**
 * A label, i.e. an attribute carrying a value.
 *
 * The `valueType` says what kind of value it holds. Not enforced at runtime — attribute values are
 * always stored as strings — but it types the `useNoteLabel*` hooks via {@link FilterLabelsByType},
 * and tells the attribute editor which field to offer.
 *
 * Deliberately the same vocabulary a promoted attribute definition declares, rather than one of its
 * own: a system label and a user's promoted field describe the same thing when they say `color`.
 *
 * Written as a union rather than as one shape with an optional list, so that the two halves of a
 * `select` cannot come apart: a closed set must name its choices, and a label of any other type
 * cannot carry choices that nothing would ever offer.
 */
export type BuiltinLabel = BuiltinLabelCommon & (
    | {
        valueType: "select";
        /**
         * The values the label accepts, in the order they are offered — the *stored* spellings, not
         * display names, since that is what the attribute editor writes and what the code reading
         * the label compares against.
         *
         * A value outside this list is still shown rather than dropped: the editor appends whatever
         * the note holds to the list it offers, so a label written by a newer version, by a script or
         * by hand survives being looked at.
         */
        selectOptions: readonly string[];
    }
    | {
        valueType: Exclude<LabelType, "select">;
        selectOptions?: never;
    }
);

/**
 * A relation, i.e. an attribute pointing at a note. Its value is always a note ID, so it needs neither
 * a value type nor a {@link BuiltinLabel.hasUserValue} marker.
 */
export interface BuiltinRelation {
    type: "relation";
    name: string;
    isDangerous?: boolean;
    /**
     * Whether the relation can be switched off by a `disabled:` prefix, keeping its target, although
     * it is not dangerous. Gives it a `disabled:*` member of {@link RelationNames}, as a dangerous
     * one has.
     */
    canBeDisabled?: boolean;
}

const BUILTIN_ATTRIBUTES = [
    // Note tree & organisation
    { type: "label", name: "inbox", valueType: "boolean" },
    // Marks a note created by the "Record meeting" launcher, which holds a meeting transcript.
    { type: "label", name: "meetingRecording", valueType: "boolean" },
    { type: "label", name: "disableVersioning", valueType: "boolean" },
    { type: "label", name: "versioningLimit", valueType: "number" },
    { type: "label", name: "calendarRoot", valueType: "boolean" },
    { type: "label", name: "archived", valueType: "boolean" },
    { type: "label", name: "excludeFromExport", valueType: "boolean" },
    { type: "label", name: "disableInclusion", valueType: "boolean" },
    { type: "label", name: "appCss", valueType: "boolean" },
    { type: "label", name: "appTheme", valueType: "text" },
    // The stock theme a custom one is layered over; `next` follows the colour scheme in use.
    { type: "label", name: "appThemeBase", valueType: "select", selectOptions: [
        "next", "next-light", "next-dark"
    ] },
    // Offers a font file note in the font picker, under the note's own title.
    { type: "label", name: "customFont", valueType: "boolean" },
    { type: "label", name: "hidePromotedAttributes", valueType: "boolean" },
    { type: "label", name: "readOnly", valueType: "boolean" },
    { type: "label", name: "autoReadOnlyDisabled", valueType: "boolean" },
    { type: "label", name: "cssClass", valueType: "text" },
    { type: "label", name: "iconClass", valueType: "text" },
    { type: "label", name: "keyboardShortcut", valueType: "text" },
    { type: "label", name: "run", valueType: "text", isDangerous: true },
    { type: "label", name: "runOnInstance", valueType: "text", isDangerous: false },
    { type: "label", name: "runAtHour", valueType: "number", isDangerous: false },
    { type: "label", name: "customRequestHandler", valueType: "text", isDangerous: true },
    { type: "label", name: "customResourceProvider", valueType: "text", isDangerous: true },
    { type: "label", name: "widget", valueType: "boolean", isDangerous: true },
    { type: "label", name: "workspace", valueType: "boolean" },
    { type: "label", name: "workspaceIconClass", valueType: "text" },
    { type: "label", name: "workspaceTabBackgroundColor", valueType: "color" },
    { type: "label", name: "workspaceCalendarRoot", valueType: "boolean" },
    { type: "label", name: "workspaceTemplate", valueType: "boolean" },
    { type: "label", name: "searchHome", valueType: "boolean" },
    { type: "label", name: "workspaceInbox", valueType: "boolean" },
    { type: "label", name: "workspaceSearchHome", valueType: "boolean" },
    { type: "label", name: "sqlConsoleHome", valueType: "boolean" },
    { type: "label", name: "llmChatHome", valueType: "boolean" },
    { type: "label", name: "workspaceLlmChatHome", valueType: "boolean" },
    { type: "label", name: "datePattern", valueType: "text" },
    { type: "label", name: "weekPattern", valueType: "text" },
    { type: "label", name: "enableWeekNote", valueType: "boolean" },
    { type: "label", name: "monthPattern", valueType: "text" },
    { type: "label", name: "quarterPattern", valueType: "text" },
    { type: "label", name: "yearPattern", valueType: "text" },
    { type: "label", name: "enableQuarterNote", valueType: "boolean" },
    // Stamped onto each generated journal note, holding the period it stands for.
    { type: "label", name: "dateNote", valueType: "date", hasUserValue: true },
    { type: "label", name: "weekNote", valueType: "text", hasUserValue: true },
    { type: "label", name: "monthNote", valueType: "text", hasUserValue: true },
    { type: "label", name: "quarterNote", valueType: "text", hasUserValue: true },
    { type: "label", name: "yearNote", valueType: "text", hasUserValue: true },
    { type: "label", name: "pageSize", valueType: "number" },
    { type: "label", name: "viewType", valueType: "select", selectOptions: [
        "list", "searchPreview", "grid", "calendar", "table", "geoMap", "board", "presentation", "dashboard"
    ] },
    { type: "label", name: "mapRootNoteId", valueType: "text" },
    { type: "label", name: "mapExcludeRelation", valueType: "text" },
    { type: "label", name: "mapIncludeRelation", valueType: "text" },
    // Keeps a note out of the note map -- unless the map is rooted at it, which journals rely on.
    { type: "label", name: "excludeFromNoteMap", valueType: "boolean" },
    { type: "label", name: "excludeFromLlm", valueType: "boolean" },
    { type: "label", name: "bookmarkFolder", valueType: "boolean" },
    // Where a click on the note's launch bar button opens it. Without the label, in the current tab.
    { type: "label", name: "bookmarkOpenMode", valueType: "select", selectOptions: [
        "currentTab", "newTab", "newSplit", "newWindow", "quickEdit"
    ] },
    { type: "label", name: "sorted", valueType: "boolean" },
    { type: "label", name: "sortDirection", valueType: "select", selectOptions: [ "asc", "desc" ] },
    { type: "label", name: "sortFoldersFirst", valueType: "boolean" },
    { type: "label", name: "sortNatural", valueType: "boolean" },
    { type: "label", name: "sortLocale", valueType: "text" },
    { type: "label", name: "top", valueType: "boolean" },
    { type: "label", name: "bottom", valueType: "boolean" },
    { type: "label", name: "fullContentWidth", valueType: "boolean" },
    { type: "label", name: "subtreeHidden", valueType: "boolean", hasUserValue: true },
    { type: "label", name: "expanded", valueType: "text", hasUserValue: true },

    // Sharing
    { type: "label", name: "shareHiddenFromTree", valueType: "boolean" },
    // Both hold the URL to link out to; `shareExternal` is the older spelling the theme still reads.
    { type: "label", name: "shareExternalLink", valueType: "url", hasUserValue: true },
    { type: "label", name: "shareExternal", valueType: "url", hasUserValue: true },
    { type: "label", name: "shareRootLink", valueType: "url", hasUserValue: true },
    { type: "label", name: "shareLogoWidth", valueType: "number" },
    { type: "label", name: "shareLogoHeight", valueType: "number" },
    { type: "label", name: "shareOpenGraphColor", valueType: "color" },
    { type: "label", name: "shareOpenGraphURL", valueType: "url", hasUserValue: true },
    { type: "label", name: "shareOpenGraphDomain", valueType: "text", hasUserValue: true },
    // Also exists as a relation, pointing at an image note instead of naming a URL.
    { type: "label", name: "shareOpenGraphImage", valueType: "url", hasUserValue: true },
    { type: "label", name: "shareAlias", valueType: "text", hasUserValue: true },
    { type: "label", name: "shareOmitDefaultCss", valueType: "boolean" },
    { type: "label", name: "shareRoot", valueType: "boolean" },
    { type: "label", name: "shareDescription", valueType: "textarea" },
    { type: "label", name: "shareRaw", valueType: "boolean", isDangerous: true },
    { type: "label", name: "shareDisallowRobotIndexing", valueType: "boolean" },
    { type: "label", name: "shareCredentials", valueType: "text", hasUserValue: true },
    { type: "label", name: "shareIndex", valueType: "boolean" },
    // Where a `~shareHtml` snippet is injected into the shared page. A bare `head`/`body`/`content` is
    // read as its `:end`, but the full spellings are what the theme documents and what is offered.
    { type: "label", name: "shareHtmlLocation", valueType: "select", selectOptions: [
        "head:start", "head:end", "body:start", "body:end", "content:start", "content:end"
    ] },

    // Attributes & scripting
    { type: "label", name: "displayRelations", valueType: "text" },
    { type: "label", name: "hideRelations", valueType: "text" },
    { type: "label", name: "titleTemplate", valueType: "text", isDangerous: true },
    // Set on a template: the default title of a note created from it, as `#titleTemplate` is for children.
    { type: "label", name: "template:titleTemplate", valueType: "text", isDangerous: true },
    { type: "label", name: "template", valueType: "boolean" },
    { type: "label", name: "snippet", valueType: "boolean" },
    { type: "label", name: "snippetDescription", valueType: "text", hasUserValue: true },
    { type: "label", name: "textSnippet", valueType: "boolean" },
    { type: "label", name: "textSnippetDescription", valueType: "text", hasUserValue: true },
    // Offers the note's content as an instruction in the text editor's AI assistant menu.
    { type: "label", name: "aiQuickAction", valueType: "boolean" },
    { type: "label", name: "color", valueType: "color" },
    { type: "label", name: "keepCurrentHoisting", valueType: "boolean" },
    { type: "label", name: "executeButton", valueType: "boolean" },
    { type: "label", name: "executeDescription", valueType: "text" },
    { type: "label", name: "executeTitle", valueType: "text", hasUserValue: true },
    { type: "label", name: "newNotesOnTop", valueType: "boolean" },
    { type: "label", name: "clipperInbox", valueType: "boolean" },
    // Stamped by the web clipper and the PWA share target on what they save, recording which
    // action produced the note.
    { type: "label", name: "clipType", valueType: "select", selectOptions: [
        "clippings", "page", "note", "tabs", "file", "share"
    ] },
    { type: "label", name: "sentFromSender", valueType: "boolean" },
    { type: "label", name: "hideChildrenOverview", valueType: "boolean" },
    // Set on the folder, for its media children. "Play once" is the absence of the label, so it is not
    // among the choices: leaving the field empty is what says it.
    { type: "label", name: "mediaNotesPlayMode", valueType: "select", selectOptions: [ "loop", "next" ] },
    { type: "label", name: "collection", valueType: "boolean" },
    { type: "label", name: "webViewSrc", valueType: "url", isDangerous: true },
    { type: "label", name: "iconPack", valueType: "text", isDangerous: true },
    { type: "label", name: "docName", valueType: "text", isDangerous: true },
    { type: "label", name: "docUrl", valueType: "url", isDangerous: true },
    { type: "label", name: "language", valueType: "text", hasUserValue: true },
    { type: "label", name: "originalFileName", valueType: "text", hasUserValue: true },
    { type: "label", name: "pageUrl", valueType: "url", hasUserValue: true },
    // Metadata the web clipper saves with a page; shown in the "Web clip" badge's details.
    { type: "label", name: "pageDescription", valueType: "text", hasUserValue: true },
    { type: "label", name: "pageAuthor", valueType: "text", hasUserValue: true },
    { type: "label", name: "publishedDate", valueType: "date", hasUserValue: true },
    { type: "label", name: "modifiedDate", valueType: "date", hasUserValue: true },
    { type: "label", name: "command", valueType: "text", hasUserValue: true },
    // Which half of the split editor a code-like note opens on; without it the read-only state decides.
    { type: "label", name: "displayMode", valueType: "select", hasUserValue: true, selectOptions: [
        "source", "split", "preview"
    ] },

    // Search
    { type: "label", name: "searchString", valueType: "text", hasUserValue: true },
    { type: "label", name: "ancestorDepth", valueType: "text", hasUserValue: true },
    { type: "label", name: "orderBy", valueType: "text", hasUserValue: true },
    { type: "label", name: "orderDirection", valueType: "select", hasUserValue: true, selectOptions: [
        "asc", "desc"
    ] },
    { type: "label", name: "limit", valueType: "text", hasUserValue: true },
    { type: "label", name: "fastSearch", valueType: "boolean" },
    { type: "label", name: "includeArchivedNotes", valueType: "boolean" },
    { type: "label", name: "debug", valueType: "boolean" },

    // Launch bar, and the hidden subtree items that back it
    { type: "label", name: "launcherType", valueType: "select", selectOptions: [
        "command", "note", "script", "builtinWidget", "customWidget"
    ] },
    // Only read when the launcher is of the `builtinWidget` type above; each names a widget the
    // launch bar knows how to build.
    { type: "label", name: "builtinWidget", valueType: "select", selectOptions: [
        "calendar", "spacer", "bookmarks", "protectedSession", "syncStatus", "backInHistoryButton",
        "forwardInHistoryButton", "todayInJournal", "quickSearch", "mobileTabSwitcher", "sidebarChat",
        "colorSchemeSwitcher", "recordMeeting"
    ] },
    // Dangerous together with `~script` below: it makes the launcher run its own content instead, so
    // neutralising only the relation would leave this as a way around it.
    { type: "label", name: "scriptInLauncherContent", valueType: "boolean", isDangerous: true },
    { type: "label", name: "baseSize", valueType: "number" },
    { type: "label", name: "growthFactor", valueType: "number" },
    { type: "label", name: "desktopOnly", valueType: "boolean" },
    { type: "label", name: "electronOnly", valueType: "boolean" },
    { type: "label", name: "serverOnly", valueType: "boolean" },
    { type: "label", name: "beta", valueType: "boolean" },

    // Recorded on import, to trace a note back to where it came from
    { type: "label", name: "oneNotePageId", valueType: "text", hasUserValue: true },
    { type: "label", name: "oneNoteSectionId", valueType: "text", hasUserValue: true },
    { type: "label", name: "oneNoteImportFailed", valueType: "boolean" },

    // Collections
    { type: "label", name: "status", valueType: "text", hasUserValue: true },
    { type: "label", name: "board:groupBy", valueType: "text", hasUserValue: true },
    // Carried by the task-state definition notes under `_taskStates`, which back the board columns.
    { type: "label", name: "stateId", valueType: "text", hasUserValue: true },
    { type: "label", name: "markdownSymbol", valueType: "text" },
    { type: "label", name: "isCompleted", valueType: "boolean" },
    { type: "label", name: "isHidden", valueType: "boolean" },
    { type: "label", name: "maxNestingDepth", valueType: "number", hasUserValue: true },
    { type: "label", name: "includeArchived", valueType: "boolean", hasUserValue: true },
    { type: "label", name: "board:showInbox", valueType: "boolean", hasUserValue: true },
    { type: "label", name: "board:hideAddColumn", valueType: "boolean", hasUserValue: true },
    // Carried by a card that stands in for another note: opening it navigates there instead.
    { type: "relation", name: "board:cardRedirectTo" },
    // The previous name of the relation above. Still read, so existing boards keep redirecting.
    { type: "relation", name: "boardCardRedirectTo" },
    // How wide the board draws its columns. Absent for the narrow default.
    { type: "label", name: "board:columnWidth", valueType: "select", hasUserValue: true,
        selectOptions: [ "narrow", "medium", "wide" ] },
    // The order a board offers for its columns, which its properties apply to every column at once.
    { type: "label", name: "board:sortColumns", valueType: "text", hasUserValue: true },
    { type: "label", name: "board:sortColumnsDescending", valueType: "boolean", hasUserValue: true },
    // FullCalendar's own view names, which is what the calendar hands back when the view is switched.
    { type: "label", name: "calendar:view", valueType: "select", hasUserValue: true, selectOptions: [
        "timeGridDay", "timeGridWeek", "dayGridMonth", "multiMonthYear", "listMonth"
    ] },
    { type: "label", name: "calendar:initialDate", valueType: "date", hasUserValue: true },
    { type: "label", name: "calendar:hideWeekends", valueType: "boolean", hasUserValue: true },
    { type: "label", name: "calendar:weekNumbers", valueType: "boolean", hasUserValue: true },
    { type: "label", name: "calendar:hideRoutineEvents", valueType: "boolean", hasUserValue: true },
    { type: "label", name: "calendar:slotDuration", valueType: "text", hasUserValue: true },
    { type: "label", name: "calendar:slotLabelInterval", valueType: "text", hasUserValue: true },
    { type: "label", name: "calendar:title", valueType: "text", hasUserValue: true },
    { type: "label", name: "calendar:titleTemplate", valueType: "text", hasUserValue: true },
    { type: "label", name: "calendar:displayedAttributes", valueType: "text", hasUserValue: true },
    // Each names the label an event reads a given field from, overriding the default listed after it.
    { type: "label", name: "calendar:startDate", valueType: "text", hasUserValue: true },
    { type: "label", name: "calendar:endDate", valueType: "text", hasUserValue: true },
    { type: "label", name: "calendar:startTime", valueType: "text", hasUserValue: true },
    { type: "label", name: "calendar:endTime", valueType: "text", hasUserValue: true },
    { type: "label", name: "calendar:recurrence", valueType: "text", hasUserValue: true },
    { type: "label", name: "startDate", valueType: "date", hasUserValue: true },
    { type: "label", name: "endDate", valueType: "date", hasUserValue: true },
    { type: "label", name: "startTime", valueType: "time", hasUserValue: true },
    { type: "label", name: "endTime", valueType: "time", hasUserValue: true },
    { type: "label", name: "recurrence", valueType: "text", hasUserValue: true },
    { type: "label", name: "geolocation", valueType: "text", hasUserValue: true },
    // A shape drawn onto a geo map: a kind, a colon, then a `lat,lng` per vertex (see the
    // client's geomap/shapes.ts).
    { type: "label", name: "geoShape", valueType: "text", hasUserValue: true },
    // The counterparts of `geolocation` and `geoShape` on a map drawn over an image (`~map:image`):
    // `x,y` in the map's coordinates, which are the image's own pixels unless the map names others.
    { type: "label", name: "mapPosition", valueType: "text", hasUserValue: true },
    { type: "label", name: "mapShape", valueType: "text", hasUserValue: true },
    // The coordinates of an image map's top-left and bottom-right corners, as `x,y x,y`.
    { type: "label", name: "map:imageBounds", valueType: "text", hasUserValue: true },
    // Which note map a note map note draws; anything but `tree` is read as `link`.
    { type: "label", name: "mapType", valueType: "select", hasUserValue: true, selectOptions: [
        "link", "tree"
    ] },
    // A built-in style's name, or the URL of a raster tileset. A tileset is switched off rather than
    // removed when the map goes back to a built-in style, so its URL is kept for switching back.
    { type: "label", name: "map:style", valueType: "text", hasUserValue: true, canBeDisabled: true },
    // Says of a style Trilium knows nothing about that it is a dark one, which only the style itself
    // can tell. The styles offered in the collection properties declare it for themselves.
    { type: "label", name: "map:darkStyle", valueType: "boolean", hasUserValue: true },
    { type: "label", name: "map:scale", valueType: "boolean", hasUserValue: true },
    { type: "label", name: "map:hideLabels", valueType: "boolean", hasUserValue: true },
    { type: "label", name: "map:cluster", valueType: "boolean", hasUserValue: true },
    // Reveal.js' own stock themes, which is what the presentation bundles; anything else falls back
    // to `white`.
    { type: "label", name: "presentation:theme", valueType: "select", hasUserValue: true, selectOptions: [
        "black", "black-contrast", "white", "white-contrast", "beige", "serif", "simple",
        "solarized", "moon", "dracula", "sky", "blood", "league", "night"
    ] },
    { type: "label", name: "slide:background", valueType: "text", hasUserValue: true },

    // Code notes
    { type: "label", name: "tabWidth", valueType: "number" },
    { type: "label", name: "indentWithTabs", valueType: "boolean" },
    { type: "label", name: "wrapLines", valueType: "boolean" },

    // Printing
    { type: "label", name: "printLandscape", valueType: "boolean" },
    { type: "label", name: "printPageSize", valueType: "select", selectOptions: [
        "A0", "A1", "A2", "A3", "A4", "A5", "A6", "Legal", "Letter", "Tabloid", "Ledger"
    ] },
    { type: "label", name: "printScale", valueType: "text" },
    { type: "label", name: "printMargins", valueType: "text" },
    { type: "label", name: "internalBookmark", valueType: "boolean" },

    // relation names
    { type: "relation", name: "internalLink" },
    { type: "relation", name: "imageLink" },
    { type: "relation", name: "relationMapLink" },
    { type: "relation", name: "includeNoteLink" },
    { type: "relation", name: "runOnNoteCreation", isDangerous: true },
    { type: "relation", name: "runOnNoteTitleChange", isDangerous: true },
    { type: "relation", name: "runOnNoteChange", isDangerous: true },
    { type: "relation", name: "runOnNoteContentChange", isDangerous: true },
    { type: "relation", name: "runOnNoteDeletion", isDangerous: true },
    { type: "relation", name: "runOnBranchCreation", isDangerous: true },
    { type: "relation", name: "runOnBranchChange", isDangerous: true },
    { type: "relation", name: "runOnBranchDeletion", isDangerous: true },
    { type: "relation", name: "runOnChildNoteCreation", isDangerous: true },
    { type: "relation", name: "runOnAttributeCreation", isDangerous: true },
    { type: "relation", name: "runOnAttributeChange", isDangerous: true },
    // The image a geo map draws in place of a world map. Switched off rather than removed when the
    // map goes back to a world map, so the image is kept for switching back.
    { type: "relation", name: "map:image", canBeDisabled: true },
    { type: "relation", name: "template" },
    // Set on a template: where a note created from it goes when no parent is picked explicitly.
    { type: "relation", name: "template:newNoteDefaultParent" },
    { type: "relation", name: "inherit" },
    // Set on a journal root, to be applied as `~template` on each note the period generates.
    { type: "relation", name: "dateTemplate" },
    { type: "relation", name: "weekTemplate" },
    { type: "relation", name: "monthTemplate" },
    { type: "relation", name: "quarterTemplate" },
    { type: "relation", name: "yearTemplate" },
    { type: "relation", name: "widget", isDangerous: true },
    { type: "relation", name: "renderNote", isDangerous: true },
    { type: "relation", name: "searchScript", isDangerous: true },
    { type: "relation", name: "ancestor" },
    { type: "relation", name: "target" },
    // Both execute a script, unlike the handlers above only once the user opens or clicks something.
    // Flagged all the same, so a safe import cannot leave one primed behind a single keystroke.
    { type: "relation", name: "script", isDangerous: true },
    { type: "relation", name: "hoistedNote" },
    { type: "relation", name: "shareCss" },
    { type: "relation", name: "shareLogo" },
    { type: "relation", name: "shareOpenGraphImage" },
    { type: "relation", name: "shareJs", isDangerous: true },
    { type: "relation", name: "shareHtml", isDangerous: true },
    { type: "relation", name: "shareTemplate", isDangerous: true },
    { type: "relation", name: "shareFavicon" }
] as const satisfies readonly (BuiltinLabel | BuiltinRelation)[];

/**
 * Exported under the interface rather than the literal-preserving `as const` type: an entry that omits
 * an optional field would otherwise not have it at all, making `attr.isDangerous` a type error across
 * the union. The literal types remain available internally, for the name unions below.
 */
export default BUILTIN_ATTRIBUTES as readonly (BuiltinLabel | BuiltinRelation)[];

type BuiltinAttributeEntry = (typeof BUILTIN_ATTRIBUTES)[number];
type LabelEntry = Extract<BuiltinAttributeEntry, { type: "label" }>;
type RelationEntry = Extract<BuiltinAttributeEntry, { type: "relation" }>;

/**
 * The `disabled:`-prefixed forms of the dangerous entries in `T`, which is how a dangerous attribute is
 * neutralised without losing its value, and of the ones that opt in with `canBeDisabled`. Derived
 * rather than enumerated, so either flag makes the disabled form known to the type system.
 */
type DisabledForms<T extends { name: string }> =
    `disabled:${Extract<T, { isDangerous: true } | { canBeDisabled: true }>["name"]}`;

/**
 * What each label type is read as in TypeScript. Written as a mapped type over {@link LabelType} so a
 * type added to that vocabulary cannot be left without a reading here.
 */
type ValueTypeToTs = {
    [K in LabelType]: K extends "boolean" ? boolean : K extends "number" ? number : string;
};

/** The label types read as `U`, e.g. every string-ish one — `text`, `url`, `color`, … — for `string`. */
type ValueTypeNamesFor<U> = {
    [K in LabelType]: ValueTypeToTs[K] extends U ? K : never;
}[LabelType];

type LabelsWithValueType<U> = Extract<LabelEntry, { valueType: ValueTypeNamesFor<U> }>;

export type LabelNames = LabelEntry["name"] | DisabledForms<LabelEntry>;
export type RelationNames = RelationEntry["name"] | DisabledForms<RelationEntry>;

/** The names of the labels whose value is read as `U`, e.g. `FilterLabelsByType<boolean>` for flags. */
export type FilterLabelsByType<U> = LabelsWithValueType<U>["name"] | DisabledForms<LabelsWithValueType<U>>;