@evotecit/canopyx 0.0.0-stage → 0.1.0

package/JavaScript/locales/pl.mjs

@@ -0,0 +1,223 @@
+// Generated from CanopyX/Views/Locales/labels.json by Build/Sync-Assets.ps1.
+const labels = Object.freeze({
+  searchPlaceholder: "Szukaj",
+  searchResults: "Wyniki wyszukiwania",
+  searchResultCount: "Wyniki: {count}",
+  searchResultCountOfTotal: "Wyniki: {count} z {total}",
+  searchResultCountOfMany: "Wyświetlone wyniki: {count}",
+  searchNoResults: "Brak wyników",
+  searchTooShort: "Wpisz co najmniej {min} znaków",
+  searchWordTooShort: "Wpisz słowo o długości co najmniej {min} znaków",
+  searchFailed: "Nie udało się wyszukać: {error}",
+  columns: "Kolumny",
+  gridFilters: "Filtry",
+  gridFitContent: "Dopasuj do zawartości",
+  gridUnpin: "Odepnij",
+  gridWhere: "Gdzie",
+  gridComplexFilter: "Ta kolumna należy do mieszanej grupy warunków. Edytuj ją w Filtrach.",
+  gridClearColumnFilter: "Wyczyść filtr",
+  gridSelectionAggregate: "Liczba: {count} · Suma: {sum} · Średnia: {average} · Minimum: {minimum} · Maksimum: {maximum}",
+  gridConditionValue: "Wartość",
+  gridConditionUpperValue: "Górna wartość",
+  gridDeleteCondition: "Usuń warunek",
+  gridShowRowsWhere: "Pokaż wiersze, dla których",
+  gridOfTheseAreTrue: "z tych warunków są spełnione",
+  gridOfThese: "z tych warunków",
+  gridGroupCount: "Grupy: {count}",
+  gridMore: "Więcej",
+  gridDone: "Gotowe",
+  gridClearAll: "Wyczyść wszystko",
+  gridRows: "wierszy",
+  gridResultNoun: "{count} z {total} {noun}",
+  gridSearchNoun: "Szukaj: {noun}",
+  gridChart: "Wykres",
+  gridColumnMenu: "Menu kolumny {column}",
+  gridSortAscending: "Sortuj rosnąco",
+  gridSortDescending: "Sortuj malejąco",
+  gridClearSort: "Usuń sortowanie",
+  gridFilterColumn: "Filtruj…",
+  gridHideColumn: "Ukryj kolumnę",
+  gridGroupedBy: "Grupowanie",
+  gridRemoveGrouping: "Usuń grupowanie",
+  gridSelectAllValues: "Zaznacz wszystkie wartości",
+  gridFilterValues: "Szukaj wartości",
+  gridAddCondition: "+ Warunek",
+  gridAddGroup: "+ Grupa",
+  gridAnd: "i",
+  gridOr: "lub",
+  gridEditAsText: "Edytuj jako tekst",
+  gridFilterText: "Wyrażenie filtru",
+  gridDeepFilters: "Zapisany filtr ma więcej niż dwa poziomy zagnieżdżenia.",
+  gridToday: "Dzisiaj",
+  gridYesterday: "Wczoraj",
+  gridLastSevenDays: "Ostatnie 7 dni",
+  gridLastThirtyDays: "Ostatnie 30 dni",
+  gridThisMonth: "Ten miesiąc",
+  gridDateRange: "Zakres",
+  gridEmpty: "Brak: {noun}",
+  gridEmptyReason: "Nie ma rekordów do wyświetlenia.",
+  gridNoMatches: "Brak pasujących: {noun}",
+  gridNoMatchesReason: "Wyszukiwanie: {search}. Aktywne filtry: {count}.",
+  gridRetry: "Ponów",
+  gridLoadFailed: "Nie udało się wczytać rekordów",
+  gridAll: "Wszystkie",
+  gridPageOf: "{page} z {pages}",
+  gridStatusCount: "{count} {noun} · zaznaczono {selected}",
+  gridDetailsSection: "Szczegóły",
+  gridPreviousRecord: "Poprzedni rekord",
+  gridNextRecord: "Następny rekord",
+  gridShowMore: "Pokaż więcej",
+  gridNoData: "Brak danych",
+  gridPeriodRange: "{from}–{to}: {state}",
+  gridHealthy: "Prawidłowy",
+  gridResultCount: "Wiersze: {count} z {total}",
+  gridUnknownCount: "Liczba wyników jest niedostępna",
+  gridMatchedCount: "Pasujące wiersze: {count}",
+  gridCursorRange: "Wiersze {first}–{last}",
+  gridPaging: "Strony wyników",
+  gridPageRange: "Wiersze {first}–{last} z {count}",
+  gridPageNumber: "Strona",
+  gridPageLength: "Wiersze na stronę",
+  gridFirstPage: "Pierwsza strona",
+  gridPreviousPage: "Poprzednia strona",
+  gridNextPage: "Następna strona",
+  gridLastPage: "Ostatnia strona",
+  gridClearQuery: "Wyczyść wyszukiwanie i filtry",
+  gridRemoveSearch: "Wyczyść wyszukiwanie: {search}",
+  gridGroupedFilters: "Grupy filtrów (warunki: {count})",
+  gridRemoveGroup: "Wyczyść grupy filtrów",
+  gridRemoveCondition: "Usuń warunek: {condition}",
+  gridExport: "Eksportuj",
+  gridFilteredResults: "Przefiltrowane wyniki",
+  gridSelectedRows: "Zaznaczone wiersze",
+  gridAllResults: "Wszystkie wyniki",
+  gridDownloadCsv: "Pobierz plik CSV",
+  gridCopy: "Kopiuj",
+  gridDetails: "Szczegóły rekordu",
+  gridColumn: "Kolumna",
+  gridOperator: "Warunek",
+  gridValue: "Wartość (daty w UTC)",
+  gridValueType: "Typ wartości źródłowej",
+  gridText: "Tekst",
+  gridBoolean: "Wartość logiczna",
+  gridAddFilter: "Dodaj filtr",
+  gridRemoveFilter: "Usuń filtr kolumny {column}",
+  gridApply: "Zastosuj",
+  gridClearFilters: "Wyczyść wszystkie filtry",
+  gridMoveEarlier: "Przenieś kolumnę {column} w lewo",
+  gridMoveLater: "Przenieś kolumnę {column} w prawo",
+  gridViews: "Widoki",
+  gridViewName: "Nazwa widoku",
+  gridSaveView: "Zapisz widok",
+  gridRemoveView: "Usuń widok",
+  gridResetView: "Resetuj widok",
+  gridChooseView: "Wybierz zapisany widok",
+  gridInvalidFilter: "Wprowadź prawidłową wartość filtru.",
+  gridBetween: "między (włącznie)",
+  gridRangeEnd: "Wartość końcowa (daty w UTC)",
+  gridInvalidRange: "Wprowadź wartość końcową nie mniejszą niż początkowa.",
+  gridSuggestedCategory: "Sugerowana kategoria",
+  gridChooseCategory: "Wybierz kategorię",
+  gridBooleanValue: "Wartość logiczna",
+  gridTrue: "Prawda",
+  gridFalse: "Fałsz",
+  gridHeaderFilter: "Filtruj kolumnę {column}",
+  gridExpandCell: "{column}: pokaż pełny tekst",
+  gridCloseCell: "Zamknij pełny tekst",
+  gridMoveColumn: "{column}: przeciągnij, aby przenieść, lub użyj strzałek w lewo i w prawo",
+  gridResizeHelp: "Enter dopasowuje do maksymalnie 200 wczytanych wierszy; strzałki w lewo i w prawo zmieniają szerokość.",
+  gridFitColumn: "Dopasuj kolumnę {column}",
+  gridFitAllColumns: "Dopasuj wszystkie kolumny",
+  gridColumnMoved: "Kolumna {column} przeniesiona na pozycję {position}",
+  gridPinColumn: "{column}: przypięcie kolumny",
+  gridPinNone: "Przewijana",
+  gridPinLeft: "Przypnij z lewej",
+  gridPinRight: "Przypnij z prawej",
+  gridResponsiveHidden: "Ukryta przy tej szerokości",
+  gridFindColumn: "Znajdź kolumnę…",
+  gridShowAllColumns: "Pokaż wszystkie",
+  gridResetColumns: "Przywróć kolumny",
+  gridReorderColumn: "{column}: przeciągnij lub naciśnij Alt+Strzałka w górę albo Alt+Strzałka w dół, aby przenieść",
+  gridPinnedLeft: "Przypięta z lewej",
+  gridPinnedRight: "Przypięta z prawej",
+  gridFilterGroupTitle: "Dodatkowe grupy warunków",
+  gridFilterMatch: "Dopasowanie",
+  gridFilterAll: "Wszystkie",
+  gridFilterAny: "Dowolny",
+  gridAddFilterGroup: "Dodaj grupę warunków",
+  gridDeleteFilterGroup: "Usuń grupę warunków",
+  gridFacetValues: "Wartości i liczby wystąpień po zastosowaniu filtrów",
+  gridFacetSearch: "Szukaj wartości",
+  gridFacetIncludeCurrent: "Uwzględnij aktywne filtry tej kolumny",
+  gridFacetLoad: "Wczytaj wartości",
+  gridFacetChoose: "Wybierz wartość",
+  gridFacetCounts: "Pasujące wiersze: {count}; wartości: {shown} z {total}.",
+  gridFacetReload: "Wartości się zmieniły lub żądanie zostało anulowane. Wczytaj wartości ponownie.",
+  gridRenameView: "Zmień nazwę widoku",
+  gridDefaultView: "Ustaw jako domyślny",
+  gridClearDefaultView: "Usuń ustawienie domyślne",
+  gridDefaultViewName: "Widok domyślny: {name}",
+  gridNoDefaultView: "Brak widoku domyślnego",
+  gridDefaultViewOption: "{name} (domyślny)",
+  gridSelection: "Zaznaczenie",
+  gridSelectPage: "Zaznacz stronę",
+  gridSelectMatching: "Zaznacz wszystkie pasujące",
+  gridClearSelection: "Wyczyść zaznaczenie",
+  gridSelectionCount: "{count} zaznaczonych",
+  gridSelectionQueryCount: "Zaznaczone pasujące rekordy: {count}; wykluczone: {excluded}",
+  gridSelectionQueryUnknown: "Zaznaczono wszystkie pasujące rekordy; wykluczone: {excluded}",
+  gridSelectRecord: "Zaznacz rekord {id}",
+  gridGroupHeading: "{column}: {value} (rekordy: {count})",
+  gridGroupMissing: "Brak wartości",
+  gridGroupExpand: "Rozwiń grupę",
+  gridGroupCollapse: "Zwiń grupę",
+  gridSummary: "Podsumowanie wyników",
+  gridGroupOrder: "Kolejność grup jest ustalona w raporcie",
+  gridExportProgress: "Rekordy: {completed} z {total}",
+  gridExportReading: "Rekordy: {completed}",
+  gridExportCancelled: "Eksport anulowany",
+  gridCancelExport: "Anuluj eksport",
+  gridPrint: "Drukuj",
+  gridCloseRecord: "Zamknij szczegóły rekordu",
+  gridContains: "zawiera",
+  gridStartsWith: "zaczyna się od",
+  gridIn: "jest jedną z wartości",
+  gridIsNull: "brak wartości",
+  gridIsNotNull: "wartość istnieje",
+  visibleColumns: "Widoczne kolumny",
+  resizeColumn: "Zmień szerokość kolumny {column}",
+  columnWidth: "{width} pikseli",
+  loading: "Ładowanie…",
+  loadError: "Nie udało się wczytać: {error} (Enter, aby ponowić)",
+  queryFailed: "Nie udało się odświeżyć widoku: {error}",
+  actions: "Akcje",
+  editValue: "Edytuj wartość kolumny {column}",
+  saveEdit: "Zapisz",
+  cancelEdit: "Anuluj",
+  invalidEdit: "Wprowadź prawidłową wartość kolumny {column}.",
+  interactionPending: "Oczekiwanie na aplikację…",
+  interactionRejected: "Aplikacja odrzuciła operację.",
+  interactionFailed: "Operacja nie powiodła się: {error}",
+  markMove: "Przenieś ten węzeł",
+  moveHere: "Przenieś tutaj",
+  moveBefore: "Przenieś przed",
+  moveAfter: "Przenieś za",
+  cancelMove: "Anuluj przenoszenie",
+  showMore: "Pokaż więcej (wczytano {loaded} z {total})",
+  showMoreUnknownTotal: "Pokaż więcej (wczytano {loaded})",
+  pageLoaded: "Wczytano {loaded} z {total}",
+  itemsLoaded: "Elementy: {count}",
+  yes: "Tak",
+  no: "Nie",
+  utcTime: "{time} UTC",
+  localTime: "{time} czasu lokalnego",
+  mountError: "Nie można wyświetlić widoku: {error}",
+});
+const staticLabels = Object.freeze({
+  overflowNote: "Pokazano {shown} z {total} wierszy.",
+  unknownTotal: "nieznanej liczby",
+  hiddenRows: "Niewyświetlone wiersze poniżej: {count}",
+  fullReport: "Otwórz pełny raport",
+});
+export { labels, staticLabels };
+export default labels;

