@konce-pt/angular 0.7.11 → 0.7.12

package/src/lib/toolbar/llms.txt

@@ -1,31 +1,31 @@
-# KptToolbar (kpt-toolbar)
-
-Górny pasek (toolbar) — pozioma belka na treść aplikacji.
-Import: `import { KptToolbar } from '@konce-pt/angular';`
-
-## Selektor
-`kpt-toolbar`
-
-## Wejścia
-- `elevated`: boolean — cień pod paskiem
-- `wrap`: boolean — pozwala zawartości zawinąć się do kolejnych wierszy. Opcjonalne, bo
-  zawijanie zmienia zachowanie `kptToolbarSpacer`: w jednowierszowym pasku rozpycha on treść,
-  a w zawijanym potrafi zepchnąć resztę akcji do nowego wiersza.
-
-## Odstęp
-Element z atrybutem `kptToolbarSpacer` dostaje `flex: 1` i rozpycha zawartość.
-
-## Przykład
-    <kpt-toolbar elevated>
-      <strong>Koncept UI</strong>
-      <span kptToolbarSpacer></span>
-      <kpt-button variant="text">Wyloguj</kpt-button>
-    </kpt-toolbar>
-
-## Responsywność
-Poniżej breakpointa `sm` pasek sam zbiega się do `--kpt-toolbar-height-compact` i węższych
-marginesów. Do chowania fragmentów zawartości na wąskim ekranie użyj klas `@konce-pt/grid`,
-np. `class="kpt-hide kpt-display-sm-inline"` na podtytule.
-
-## Tokeny
-`--kpt-toolbar-{bg,fg,border,height,height-compact}`.
+# KptToolbar (kpt-toolbar)
+
+A top bar (toolbar) — a horizontal strip for application content.
+Import: `import { KptToolbar } from '@konce-pt/angular';`
+
+## Selector
+`kpt-toolbar`
+
+## Inputs
+- `elevated`: boolean — a shadow under the bar
+- `wrap`: boolean — lets the content wrap onto further rows. Optional, because
+  wrapping changes what `kptToolbarSpacer` does: in a single-row bar it pushes content apart,
+  while in a wrapping bar it can shove the remaining actions onto a new row.
+
+## Spacer
+An element carrying the `kptToolbarSpacer` attribute gets `flex: 1` and pushes the content apart.
+
+## Example
+    <kpt-toolbar elevated>
+      <strong>Koncept UI</strong>
+      <span kptToolbarSpacer></span>
+      <kpt-button variant="text">Sign out</kpt-button>
+    </kpt-toolbar>
+
+## Responsiveness
+Below the `sm` breakpoint the bar shrinks itself to `--kpt-toolbar-height-compact` and narrower
+margins. To hide parts of the content on a narrow screen use `@konce-pt/grid` classes,
+e.g. `class="kpt-hide kpt-display-sm-inline"` on a subtitle.
+
+## Tokens
+`--kpt-toolbar-{bg,fg,border,height,height-compact}`.

package/src/lib/tooltip/llms.txt

@@ -1,33 +1,33 @@
 # KptTooltip (kptTooltip)
 
-Dyrektywa dymka podpowiedzi pokazywanego na hover/focus. Lekka — element dodawany do
-`body`, pozycjonowany względem hosta (działa w trybie zoneless).
+A directive for a tooltip shown on hover/focus. Lightweight — the element is appended to
+`body` and positioned relative to the host (works in zoneless mode).
 Import: `import { KptTooltip } from '@konce-pt/angular';`
 
-## Selektor (atrybut)
+## Selector (attribute)
 `[kptTooltip]`
 
