@evotecit/canopyx 0.1.2 → 0.2.0

package/JavaScript/locales/pl.mjs

@@ -1,5 +1,6 @@
 // Generated from CanopyX/Views/Locales/labels.json by Build/Sync-Assets.ps1.
 const labels = Object.freeze({
+  gridNoExportColumns: "Żadna widoczna kolumna nie obsługuje eksportu.",
   searchPlaceholder: "Szukaj",
   searchResults: "Wyniki wyszukiwania",
   searchResultCount: "Wyniki: {count}",
@@ -13,6 +14,24 @@ const labels = Object.freeze({
   gridFilters: "Filtry",
   gridFitContent: "Dopasuj do zawartości",
   gridUnpin: "Odepnij",
+  matchesHighlight: "Wyróżniaj dopasowania",
+  matchesCount: "[one]{count} dopasowanie[few]{count} dopasowania[many]{count} dopasowań[other]{count} dopasowania",
+  matchesPosition: "{current} z {count}",
+  matchesNone: "Brak dopasowań",
+  matchesLoaded: "[one]{count} dopasowanie we wczytanych wierszach[few]{count} dopasowania we wczytanych wierszach[many]{count} dopasowań we wczytanych wierszach[other]{count} dopasowania we wczytanych wierszach",
+  matchesPrevious: "Poprzednie dopasowanie",
+  matchesNext: "Następne dopasowanie",
+  matchesAnnounce: "Dopasowanie {current} z {count}, {column}",
+  layoutMenu: "Układ",
+  layoutFit: "Dopasuj do szerokości",
+  layoutScroll: "Wszystkie kolumny, przewijanie w poziomie",
+  layoutCards: "Karty",
+  layoutDensity: "Gęstość",
+  layoutCompact: "Zwarta",
+  layoutNormal: "Normalna",
+  layoutComfortable: "Swobodna",
+  layoutChanged: "Układ: {mode}, {density}",
+  layoutSort: "Sortuj według",
   gridWhere: "Gdzie",
   gridComplexFilter: "Ta kolumna należy do mieszanej grupy warunków. Edytuj ją w Filtrach.",
   gridClearColumnFilter: "Wyczyść filtr",
@@ -82,6 +101,9 @@ const labels = Object.freeze({
   gridPreviousPage: "Poprzednia strona",
   gridNextPage: "Następna strona",
   gridLastPage: "Ostatnia strona",
+  gridPageInfo: "Wyświetlanie wierszy od {first} do {last} z {count}",
+  gridPageInfoFiltered: "Wyświetlanie wierszy od {first} do {last} z {count} (odfiltrowano z {total})",
+  gridPageButton: "Strona {page}",
   gridClearQuery: "Wyczyść wyszukiwanie i filtry",
   gridRemoveSearch: "Wyczyść wyszukiwanie: {search}",
   gridGroupedFilters: "Grupy filtrów (warunki: {count})",
@@ -91,9 +113,30 @@ const labels = Object.freeze({
   gridFilteredResults: "Przefiltrowane wyniki",
   gridSelectedRows: "Zaznaczone wiersze",
   gridAllResults: "Wszystkie wyniki",
+  gridVisibleRows: "Widoczne wiersze",
+  gridAllRows: "Wszystkie wiersze",
   gridDownloadCsv: "Pobierz plik CSV",
   gridCopy: "Kopiuj",
   gridDetails: "Szczegóły rekordu",
+  gridCellRangeSelected: "Zaznaczono wiersze: {rows} × kolumny: {columns}",
+  gridCellRangesSelected: "Zaznaczone zakresy: {ranges}, komórki: {cells}",
+  gridCellRangeCleared: "Wyczyszczono zaznaczenie komórek",
+  gridCopyCells: "Kopiuj komórki",
+  gridCopyCellsWithHeaders: "Kopiuj komórki z nagłówkami",
+  gridPasteCells: "Wklej",
+  gridSelectAllCells: "Zaznacz wszystkie komórki",
+  gridCellsCopied: "Skopiowano wiersze: {rows} × kolumny: {columns}",
+  gridCellsPasted: "Wklejone komórki: {count}",
+  gridPasteRefused: "Niewklejone komórki: {count}",
+  gridPasteReadOnly: "Tej komórki nie można zmienić.",
+  gridPasteType: "„{value}” nie jest prawidłową wartością dla: {column}.",
+  gridPasteReport: "Raport wklejania",
+  gridPasteCell: "Wiersz {row}, {column}: {reason}",
+  gridFillHandle: "Przeciągnij, aby wypełnić komórki poniżej",
+  gridCellsFilled: "Wypełnione komórki: {count}",
+  gridCellMenu: "Akcje komórek",
+  gridClearCellRanges: "Wyczyść zaznaczenie komórek",
+  gridRowPicked: "Podniesiono {title}. Przejdź do kalendarza i naciśnij Enter, aby go upuścić.",
   gridColumn: "Kolumna",
   gridOperator: "Warunek",
   gridValue: "Wartość (daty w UTC)",
@@ -173,6 +216,28 @@ const labels = Object.freeze({
   gridGroupCollapse: "Zwiń grupę",
   gridSummary: "Podsumowanie wyników",
   gridGroupOrder: "Kolejność grup jest ustalona w raporcie",
+  gridAggregateCount: "liczba {value}",
+  gridAggregateSum: "suma {value}",
+  gridAggregateAverage: "śr. {value}",
+  gridAggregateMinimum: "min. {value}",
+  gridAggregateMaximum: "maks. {value}",
+  gridGroupBy: "Grupuj według tej kolumny",
+  gridUngroup: "Przestań grupować według tej kolumny",
+  gridGroupDrop: "Przeciągnij tutaj nagłówek kolumny, aby pogrupować wiersze",
+  gridExpandAll: "Rozwiń wszystko",
+  gridCollapseAll: "Zwiń wszystko",
+  gridExpandLevel: "Rozwiń poziom {level}",
+  gridCollapseLevel: "Zwiń poziom {level}",
+  gridGroupMove: "Alt+Strzałka w lewo i Alt+Strzałka w prawo przesuwają ten poziom",
+  gridGroupSortBy: "Sortuj grupy według",
+  gridGroupSortValue: "według wartości",
+  gridGroupSortAggregate: "według: {aggregate}",
+  gridSelectGroup: "Zaznacz rekordy grupy {group}",
+  gridAggregateDistinct: "unikalne {value}",
+  gridShowDetail: "Pokaż szczegóły",
+  gridHideDetail: "Ukryj szczegóły",
+  gridDetailOf: "Szczegóły: {record}",
+  gridDetailFailed: "Nie udało się wczytać szczegółów: {error}",
   gridExportProgress: "Rekordy: {completed} z {total}",
   gridExportReading: "Rekordy: {completed}",
   gridExportCancelled: "Eksport anulowany",
@@ -207,11 +272,250 @@ const labels = Object.freeze({
   showMoreUnknownTotal: "Pokaż więcej (wczytano {loaded})",
   pageLoaded: "Wczytano {loaded} z {total}",
   itemsLoaded: "Elementy: {count}",
+  recordBack: "Wstecz",
+  recordBackTo: "Wróć do: {record}",
+  recordTrail: "Ścieżka rekordów",
+  recordShowing: "Wyświetlono: {record}",
+  recordTabs: "Widoki rekordu",
+  recordSections: "Przejdź do sekcji",
+  recordOtherFields: "Pozostałe pola",
+  recordShowEmpty: "Pokaż puste pola ({count})",
+  recordHideEmpty: "Ukryj puste pola",
+  recordActions: "Akcje rekordu",
+  recordCopyValues: "Kopiuj wartości",
+  recordCopyJson: "Kopiuj jako JSON",
+  recordCopyLink: "Kopiuj link",
+  recordCopied: "Skopiowano do schowka",
+  recordPrint: "Drukuj rekord",
+  recordExportCsv: "Eksportuj CSV",
+  recordExportJson: "Eksportuj JSON",
+  recordOpenAll: "Otwórz wszystkie w tabeli",
+  recordLoadMore: "Wczytaj więcej",
+  recordCount: "{shown} z {total}",
+  recordItems: "Elementy: {count}",
+  recordMore: "+{count}",
+  recordShowAll: "Pokaż wszystkie ({count})",
+  recordRetry: "Ponów",
+  recordLoadFailed: "Nie udało się wczytać szczegółów rekordu: {error}",
+  recordUnavailable: "Rekord {id} nie jest tutaj dostępny.",
+  recordField: "Pole",
+  recordValue: "Wartość",
+  recordSection: "Sekcja",
+  recordBefore: "Przed",
+  recordAfter: "Po",
+  recordAdded: "Dodano",
+  recordRemoved: "Usunięto",
+  recordChanged: "Zmienione pola: {count}",
   yes: "Tak",
   no: "Nie",
   utcTime: "{time} UTC",
   localTime: "{time} czasu lokalnego",
   mountError: "Nie można wyświetlić widoku: {error}",
+  gridEditCell: "Edytuj: {column}",
+  gridEditSave: "Zapisz",
+  gridEditCancel: "Anuluj",
+  gridEditDiscard: "Odrzuć zmiany",
+  gridEditUndo: "Cofnij",
+  gridEditRedo: "Ponów",
+  gridEditEdited: "Zmieniono",
+  gridEditChanges: "Niezapisane zmiany: {count}",
+  gridEditErrors: "Błędy: {count}",
+  gridEditSaving: "Zapisywanie…",
+  gridEditSaved: "Zapisane wiersze: {count}",
+  gridEditFailed: "Niezapisane wiersze: {count}",
+  gridEditRequired: "{column}: pole wymagane.",
+  gridEditNumber: "{column}: wpisz liczbę.",
+  gridEditDate: "{column}: wpisz poprawną datę.",
+  gridEditMin: "{column}: wartość nie może być mniejsza niż {min}.",
+  gridEditMax: "{column}: wartość nie może być większa niż {max}.",
+  gridEditStep: "{column}: wartość musi być wielokrotnością {step}.",
+  gridEditMinLength: "{column}: minimalna liczba znaków to {min}.",
+  gridEditMaxLength: "{column}: maksymalna liczba znaków to {max}.",
+  gridEditPattern: "{column}: niepoprawny format.",
+  gridEditChoice: "{column}: wybierz wartość z listy.",
+  gridEditConflict: "Ktoś inny zmienił ten wiersz. Odśwież go i spróbuj ponownie.",
+  gridEditRejected: "Nie zapisano: {error}",
+  gridEditNotSaved: "Nie zapisano.",
+  gridEditNoMatches: "Brak dopasowań",
+  gridEditSearching: "Wyszukiwanie…",
+  gridEditUndone: "Cofnięto: {column}",
+  gridEditRedone: "Ponowiono: {column}",
+  gridEditNone: "(brak)",
+  gridLiveOrderChanged: "Kolejność się zmieniła",
+  gridLiveResort: "Sortuj ponownie",
+  gridLiveNewData: "Nowe dane",
+  gridLiveRefresh: "Odśwież",
+  gridLiveOrderHint: "Wiersze zostają na swoich miejscach, gdy dane się zmieniają. Posortuj ponownie, aby przenieść je na miejsca zgodne z sortowaniem.",
+  gridLiveChanged: "Zmienione wiersze: dodane {added}, zaktualizowane {updated}, usunięte {removed}",
+  gridLiveSorted: "Wiersze przeniesiono na miejsca zgodne z sortowaniem.",
+  gridLiveRecordRemoved: "Ten rekord został usunięty.",
+  gridFacetPanel: "Filtruj według",
+  gridFacetPanelHide: "Ukryj panel filtrów",
+  gridFacetPanelShow: "Pokaż panel filtrów",
+  gridFacetShowMore: "Pokaż więcej: {count}",
+  gridFacetShowFewer: "Pokaż mniej",
+  gridFacetEmptyValue: "(Puste)",
+  gridFacetFrom: "Od",
+  gridFacetTo: "Do",
+  gridFacetHistogram: "Rozkład: {column}",
+  gridFacetBin: "Od {from} do {to}, wiersze: {count}",
+  gridFacetNoChart: "Zbyt wiele wartości do wykresu",
+  gridFacetClear: "Wyczyść: {column}",
+  gridFacetCustom: "Tę kolumnę filtruje inny warunek.",
+  gridFacetResult: "Pasujące wiersze: {count}",
+  gridFacetSelected: "Zaznaczone: {count}",
+  gridFacetValueCount: "{value}, wiersze: {count}",
+  gridFacetCollapse: "Zwiń: {column}",
+  gridFacetExpand: "Rozwiń: {column}",
+  gridFacetInvalid: "Wpisz poprawną wartość.",
+  gridFacetReversed: "Wartość „Od” nie może być późniejsza niż „Do”.",
+  linkFilteredBy: "Filtr z {source}: {values}",
+  linkRemoveFilter: "Usuń filtr z {source}: {values}",
+  linkFiltered: "Filtr z {source}, wiersze: {count}",
+  linkHighlighted: "Wyróżnione wiersze z {source}: {count}",
+  linkHighlightedRows: "Wyróżnione wiersze: {count}",
+  linkCleared: "Usunięto powiązane filtry",
+  formatRules: "Formatowanie warunkowe",
+  formatLegend: "Legenda formatowania",
+  formatUpTo: "Do",
+  formatAbove: "Powyżej",
+  formatHiddenFlagged: "Sformatowane ukryte pola: {count} ({rules})",
+  formatRule: "Reguła {number}",
+  formatAddRule: "Dodaj regułę",
+  formatEditRule: "Edytuj: {rule}",
+  formatDeleteRule: "Usuń: {rule}",
+  formatMoveUp: "Przenieś wyżej: {rule}",
+  formatMoveDown: "Przenieś niżej: {rule}",
+  formatEnableRule: "Stosuj: {rule}",
+  formatNoRules: "Brak reguł formatowania.",
+  formatName: "Nazwa",
+  formatDescription: "Opis dla czytnika ekranu",
+  formatOnlyRowsWhere: "Tylko wiersze, w których",
+  formatEveryRow: "Każdy wiersz",
+  formatNone: "Żaden",
+  formatApplyTo: "Zastosuj do",
+  formatTargetCell: "Komórka",
+  formatTargetRow: "Cały wiersz",
+  formatTargetColumns: "Wybrane kolumny",
+  formatStyle: "Styl",
+  formatHighlight: "Wyróżnienie",
+  formatDataBar: "Pasek danych",
+  formatColorScale: "Skala kolorów",
+  formatBands: "Progi",
+  formatTone: "Ton",
+  formatEmphasis: "Wyróżnienie tonu",
+  formatFill: "Wypełnienie",
+  formatTextOnly: "Kolor tekstu",
+  formatStrong: "Pogrubione wypełnienie",
+  formatIcon: "Ikona",
+  formatNoIcon: "Bez ikony",
+  formatAutomatic: "Automatycznie",
+  formatBadge: "Plakietka",
+  formatCue: "Wskazówka tekstowa",
+  formatLowest: "Najniższa",
+  formatMidpoint: "Punkt środkowy",
+  formatHighest: "Najwyższa",
+  formatAddBand: "+ Próg",
+  formatRemoveBand: "Usuń próg",
+  formatSave: "Zapisz regułę",
+  formatCancel: "Anuluj",
+  formatShowLegend: "Pokaż legendę",
+  formatInvalid: "Uzupełnij regułę przed zapisaniem.",
+  formatMatchCase: "Uwzględnij wielkość liter",
+  formatToneDanger: "Zagrożenie",
+  formatToneWarning: "Ostrzeżenie",
+  formatToneSuccess: "Sukces",
+  formatToneInfo: "Informacja",
+  formatToneNeutral: "Neutralny",
+  formatToneMuted: "Wyciszony",
+  formatNotContains: "nie zawiera",
+  formatEndsWith: "kończy się na",
+  formatNotIn: "nie jest żadną z",
+  formatBetween: "między",
+  formatLike: "pasuje do wzorca z symbolami wieloznacznymi",
+  formatMatches: "pasuje do wyrażenia",
+  formatOlderThan: "starsze niż (dni)",
+  formatWithinLast: "w ciągu ostatnich (dni)",
+  formatNotLike: "nie pasuje do wzorca z symbolami wieloznacznymi",
+  formatNotMatches: "nie pasuje do wyrażenia",
+  formatBetweenExclusive: "między (bez granic)",
+  calendarToday: "Dzisiaj",
+  calendarPrevious: "Poprzedni okres",
+  calendarNext: "Następny okres",
+  calendarViews: "Widok kalendarza",
+  calendarMonth: "Miesiąc",
+  calendarWeek: "Tydzień",
+  calendarDay: "Dzień",
+  calendarDays: "{count} dni",
+  calendarAgenda: "Harmonogram",
+  calendarYear: "Rok",
+  calendarTimeline: "Oś czasu",
+  calendarGoTo: "Przejdź do daty",
+  calendarAllDay: "Cały dzień",
+  calendarMore: "+{count} więcej",
+  calendarMoreLabel: "Pokaż więcej wydarzeń z dnia {date}: {count}",
+  calendarDayEvents: "Wydarzenia z dnia {date}",
+  calendarNoEvents: "Brak wydarzeń w tym okresie",
+  calendarEvents: "[one]{count} wydarzenie[few]{count} wydarzenia[many]{count} wydarzeń[other]{count} wydarzenia",
+  calendarShowing: "{view}, {range}",
+  calendarRepeats: "Powtarza się",
+  calendarTruncated: "Pokazano pierwsze wydarzenia: {count}. Zawęź okres lub filtry, aby zobaczyć resztę.",
+  calendarLoading: "Wczytywanie wydarzeń…",
+  calendarLoadError: "Nie udało się wczytać wydarzeń: {error}",
+  calendarNow: "Teraz",
+  calendarZoom: "Skala",
+  calendarZoomHour: "Godziny",
+  calendarZoomDay: "Dni",
+  calendarZoomWeek: "Tygodnie",
+  calendarZoomMonth: "Miesiące",
+  calendarZoomQuarter: "Kwartały",
+  calendarResources: "Zasoby",
+  calendarCapacity: "Równoczesne wydarzenia",
+  calendarCapacityAt: "Jednocześnie: {count}",
+  calendarBusy: "Zajęte: {hours} h",
+  calendarOverlaps: "[one]{count} kolizja[few]{count} kolizje[many]{count} kolizji[other]{count} kolizji",
+  calendarUnavailable: "Niedostępne",
+  calendarOutsideHours: "Poza godzinami pracy",
+  calendarConflict: "Koliduje z: {title}",
+  calendarNotAllowed: "{resource} nie może przyjąć tego wydarzenia",
+  calendarMoved: "Przeniesiono {title} na {time}",
+  calendarResized: "Nowy koniec wydarzenia {title}: {time}",
+  calendarSeriesMoved: "Przeniesiono wszystkie wystąpienia: {title}",
+  calendarSeriesTime: "Tutaj można przesunąć tylko godzinę całej serii.",
+  calendarMoveHelp: "Strzałki przesuwają, Shift ze strzałkami zmienia koniec, Alt ze strzałką w górę lub w dół zmienia zasób, Enter zapisuje, Escape anuluje.",
+  calendarEdit: "Przenieś lub zmień długość: {title}",
+  calendarSaveFailed: "Nie zapisano {title}: {error}",
+  calendarExport: "iCalendar (.ics)",
+  calendarTimeRange: "{start} – {end}",
+  calendarSelected: "Zaznaczono: {range}",
+  calendarLane: "{resource}, {events}",
+  calendarHighlighted: "[one]Wyróżniono {count} wydarzenie[few]Wyróżniono {count} wydarzenia[many]Wyróżniono {count} wydarzeń[other]Wyróżniono {count} wydarzenia",
+  calendarMini: "Mały miesiąc",
+  calendarWeekList: "Lista tygodnia",
+  calendarDayList: "Lista dnia",
+  calendarMonths: "Miesiące",
+  calendarWeekNumber: "Tydzień {number}",
+  calendarWeekShort: "T{number}",
+  calendarNewEvent: "Nowe wydarzenie",
+  calendarEventTitle: "Tytuł",
+  calendarCreate: "Dodaj",
+  calendarCancel: "Anuluj",
+  calendarCreated: "Dodano {title} na {time}",
+  calendarReceived: "Zaplanowano {title} na {time}",
+  calendarOccurrenceTitle: "Zmień wydarzenie cykliczne",
+  calendarOccurrenceReadOnly: "Nie można zapisać tej części serii, ponieważ niektóre wartości są tylko do odczytu.",
+  calendarThisEvent: "To wydarzenie",
+  calendarThisAndFollowing: "To i następne wydarzenia",
+  calendarAllEvents: "Wszystkie wydarzenia",
+  calendarSources: "Kalendarze",
+  calendarImportFailed: "Nie udało się odczytać {source}: {error}",
+  calendarActions: "Akcje dla {title}",
+  calendarOpen: "Otwórz",
+  calendarMove: "Przenieś",
+  calendarNewHere: "Nowe wydarzenie tutaj",
+  calendarOutsideRange: "Poza datami, które pokazuje ten kalendarz",
+  calendarClose: "Zamknij",
+  calendarDetailsOf: "Szczegóły: {title}",
 });
 const staticLabels = Object.freeze({
   overflowNote: "Pokazano {shown} z {total} wierszy.",

package/JavaScript/plugins.d.ts

@@ -0,0 +1,113 @@
+// Plugins and parts: the extension points of every CanopyX runtime (docs/plugins.md).
+import type { CanopyNode, CanopyView } from "./protocol.js";
+import type { CellContext, ExportFormat } from "./hosts.js";
+import type { TreeGrid } from "./index.js";
+import type { RecordSectionRenderer, RecordAction } from "./records.js";
+import type { DataGrid, GridCellContext, GridRow, GridView } from "./grid.js";
+
+/** The kinds of view a plugin can apply to. */
+export type CanopyViewKind = "tree" | "grid";
+
+/** What a plugin's lifecycle hooks and event handlers receive, once per grid or tree. Frozen. */
+export interface CanopyPluginContext {
+  /** The public API of the grid or tree, as createTreeGrid or createDataGrid return it. Narrow it with kind. */
+  readonly api: TreeGrid | DataGrid;
+  /** The host element. */
+  readonly element: HTMLElement;
+  /** The view document the grid or tree was created from. */
+  readonly view: CanopyView | GridView;
+  readonly kind: CanopyViewKind;
+  /** The texts the grid writes itself, translations included. */
+  readonly labels: Readonly<Record<string, string>>;
+  /** Aborts when the grid or tree is destroyed; put listeners, timers and requests on it. */
+  readonly signal: AbortSignal;
+  /** Loads a part of the runtime by name (for example "export") and resolves once it is installed. */
+  part(name: string): Promise<void>;
+}
+
+/**
+ * Draws a cell of a column whose renderer field names it. The same contract as a host renderer: return true when the
+ * renderer drew the cell (a tree), or draw into element (a flat grid); a host renderer for the column wins.
+ */
+export type CanopyCellRenderer =
+  | ((node: CanopyNode, element: HTMLElement, context: CellContext) => boolean)
+  | ((row: GridRow, element: HTMLElement, context: GridCellContext) => boolean | void);
+
+/** Typed cell editors that editable flat-grid columns choose by name (docs/editing.md). */
+export type { CanopyCellEditor, CanopyEditorContext, CanopyEditorInstance } from "./editing.js";
+/** A custom aggregate: the raw nonmissing values of a group (or the whole result) in, a finite number or null out. */
+export interface CanopyAggregate {
+  compute(values: readonly (string | number | boolean)[], context: { readonly column: string; readonly aggregate: string }): number | null;
+  /** The cell text, a template with {value}, for example "med {value}". Default "<name> {value}". */
+  readonly label?: string;
+}
+
+/** Reserved for named column types: plugins can register them now, and later features read them. */
+export interface CanopyColumnType { readonly [key: string]: unknown; }
+
+/** What a plugin's toolbar item or menu entry runs with: the host action context (the selected nodes of a tree, or a grid's query) and the API. */
+export interface CanopyPluginItemContext {
+  readonly signal: AbortSignal;
+  readonly api: TreeGrid | DataGrid;
+  /** Trees: the selected nodes. */
+  readonly nodes?: CanopyNode[];
+  /** Flat grids: the accepted query. */
+  readonly query?: unknown;
+}
+
+/** A toolbar button or a more-menu entry. A menu entry on the reporting runtime can render content instead of running. */
+export type CanopyPluginItem =
+  | { label: string; run(context: CanopyPluginItemContext): unknown; render?: never }
+  | { label: string; render(container: HTMLElement, context: { close(): void; signal: AbortSignal }): void; run?: never };
+
+/** A handler for a canopyx:<name> event on the host element; call preventDefault on cancelable events to keep the default. */
+export type CanopyPluginEventHandler = (event: CustomEvent, context: CanopyPluginContext) => void;
+
+/**
+ * A plugin: a named bundle of lifecycle hooks and extension points. Register it for the page with CanopyX.use, or for one
+ * grid with the plugins option. Every member except name is optional.
+ */
+export interface CanopyPlugin {
+  /** 1 to 32 lowercase ASCII letters, digits and hyphens, starting with a letter; unique on the page. */
+  readonly name: string;
+  /** Plugins that start first, and parts of the runtime (for example "export") that load before init. */
+  readonly requires?: readonly string[];
+  /** The view kinds the plugin applies to; absent means both. */
+  readonly views?: readonly CanopyViewKind[];
+  /** Runs once per grid or tree, after its required parts loaded; the grid's ready waits for a returned promise. */
+  init?(context: CanopyPluginContext): void | PromiseLike<void>;
+  /** Runs when the grid or tree is destroyed. */
+  destroy?(context: CanopyPluginContext): void;
+  /** Cell renderers by name; a column chooses one with its renderer field. */
+  readonly cellRenderers?: Readonly<Record<string, CanopyCellRenderer>>;
+  /** Reserved: named column types. */
+  readonly columnTypes?: Readonly<Record<string, CanopyColumnType>>;
+  /** Typed cell editors by name; an editable flat-grid column chooses one with its editor type. */
+  readonly editors?: Readonly<Record<string, import("./editing.js").CanopyCellEditor>>;
+  /** Custom aggregates by operation name: compute(values, context) returns a finite number or null; label is a "{value}" template. */
+  readonly aggregates?: Readonly<Record<string, CanopyAggregate | CanopyAggregate["compute"]>>;
+  /** Detail renderers by name; a reporting definition chooses one with detail.renderer. */
+  readonly detailRenderers?: Readonly<Record<string, (row: Readonly<{ id: string; cells: Readonly<Record<string, unknown>> }>, element: HTMLElement, context: { readonly id: string; readonly signal: AbortSignal; readonly api: unknown; readonly labels: Readonly<Record<string, string>>; onDispose(cleanup: () => void): void }) => void | PromiseLike<void>>>;
+  /** Record panel section renderers by name (a chart, for example); a section chooses one with renderer. */
+  readonly drawerSections?: Readonly<Record<string, RecordSectionRenderer>>;
+  /** Actions of the record panel's actions menu, after the built-in ones and the host's. */
+  readonly recordActions?: readonly RecordAction[];
+  /** Buttons in the toolbar's left-hand group, after Columns and before Views. */
+  readonly toolbarItems?: readonly CanopyPluginItem[];
+  /** Entries of the more menu, after the host's actions. */
+  readonly menuItems?: readonly CanopyPluginItem[];
+  /** Export formats: registered for the page by CanopyX.use, offered by the one grid for the plugins option. */
+  readonly exportFormats?: readonly ExportFormat<any>[];
+  /** Handlers by event name without the canopyx: prefix (select, query, load, error, rowActivate, ...). */
+  readonly events?: Readonly<Record<string, CanopyPluginEventHandler>>;
+}
+
+/** The code of a part of the runtime, as its script registers it. */
+export interface CanopyPartDefinition {
+  /** The build version; a runtime installs only the part of its own build. */
+  readonly version: string;
+  /** Parts that load, and install, before this one. */
+  readonly requires?: readonly string[];
+  /** Installs the part into the runtime context it is given. */
+  install(context: Readonly<Record<string, unknown>>): void;
+}