@konce-pt/ui 0.16.1 → 0.17.0

package/README.md

@@ -16,20 +16,46 @@ npx @konce-pt/ui add nip-lookup-field
 
 | Komenda | Opis |
 |---|---|
-| `init` | Tworzy `konce.json` (`--registry --blocks-dir --alias --prefix --theme --force`) |
+| `init` | Tworzy `konce.json` (`--registry --blocks-dir --alias --prefix --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 (`--category --registry`); kategorie: `forms`, `forms-pl` |
+
+Flagi przyjmują wartość wyłącznie jako `--klucz=wartość` (np. `--registry=https://ui.konce.pt/cli/`).
+Wartość po spacji parser czyta jako osobny argument - w `add` zostałaby wzięta za nazwę bloku.
+
+Po instalacji paczki (globalnie albo w devDependencies) ten sam CLI jest dostępny jako `konce`.
+
+## `konce.json`
+
+Domyślnie `init` zapisuje:
+
+| Pole | Domyślnie |
+|---|---|
+| `registry` | `https://ui.konce.pt/cli` ([spis bloków](https://ui.konce.pt/cli/)) |
+| `blocksDir` | `src/app/shared/blocks` |
+| `alias` | `@shared/blocks` |
+| `prefix` | `kpt` |
+
+Alias musisz sam zmapować w `tsconfig.json` -> `compilerOptions.paths`, np.
+`"@shared/blocks/*": ["src/app/shared/blocks/*"]` - bloki importują się nawzajem przez alias
+i bez tego wpisu się nie skompilują. `init` tsconfiga nie przepisuje (bywa z komentarzami), ale gdy
+wpisu brakuje, wypisuje dokładnie ten, który trzeba dodać.
 
 ## 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).
-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.
+2. Pomija bloki zapisane już w `installedBlocks` (`--overwrite` instaluje je ponownie).
+3. Sprawdza zależności npm - brak: ostrzega, wersja spoza zakresu: przerywa. Zależności `peer`
+   (Angular, rxjs) dają wyłącznie ostrzeżenie.
+4. Przepisuje `@/` -> `alias` oraz `kpt-` -> `prefix` w selektorach, klasach CSS i generowanych id
+   (tokeny `--kpt-*` i nazwy klas TS, np. `KptField`, zostają nietknięte).
+5. Konflikt pliku: identyczny pomija, różny zapisuje jako `.new` (lub `--overwrite`).
+6. Zapisuje dopiero po pobraniu wszystkich plików; odnotowuje `installedBlocks` (wersja biblioteki
+   i data).
+7. 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.
+Sprawdzenie zależności npm działa także wtedy, więc niezgodna wersja przerwie również dry-run.
 
 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/init.js

@@ -1,5 +1,5 @@
 import path from 'node:path';
-import { existsSync } from 'node:fs';
+import { existsSync, readFileSync } from 'node:fs';
 import { CONFIG_FILE, DEFAULT_CONFIG, writeConfig } from "../config.js";
 import { flag, hasFlag, log, UserError } from "../util.js";
 export function initCommand(args) {
@@ -14,7 +14,6 @@ export function initCommand(args) {
         blocksDir: flag(args, 'blocks-dir') ?? DEFAULT_CONFIG.blocksDir,
         alias: flag(args, 'alias') ?? DEFAULT_CONFIG.alias,
         prefix: flag(args, 'prefix') ?? DEFAULT_CONFIG.prefix,
-        theme: flag(args, 'theme') ?? DEFAULT_CONFIG.theme,
         installedBlocks: {},
     };
     writeConfig(configPath, config);
@@ -23,5 +22,18 @@ export function initCommand(args) {
     log.step(`blocksDir: ${config.blocksDir}`);
     log.step(`alias:     ${config.alias}`);
     log.step(`prefix:    ${config.prefix}`);
+    // Bloki importują się nawzajem przez alias - bez wpisu w `paths` projekt się nie skompiluje.
+    // tsconfig.json bywa z komentarzami (Angular CLI), więc go nie przepisujemy, tylko podpowiadamy.
+    if (!tsconfigMapsAlias(cwd, config.alias)) {
+        log.info('\nMap the alias in tsconfig.json -> compilerOptions.paths:');
+        log.step(`"${config.alias}/*": ["${config.blocksDir}/*"]`);
+    }
     log.info('\nAdd a block: npx @konce-pt/ui add <name>');
 }
+/** Czy tsconfig.json w katalogu projektu ma już wpis aliasu bloków (sprawdzenie tekstowe). */
+function tsconfigMapsAlias(cwd, alias) {
+    const tsconfig = path.join(cwd, 'tsconfig.json');
+    if (!existsSync(tsconfig))
+        return false;
+    return readFileSync(tsconfig, 'utf8').includes(`"${alias}/*"`);
+}

package/dist/config.js

@@ -3,7 +3,6 @@ import path from 'node:path';
 import { UserError } from "./util.js";
 export const CONFIG_FILE = 'konce.json';
 export const DEFAULT_CONFIG = {
-    $schema: 'https://ui.konce.pt/cli/konce-config-schema.json',
     registry: 'https://ui.konce.pt/cli',
     blocksDir: 'src/app/shared/blocks',
     alias: '@shared/blocks',

package/dist/index.js

@@ -9,7 +9,7 @@ Usage:
   npx @konce-pt/ui <command> [options]
 
 Commands:
-  init                     create konce.json (--registry --blocks-dir --alias --prefix --theme --force)
+  init                     create konce.json (--registry --blocks-dir --alias --prefix --force)
   add <name...>            install block(s) + their dependencies (--overwrite --dry-run --path --registry)
   list [--category=...]    show the available blocks (--registry)
 

package/package.json

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