@evotecit/canopyx 0.0.0-stage → 0.1.1

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.

package/README.md

@@ -1,3 +1,199 @@
-# Temporary Holding Version
+# CanopyX - Interactive Trees and Data Grids
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Turn application data into searchable trees, sortable tables and standalone HTML reports. Use C# to write a report you can open in a browser, or mount the JavaScript runtime in your own page.
+
+📦 **.NET packages**
+
+[![CanopyX NuGet](https://img.shields.io/nuget/v/CanopyX?label=CanopyX)](https://www.nuget.org/packages/CanopyX)
+[![CanopyX.Html NuGet](https://img.shields.io/nuget/v/CanopyX.Html?label=CanopyX.Html)](https://www.nuget.org/packages/CanopyX.Html)
+
+🌐 **JavaScript package**
+
+[![npm version](https://img.shields.io/npm/v/@evotecit/canopyx)](https://www.npmjs.com/package/@evotecit/canopyx)
+[![MIT license](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/license/mit)
+
+## What you can build
+
+- **File and folder explorers** with expandable branches, lazy loading, search and multi-selection.
+- **Inventory and results tables** with typed sorting, filters, column resizing and saved views.
+- **HTML reports** that include their own runtime and data and can be opened from disk or a file share.
+- **Application views** backed by paged or cursor-based data sources, with selection and detail callbacks.
+- **Email and print tables** rendered from the same .NET view without JavaScript.
+
+![File explorer in the light theme, with sizes, dates, owners and an expanded detail row](https://cdn.jsdelivr.net/npm/@evotecit/canopyx@0.1.1/docs/images/tree-grid-light.png)
+
+The same explorer in the dark theme, alongside its script-free output for email and print:
+
+| Dark theme | Static outline |
+| --- | --- |
+| ![File explorer in the dark theme](https://cdn.jsdelivr.net/npm/@evotecit/canopyx@0.1.1/docs/images/tree-grid-dark.png) | ![Static outline table](https://cdn.jsdelivr.net/npm/@evotecit/canopyx@0.1.1/docs/images/static-outline.png) |
+
+## Features
+
+| | Tree grid | Data grid |
+| --- | --- | --- |
+| Navigation | Expandable branches, path search and lazy children | Continuous or paged records, offset or cursor navigation |
+| Querying | Search, sibling sorting and named filters | Search, multi-column sorting, typed filters and condition groups |
+| Columns | Resize and hide | Resize, hide, reorder, pin and fit to content |
+| Selection | Single/multiple selection and hierarchical checkboxes | Single/multiple selection with stable record IDs |
+| Presentation | Badges, details, custom cells and light/dark themes | Links, progress, wrapped text, row highlighting and light/dark themes |
+| Delivery | Single HTML file, sidecar bundle or hosted data | Single HTML file or hosted data |
+
+Both views use virtual rows and support keyboard navigation. Reporting grids also provide grouping, aggregates, saved views, CSV export and row copying. English labels are built in; Polish, German and Spanish packs are included.
+
+## Installation
+
+### .NET
+
+```shell
+dotnet add package CanopyX.Html
+```
+
+`CanopyX.Html` includes the browser assets and brings in `CanopyX` for the view definitions. Install `CanopyX` alone when you only need the model, tree bundle writer or script-free table renderer.
+
+| Target | Support |
+| --- | --- |
+| .NET 8 and .NET 10 | Windows, Linux and macOS |
+| .NET Standard 2.0 | Compatible .NET applications |
+| .NET Framework 4.7.2 | Windows |
+
+Neither .NET package adds third-party runtime dependencies. Generating a report from C# needs no Node.js, npm or JavaScript build step.
+
+### JavaScript
+
+```shell
+npm install @evotecit/canopyx
+```
+
+The package includes ES modules, classic scripts, stylesheets and TypeScript declarations, with no runtime package dependencies.
+
+## Usage in .NET
+
+### Create a file explorer
+
+```csharp
+using CanopyX;
+using CanopyX.Html;
+
+var files = new CanopyTreeView("files", "Project files");
+files.Search = new CanopySearchOptions();
+files.Columns.Add(new CanopyColumn("name", "Name") { Sortable = true });
+files.Columns.Add(new CanopyColumn("size", "Size")
+{
+    Kind = CanopyColumnKind.Number,
+    Sortable = true
+});
+
+var projects = new CanopyNode("projects", "Projects");
+var report = new CanopyNode("quarterly-report", "Quarterly report.pdf");
+report.Cells["size"] = new CanopyCell(2048L) { Text = "2 KiB" };
+projects.Children.Add(report);
+files.Roots.Add(projects);
+
+files.SaveHtmlPage("files.html");
+```
+
+Open `files.html` in a browser and expand Projects. The first column displays the node label; the Size column displays the matching cell. Numeric values control sorting while `Text` controls the displayed value.
+
+For a larger tree, write a bundle that loads branches on demand:
+
+```csharp
+files.SaveHtmlBundle("file-report");
+```
+
+Keep the generated page, assets and data files together. The bundle can be opened directly from disk or a file share.
+
+### Create an inventory table
+
+```csharp
+using CanopyX;
+using CanopyX.Html;
+
+var inventory = new CanopyDataGridView("inventory", "Inventory");
+inventory.Columns.Add(new CanopyColumn("name", "Name") { Sortable = true });
+inventory.Columns.Add(new CanopyColumn("size", "Size")
+{
+    Kind = CanopyColumnKind.Number,
+    Sortable = true
+});
+
+foreach (var (name, bytes) in new[] { ("Archive", 2048L), ("Documents", 512L) })
+{
+    var row = new CanopyGridRow(name);
+    row.Cells["name"] = name;
+    row.Cells["size"] = new CanopyCell(bytes) { Text = $"{bytes:N0} bytes" };
+    inventory.Rows.Add(row);
+}
+
+inventory.SaveHtmlPage("inventory.html");
+```
+
+Open `inventory.html` to search the records, sort by name or size, and adjust the columns. Record IDs stay stable when the order changes.
+
+### Render a table for email or print
+
+```csharp
+using CanopyX.Rendering;
+
+string treeTable = CanopyStaticHtml.Render(files);
+string inventoryTable = CanopyStaticHtml.RenderGrid(inventory);
+```
+
+These methods return HTML tables with no scripts. Insert the returned HTML into your email, print layout or document-generation workflow.
+
+## Usage in JavaScript
+
+Add a container to your page:
+
+```html
+<div id="files" style="height: 360px"></div>
+```
+
+Then mount a tree grid:
+
+```javascript
+import { createTreeGrid } from "@evotecit/canopyx";
+import "@evotecit/canopyx/styles.css";
+
+const grid = createTreeGrid(document.getElementById("files"), {
+  view: {
+    protocol: "canopyx/2", type: "view", id: "files", label: "Project files",
+    rowHeight: 28, pageSize: 100, selection: "single",
+    search: { minLength: 1, maxResults: 50 },
+    columns: [{ id: "name", title: "Name", kind: "text", width: 320 }],
+    source: { kind: "inline" },
+    roots: [{
+      id: "projects", label: "Projects",
+      children: [{ id: "quarterly-report", label: "Quarterly report.pdf" }]
+    }]
+  }
+});
+
+await grid.ready;
+```
+
+The stylesheet import uses your application's asset pipeline. For a page without a bundler, serve `classic.js` and `styles.css` from the installed package and load them with `<script>` and `<link>` elements; the script exposes `window.CanopyX`. Use one matching runtime and stylesheet per page.
+
+### Choose a runtime
+
+| Import | Use it for | Stylesheet |
+| --- | --- | --- |
+| `@evotecit/canopyx` | Interactive tree grids | `@evotecit/canopyx/styles.css` |
+| `@evotecit/canopyx/grid` | Flat data grids | `@evotecit/canopyx/grid.css` |
+| `@evotecit/canopyx/reporting` | Flat grids with reporting controls | `@evotecit/canopyx/reporting.css` |
+
+Module imports are safe on the server; mounting a view requires a browser. The included TypeScript declarations describe the view, data-source and event APIs.
+
+### Translate the controls
+
+Import labels from `@evotecit/canopyx/locales/pl`, `/locales/de` or `/locales/es` and pass them as `labels` in your view definition. In C#, set the view's `Labels` to `CanopyLabels.Polish()`, `German()` or `Spanish()` before writing the page.
+
+## Working with larger datasets
+
+Virtual rows keep the rendered DOM small. Tree bundles split data into sidecar files, and hosted sources let your application fetch records as the reader navigates. Flat-grid queries filter and sort the complete dataset before paging; loading one page does not mean the rest of the results are available in the browser.
+
+CSV export and copying distinguish filtered results, selected records and all records. For Office files, large exports or application actions, connect your own callbacks to the view.
+
+## Community and license
+
+CanopyX is an Evotec project, licensed under MIT. Questions and feedback are welcome in the [Evotec community on Discord](https://evo.yt/discord). You can find more Evotec projects and articles at [evotec.xyz](https://evotec.xyz/hub).