@koslibs/builder 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 holypower777
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,301 @@
+# @koslibs/builder
+
+Единый CLI для React-приложений, ESM-библиотек, Storybook и тестов.
+UI собирается через Rsbuild, библиотеки — через Rslib. Оба используют Rspack.
+
+## Подключение
+
+Node.js >= 24.13.0. Builder устанавливается в devDependencies:
+
+```sh
+npm install @koslibs/api @koslibs/components
+npm install --save-dev @koslibs/builder @koslibs/configs @types/react @types/react-dom @types/node
+```
+
+`@koslibs/configs` — обязательная peer-зависимость builder с диапазоном `^0.2.11`.
+Builder использует версию configs, установленную в проекте.
+
+Первая строка — целевая схема подключения runtime-пакетов: она применима, когда
+нужные версии API и components опубликованы. Builder не устанавливает эти пакеты автоматически
+и не требует их наличия для работы. React и react-dom устанавливаются самим приложением.
+Поддерживаются React 18.3 и 19; совместимость остальных пакетов нужно учитывать отдельно.
+
+В корне проекта создаётся `koslibs-builder.ts`:
+
+```ts
+import type { KoslibsBuilderConfig } from '@koslibs/builder';
+
+const config: KoslibsBuilderConfig = {};
+
+export default config;
+```
+
+Конфиг загружается встроенным TypeScript-загрузчиком Node.js. Типы импортируются через
+`import type`, относительные импорты указываются с расширением файла, например `./settings.ts`.
+В конфиге не поддерживаются `enum`, декораторы и другие конструкции, требующие преобразования в JavaScript.
+
+Пустой объект использует дефолты builder. Отсутствующий файл также означает дефолты.
+`init` не нужен. Builder создаёт служебные настройки в `.cache/koslibs-builder`,
+не перезаписывая конфиг или scripts проекта. После изменения `koslibs-builder.ts`
+следует перезапустить dev/watch-процесс.
+
+Публичный тип контролируется пакетом:
+
+```ts
+interface KoslibsBuilderConfig {
+    rsbuildConfig?: RsbuildConfig;
+    clientConfig?: EnvironmentConfig;
+    port?: number;
+}
+```
+
+Типы Rsbuild экспортируются из `@koslibs/builder`, поэтому для импортов типов
+не нужно отдельно устанавливать `@rsbuild/core`. Неизвестные поля верхнего уровня
+игнорируются при загрузке; TypeScript подсказывает только поддерживаемые поля.
+Некорректные значения известных полей, например `port: "8080"`, вызывают ошибку.
+
+```ts
+import type { KoslibsBuilderConfig } from '@koslibs/builder';
+
+const config: KoslibsBuilderConfig = {
+    port: 8080,
+    rsbuildConfig: {
+        source: { entry: { index: './src/main.tsx' } },
+    },
+    clientConfig: {
+        html: { title: 'GullEye' },
+        output: { distPath: { root: 'dist' } },
+    },
+};
+
+export default config;
+```
+
+Настройки глубоко объединяются через `mergeRsbuildConfig`: дефолты → `rsbuildConfig`
+→ клиентское окружение `clientConfig`. В UI это окружение называется `client`.
+`port` имеет приоритет над `rsbuildConfig.server.port`, затем используется 8080.
+Занятый порт вызывает ошибку вместо незаметного переключения на другой.
+`clientConfig` используется для UI и Storybook, для сборки библиотеки он игнорируется.
+
+## Scripts приложения
+
+```json
+{
+    "start": "koslibs-builder ui:start",
+    "build": "koslibs-builder ui:build",
+    "preview": "koslibs-builder ui:preview",
+    "typecheck": "koslibs-builder ui:typecheck",
+    "test": "koslibs-builder ui:test",
+    "test:watch": "koslibs-builder ui:test:watch",
+    "test:coverage": "koslibs-builder ui:test:coverage",
+    "test:e2e": "koslibs-builder ui:test:e2e",
+    "test:screenshots": "koslibs-builder ui:test:screenshots",
+    "storybook:start": "koslibs-builder storybook:start",
+    "storybook:build": "koslibs-builder storybook:build"
+}
+```
+
+Дефолты UI:
+
+- Entry: `src/index.tsx`, затем существующий `src/main.tsx` или `src/index.ts`.
+- React Fast Refresh в dev, production-оптимизации при build.
+- CSS Modules для `*.module.css`; обычный CSS также поддерживается.
+- Разделение vendor-кода и динамических импортов на чанки.
+- Browserslist: `last 2 versions`. Это настройка преобразования синтаксиса; builder не добавляет полифиллы всех браузерных API.
+- Выход в `dist`, относительные ссылки на ресурсы `./`, HTML с контейнером `#root`.
+
+Rsbuild предоставляет дополнительные возможности через `rsbuildConfig` и `clientConfig`.
+HTML можно изменить через `clientConfig.html`; для обычного сайта абсолютный путь к ресурсам
+можно задать через `clientConfig.output.assetPrefix: '/'`.
+
+Нужен `tsconfig.json`, расширяющий `@koslibs/configs`:
+
+```json
+{
+    "extends": "@koslibs/configs/tsconfig",
+    "compilerOptions": {
+        "types": ["@koslibs/builder/client"],
+        "jsx": "react-jsx"
+    },
+    "include": ["src", "koslibs-builder.ts"]
+}
+```
+
+`@koslibs/builder/client` предоставляет типы CSS Modules, ресурсов и `import.meta.env`.
+Для кода Node.js и конфигов, использующих `process`, добавь `@types/node` и `node` в `types`.
+При использовании библиотек или JSX также нужны соответствующие `@types/*`.
+
+Для работы с `examples/ui` в этом репозитории сначала выполни `npm run build`
+из корня builder, затем в папке `examples/ui`:
+
+```sh
+npm install --no-save --package-lock=false ../..
+npm run typecheck
+```
+
+Это подключит локальный builder, включая `@koslibs/builder/client`, без изменения
+зависимостей в package.json примера.
+
+`ui:build` сначала проверяет весь TS-проект и возвращает ненулевой код при ошибках.
+`ui:start` проверяет типы в отдельном процессе, показывает ошибки в терминале и overlay,
+продолжает работать и повторяет проверку после исправлений. Dev-server не прекращает
+работу из-за исправимой ошибки типов. Проверку типов задаёт builder.
+
+## Библиотеки
+
+Scripts используют префикс `lib` для build, typecheck и всех тестовых команд:
+
+```json
+{
+    "start": "koslibs-builder lib:start",
+    "watch": "koslibs-builder lib:watch",
+    "build": "koslibs-builder lib:build",
+    "typecheck": "koslibs-builder lib:typecheck",
+    "test": "koslibs-builder lib:test",
+    "test:watch": "koslibs-builder lib:test:watch",
+    "test:coverage": "koslibs-builder lib:test:coverage",
+    "test:e2e": "koslibs-builder lib:test:e2e",
+    "test:screenshots": "koslibs-builder lib:test:screenshots",
+    "storybook:start": "koslibs-builder storybook:start",
+    "storybook:build": "koslibs-builder storybook:build"
+}
+```
+
+`lib:start` — алиас `storybook:start` для компонентов. Для библиотеки без UI, например
+API-клиента, script `start` можно направить на `koslibs-builder lib:watch`.
+`lib:watch` пересобирает исходники и декларации при изменениях, проверяет типы в фоне
+и продолжает следить за файлами после исправимой ошибки типов.
+
+Дефолты: ESM-only, структура файлов из `src` сохраняется в `dist`, генерируются `.d.ts`.
+Dependencies и peerDependencies остаются внешними. Тесты, spec-файлы и stories не входят в dist.
+TypeScript проверяется перед build; ошибки деклараций тоже завершают сборку с ошибкой.
+Для Node.js библиотеки задай `rsbuildConfig.output.target: 'node'`.
+
+Служебный tsconfig для деклараций расширяет корневой tsconfig, ограничивает исходники
+каталогом `src` и задаёт `rootDir: src`. Для другой структуры, специальных исключений
+или project references укажи собственный `rsbuildConfig.source.tsconfigPath`.
+В режиме сохранения модулей `source.entry` задаётся glob-паттернами, например
+`{ index: ['./src/**', '!./src/**/*.test.*', '!./src/**/*.stories.*'] }`.
+
+В package.json библиотеки указываются `"type": "module"`, `files` и exports:
+
+```json
+{
+    "type": "module",
+    "files": ["dist"],
+    "exports": {
+        ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" },
+        "./feature": { "types": "./dist/feature.d.ts", "import": "./dist/feature.js" }
+    }
+}
+```
+
+Builder не изменяет exports автоматически. Линтинг и форматирование остаются командами
+`koslibs-lint` из configs. Сам builder компилируется через tsc для начальной загрузки CLI.
+
+`npm run lint` запускает общую проверку ESLint и Prettier через `koslibs-lint lint`.
+`npm run lint:fix` исправляет ошибки линтинга и форматирование через `koslibs-lint lint:fix`.
+
+## Storybook
+
+Builder управляет Rsbuild-framework, addon-docs, Controls, автодокументацией и stories
+из `src/**/*.stories.{ts,tsx,js,jsx,mjs}`. `.storybook/main.ts` не требуется и не читается:
+служебный main создаётся builder. При миграции старые addons и main-настройки нужно
+сверить отдельно. Для локальных decorators и parameters используется `.storybook/preview.ts`.
+Файлы `public` подключаются как статические ресурсы. Выход — `storybook-static`.
+
+Storybook использует `port`, проверяет типы, наследует подходящие общие настройки
+Rsbuild и клиентские настройки. Entry, HTML, server и distPath принадлежат Storybook
+и не переносятся из настроек сборки приложения. Неподдерживаемые поля builder-конфига,
+включая `storybookConfig`, игнорируются; расширение API для addons возможно следующим шагом.
+
+## Тесты
+
+Только Rstest и Playwright. Компонентного браузерного runner нет.
+
+- `test` запускает unit-тесты один раз, `test:watch` следит за изменениями.
+- `test:coverage` создаёт отчёты text, HTML и lcov через Istanbul.
+- Дефолтные unit-тесты: `src` и `tests`, имена `*.test.*` и `*.spec.*`.
+- UI unit-тесты используют happy-dom и React preset configs; lib unit-тесты — Node.js.
+- Без тестов команда завершается с ошибкой.
+- Playwright E2E использует `playwright/**/*.spec.*`, исключая `*.screenshots.spec.*`.
+- Screenshot-suite использует `playwright/**/*.screenshots.spec.*`.
+- Playwright сам запускает UI dev-server, а для библиотеки — Storybook, на заданном порту.
+- Скриншоты сравниваются через `expect(page).toHaveScreenshot()`. Обновление существующих
+  эталонов — отдельное осознанное действие через `--update-snapshots`.
+
+Для браузерных тестов нужен установленный Chromium соответствующей версии Playwright.
+API тестов и типы stories доступны через builder, поэтому отдельные зависимости на
+тестовые инструменты в проекте не обязательны:
+
+```ts
+// unit-тесты
+import { test, expect } from '@koslibs/builder/rstest';
+// Playwright-тесты (в другом файле)
+import { test, expect } from '@koslibs/builder/playwright';
+// типы stories
+import type { Meta, StoryObj } from '@koslibs/builder/storybook';
+```
+
+Если используются прямые импорты `@playwright/test`, `@rstest/core` или
+`storybook-react-rsbuild`, эти пакеты должны быть прямыми devDependencies проекта.
+Builder сам разрешает исполняемые файлы своих инструментов и не полагается на глобальную установку.
+
+Если проект имеет `rstest.config.*` или `playwright.config.*`, builder использует их.
+В пользовательском Playwright-конфиге помечай screenshot-тесты тегом `@screenshots`:
+builder выбирает E2E/screenshot-suite через grep. При таком конфиге запуск сервера
+и остальные настройки контролирует сам проект. Общие фабрики доступны из
+`@koslibs/builder/testing`, можно расширять их через обычные конфиги инструментов.
+Тестовые и Storybook-флаги передаются дальше:
+
+```sh
+npm run test -- greeting
+npm run test:e2e -- --list
+npm run test:screenshots -- --update-snapshots
+koslibs-builder ui:build --root ./frontend
+```
+
+## Переменные окружения
+
+В UI загружаются `.env`, `.env.local`, `.env.development` / `.env.production` и их `.local` варианты.
+Публичные переменные с префиксом `PUBLIC_` встраиваются в клиентскую сборку:
+
+```dotenv
+PUBLIC_API_URL=http://localhost:8081
+```
+
+```ts
+const apiUrl = import.meta.env.PUBLIC_API_URL;
+```
+
+Это значения времени сборки. В production смена адреса требует пересборки.
+Для runtime-настроек нужен отдельный механизм приложения. Секреты не должны иметь
+префикс `PUBLIC_`: содержимое клиентского бандла доступно пользователям.
+Для переиспользуемых библиотек builder не загружает `.env` автоматически.
+Поведение описано в [документации Rsbuild](https://rsbuild.rs/guide/advanced/env-vars).
+
+## Структура исходников
+
+```text
+src/
+  index.ts             публичные типы builder
+  cli/
+    index.ts           точка входа CLI
+    run.ts             маршрутизация команд
+    args.ts            разбор аргументов
+    commands.ts        список команд
+    process.ts         запуск и завершение процессов
+    handlers/          UI, библиотеки, Storybook, тесты, typecheck
+  configs/             загрузка, валидация, дефолты и настройки инструментов
+  typings/             интерфейсы, типы и клиентские декларации
+  utils/               общие функции для пакетов и shell-команд
+  storybook/           публичная точка входа @koslibs/builder/storybook
+  testing/             публичные точки входа testing, rstest и playwright
+```
+
+Тесты повторяют структуру модулей в `tests/cli` и `tests/configs`.
+Сборка очищает `dist`, чтобы удалённые или перенесённые модули не попадали в npm-архив.
+
+Архитектурные источники: [Rsbuild](https://rsbuild.dev/guide/faq/general),
+[Rslib: сохранение структуры модулей](https://www.rslib.rs/config/lib/bundle),
+[Storybook Rsbuild](https://storybook.rsbuild.rs/guide/configuration).

package/dist/cli/args.d.ts

@@ -0,0 +1,3 @@
+import type { CliOptions } from '../typings/cli.js';
+export declare function parseArgs(argv: string[], cwd?: string): CliOptions;
+//# sourceMappingURL=args.d.ts.map

package/dist/cli/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIpD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,SAAgB,GAAG,UAAU,CAoBzE"}

package/dist/cli/args.js

@@ -0,0 +1,24 @@
+import { resolve } from 'node:path';
+import { COMMANDS } from './commands.js';
+export function parseArgs(argv, cwd = process.cwd()) {
+    const args = [...argv];
+    const command = args.shift();
+    if (!command || command === '--help' || command === '-h') {
+        return { root: cwd, help: true, args: [] };
+    }
+    if (!COMMANDS.includes(command)) {
+        throw new Error(`Unknown command "${command}". Run koslibs-builder --help.`);
+    }
+    let root = cwd;
+    const rootIndex = args.indexOf('--root');
+    if (rootIndex !== -1) {
+        const path = args[rootIndex + 1];
+        if (!path || path.startsWith('--')) {
+            throw new Error('--root requires a project directory.');
+        }
+        root = resolve(cwd, path);
+        args.splice(rootIndex, 2);
+    }
+    return { command, root, help: args.includes('--help') || args.includes('-h'), args };
+}
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,UAAU,SAAS,CAAC,IAAc,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IACzD,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACvD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAC/C,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,gCAAgC,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,IAAI,GAAG,GAAG,CAAC;IACf,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;AACzF,CAAC"}

package/dist/cli/commands.d.ts

@@ -0,0 +1,2 @@
+export declare const COMMANDS: string[];
+//# sourceMappingURL=commands.d.ts.map

package/dist/cli/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,UAkBpB,CAAC"}

package/dist/cli/commands.js

@@ -0,0 +1,20 @@
+export const COMMANDS = [
+    'ui:start',
+    'ui:build',
+    'ui:preview',
+    'ui:typecheck',
+    'lib:start',
+    'lib:watch',
+    'lib:build',
+    'lib:typecheck',
+    'storybook:start',
+    'storybook:build',
+    ...['ui', 'lib'].flatMap((kind) => [
+        `${kind}:test`,
+        `${kind}:test:watch`,
+        `${kind}:test:coverage`,
+        `${kind}:test:e2e`,
+        `${kind}:test:screenshots`,
+    ]),
+];
+//# sourceMappingURL=commands.js.map

package/dist/cli/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;IACpB,UAAU;IACV,UAAU;IACV,YAAY;IACZ,cAAc;IACd,WAAW;IACX,WAAW;IACX,WAAW;IACX,eAAe;IACf,iBAAiB;IACjB,iBAAiB;IACjB,GAAI,CAAC,IAAI,EAAE,KAAK,CAAW,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1C,GAAG,IAAI,OAAO;QACd,GAAG,IAAI,aAAa;QACpB,GAAG,IAAI,gBAAgB;QACvB,GAAG,IAAI,WAAW;QAClB,GAAG,IAAI,mBAAmB;KAC7B,CAAC;CACL,CAAC"}

package/dist/cli/handlers/library.d.ts

@@ -0,0 +1,2 @@
+export declare function runLibrary(command: string, root: string): Promise<void>;
+//# sourceMappingURL=library.d.ts.map

package/dist/cli/handlers/library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/library.ts"],"names":[],"mappings":"AAKA,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAc7E"}

package/dist/cli/handlers/library.js

@@ -0,0 +1,21 @@
+import { writeLibraryTsconfig } from '../../configs/generated.js';
+import { createLibraryConfig } from '../../configs/library.js';
+import { loadBuilderConfig } from '../../configs/load.js';
+import { closeOnSignal } from '../process.js';
+export async function runLibrary(command, root) {
+    const config = await loadBuilderConfig(root);
+    const { createRslib } = await import('@rslib/core');
+    await writeLibraryTsconfig(root);
+    const rslib = await createRslib({
+        cwd: root,
+        config: createLibraryConfig(config, root, command === 'lib:watch'),
+    });
+    const result = await rslib.build({ watch: command === 'lib:watch' });
+    if (command === 'lib:watch') {
+        closeOnSignal(() => result.close());
+    }
+    else {
+        await result.close();
+    }
+}
+//# sourceMappingURL=library.js.map

package/dist/cli/handlers/library.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.js","sourceRoot":"","sources":["../../../src/cli/handlers/library.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAe,EAAE,IAAY;IAC1D,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACpD,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC;QAC5B,GAAG,EAAE,IAAI;QACT,MAAM,EAAE,mBAAmB,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,WAAW,CAAC;KACrE,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,KAAK,WAAW,EAAE,CAAC,CAAC;IACrE,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;QAC1B,aAAa,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACxC,CAAC;SAAM,CAAC;QACJ,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;AACL,CAAC"}

package/dist/cli/handlers/storybook.d.ts

@@ -0,0 +1,2 @@
+export declare function runStorybook(command: string, root: string, args: string[]): Promise<number>;
+//# sourceMappingURL=storybook.d.ts.map

package/dist/cli/handlers/storybook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storybook.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/storybook.ts"],"names":[],"mappings":"AAQA,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAuBjG"}

package/dist/cli/handlers/storybook.js

@@ -0,0 +1,23 @@
+import { resolve } from 'node:path';
+import { DEFAULT_PORT } from '../../configs/defaults.js';
+import { writeGeneratedConfig } from '../../configs/generated.js';
+import { loadBuilderConfig } from '../../configs/load.js';
+import { packageBin } from '../../utils/packages.js';
+import { runNode } from '../process.js';
+export async function runStorybook(command, root, args) {
+    const config = await loadBuilderConfig(root);
+    const generated = await writeGeneratedConfig(root, 'storybook', `import { createStorybookConfig } from ${JSON.stringify(new URL('../../storybook/index.js', import.meta.url).href)};\n` +
+        `export default await createStorybookConfig(${JSON.stringify(root)});\n`);
+    const dev = command.endsWith(':start');
+    const flags = dev
+        ? [
+            'dev',
+            '--port',
+            String(config.port ?? config.rsbuildConfig?.server?.port ?? DEFAULT_PORT),
+            '--exact-port',
+            '--no-open',
+        ]
+        : ['build', '--output-dir', resolve(root, 'storybook-static')];
+    return runNode(packageBin('storybook', 'storybook'), [...flags, '--config-dir', generated.directory, '--disable-telemetry', ...args], root);
+}
+//# sourceMappingURL=storybook.js.map

package/dist/cli/handlers/storybook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storybook.js","sourceRoot":"","sources":["../../../src/cli/handlers/storybook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe,EAAE,IAAY,EAAE,IAAc;IAC5E,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,MAAM,oBAAoB,CACxC,IAAI,EACJ,WAAW,EACX,yCAAyC,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,0BAA0B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK;QACnH,8CAA8C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAC/E,CAAC;IACF,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,GAAG;QACb,CAAC,CAAC;YACI,KAAK;YACL,QAAQ;YACR,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,IAAI,YAAY,CAAC;YACzE,cAAc;YACd,WAAW;SACd;QACH,CAAC,CAAC,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACnE,OAAO,OAAO,CACV,UAAU,CAAC,WAAW,EAAE,WAAW,CAAC,EACpC,CAAC,GAAG,KAAK,EAAE,cAAc,EAAE,SAAS,CAAC,SAAS,EAAE,qBAAqB,EAAE,GAAG,IAAI,CAAC,EAC/E,IAAI,CACP,CAAC;AACN,CAAC"}

package/dist/cli/handlers/tests.d.ts

@@ -0,0 +1,2 @@
+export declare function runTests(command: string, root: string, args: string[]): Promise<number>;
+//# sourceMappingURL=tests.d.ts.map

package/dist/cli/handlers/tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tests.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/tests.ts"],"names":[],"mappings":"AAMA,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA6C7F"}

package/dist/cli/handlers/tests.js

@@ -0,0 +1,39 @@
+import { findTestConfig } from '../../configs/find-test.js';
+import { writeGeneratedConfig } from '../../configs/generated.js';
+import { packageBin } from '../../utils/packages.js';
+import { runNode } from '../process.js';
+export async function runTests(command, root, args) {
+    const [kind] = command.split(':');
+    const browser = command.endsWith(':e2e') || command.endsWith(':screenshots');
+    let file = findTestConfig(root, browser ? 'playwright' : 'rstest');
+    if (!file) {
+        const module = new URL('../../testing/index.js', import.meta.url).href;
+        const expression = browser
+            ? `await createBrowserTestConfig(${JSON.stringify(kind)}, ${JSON.stringify(command.endsWith(':screenshots') ? 'screenshots' : 'e2e')}, ${JSON.stringify(root)})`
+            : `createUnitTestConfig(${JSON.stringify(kind)}, ${JSON.stringify(root)})`;
+        const generated = await writeGeneratedConfig(root, browser ? 'playwright' : 'rstest', `import { createBrowserTestConfig, createUnitTestConfig } from ${JSON.stringify(module)};\n` +
+            `export default ${expression};\n`);
+        file = generated.file;
+    }
+    if (browser) {
+        const filter = command.endsWith(':screenshots')
+            ? ['--grep', '@screenshots']
+            : ['--grep-invert', '@screenshots'];
+        // Generated configs select by filename; custom configs use the shared @screenshots tag.
+        return runNode(packageBin('@playwright/test', 'playwright'), [
+            'test',
+            '--config',
+            file,
+            ...(findTestConfig(root, 'playwright') ? filter : []),
+            ...args,
+        ], root);
+    }
+    return runNode(packageBin('@rstest/core', 'rstest'), [
+        command.endsWith(':watch') ? 'watch' : 'run',
+        '--config',
+        file,
+        ...(command.endsWith(':coverage') ? ['--coverage'] : []),
+        ...args,
+    ], root);
+}
+//# sourceMappingURL=tests.js.map

package/dist/cli/handlers/tests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tests.js","sourceRoot":"","sources":["../../../src/cli/handlers/tests.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAe,EAAE,IAAY,EAAE,IAAc;IACxE,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;IACnD,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC7E,IAAI,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACnE,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,wBAAwB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;QACvE,MAAM,UAAU,GAAG,OAAO;YACtB,CAAC,CAAC,iCAAiC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG;YAChK,CAAC,CAAC,wBAAwB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;QAC/E,MAAM,SAAS,GAAG,MAAM,oBAAoB,CACxC,IAAI,EACJ,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,EACjC,iEAAiE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK;YACxF,kBAAkB,UAAU,KAAK,CACxC,CAAC;QACF,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACV,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;YAC3C,CAAC,CAAC,CAAC,QAAQ,EAAE,cAAc,CAAC;YAC5B,CAAC,CAAC,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;QACxC,wFAAwF;QACxF,OAAO,OAAO,CACV,UAAU,CAAC,kBAAkB,EAAE,YAAY,CAAC,EAC5C;YACI,MAAM;YACN,UAAU;YACV,IAAI;YACJ,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,GAAG,IAAI;SACV,EACD,IAAI,CACP,CAAC;IACN,CAAC;IACD,OAAO,OAAO,CACV,UAAU,CAAC,cAAc,EAAE,QAAQ,CAAC,EACpC;QACI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;QAC5C,UAAU;QACV,IAAI;QACJ,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,GAAG,IAAI;KACV,EACD,IAAI,CACP,CAAC;AACN,CAAC"}

package/dist/cli/handlers/typecheck.d.ts

@@ -0,0 +1,2 @@
+export declare function typecheck(root: string): Promise<number>;
+//# sourceMappingURL=typecheck.d.ts.map

package/dist/cli/handlers/typecheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typecheck.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/typecheck.ts"],"names":[],"mappings":"AAGA,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM7D"}

package/dist/cli/handlers/typecheck.js

@@ -0,0 +1,6 @@
+import { packageBin } from '../../utils/packages.js';
+import { runNode } from '../process.js';
+export async function typecheck(root) {
+    return runNode(packageBin('typescript', 'tsc'), ['--project', 'tsconfig.json', '--noEmit'], root);
+}
+//# sourceMappingURL=typecheck.js.map

package/dist/cli/handlers/typecheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typecheck.js","sourceRoot":"","sources":["../../../src/cli/handlers/typecheck.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IACxC,OAAO,OAAO,CACV,UAAU,CAAC,YAAY,EAAE,KAAK,CAAC,EAC/B,CAAC,WAAW,EAAE,eAAe,EAAE,UAAU,CAAC,EAC1C,IAAI,CACP,CAAC;AACN,CAAC"}

package/dist/cli/handlers/ui.d.ts

@@ -0,0 +1,2 @@
+export declare function runUi(command: string, root: string): Promise<void>;
+//# sourceMappingURL=ui.d.ts.map

package/dist/cli/handlers/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/ui.ts"],"names":[],"mappings":"AAIA,wBAAsB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBxE"}

package/dist/cli/handlers/ui.js

@@ -0,0 +1,25 @@
+import { loadBuilderConfig } from '../../configs/load.js';
+import { createUiConfig } from '../../configs/ui.js';
+import { closeOnSignal } from '../process.js';
+export async function runUi(command, root) {
+    const config = await loadBuilderConfig(root);
+    const { createRsbuild } = await import('@rsbuild/core');
+    const rsbuild = await createRsbuild({
+        cwd: root,
+        rsbuildConfig: createUiConfig(config, root),
+        loadEnv: true,
+    });
+    if (command === 'ui:start') {
+        const result = await rsbuild.startDevServer();
+        closeOnSignal(() => result.server.close());
+    }
+    else if (command === 'ui:preview') {
+        const result = await rsbuild.preview();
+        closeOnSignal(() => result.server.close());
+    }
+    else {
+        const result = await rsbuild.build();
+        await result.close();
+    }
+}
+//# sourceMappingURL=ui.js.map

package/dist/cli/handlers/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../../src/cli/handlers/ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,OAAe,EAAE,IAAY;IACrD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC;QAChC,GAAG,EAAE,IAAI;QACT,aAAa,EAAE,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC;QAC3C,OAAO,EAAE,IAAI;KAChB,CAAC,CAAC;IACH,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC;QAC9C,aAAa,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAC/C,CAAC;SAAM,IAAI,OAAO,KAAK,YAAY,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACvC,aAAa,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAC/C,CAAC;SAAM,CAAC;QACJ,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACrC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;AACL,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { runCli } from './run.js';
+try {
+    process.exitCode = await runCli();
+}
+catch (error) {
+    console.error(`[koslibs-builder] ${error instanceof Error ? error.message : String(error)}`);
+    process.exitCode = 1;
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,IAAI,CAAC;IACD,OAAO,CAAC,QAAQ,GAAG,MAAM,MAAM,EAAE,CAAC;AACtC,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACb,OAAO,CAAC,KAAK,CAAC,qBAAqB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC7F,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/cli/process.d.ts

@@ -0,0 +1,3 @@
+export declare function runNode(bin: string, args: string[], root: string): Promise<number>;
+export declare function closeOnSignal(close: () => Promise<void>): void;
+//# sourceMappingURL=process.d.ts.map

package/dist/cli/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/cli/process.ts"],"names":[],"mappings":"AAEA,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBlF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAgB9D"}