package/JavaScript/protocol.d.ts

@@ -0,0 +1,229 @@
+/** Values carried by cells and host-governed edit proposals. Numbers must be finite. */
+export type CellValue = string | number | boolean | null;
+export type TimeZone = "utc" | "local";
+export type CheckMode = "independent" | "hierarchical";
+export type CheckState = boolean | "mixed";
+export type SortDirection = "asc" | "desc";
+
+export interface CanopyBadge { text: string; tone?: string; title?: string; }
+/** Ordered visual history metadata; raw cell values still drive queries and exports. */
+export interface CellPeriod { period: string; value?: number | null; state?: string | null; tone?: string; }
+export interface CanopyCell {
+  value?: CellValue;
+  text?: string;
+  /** Alternate flat-grid search text, independent of display, typed queries and export. */
+  searchText?: string;
+  title?: string;
+  tone?: string;
+  badges?: CanopyBadge[];
+  /** Secondary identifier text, independent of the raw value. */
+  secondary?: string;
+  /** At most 4096 ordered periods for a flat-grid history presenter. */
+  series?: CellPeriod[];
+}
+export type Cell = CellValue | CanopyCell;
+
+export interface TableDetail {
+  type: "table";
+  height?: number;
+  caption?: string;
+  columns: string[];
+  widths?: number[];
+  rows: Cell[][];
+}
+export interface PropertiesDetail {
+  type: "properties";
+  height?: number;
+  items: { name: string; value: Cell }[];
+}
+/** HTML details contain content the host explicitly trusts. */
+export interface HtmlDetail { type: "html"; height?: number; html: string; }
+export type CanopyDetail = TableDetail | PropertiesDetail | HtmlDetail;
+
+/** A host-owned node. IDs are unique within the view; lazy nodes omit children. */
+interface NodeDefinition {
+  id: string;
+  label: string;
+  kind?: string;
+  icon?: string;
+  group?: boolean;
+  cells?: Record<string, Cell>;
+  badges?: CanopyBadge[];
+  flags?: string[];
+  data?: Record<string, string>;
+  expanded?: boolean;
+  className?: string;
+}
+
+export interface CanopyColumn {
+  id: string;
+  title: string;
+  width: number;
+  /** Minimum manual width in CSS pixels; defaults to 40. */
+  minWidth?: number;
+  /** Maximum manual width in CSS pixels; defaults to 2147483647. */
+  maxWidth?: number;
+  kind: "text" | "number" | "datetime";
+  sortable?: boolean;
+  hidden?: boolean;
+  editable?: boolean;
+}
+export interface CanopyFilter {
+  id: string;
+  label: string;
+  flag: string;
+  ancestorFlag?: string;
+  hidden?: boolean;
+}
+export interface ContextAction { id: string; label: string; }
+export interface CheckIntent { readonly path: readonly string[]; readonly checked: boolean; }
+export interface Sort { column: string; direction: SortDirection; }
+export interface ViewQuery { version: 1; sort: Sort | null; filters: string[]; }
+/** Source callbacks observe frozen query snapshots, including their sort and filter values. */
+export interface ReadonlyViewQuery {
+  readonly version: 1;
+  readonly sort: Readonly<Sort> | null;
+  readonly filters: readonly string[];
+}
+export type LeafNode = NodeDefinition & {
+  hasChildren?: false; children?: []; childCount?: never; ref?: never; detail?: never;
+};
+export type DetailNode = NodeDefinition & {
+  detail: CanopyDetail; hasChildren?: false; children?: never; childCount?: never; ref?: never;
+};
+export interface InlineBranch<TNode = CanopyNode> extends NodeDefinition {
+  children: TNode[]; hasChildren?: true; childCount?: number; ref?: never; detail?: never;
+}
+export type LazyNode = NodeDefinition & {
+  hasChildren: true; childCount?: number; ref?: string; children?: never; detail?: never;
+};
+/** A node chooses one leaf, detail, complete branch, or lazy branch payload. */
+export type CanopyNode = LeafNode | DetailNode | InlineBranch | LazyNode;
+/** Inline roots and every descendant are fully materialized. */
+export type InlineNode = LeafNode | DetailNode | InlineBranch<InlineNode>;
+
+/** Names accepted by the interactive runtime; omitted translations use English. */
+export type LabelName =
+  | "gridPaging" | "gridPageRange" | "gridPageNumber" | "gridPageLength" | "gridFirstPage" | "gridPreviousPage" | "gridNextPage" | "gridLastPage"
+  | "gridUnknownCount" | "gridMatchedCount" | "gridCursorRange"
+  | "gridResultCount" | "gridClearQuery" | "gridRemoveSearch" | "gridGroupedFilters" | "gridRemoveGroup" | "gridRemoveCondition"
+  | "gridExport" | "gridFilteredResults" | "gridSelectedRows" | "gridAllResults" | "gridDownloadCsv" | "gridCopy" | "gridDetails"
+  | "searchPlaceholder" | "searchResults" | "searchResultCount" | "searchResultCountOfTotal"
+  | "searchResultCountOfMany" | "searchNoResults" | "searchTooShort" | "searchWordTooShort" | "searchFailed"
+  | "columns" | "visibleColumns" | "resizeColumn" | "columnWidth" | "loading" | "loadError" | "queryFailed"
+  | "showMore" | "showMoreUnknownTotal" | "pageLoaded" | "itemsLoaded" | "yes" | "no"
+  | "utcTime" | "localTime" | "mountError" | "actions" | "editValue" | "saveEdit" | "cancelEdit"
+  | "invalidEdit" | "interactionPending" | "interactionRejected" | "interactionFailed"
+  | "markMove" | "moveHere" | "moveBefore" | "moveAfter" | "cancelMove"
+  | "gridFilters" | "gridColumn" | "gridOperator" | "gridValue" | "gridValueType" | "gridText" | "gridBoolean" | "gridAddFilter" | "gridRemoveFilter" | "gridApply" | "gridClearFilters" | "gridMoveEarlier" | "gridMoveLater" | "gridViews" | "gridViewName" | "gridSaveView" | "gridRemoveView" | "gridResetView" | "gridChooseView" | "gridInvalidFilter" | "gridContains" | "gridStartsWith" | "gridIn" | "gridIsNull" | "gridIsNotNull"
+  | "gridBetween" | "gridRangeEnd" | "gridInvalidRange" | "gridSuggestedCategory" | "gridChooseCategory" | "gridBooleanValue" | "gridTrue" | "gridFalse" | "gridHeaderFilter"
+  | "gridExpandCell" | "gridCloseCell" | "gridCloseRecord" | "gridMoveColumn" | "gridResizeHelp" | "gridColumnMoved" | "gridFitColumn" | "gridFitAllColumns"
+  | "gridPinColumn" | "gridPinNone" | "gridPinLeft" | "gridPinRight" | "gridResponsiveHidden"
+  | "gridFindColumn" | "gridShowAllColumns" | "gridResetColumns" | "gridReorderColumn" | "gridPinnedLeft" | "gridPinnedRight"
+  | "gridFilterGroupTitle" | "gridFilterMatch" | "gridFilterAll" | "gridFilterAny" | "gridAddFilterGroup" | "gridDeleteFilterGroup"
+  | "gridFacetValues" | "gridFacetSearch" | "gridFacetIncludeCurrent" | "gridFacetLoad" | "gridFacetChoose" | "gridFacetCounts" | "gridFacetReload"
+  | "gridRenameView" | "gridDefaultView" | "gridClearDefaultView" | "gridDefaultViewName" | "gridNoDefaultView" | "gridDefaultViewOption"
+  | "gridSelection" | "gridSelectPage" | "gridSelectMatching" | "gridClearSelection" | "gridSelectionCount"
+  | "gridSelectionQueryCount" | "gridSelectionQueryUnknown" | "gridSelectRecord"
+  | "gridGroupHeading" | "gridGroupMissing" | "gridGroupExpand" | "gridGroupCollapse" | "gridSummary" | "gridGroupOrder"
+  | "gridExportProgress" | "gridExportReading" | "gridExportCancelled" | "gridCancelExport" | "gridPrint"
+  | "gridFitContent"
+  | "gridUnpin"
+  | "gridWhere"
+  | "gridComplexFilter"
+  | "gridClearColumnFilter"
+  | "gridSelectionAggregate"
+  | "gridConditionValue"
+  | "gridConditionUpperValue"
+  | "gridDeleteCondition"
+  | "gridShowRowsWhere"
+  | "gridOfTheseAreTrue"
+  | "gridOfThese"
+  | "gridGroupCount"
+  | "gridMore" | "gridDone" | "gridClearAll" | "gridRows" | "gridResultNoun" | "gridSearchNoun" | "gridChart" | "gridColumnMenu" | "gridSortAscending" | "gridSortDescending" | "gridClearSort" | "gridFilterColumn" | "gridHideColumn" | "gridGroupedBy" | "gridRemoveGrouping" | "gridSelectAllValues" | "gridFilterValues" | "gridAddCondition" | "gridAddGroup" | "gridAnd" | "gridOr" | "gridEditAsText" | "gridFilterText" | "gridDeepFilters" | "gridToday" | "gridYesterday" | "gridLastSevenDays" | "gridLastThirtyDays" | "gridThisMonth" | "gridDateRange" | "gridEmpty" | "gridEmptyReason" | "gridNoMatches" | "gridNoMatchesReason" | "gridRetry" | "gridLoadFailed" | "gridAll" | "gridPageOf" | "gridStatusCount" | "gridDetailsSection" | "gridPreviousRecord" | "gridNextRecord" | "gridShowMore" | "gridNoData" | "gridPeriodRange" | "gridHealthy";
+export type CanopyLabels = Partial<Record<LabelName, string>>;
+
+export interface InlineSourceDefinition { kind: "inline"; }
+export interface SidecarSourceDefinition { kind: "sidecar"; base: string; }
+/** URL templates use the placeholders defined in docs/data-protocol.md. */
+export interface RemoteSourceDefinition {
+  kind: "remote";
+  children: string;
+  search?: string;
+  counts?: string;
+  queryAware?: boolean;
+}
+export type SourceDefinition = InlineSourceDefinition | SidecarSourceDefinition | RemoteSourceDefinition;
+
+interface ViewDefinitionBase {
+  protocol: "canopyx/2";
+  type: "view";
+  id: string;
+  label: string;
+  rowHeight: number;
+  pageSize: number;
+  selection: "single" | "multiple";
+  columns: CanopyColumn[];
+  icons?: Record<string, string>;
+  search?: { minLength: number; maxResults: number; placeholder?: string; kinds?: string[] };
+  filters?: CanopyFilter[];
+  timeZone?: TimeZone;
+  pinTreeColumn?: boolean;
+  stateKey?: string;
+  deepLink?: boolean;
+  labels?: CanopyLabels;
+  dragDrop?: boolean;
+  contextActions?: ContextAction[];
+}
+/** Checking intents describe a view only when its checkbox mode is enabled. */
+export type ViewDefinition = ViewDefinitionBase & (
+  | { checkboxes: CheckMode; checkIntents?: readonly CheckIntent[] }
+  | { checkboxes?: never; checkIntents?: never }
+);
+/** Inline views own roots. Sidecar and remote views read roots from their source. */
+export type InlineView = ViewDefinition & { source: InlineSourceDefinition; roots: InlineNode[] };
+export type SidecarView = ViewDefinition & { source: SidecarSourceDefinition; roots?: never };
+export type RemoteView = ViewDefinition & { source: RemoteSourceDefinition; roots?: never };
+export type CanopyView = InlineView | SidecarView | RemoteView;
+
+export interface PageResult {
+  items: CanopyNode[];
+  next?: string | null;
+  offset?: number;
+  total?: number;
+  revision?: string;
+}
+export interface PageDocument extends PageResult {
+  protocol: "canopyx/2";
+  type: "page";
+  parent: string | null;
+  next: string | null;
+  offset: number;
+}
+export interface SearchHit { path: string[]; label: string; kind?: string; context?: string; }
+export interface SearchResult { hits: SearchHit[]; truncated: boolean; total?: number; revision?: string; }
+export interface SearchDocument extends SearchResult { protocol: "canopyx/2"; type: "search"; query: string; }
+export interface CountUpdate { id: string; childCount?: number; cells?: Record<string, Cell>; flags?: string[]; }
+export interface CountsDocument {
+  protocol: "canopyx/2";
+  type: "counts";
+  items: CountUpdate[];
+  revision?: string;
+}
+
+/** Versioned presentation state. Paths can name unloaded nodes; restore validates before changing presentation. */
+export interface ViewState {
+  version: 1;
+  expanded: string[][];
+  selection: string[][];
+  columns: { id: string; width: number; hidden: boolean }[];
+  sort: Sort | null;
+  filters: string[];
+  timeZone: TimeZone;
+  pinTreeColumn: boolean;
+  focus: string[] | null;
+  anchor: { path: string[]; offset: number } | null;
+  checkboxes?: CheckMode;
+  checkIntents?: readonly CheckIntent[];
+}
+export interface LegacyViewState { expanded: string[][]; version?: never; }

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Evotec
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.