-## Wejścia
-- `kptTooltip`: string (treść, wymagane) — pusta treść wyłącza dymek
-- `kptTooltipPosition`: 'top'|'bottom'|'left'|'right' (domyślnie 'top')
-- `kptTooltipOnlyWhenTruncated`: boolean (domyślnie false) — pokazuje dymek tylko wtedy,
-  gdy treść nie mieści się w elemencie (jest ucięta wielokropkiem)
+## Inputs
+- `kptTooltip`: string (the content, required) — empty content disables the tooltip
+- `kptTooltipPosition`: 'top'|'bottom'|'left'|'right' (default 'top')
+- `kptTooltipOnlyWhenTruncated`: boolean (default false) — shows the tooltip only when
+  the content does not fit the element (it is cut off with an ellipsis)
 
-## Dymek tylko dla przyciętego tekstu
-Przy `kptTooltipOnlyWhenTruncated` podpowiedź nie powtarza tekstu, który i tak widać.
-Przepełnienie sprawdzane jest na hoście **oraz jego bezpośrednich dzieciach** — `text-overflow:
-ellipsis` siedzi zwykle na wewnętrznym elemencie, a taki element kurczy się do dostępnej szerokości
-i nie rozpycha rodzica, więc pomiar samego hosta niczego by nie wykrył. Gdy tekst jest głębiej niż
-jeden poziom, dyrektywę trzeba osadzić na jego bezpośrednim rodzicu.
+## A tooltip only for truncated text
+With `kptTooltipOnlyWhenTruncated` the tooltip does not repeat text that is visible anyway.
+Overflow is measured on the host **and on its direct children** — `text-overflow:
+ellipsis` usually sits on an inner element, and such an element shrinks to the available width
+without stretching its parent, so measuring the host alone would detect nothing. When the text is deeper
+than one level, put the directive on its direct parent.
 
-Sprawdzenie następuje w chwili najechania (lub focusu), nie przy renderze — wynik jest więc zawsze
-aktualny po zmianie szerokości, powiększenia czy układu, bez `ResizeObserver`.
+The check happens at hover (or focus) time, not at render — so the result is always
+current after a change in width, zoom or layout, with no `ResizeObserver`.
 
     <span class="ellipsis" [kptTooltip]="name" kptTooltipOnlyWhenTruncated>{{ name }}</span>
 
-## Przykład
-    <kpt-button kptTooltip="Zapisz zmiany" kptTooltipPosition="bottom">Zapisz</kpt-button>
-    <span kptTooltip="Więcej informacji">?</span>
+## Example
+    <kpt-button kptTooltip="Save changes" kptTooltipPosition="bottom">Save</kpt-button>
+    <span kptTooltip="More information">?</span>
 
-## Tokeny
-Tło `--kpt-color-on-surface`, tekst `--kpt-color-surface` (kontrast w obu motywach), `--kpt-elevation-2`.
+## Tokens
+Background `--kpt-color-on-surface`, text `--kpt-color-surface` (contrast in both themes), `--kpt-elevation-2`.

package/src/lib/tree/llms.txt

@@ -1,17 +1,17 @@
 # KptTree (kpt-tree)
 
-Drzewo hierarchiczne (rozwijanie, zaznaczanie, ikony). Rekurencyjny render.
+A hierarchical tree (expanding, selection, icons). Rendered recursively.
 Import: `import { KptTree, KptTreeNode } from '@konce-pt/angular';`
 
-## Model węzła (KptTreeNode)
+## The node model (KptTreeNode)
 `{ label: string; value?: T; icon?: string; children?: KptTreeNode[]; expanded?: boolean; disabled?: boolean }`
 
-## Wejścia / wyjścia
+## Inputs / outputs
 - `nodes`: KptTreeNode[]; `selectable`: boolean
 - `selected`: model<KptTreeNode|null>; `nodeClick`: output<KptTreeNode>
 
-## Przykład
+## Example
     <kpt-tree [nodes]="tree" selectable [(selected)]="node" (nodeClick)="open($event)" />
 
-## Tokeny
-Wiersz hover `--kpt-color-surface-variant`; zaznaczony `--kpt-color-primary`.
+## Tokens
+Row hover `--kpt-color-surface-variant`; the selected row `--kpt-color-primary`.