@evotecit/canopyx 0.3.15 → 0.3.18

package/JavaScript/locales/pl.mjs

@@ -1,7 +1,14 @@
 // Generated from CanopyX/Views/Locales/labels.json by Build/Sync-Assets.ps1.
 const labels = Object.freeze({
   gridNoExportColumns: "Żadna widoczna kolumna nie obsługuje eksportu.",
+  gridDownloadXlsx: "Skoroszyt Excel (.xlsx)",
+  gridDownloadPdf: "PDF",
+  gridExportWorkbookHint: "Formatowanie, grupy i sumy",
+  gridExportPdfHint: "Raport stronicowany z powtarzanymi nagłówkami",
+  gridExportCsvHint: "Wartości tekstowe (.csv)",
+  gridExportCopy: "Kopiuj do schowka",
   searchPlaceholder: "Szukaj",
+  gridRegexSearch: "Szukaj według wzorca",
   searchResults: "Wyniki wyszukiwania",
   searchResultCount: "Wyniki: {count}",
   searchResultCountOfTotal: "Wyniki: {count} z {total}",
@@ -116,7 +123,7 @@ const labels = Object.freeze({
   gridAllResults: "Wszystkie wyniki",
   gridVisibleRows: "Widoczne wiersze",
   gridAllRows: "Wszystkie wiersze",
-  gridDownloadCsv: "Pobierz plik CSV",
+  gridDownloadCsv: "CSV",
   gridCopy: "Kopiuj",
   gridDetails: "Szczegóły rekordu",
   gridCellRangeSelected: "Zaznaczono wiersze: {rows} × kolumny: {columns}",
@@ -215,7 +222,7 @@ const labels = Object.freeze({
   gridGroupMissing: "Brak wartości",
   gridGroupExpand: "Rozwiń grupę",
   gridGroupCollapse: "Zwiń grupę",
-  gridSummary: "Podsumowanie wyników",
+  gridSummary: "Suma całkowita",
   gridGroupOrder: "Kolejność grup jest ustalona w raporcie",
   gridAggregateCount: "liczba {value}",
   gridAggregateSum: "suma {value}",
@@ -350,7 +357,7 @@ const labels = Object.freeze({
   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",
+  gridFacetPanel: "Doprecyzuj",
   gridFacetPanelHide: "Ukryj panel filtrów",
   gridFacetPanelShow: "Pokaż panel filtrów",
   gridFacetShowMore: "Pokaż więcej: {count}",
@@ -506,11 +513,6 @@ const labels = Object.freeze({
   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",
-  calendarEditOccurrence: "Edytuj to wystąpienie",
-  calendarRemoveOccurrence: "Usuń to wystąpienie",
-  calendarOccurrenceScope: "Zmienia się tylko {date}; pozostałe daty wydarzenia {title} pozostają bez zmian.",
-  calendarSharedResources: "{count} {resources}",
-  calendarResourceWindow: "{resources} {start}–{end} z {total}",
   calendarThisAndFollowing: "To i następne wydarzenia",
   calendarAllEvents: "Wszystkie wydarzenia",
   calendarSources: "Kalendarze",
@@ -774,6 +776,172 @@ const labels = Object.freeze({
   changeCopyRequest: "Kopiuj żądanie",
   changeFiltered: "Filtry: {filters}",
   changePrintLimit: "Pominięte w wydruku wiersze: {count}.",
+  gridPivotFieldOptions: "Opcje pola",
+  gridCalculationResultType: "Typ wyniku",
+  gridCalculationDivideZero: "Dzielenie przez zero",
+  gridCalculationAdd: "Dodaj kolumnę obliczeniową",
+  gridCalculationTitle: "Nazwa kolumny",
+  gridCalculationId: "Identyfikator kolumny",
+  gridCalculationExpression: "Wyrażenie",
+  gridCalculationError: "Błąd obliczenia: {error}",
+  gridCalculationInvalid: "Sprawdź wyrażenie, odwołania do kolumn i typ wyniku.",
+  gridCalculationHelp: "Użyj [columnId], działań arytmetycznych, IF, COALESCE, ROUND, CONCAT, DATEPART lub DATEDIFF.",
+  gridCalculationNumber: "Liczba",
+  gridCalculationDate: "Data i czas",
+  gridPivot: "Tabela przestawna",
+  gridPivotRows: "Grupy wierszy",
+  gridPivotColumns: "Grupy kolumn",
+  gridPivotValues: "Wartości",
+  gridPivotFlat: "Pokaż rekordy",
+  gridPivotConfigure: "Ustawienia tabeli przestawnej",
+  gridPivotOther: "Pozostałe",
+  gridPivotLimited: "Widoczne ścieżki kolumn: {shown} z {total}; reszta w grupie Pozostałe. Sumy częściowe obejmują wszystkie pasujące elementy podrzędne.",
+  gridPivotColumn: "Wybierz kolumnę",
+  gridPivotTopN: "Najwyższe kolumny",
+  gridPivotSort: "Kolejność wierszy",
+  gridPivotDrill: "Pokaż rekordy dla: {row}, {column}",
+  gridPivotReturn: "Wróć do tabeli przestawnej",
+  gridPivotInvalid: "Wybierz poprawne osie i co najmniej jedną wartość.",
+  gridShowAs: "Pokaż wartości jako",
+  gridShowAsValue: "Wartość",
+  gridShowAsPercentGrandTotal: "% sumy całkowitej",
+  gridShowAsPercentParent: "% sumy grupy nadrzędnej",
+  gridShowAsPercentColumn: "% sumy kolumny",
+  gridShowAsPercentRow: "% sumy wiersza",
+  gridShowAsRunningTotal: "Suma narastająca",
+  gridShowAsRank: "Pozycja",
+  gridShowAsDifference: "Różnica względem poprzedniej wartości",
+  gridShowAsPercentChange: "% zmiany względem poprzedniej wartości",
+  gridBucket: "Przedział",
+  gridBucketNone: "Dokładne wartości",
+  gridBucketDay: "Dzień",
+  gridBucketWeek: "Tydzień",
+  gridBucketMonth: "Miesiąc",
+  gridBucketQuarter: "Kwartał",
+  gridBucketYear: "Rok",
+  gridBucketHour: "Godzina dnia",
+  gridBucketWeekday: "Dzień tygodnia",
+  gridBucketWidth: "Szerokość przedziału",
+  gridBucketEdges: "Granice przedziałów",
+  gridBucketOrigin: "Początek przedziałów",
+  gridBucketInvalid: "Podaj poprawne ustawienia przedziałów.",
+  boardLane: "Tor",
+  boardUnassigned: "Nieprzypisane",
+  boardEmpty: "Brak rekordów w tym torze",
+  boardWip: "{count} / {limit}",
+  boardWipFull: "Tor {lane} osiągnął limit pracy ({limit}).",
+  boardMove: "Przenieś do toru",
+  boardMoved: "Przeniesiono {title} do {lane}.",
+  boardRejected: "Przeniesienie nie zostało zaakceptowane.",
+  boardPending: "Oczekiwanie na akceptację przeniesienia…",
+  boardPartial: "Wyświetlono pierwsze {count} rekordów. Zawęź filtry, aby zobaczyć pozostałe.",
+  boardKeys: "Alt+Lewo lub Alt+Prawo przenosi między torami; Góra i Dół przegląda karty.",
+  planMilestone: "Kamień milowy",
+  planCritical: "Ścieżka krytyczna",
+  planBaseline: "Plan bazowy: {start} – {end}",
+  planDependency: "{from} kończy się przed rozpoczęciem {to}",
+  planDependencyConflict: "Konflikt zależności z {task}",
+  planOverlapConflict: "Nakłada się na {task}",
+  planIncomplete: "Pełna sieć zadań jest niedostępna; host musi sprawdzić tę propozycję.",
+  planInvalidRange: "Zadanie musi kończyć się w chwili rozpoczęcia lub później.",
+  planInvalidResource: "Wybierz zasób zadania.",
+  planProposal: "Propozycja {task}: {start} – {end}",
+  planMoveHint: "Alt+Lewo lub Alt+Prawo proponuje nową datę; Alt+Góra lub Alt+Dół proponuje zasób.",
+  planActual: "Rzeczywiste",
+  planPending: "Propozycja oczekuje na hosta",
+  planBaselineLabel: "Plan bazowy",
+  planDependencies: "Zależności",
+  planConflict: "Konflikt",
+  calendarEditOccurrence: "Edytuj to wystąpienie",
+  calendarRemoveOccurrence: "Usuń to wystąpienie",
+  calendarOccurrenceScope: "Zmienia się tylko {date}; pozostałe daty wydarzenia {title} pozostają bez zmian.",
+  calendarSharedResources: "{count} {resources}",
+  calendarResourceWindow: "{resources} {start}–{end} z {total}",
+  viewIntentWords: "Całe słowa",
+  viewIntentSubstring: "Tekst zawiera",
+  viewIntentPreview: "Proponowane zmiany",
+  viewIntentApplied: "Zastosowano zmiany widoku.",
+  viewIntentSuperseded: "Widok się zmienił. Ponownie wyświetl podgląd propozycji.",
+  viewIntentSearch: "Szukaj: {search}",
+  viewIntentSort: "Sortuj według {columns}",
+  viewIntentGroup: "Grupuj wiersze według {columns}",
+  viewIntentColumns: "Pokaż kolumny: {columns}",
+  compareSummary: "Porównanie zbiorów danych",
+  compareAdded: "Dodane",
+  compareRemoved: "Usunięte",
+  compareChanged: "Zmienione",
+  compareUnchanged: "Bez zmian",
+  compareOnlyChanges: "Tylko zmiany",
+  compareColumnChanges: "[one]{column}: {count} zmieniona komórka[few]{column}: {count} zmienione komórki[many]{column}: {count} zmienionych komórek[other]{column}: {count} zmienionych komórek",
+  compareChanges: "Zmiany",
+  viewIntentClearSearch: "Wyczyść wyszukiwanie",
+  viewIntentRemoveGrouping: "Usuń grupowanie",
+  viewIntentFlat: "Pokaż rekordy",
+  viewIntentAscending: "rosnąco",
+  viewIntentDescending: "malejąco",
+  viewIntentNotEqual: "nie jest",
+  viewIntentGreater: "większe niż",
+  viewIntentAtLeast: "co najmniej",
+  viewIntentLess: "mniejsze niż",
+  viewIntentAtMost: "co najwyżej",
+  viewIntentFilter: "Pokaż wiersze, gdzie {column} {operator} {values}",
+  viewIntentOnly: "Pokaż tylko {column}: {values}",
+  viewIntentPivot: "Wiersze: {rows}; kolumny: {columns}; wartości: {values}",
+  viewIntentAllRows: "wszystkie rekordy",
+  viewIntentTotals: "sumy",
+  viewIntentTuples: "Pokaż pasujące kombinacje {columns}: {values}",
+  viewIntentExcludeTuples: "Wyklucz pasujące kombinacje {columns}: {values}",
+  viewIntentNoChanges: "Ten widok jest już wybrany.",
+  pathEmpty: "Brak ścieżek do wyświetlenia",
+  pathSource: "Źródło",
+  pathTarget: "Cel",
+  pathStep: "Krok {number} z {total}",
+  pathCycle: "Cykl",
+  pathForeign: "Zewnętrzny",
+  pathDisabled: "Wyłączony",
+  pathKeys: "Przeglądaj kroki klawiszem Tab lub strzałkami; Enter lub Spacja otwiera rekord.",
+  pathPartial: "Wyświetlono {shown} z {total} kroków.",
+  stackWinner: "Wynik wybrany",
+  stackEnforced: "Wymuszona",
+  stackFiltered: "Odfiltrowana",
+  stackEmpty: "Brak warstw do wyświetlenia.",
+  stackOrder: "Kolejność przetwarzania",
+  stackTruncated: "Wyświetlono {shown} z {total} warstw w kolejności przetwarzania; wybrana warstwa jest zawsze uwzględniona.",
+  timePlay: "Odtwórz",
+  timePause: "Wstrzymaj",
+  timePrevious: "Poprzedni stan",
+  timeNext: "Następny stan",
+  timePosition: "Stan {index} z {count}",
+  timeFrame: "Stan z {time}",
+  timeReducedMotion: "Automatyczne odtwarzanie jest wyłączone z powodu ograniczenia ruchu. Przeglądaj stany ręcznie.",
+  tabsMore: "Więcej",
+  tabsMoreSelected: "Więcej: {label}",
+  tabsScrollPrevious: "Poprzednie karty",
+  tabsScrollNext: "Następne karty",
+  tabsSection: "Sekcja",
+  tabsPosition: "{current} z {total}",
+  tabsPause: "Wstrzymaj",
+  tabsPlay: "Odtwórz",
+  tabsMotionDisabled: "Automatyczne przełączanie kart jest wyłączone przy ograniczeniu ruchu",
+  stepperStepOf: "Krok {current} z {total}",
+  stepperBack: "Wstecz",
+  stepperNext: "Dalej",
+  stepperFinish: "Zakończ",
+  stepperSkip: "Pomiń",
+  stepperSaveDraft: "Zapisz wersję roboczą",
+  stepperAllSteps: "Wszystkie kroki",
+  stepperOptional: "Opcjonalny",
+  stepperCompleted: "Ukończono",
+  stepperSkipped: "Pominięto",
+  stepperIssues: "Problemy do rozwiązania: {count}",
+  stepperIssue: "1 problem do rozwiązania",
+  dialogClose: "Zamknij",
+  drawerClose: "Zamknij",
+  drawerPrevious: "Poprzedni rekord",
+  drawerNext: "Następny rekord",
+  stateLoading: "Ładowanie…",
+  stateRetry: "Ponów",
+  stateDetails: "Szczegóły",
 });
 const staticLabels = Object.freeze({
   overflowNote: "Pokazano {shown} z {total} wierszy.",

package/JavaScript/matrix.d.ts

@@ -1,3 +1,4 @@
+import type { TimePlaybackApi } from "./time-slider.js";
 // Type declarations for the matrix view (docs/matrix.md): the matrix document, its state and the API of createMatrix.
 import type { CellValue } from "./protocol.js";
 
@@ -139,6 +140,8 @@ export interface MatrixOptions {
 
 /** The API of a matrix. Call it once `ready` has settled; a call made before the matrix part is in waits for it and returns a promise instead. */
 export interface MatrixApi {
+  /** Snapshot controls; available after ready when the document supplies timeSlider. */
+  readonly playback: TimePlaybackApi;
   readonly element: HTMLElement;
   readonly view: MatrixDocument;
   readonly ready: Promise<MatrixApi>;
@@ -154,7 +157,7 @@ export interface MatrixApi {
   /** Moves focus to a cell; false when the row or column is not shown. */
   focusCell(row: string, column: string): boolean;
   /** Replaces the document, keeping the query that still applies (live refresh). */
-  update(view: MatrixDocument): void;
+  update(view: MatrixDocument): void | Promise<void>;
   destroy(): void;
 }
 

package/JavaScript/path.d.ts

@@ -0,0 +1,33 @@
+import type { CanopyBadge } from "./protocol.js";
+
+/** An annotation supplied by the host, never inferred from the records. Disabled steps still open for reading. */
+export type GridPathFlag = "cycle" | "foreign" | "disabled";
+
+/** One occurrence of a record; repeated identities retain their supplied position and annotations. */
+export interface GridPathHop {
+  /** Explicit stable identity of an existing inline grid record. */
+  record: string;
+  /** Optional host explanation, 1 to 4,096 characters, nonblank and without controls. */
+  label?: string;
+  /** Distinct annotations in display order. */
+  flags?: GridPathFlag[];
+  /** Up to 16 existing-wire badges; text is at most 256 characters and title at most 4,096. */
+  badges?: CanopyBadge[];
+}
+
+/** A source-to-target chain with one to 256 explicitly ordered steps. */
+export interface GridPathChain {
+  /** Unique among chains; nonblank, without controls, at most 256 characters. */
+  id: string;
+  /** Nonblank host heading without controls, at most 4,096 characters. */
+  label: string;
+  hops: GridPathHop[];
+}
+
+/** Optional path renderer over stable inline grid records. No route discovery or domain calculations. */
+export interface GridPathDefinition {
+  /** Defaults to the row header, then the first visible column. */
+  titleColumn?: string;
+  /** At most 200 chains and 10,000 step occurrences in total. Empty shows the empty state. */
+  chains: GridPathChain[];
+}

package/JavaScript/pivot.d.ts

@@ -0,0 +1,135 @@
+import type { CellValue } from "./protocol.js";
+import type { GridAggregateDisplayValue, GridGroupLevel, GridQuery } from "./grid.js";
+
+/** A declared sortable/filterable field, optionally bucketed. Aggregate ordering uses sortByTotal instead. */
+export type GridPivotLevel = Omit<GridGroupLevel, "aggregate">;
+/** Bounded full-query cross-tabulation. The value axis names declared reporting aggregates. */
+export interface GridPivotDefinition {
+  /** Up to four levels, outermost first. Empty axes produce totals only. */
+  readonly rows: readonly GridPivotLevel[];
+  /** Up to two levels, outermost first. */
+  readonly columns: readonly GridPivotLevel[];
+  /** One to 32 distinct declared aggregate IDs. */
+  readonly values: readonly string[];
+  /** One to 200 leaf columns including Other; defaults to 200. */
+  readonly maxColumns?: number;
+  /** One to 200 highest-total complete column paths, ranked by the first value aggregate. */
+  readonly topNColumns?: number;
+  readonly sortByTotal?: { readonly aggregate: string; readonly direction: "asc" | "desc" };
+}
+/** Presentation intent saved with the view; collapsing never changes raw result aggregates. */
+export interface GridPivotState extends GridPivotDefinition {
+  readonly active: boolean;
+  readonly collapsedRows: readonly string[];
+  readonly collapsedColumns: readonly string[];
+  /** The selected column on a compact screen. Keys are opaque result identities. */
+  readonly columnKey?: string;
+}
+/** An offset query with a mandatory accepted revision, plus its pivot definition. Paging does not limit pivot input. */
+export interface GridPivotQuery {
+  readonly protocol: "canopyx/2";
+  readonly type: "gridPivotQuery";
+  readonly query: GridQuery & { readonly revision: string };
+  readonly definition: GridPivotDefinition;
+}
+/** A raw prefix, total, or synthetic Other node. Datetime path operands retain explicit-zone ISO strings. */
+export interface GridPivotAxisNode {
+  /** Opaque bounded identity; at most 65536 UTF-16 code units. */
+  readonly key: string;
+  readonly parent?: string;
+  readonly path: readonly CellValue[];
+  readonly other: boolean;
+}
+/** A populated prefix intersection. Missing intersections have zero counts and operation-specific empty values. */
+export interface GridPivotCell {
+  readonly row: string;
+  readonly column: string;
+  readonly count: number;
+  readonly aggregates: Readonly<Record<string, number | null>>;
+}
+/** The data-only result written by CanopyPivot.Compute(...).ToJson(); no dataset ownership is implied. */
+export interface GridPivotResult {
+  readonly protocol: "canopyx/2";
+  readonly type: "gridPivot";
+  readonly view: string;
+  readonly definition: GridPivotDefinition;
+  readonly matched: number;
+  readonly distinctColumns: number;
+  readonly columnsLimited: boolean;
+  /** Total first, followed by depth-first prefixes; at most 10001 nodes. */
+  readonly rows: readonly GridPivotAxisNode[];
+  /** Total first, retained prefixes, then Other; at most 402 nodes. */
+  readonly columns: readonly GridPivotAxisNode[];
+  /** Complete retained column paths, used as one atomic exclusion predicate for Other drill-through. */
+  readonly retainedColumns: readonly (readonly CellValue[])[];
+  /** At most 100000 populated intersections, including exact prefix totals. */
+  readonly cells: readonly GridPivotCell[];
+}
+/** Hosted and browser-accepted results echo the exact accepted offset query and its revision. */
+export interface GridPivotAcceptedResult extends GridPivotResult {
+  readonly query: GridQuery & { readonly revision: string };
+  readonly revision: string;
+}
+/** Numeric export values stay numeric; adapters apply numberFormat instead of parsing text. */
+export interface GridPivotExportValue extends GridAggregateDisplayValue { readonly text: string; }
+/** Presentation of an accepted axis identity. Prefix summaries precede their descendants; grand totals follow them. */
+export interface GridPivotExportAxisPresentation {
+  /** Opaque key into rowAxis or columnAxis; do not infer identity from a localized title. */
+  readonly axisKey: string;
+  readonly outlineLevel: number;
+  readonly summary: boolean;
+  readonly grandTotal: boolean;
+  readonly collapsed: boolean;
+  readonly hidden: boolean;
+}
+export interface GridPivotExportRow extends GridPivotExportAxisPresentation {
+  readonly id: string;
+  readonly cells: Readonly<Record<string, GridPivotExportValue | { readonly value: string; readonly text: string }>>;
+}
+export interface GridPivotExportColumn extends GridPivotExportAxisPresentation {
+  readonly id: string;
+  readonly title: string;
+  readonly kind: "number";
+  readonly aggregate: string;
+}
+/** A contiguous descendant range, excluding its leading prefix summary columns. */
+export interface GridPivotExportColumnGroup {
+  readonly key: string;
+  readonly parent?: string;
+  /** Zero-based index into snapshot.columns, including the row-label column. */
+  readonly firstColumn: number;
+  readonly columnCount: number;
+  /** One-based axis depth. */
+  readonly depth: number;
+  readonly collapsed: boolean;
+  readonly hidden: boolean;
+}
+/** Frozen full-query pivot export, independent of flat-record export scopes. Includes all prefixes and descendants. */
+export interface GridPivotExportSnapshot {
+  readonly view: string;
+  readonly query: GridQuery;
+  readonly definition: GridPivotDefinition;
+  readonly columns: readonly ({ readonly id: string; readonly title: string; readonly kind: "text" } | GridPivotExportColumn)[];
+  readonly rows: readonly GridPivotExportRow[];
+  readonly columnGroups: readonly GridPivotExportColumnGroup[];
+  readonly rowAxis: readonly GridPivotAxisNode[];
+  readonly columnAxis: readonly GridPivotAxisNode[];
+  /** Underlying accepted records, not the number of projected prefix rows. */
+  readonly matched: number;
+  readonly distinctColumns: number;
+  readonly retainedColumns: readonly (readonly CellValue[])[];
+  /** Omitted complete paths are combined in Other; the accepted record scope and totals remain complete. */
+  readonly columnsLimited: boolean;
+}
+/** Data-only pivot metadata accompanying an ordinary frozen export capture. Columns and enumerated rows stay outside it. */
+export type GridPivotExportDescriptor = Pick<GridPivotExportSnapshot,
+  "definition" | "rowAxis" | "columnAxis" | "columnGroups" | "distinctColumns" | "retainedColumns" | "columnsLimited">;
+/** Available only on reporting grids with an initial pivot or pivotable enabled. */
+export interface GridPivotApi {
+  getPivot?(): GridPivotState | null;
+  /** False shows flat records while retaining the configured definition. Resolves after acceptance. */
+  setPivot?(definition: GridPivotDefinition | false): Promise<void>;
+  getPivotResult?(): GridPivotAcceptedResult | null;
+  getPivotExport?(): Promise<GridPivotExportSnapshot>;
+  setPivotCollapsed?(axis: "rows" | "columns", key: string, collapsed: boolean): Promise<void>;
+}

package/JavaScript/plan.d.ts

@@ -0,0 +1,23 @@
+/** Optional planning over the calendar resource timeline; durations and lags use elapsed time. */
+export interface GridPlanDefinition {
+  baselineStart?: string;
+  baselineEnd?: string;
+  /** Boolean or text 'true' cells declare milestones; zero-duration tasks are milestones too. */
+  milestone?: string;
+  /** Emphasize zero-slack tasks only when the complete task network is available. Defaults to true. */
+  criticalPath?: boolean;
+  proposeMoves?: boolean;
+  avoidOverlap?: boolean;
+  dependencies?: { predecessor: string; successor: string; lagMinutes?: number }[];
+}
+
+/** A proposal leaves actual dates and resources unchanged; the host validates, persists and refreshes them. */
+export interface GridPlanChangeProposal {
+  readonly id: string;
+  readonly previous: { readonly start: string; readonly end: string; readonly resource: string | null };
+  readonly proposed: { readonly start: string; readonly end: string; readonly resource: string | null };
+  readonly conflicts: readonly { readonly kind: string; readonly id: string | null; readonly label: string }[];
+}
+export interface GridPlanOptions {
+  propose?(proposal: GridPlanChangeProposal, context: { signal: AbortSignal }): void | PromiseLike<void>;
+}

package/JavaScript/protocol.d.ts

@@ -202,10 +202,12 @@ export type InlineNode = LeafNode | DetailNode | InlineBranch<InlineNode>;
 
 /** Names accepted by the interactive runtime; omitted translations use English. */
 export type LabelName =
+  | "gridShowAs" | "gridShowAsValue" | "gridShowAsPercentGrandTotal" | "gridShowAsPercentParent" | "gridShowAsPercentColumn" | "gridShowAsPercentRow" | "gridShowAsRunningTotal" | "gridShowAsRank" | "gridShowAsDifference" | "gridShowAsPercentChange"
+  | "gridBucket" | "gridBucketNone" | "gridBucketDay" | "gridBucketWeek" | "gridBucketMonth" | "gridBucketQuarter" | "gridBucketYear" | "gridBucketHour" | "gridBucketWeekday" | "gridBucketWidth" | "gridBucketEdges" | "gridBucketOrigin" | "gridBucketInvalid"
   | "gridPaging" | "gridPageRange" | "gridPageNumber" | "gridPageLength" | "gridFirstPage" | "gridPreviousPage" | "gridNextPage" | "gridLastPage" | "gridPageInfo" | "gridPageInfoFiltered" | "gridPageButton"
   | "gridUnknownCount" | "gridMatchedCount" | "gridCursorRange"
-  | "gridResultCount" | "gridClearQuery" | "gridRemoveSearch" | "gridGroupedFilters" | "gridRemoveGroup" | "gridRemoveCondition"
-  | "gridExport" | "gridFilteredResults" | "gridSelectedRows" | "gridAllResults" | "gridVisibleRows" | "gridAllRows" | "gridDownloadCsv" | "gridCopy" | "gridDetails"
+  | "gridResultCount" | "gridRegexSearch" | "gridClearQuery" | "gridRemoveSearch" | "gridGroupedFilters" | "gridRemoveGroup" | "gridRemoveCondition"
+  | "gridExport" | "gridFilteredResults" | "gridSelectedRows" | "gridAllResults" | "gridVisibleRows" | "gridAllRows" | "gridDownloadCsv" | "gridDownloadXlsx" | "gridDownloadPdf" | "gridCopy" | "gridDetails"
   | "searchPlaceholder" | "searchResults" | "searchResultCount" | "searchResultCountOfTotal"
   | "searchResultCountOfMany" | "searchNoResults" | "searchTooShort" | "searchWordTooShort" | "searchFailed"
   | "columns" | "hiddenColumns" | "visibleColumns" | "resizeColumn" | "columnWidth" | "loading" | "loadError" | "queryFailed"
@@ -225,6 +227,7 @@ export type LabelName =
   | "gridSelectionQueryCount" | "gridSelectionQueryUnknown" | "gridSelectRecord"
   | "gridGroupHeading" | "gridGroupMissing" | "gridGroupExpand" | "gridGroupCollapse" | "gridSummary" | "gridGroupOrder" | "gridAggregateCount" | "gridAggregateSum" | "gridAggregateAverage" | "gridAggregateMinimum" | "gridAggregateMaximum" | "gridGroupBy" | "gridUngroup" | "gridGroupDrop" | "gridExpandAll" | "gridCollapseAll" | "gridExpandLevel" | "gridCollapseLevel" | "gridGroupMove" | "gridGroupSortBy" | "gridGroupSortValue" | "gridGroupSortAggregate" | "gridSelectGroup" | "gridAggregateDistinct" | "gridShowDetail" | "gridHideDetail" | "gridDetailOf" | "gridDetailFailed"
   | "gridExportProgress" | "gridExportReading" | "gridExportCancelled" | "gridCancelExport" | "gridNoExportColumns" | "gridPrint"
+  | "gridExportWorkbookHint" | "gridExportPdfHint" | "gridExportCsvHint" | "gridExportCopy"
   | "matchesHighlight" | "matchesCount" | "matchesPosition" | "matchesNone" | "matchesLoaded" | "matchesPrevious" | "matchesNext" | "matchesAnnounce"
   | "layoutMenu" | "layoutFit" | "layoutScroll" | "layoutCards" | "layoutDensity" | "layoutCompact" | "layoutNormal" | "layoutComfortable" | "layoutChanged" | "layoutSort"
   | "gridFitContent"
@@ -270,7 +273,17 @@ export type LabelName =
   | "calendarZoom" | "calendarZoomHour" | "calendarZoomDay" | "calendarZoomWeek" | "calendarZoomMonth" | "calendarZoomQuarter" | "calendarResources" | "calendarCapacity"
   | "calendarCapacityAt" | "calendarBusy" | "calendarOverlaps" | "calendarUnavailable" | "calendarOutsideHours" | "calendarConflict" | "calendarNotAllowed" | "calendarMoved"
   | "calendarResized" | "calendarSeriesMoved" | "calendarSeriesTime" | "calendarMoveHelp" | "calendarEdit" | "calendarSaveFailed" | "calendarExport" | "calendarTimeRange" | "calendarSelected"
-  | "calendarLane" | "calendarHighlighted";
+  | "calendarLane" | "calendarHighlighted"
+  /** Standalone UI primitives; their English defaults load with the optional UI parts. */
+  | "tabsMore" | "tabsMoreSelected" | "tabsScrollPrevious" | "tabsScrollNext" | "tabsSection" | "tabsPosition" | "tabsPause" | "tabsPlay" | "tabsMotionDisabled"
+  | "stepperStepOf" | "stepperBack" | "stepperNext" | "stepperFinish" | "stepperSkip" | "stepperSaveDraft"
+  | "stepperAllSteps" | "stepperOptional" | "stepperCompleted" | "stepperSkipped" | "stepperIssues" | "stepperIssue"
+  | "dialogClose" | "drawerClose" | "drawerPrevious" | "drawerNext" | "stateLoading" | "stateRetry" | "stateDetails"
+  | "boardLane" | "boardUnassigned" | "boardEmpty" | "boardWip" | "boardWipFull" | "boardMove" | "boardMoved" | "boardRejected" | "boardPending" | "boardPartial" | "boardKeys" | "planMilestone" | "planCritical" | "planBaseline" | "planDependency" | "planDependencyConflict" | "planOverlapConflict" | "planIncomplete" | "planInvalidRange" | "planInvalidResource" | "planProposal" | "planMoveHint" | "planActual" | "planPending" | "planBaselineLabel" | "planDependencies" | "planConflict"
+  | "pathEmpty" | "pathSource" | "pathTarget" | "pathStep" | "pathCycle" | "pathForeign" | "pathDisabled" | "pathKeys" | "pathPartial" | "stackWinner" | "stackEnforced" | "stackFiltered" | "stackEmpty" | "stackOrder" | "stackTruncated" | "timePlay" | "timePause" | "timePrevious" | "timeNext" | "timePosition" | "timeFrame" | "timeReducedMotion"
+  /** Calculated-column editor and stable per-cell errors (flat grids only). */
+  | "gridCalculationAdd" | "gridCalculationTitle" | "gridCalculationId" | "gridCalculationExpression" | "gridCalculationError" | "gridCalculationInvalid" | "gridCalculationHelp" | "gridCalculationNumber" | "gridCalculationDate" | "gridCalculationResultType" | "gridCalculationDivideZero" | "gridPivotFieldOptions"
+  | "compareChanges" | "viewIntentClearSearch" | "viewIntentRemoveGrouping" | "viewIntentFlat" | "viewIntentAscending" | "viewIntentDescending" | "viewIntentNotEqual" | "viewIntentGreater" | "viewIntentAtLeast" | "viewIntentLess" | "viewIntentAtMost" | "viewIntentFilter" | "viewIntentOnly" | "viewIntentPivot" | "viewIntentAllRows" | "viewIntentTotals" | "viewIntentTuples" | "viewIntentExcludeTuples" | "viewIntentNoChanges" | "viewIntentPreview" | "viewIntentApplied" | "viewIntentSuperseded" | "viewIntentSearch" | "viewIntentSort" | "viewIntentGroup" | "viewIntentColumns" | "compareSummary" | "compareAdded" | "compareRemoved" | "compareChanged" | "compareUnchanged" | "compareOnlyChanges" | "compareColumnChanges" | "viewIntentWords" | "viewIntentSubstring";
 export type CanopyLabels = Partial<Record<LabelName, string>>;
 
 export interface InlineSourceDefinition { kind: "inline"; }

package/JavaScript/records.d.ts

@@ -110,11 +110,21 @@ export interface RecordSectionContext {
 /** Draws a drawer section's content (a chart, for example) into element. */
 export type RecordSectionRenderer = (record: Readonly<{ id: string; cells?: Readonly<Record<string, Cell>>; fields?: Readonly<Record<string, Cell>>; label?: string }>,
   element: HTMLElement, context: RecordSectionContext) => void | PromiseLike<void>;
-/** An action of the record panel's actions menu. */
+/** A detached snapshot of the selected record and its loaded details. */
+export interface RecordActionContext {
+  readonly record: Readonly<{ id: string; cells?: Readonly<Record<string, Cell>>; fields?: Readonly<Record<string, Cell>> }>;
+  readonly view: string; readonly api: unknown; readonly payload: GridRecord | null; readonly signal: AbortSignal;
+}
+/** An action of the record panel's actions menu. Hosts must enforce authorization again when executing it. */
 export interface RecordAction {
+  /** Keeps the action focusable in its menu while preventing activation. */
+  readonly disabled?: boolean;
+  /** Evaluated after each record paint, including loaded details. Hidden actions cannot run through a stale control. */
+  readonly visible?: boolean | ((context: RecordActionContext) => boolean);
+  /** Also renders this action as a visible footer button. Menu access is retained. */
+  readonly prominent?: boolean | ((context: RecordActionContext) => boolean);
   readonly label: string;
-  run(context: { readonly record: Readonly<{ id: string; cells?: Readonly<Record<string, Cell>>; fields?: Readonly<Record<string, Cell>> }>; readonly view: string; readonly api: unknown;
-    readonly payload: GridRecord | null; readonly signal: AbortSignal }): void | PromiseLike<void>;
+  run(context: RecordActionContext): void | PromiseLike<void>;
 }
 /** The canopyx:openAll event's detail (and onOpenAll's argument): cancel it to filter the target grid yourself. */
 export interface RecordOpenAll {
@@ -122,9 +132,15 @@ export interface RecordOpenAll {
   readonly filters: readonly { readonly column: string; readonly operator: string; readonly values: readonly CellValue[] }[] | null;
 }
 /** Options that open a record (openRecord). */
-export interface OpenRecordOptions { readonly returnFocus?: Element | null; readonly path?: readonly string[]; readonly tab?: string; }
+export interface OpenRecordOptions {
+  readonly returnFocus?: Element | null; readonly path?: readonly string[]; readonly tab?: string;
+  /** Read this record's details again after a host mutation, even when the grid's row/revision has not changed. */
+  readonly reload?: boolean;
+}
 /** Host options of the record panel, on grids and trees. */
 export interface RecordPanelOptions {
+  /** Plain-text heading projection. The record is a detached read-only snapshot; title and subtitle are bounded. */
+  recordHeading?: (record: Readonly<{id:string; cells?:Readonly<Record<string,Cell>>; fields?:Readonly<Record<string,Cell>>}>) => {title:string;subtitle?:string};
   /** Loads a record's details when its drawer opens; used whatever the declared source. */
   loadRecord?: RecordLoader;
   /** Section renderers by name, beside the plugins' drawerSections. */

package/JavaScript/stack.d.ts

@@ -0,0 +1,28 @@
+import type { CanopyBadge } from "./protocol.js";
+
+/** Optional inline stack explanation. The host supplies processing order, states, reasons and the winner. */
+export interface GridStackDefinition {
+  /** A declared column; defaults to the row-header column, then the first visible column. */
+  titleColumn?: string;
+  /** Up to 1,000 ordered layers. Empty is valid; a nonempty stack has exactly one winner. */
+  layers: GridStackLayer[];
+}
+
+/** A layer's identity is independent of its record, so several layers can open the same record panel. */
+export interface GridStackLayer {
+  /** Unique, stable layer id. */
+  id: string;
+  /** Existing stable inline grid record id. */
+  record: string;
+  /** Nonblank host explanation; CanopyX performs no precedence calculations. */
+  reason: string;
+  /** Optional context in addition to the record title. */
+  label?: string;
+  /** Exactly one true value in a nonempty stack. A winner cannot be filtered. */
+  winner?: boolean;
+  /** Host-supplied state, independent of winner selection. */
+  enforced?: boolean;
+  /** Host-supplied exclusion, kept visible with its reason. */
+  filtered?: boolean;
+  badges?: CanopyBadge[];
+}

package/JavaScript/time-slider.d.ts

@@ -0,0 +1,58 @@
+// Host-provided snapshot replay for matrix and propagation views (docs/time-slider.md).
+import type { MatrixDocument } from "./matrix.js";
+import type { PropagationDocument } from "./changes.js";
+
+/** One complete view captured by the host, with the parent view's id and type. Nested sliders are forbidden. */
+export interface TimeSnapshot<T extends MatrixDocument | PropagationDocument> {
+  /** ISO 8601 instant with a zone. Instants are distinct and strictly ascending at Date.parse millisecond precision. */
+  at: string;
+  /** Optional visible description of this frame, at most 200 characters. */
+  label?: string;
+  view: Omit<T, "timeSlider"> & { timeSlider?: never };
+}
+
+/** Local replay of 1 to 500 host-provided frames. Playback starts manually; no history is fetched. */
+export interface TimeSlider<T extends MatrixDocument | PropagationDocument> {
+  /** Timed playback interval, 100 to 60,000 milliseconds. Defaults to 1,000. Reduced motion disables timed play. */
+  interval?: number;
+  /** Zero-based initial frame index. Omitted selects the latest frame. */
+  initial?: number;
+  snapshots: TimeSnapshot<T>[];
+}
+
+/** Current frame and playback status. Available after the containing view's ready promise resolves. */
+export interface TimePlaybackState {
+  /** Zero-based selected frame. */
+  index: number;
+  count: number;
+  /** The selected snapshot's ISO 8601 instant. */
+  at: string;
+  playing: boolean;
+  reducedMotion: boolean;
+}
+
+/** The nested api.playback controller. Methods are synchronous after api.ready, which includes initial frame application. */
+export interface TimePlaybackApi {
+  /** Starts timed replay unless reduced motion is requested. */
+  play(): void;
+  pause(): void;
+  /** Moves by delta frames, one forward by default. */
+  step(delta?: number): void;
+  /** Selects a zero-based frame. */
+  seek(index: number): void;
+  getState(): TimePlaybackState;
+}
+
+declare module "./matrix.js" {
+  interface MatrixDocument {
+    /** Optional local snapshot replay. Manual stepping remains available with reduced motion. */
+    timeSlider?: TimeSlider<MatrixDocument>;
+  }
+}
+
+declare module "./changes.js" {
+  interface PropagationDocument {
+    /** Optional local snapshot replay. Manual stepping remains available with reduced motion. */
+    timeSlider?: TimeSlider<PropagationDocument>;
+  }
+}