Na npm

CLI molique-jit

Wiersz poleceń, którym obsługujesz silnik molique JIT: budowanie, tryb nasłuchujący na żywo, konfiguracja - plus 8 generatorów gotowych bloków HTML.

1. Instalacja

Pakiet jest opublikowany na npm jako molique-jit. Zwykle wystarczy zależność deweloperska:

npm install --save-dev molique-jit

Albo bez instalacji, jednorazowo przez npx:

npx molique-jit init
npx molique-jit build

Strona pakietu: npmjs.com/package/molique-jit. Kod źródłowy jest jawny w repozytorium: github.com/rafalrozacki-debug/molique.

2. Plik konfiguracyjny molique.config.mjs

Komenda init tworzy ten plik za Ciebie, z komentarzami przy każdym polu. Pełny, ręcznie napisany przykład:

// molique.config.mjs
export default {
  // Gdzie szukać nazw klas.
  content: ['**/*.html', '**/*.php'],

  // Gdzie zapisać wynikowy CSS.
  output: 'css/molique-jit.css',

  // WYŁĄCZNIE klasy specyficzne dla Twojego projektu (np. składane w PHP).
  // Klas runtime'owych molique (toasty, karuzela, stany .is-*) NIE trzeba
  // tu wpisywać - silnik dołącza je automatycznie.
  safelist: ['badge-success', 'badge-danger'],

  minify: true,
};

Jeśli masz kilka niezależnych stron w jednym projekcie (np. główną witrynę i osobny landing kampanii), pole targets zastępuje content/ output powyżej i buduje każdy cel osobno - landing dostaje własny, mały plik CSS, bez reszty:

export default {
  targets: [
    { content: ['src/**/*.html'], output: 'css/molique-jit.css' },
    { content: ['landing-kampania.html'], output: 'css/landing-kampania.css' },
  ],
};
Pole Domyślnie Opis
content ['**/*.html', '**/*.php'] Gdzie szukać klas (wzorce glob).
output css/molique-jit.css Ścieżka pliku wynikowego.
safelist [] Klasy Twojego projektu, których skan mógłby nie znaleźć (np. sklejane w backendzie).
minify true Obecnie efektywnie bez znaczenia - źródłowe dane są już skompresowane u źródła.
targets - Lista niezależnych buildów; gdy podana, zastępuje content/output.

3. Komendy silnika

Binarka nazywa się molique-jit (nie samo molique), żeby nie kolidować z innymi narzędziami o krótszej nazwie. CLI rozumie polecenia po angielsku, ale też ich polskie i niemieckie odpowiedniki - wygodne w zespołach, które na co dzień mówią jednym z tych języków.

Angielski (kanoniczny) Polski alias Niemiecki alias Co robi
init start start Tworzy plik molique.config.mjs ze wzorcową konfiguracją.
build buduj bauen Jednorazowo kompiluje CSS do pliku(ów) wyjściowego(ych).
watch obserwuj beobachten Nasłuchuje zmian plików i przebudowuje na żywo (~50ms debounce).
--minify / -m --minifikuj --minifizieren Wymusza kompresję wyjścia.
--config / -c --konfiguracja --konfiguration Wskazuje własną ścieżkę pliku konfiguracyjnego.

Wszystkie trzy warianty językowe robią dokładnie to samo:

npx molique-jit init
npx molique-jit build --minify
npx molique-jit watch --config ./custom.config.mjs
npx molique-jit start
npx molique-jit buduj --minifikuj
npx molique-jit obserwuj --konfiguracja ./custom.config.mjs
npx molique-jit start
npx molique-jit bauen --minifizieren
npx molique-jit beobachten --konfiguration ./custom.config.mjs

Kody wyjścia

build kończy się kodem 0 przy sukcesie i 1 przy błędzie (np. gdy plik konfiguracyjny wskazuje nieistniejący folder) - wygodne do spięcia z CI, np. jako krok przed publikacją.

4. Generatory komponentów: make:*

Osobna rodzina komend, niezależna od budowania CSS. Każda uruchamia w terminalu interaktywny kreator (strzałki + Enter), a na końcu wypisuje gotowy, wklejalny blok HTML - zgodny co do znaku z prawdziwymi, działającymi przykładami z tej dokumentacji. Sama komenda make:component niczego nie generuje - wypisuje spis wszystkich dostępnych generatorów, żeby nie trzeba było pamiętać nazw:

npx molique-jit make:component
Komenda Polski alias Niemiecki alias Generuje
make:modal zrob:modal mache:modal Modal (<dialog>) - Standard / Confirm / Context
make:layout zrob:uklad mache:layout Szkielet strony - Admin Dashboard / Hero (Simple + Cutout) / Bento Grid
make:nav zrob:nawigacje mache:nav Navbar - offcanvas, 3 warianty tła, opcjonalnie Mega Menu / Theme Switch / Language Switch
make:table zrob:tabele mache:tabelle Tabela B2B z automatycznym data-label na mobile
make:chart zrob:wykres mache:diagramm Wykres CSS/SVG - Radial Bar / Funnel / Pipeline / Stock Bar
make:form zrob:formularz mache:formular Formularz - Floating Labels / Klasyczny, opcjonalnie Searchable Select / Premium Multi Select / Drag & Drop File Upload
make:popover zrob:popover mache:popover Menu kontekstowe .popover-context (CSS Anchor Positioning)
make:widget zrob:widget mache:widget Speed Dial / Before-After Slider / Stepper / Share Bar
make:component - Wypisuje ten spis (nie jest generatorem)

Flaga -n, --count

Każdy generator, który tworzy listę o zmiennej długości (pozycje menu, wiersze tabeli, etapy wykresu…), przyjmuje -n, --count <liczba> - pomija TYLKO pytanie „ile?", reszta kreatora (etykiety, warianty, kolory) nadal działa interaktywnie:

npx molique-jit make:modal
npx molique-jit make:table --count 5

Na koniec każdego generatora wybierasz, czy kod ma trafić na ekran konsoli (do skopiowania myszką) czy od razu zapisać się do pliku - narzędzie nigdy nie nadpisuje istniejącego pliku bez wyraźnego potwierdzenia.