bitboss-ui 2.1.135 → 3.0.0-alpha.4

package/bin/bitboss-ui.node.test.mjs

@@ -0,0 +1,113 @@
+/**
+ * `npx bitboss-ui check` integration tests.
+ *
+ * The CLI entrypoint (`bitboss-ui.mjs`) runs its command dispatch as a
+ * top-level side effect keyed off `process.argv` — importing it directly
+ * would execute the dispatcher against the TEST RUNNER's own argv. So this
+ * spawns the real binary as a subprocess against a scratch directory, which
+ * also happens to be the most faithful reproduction of SNT-007: a Laravel-
+ * shaped consumer tree where `check` used to report on `vendor/**` READMEs
+ * as if they were the project's own markup.
+ */
+import { execFileSync } from 'node:child_process';
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { afterEach, describe, expect, it } from 'vitest';
+
+const BIN = fileURLToPath(new URL('./bitboss-ui.mjs', import.meta.url));
+
+let scratch;
+
+afterEach(() => {
+	if (scratch) rmSync(scratch, { recursive: true, force: true });
+	scratch = undefined;
+});
+
+/** Build a temp Laravel-shaped consumer tree: vendored noise + real markup. */
+function makeLaravelLikeFixture() {
+	const dir = mkdtempSync(join(tmpdir(), 'bitboss-ui-check-'));
+
+	// Noise a default sweep must now skip.
+	mkdirSync(join(dir, 'vendor', 'some', 'package'), { recursive: true });
+	writeFileSync(
+		join(dir, 'vendor', 'some', 'package', 'README.md'),
+		'# Vendored package\n'
+	);
+	mkdirSync(join(dir, 'storage', 'logs'), { recursive: true });
+	writeFileSync(join(dir, 'storage', 'logs', 'notes.md'), '# log notes\n');
+	mkdirSync(join(dir, 'public', 'build'), { recursive: true });
+	writeFileSync(join(dir, 'public', 'build', 'manifest.md'), '# build\n');
+	mkdirSync(join(dir, 'bootstrap', 'cache'), { recursive: true });
+	writeFileSync(
+		join(dir, 'bootstrap', 'cache', 'config.md'),
+		'# compiled config\n'
+	);
+
+	// A hand-authored doc that happens to live next to (not inside) the
+	// skipped `bootstrap/cache` dir — must still be counted.
+	writeFileSync(join(dir, 'bootstrap', 'README.md'), '# real bootstrap doc\n');
+
+	// Real app markup: one .vue, one .md.
+	mkdirSync(join(dir, 'resources', 'js', 'components'), { recursive: true });
+	writeFileSync(
+		join(dir, 'resources', 'js', 'components', 'Widget.vue'),
+		'<template><div>hi</div></template>\n'
+	);
+	writeFileSync(join(dir, 'GUIDE.md'), '# guide\n');
+
+	return dir;
+}
+
+function runCheck(cwd, args = []) {
+	try {
+		const stdout = execFileSync(process.execPath, [BIN, 'check', ...args], {
+			cwd,
+			encoding: 'utf-8',
+		});
+		return { status: 0, stdout };
+	} catch (error) {
+		return {
+			status: error.status,
+			stdout: error.stdout ?? '',
+			stderr: error.stderr ?? '',
+		};
+	}
+}
+
+describe('bitboss-ui check — default sweep skip list (SNT-007)', () => {
+	it('skips vendor/storage/public/bootstrap-cache and splits the summary by extension', () => {
+		scratch = makeLaravelLikeFixture();
+		const { status, stdout } = runCheck(scratch);
+
+		expect(status).toBe(0);
+		// Exactly the two real files: Widget.vue + (GUIDE.md + bootstrap/README.md).
+		expect(stdout).toMatch(
+			/\[bitboss-ui\] check OK — 1 \.vue \+ 2 \.md file\(s\), zero unknown Bb\* props\/v-models\./
+		);
+	});
+
+	it('still reports findings when a real file has an unknown prop', () => {
+		scratch = makeLaravelLikeFixture();
+		writeFileSync(
+			join(scratch, 'resources', 'js', 'components', 'Bad.vue'),
+			'<template><BbButton totallyBogusProp="x" /></template>\n'
+		);
+		const { status, stdout, stderr } = runCheck(scratch);
+
+		expect(status).toBe(1);
+		expect(stdout + stderr).toMatch(/check FAILED/);
+		expect(stdout + stderr).toMatch(/totallyBogusProp|totallybogusprop/i);
+	});
+
+	it('an explicit path still widens the scan into a normally-skipped dir', () => {
+		scratch = makeLaravelLikeFixture();
+		const { status, stdout } = runCheck(scratch, [
+			join('vendor', 'some', 'package', 'README.md'),
+		]);
+
+		expect(status).toBe(0);
+		expect(stdout).toMatch(/check OK — 1 \.md file\(s\)/);
+	});
+});