@konce-pt/ui 0.12.0 → 0.14.0

package/README.md

@@ -1,10 +1,10 @@
 <p align="center">
-  <img src="https://ui.konce.pt/images/koncept_ui_lib.png" alt="Koncept UI — Angular component library" width="100%" />
+  <img src="https://ui.konce.pt/images/koncept_ui_lib.png" alt="Koncept UI - Angular component library" width="100%" />
 </p>
 
 # @konce-pt/ui
 
-CLI Koncept UI — instaluje **bloki** (gotowe fragmenty UI) do projektu Angular w modelu
+CLI Koncept UI - instaluje **bloki** (gotowe fragmenty UI) do projektu Angular w modelu
 copy-paste. Po instalacji blok jest Twoim kodem.
 
 ```bash
@@ -18,18 +18,18 @@ npx @konce-pt/ui add nip-lookup-field
 |---|---|
 | `init` | Tworzy `konce.json` (`--registry --blocks-dir --alias --prefix --theme --force`) |
 | `add <nazwa...>` | Instaluje blok(i) + zależności registry (`--overwrite --dry-run --path --registry`) |
-| `list [--category=…]` | Lista dostępnych bloków |
+| `list [--category=...]` | Lista dostępnych bloków |
 
 ## Jak działa `add`
 
 1. Rozwiązuje zależności registry rekurencyjnie (wykrywa cykle).
-2. Sprawdza zależności npm — brak: ostrzega, za niska wersja: przerywa.
-3. Przepisuje `@/` → `alias`, selektory `kpt-` → `prefix` (tokeny `--kpt-*` zostają nietknięte).
+2. Sprawdza zależności npm - brak: ostrzega, za niska wersja: przerywa.
+3. Przepisuje `@/` -> `alias`, selektory `kpt-` -> `prefix` (tokeny `--kpt-*` zostają nietknięte).
 4. Konflikt pliku: identyczny pomija, różny zapisuje jako `.new` (lub `--overwrite`).
 5. Zapisuje dopiero po pobraniu wszystkich plików; odnotowuje `installedBlocks`.
 6. Wypisuje: dodane pliki, przykład użycia, porty do podpięcia, uwagi.
 
-`--dry-run` przechodzi całą ścieżkę bez zapisu — idealne dla agentów AI do podglądu skutków.
+`--dry-run` przechodzi całą ścieżkę bez zapisu - idealne dla agentów AI do podglądu skutków.
 
 Pełny opis: [`llms.txt`](https://ui.konce.pt/llms/cli/llms.txt) (EN)
 i [`llms-pl.txt`](https://ui.konce.pt/llms/cli/llms-pl.txt) (PL).

package/dist/commands/add.js

@@ -32,11 +32,11 @@ export async function addCommand(args) {
     for (const name of toInstall)
         metas.set(name, await loadBlockMeta(ctx.base, name));
     checkNpmDependencies(metas, ctx.projectRoot);
-    // 4) Pobierz WSZYSTKIE pliki i zaplanuj zapis (instalacja atomowa — nic nie zapisujemy wcześniej).
+    // 4) Pobierz WSZYSTKIE pliki i zaplanuj zapis (instalacja atomowa - nic nie zapisujemy wcześniej).
     const plan = await planWrites(toInstall, metas, ctx);
     // 5) Zapis (albo raport dry-run).
     if (dryRun) {
-        log.info('— dry-run: nothing written —');
+        log.info('- dry-run: nothing written -');
         for (const p of plan)
             log.step(`${labelFor(p.action)}  ${p.target}`);
     }
@@ -47,7 +47,7 @@ export async function addCommand(args) {
     }
     printSummary(toInstall, metas, dryRun);
 }
-// — pomocnicze —
+// - pomocnicze -
 /** Kolejność instalacji: zależności registry przed blokiem, który ich potrzebuje. Wykrywa cykle. */
 function resolveOrder(requested, index) {
     const order = [];
@@ -77,11 +77,11 @@ function logAlreadyInstalled(order, ctx) {
         return;
     for (const name of order) {
         if (ctx.config.installedBlocks[name]) {
-            log.step(`${name} — already installed (skipping; --overwrite would replace it)`);
+            log.step(`${name} - already installed (skipping; --overwrite would replace it)`);
         }
     }
 }
-/** Pobiera pliki wszystkich bloków i planuje zapis — bez dotykania dysku. */
+/** Pobiera pliki wszystkich bloków i planuje zapis - bez dotykania dysku. */
 async function planWrites(toInstall, metas, ctx) {
     const plan = [];
     for (const name of toInstall) {
@@ -128,11 +128,11 @@ function labelFor(action) {
     switch (action) {
         case 'write': return 'new      ';
         case 'overwrite': return 'overwrote';
-        case 'conflict-new': return 'conflict→.new';
+        case 'conflict-new': return 'conflict->.new';
         case 'skip-identical': return 'unchanged';
     }
 }
-/** Przepisuje placeholdery: `@/` → alias, selektory `kpt-` → prefix (nie rusza `--kpt-`). */
+/** Przepisuje placeholdery: `@/` -> alias, selektory `kpt-` -> prefix (nie rusza `--kpt-`). */
 function rewriteImports(content, config) {
     let out = content.replaceAll('@/', `${config.alias}/`);
     if (config.prefix !== 'kpt') {
@@ -144,14 +144,14 @@ function rewriteImports(content, config) {
  * Weryfikuje zależności bloku względem package.json projektu.
  *
  * Rozróżnienie surowości jest celowe: `npm` to nasze paczki i zła wersja realnie
- * psuje blok, więc przerywamy. `peer` to Angular i rxjs — ich wersję trzyma
+ * psuje blok, więc przerywamy. `peer` to Angular i rxjs - ich wersję trzyma
  * aplikacja, a twardy błąd na prerelease, którego prosty parser może odczytać
  * inaczej niż npm, byłby gorszy od ostrzeżenia.
  */
 function checkNpmDependencies(metas, projectRoot) {
     const installed = readInstalledDeps(projectRoot);
     const missing = new Map();
-    // Set, bo kilka bloków deklaruje zwykle ten sam peer (@angular/core) — bez tego
+    // Set, bo kilka bloków deklaruje zwykle ten sam peer (@angular/core) - bez tego
     // to samo ostrzeżenie poszłoby raz na blok.
     const peerNotes = new Set();
     for (const { kind, name, range } of declaredDependencies(metas)) {
@@ -169,7 +169,7 @@ function checkNpmDependencies(metas, projectRoot) {
             continue;
         }
         peerNotes.add(verdict === 'missing'
-            ? `${name} (peer) — not in the project, the block needs ${range}`
+            ? `${name} (peer) - not in the project, the block needs ${range}`
             : `${name} (peer) is at version ${have}, the block needs ${range}`);
     }
     reportMissing(missing);
@@ -182,7 +182,7 @@ function readInstalledDeps(projectRoot) {
     if (!existsSync(pkgPath))
         return {};
     const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
-    // Rozwinięcie `undefined` w literale obiektu jest legalne i nic nie wnosi — bez `?? {}`.
+    // Rozwinięcie `undefined` w literale obiektu jest legalne i nic nie wnosi - bez `?? {}`.
     return { ...pkg.dependencies, ...pkg.devDependencies };
 }
 /** Płaska lista zależności zadeklarowanych przez wszystkie instalowane bloki. */
@@ -198,11 +198,11 @@ function* dependenciesOfKind(kind, deps) {
     for (const [name, range] of Object.entries(deps))
         yield { kind, name, range };
 }
-/** Werdykt dla jednej zależności — bez rozróżnienia na npm/peer, to robi wołający. */
+/** Werdykt dla jednej zależności - bez rozróżnienia na npm/peer, to robi wołający. */
 function inspectDependency(range, have) {
     if (!have)
         return 'missing';
-    // Specyfikatory bez konkretnej wersji (workspace:*, *, latest, git/file:) — nie oceniamy.
+    // Specyfikatory bez konkretnej wersji (workspace:*, *, latest, git/file:) - nie oceniamy.
     if (!/\d/.test(have))
         return 'ok';
     return satisfies(have, range) ? 'ok' : 'mismatch';
@@ -210,9 +210,9 @@ function inspectDependency(range, have) {
 function reportMissing(missing) {
     if (missing.size === 0)
         return;
-    // Do instalacji podajemy same nazwy — zakres bywa złożony (">=0.6.0 <1.0.0")
+    // Do instalacji podajemy same nazwy - zakres bywa złożony (">=0.6.0 <1.0.0")
     // i wklejony do shella by się rozpadł. Wymagania pokazujemy osobno.
-    log.warn(`Missing npm dependencies — install them: ${[...missing.keys()].join(' ')}`);
+    log.warn(`Missing npm dependencies - install them: ${[...missing.keys()].join(' ')}`);
     for (const [name, range] of missing)
         log.step(`${name} needs ${range}`);
 }
@@ -226,7 +226,7 @@ function printSummary(installed, metas, dryRun) {
         }
         const ports = meta.api?.ports ?? [];
         for (const port of ports) {
-            log.warn(`port to wire up: ${port.token} — ${port.signature}${port.stubProvided ? ' (a stub is included)' : ''}`);
+            log.warn(`port to wire up: ${port.token} - ${port.signature}${port.stubProvided ? ' (a stub is included)' : ''}`);
         }
         if (meta.notes)
             log.step(`note: ${meta.notes}`);

package/dist/index.js

@@ -3,7 +3,7 @@ import { parseArgs, log, UserError } from "./util.js";
 import { initCommand } from "./commands/init.js";
 import { listCommand } from "./commands/list.js";
 import { addCommand } from "./commands/add.js";
-const HELP = `Koncept UI — the block CLI.
+const HELP = `Koncept UI - the block CLI.
 
 Usage:
   npx @konce-pt/ui <command> [options]

package/dist/semver.js

@@ -1,11 +1,11 @@
 // Minimalna obsługa zakresów semver. CLI ma zero zależności runtime
-// (package.json → "dependencies": {}), więc zamiast paczki `semver` niesiemy tyle
+// (package.json -> "dependencies": {}), więc zamiast paczki `semver` niesiemy tyle
 // kodu, ile pokrywa realne kształty zakresów z registry i z package.json aplikacji:
 // ">=0.6.0 <1.0.0", "^22.0.0", "~1.2.3", "1.2.3", oraz alternatywy przez "||".
 //
 // Zasada bezpieczeństwa: czego nie rozumiemy, tego nie oceniamy. Zablokowanie
 // instalacji z powodu składni nieznanej naszemu parserowi byłoby gorsze niż
-// pominięcie kontroli — stąd `satisfies` zwraca `true` dla zakresów, których nie
+// pominięcie kontroli - stąd `satisfies` zwraca `true` dla zakresów, których nie
 // potrafi rozłożyć.
 /** Wyciąga trójkę z wersji; toleruje prefiksy (`v1.2.3`) i sufiksy (`1.2.3-rc.1`). */
 export function parseVersion(input) {
@@ -38,7 +38,7 @@ function satisfiesOne(version, comparator) {
         return null;
     const [, op, rest] = m;
     if (/[x*]/i.test(rest))
-        return null; // 1.x / 1.* — poza zakresem tego parsera
+        return null; // 1.x / 1.* - poza zakresem tego parsera
     const target = parseVersion(rest);
     if (!target)
         return null;
@@ -55,7 +55,7 @@ function satisfiesOne(version, comparator) {
 /**
  * Czy `version` mieści się w `range`. Obsługuje koniunkcję przez spację
  * (">=0.6.0 <1.0.0") i alternatywę przez "||". Zakres, którego nie da się
- * rozłożyć, traktujemy jako spełniony — patrz nagłówek pliku.
+ * rozłożyć, traktujemy jako spełniony - patrz nagłówek pliku.
  */
 export function satisfies(version, range) {
     const parsed = parseVersion(version);
@@ -67,7 +67,7 @@ export function satisfies(version, range) {
             continue;
         const results = comparators.map((c) => satisfiesOne(parsed, c));
         if (results.includes(null))
-            return true; // nieznany kształt — nie oceniamy
+            return true; // nieznany kształt - nie oceniamy
         if (results.every(Boolean))
             return true;
     }

package/dist/util.js

@@ -26,9 +26,9 @@ export function hasFlag(args, name) {
 export const log = {
     info: (msg) => console.log(msg),
     step: (msg) => console.log(`  ${msg}`),
-    ok: (msg) => console.log(`✓ ${msg}`),
+    ok: (msg) => console.log(`OK: ${msg}`),
     warn: (msg) => console.warn(`! ${msg}`),
-    error: (msg) => console.error(`✗ ${msg}`),
+    error: (msg) => console.error(`ERROR: ${msg}`),
 };
 /** Błąd, którego komunikat wystarczy pokazać userowi (bez stack trace). */
 export class UserError extends Error {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@konce-pt/ui",
-  "version": "0.12.0",
-  "description": "The Koncept UI CLI — installs blocks (copy-paste) into an Angular project: init, add, list.",
+  "version": "0.14.0",
+  "description": "The Koncept UI CLI - installs blocks (copy-paste) into an Angular project: init, add, list.",
   "license": "MIT",
   "author": "konce.pt",
   "homepage": "https://ui.konce.pt/",