@voltro/cli 0.33.0 → 0.34.0

package/dist/fileTaxonomy-CJfgOllU.js

@@ -0,0 +1,457 @@
+import { C as e, E as t, O as n, T as r, d as i, h as a, i as o, l as s, m as c, r as l, u } from "./fileConventions-Cof68_BL.js";
+import { n as d, t as f } from "./tsconfigPaths-BWXBWgcl.js";
+import { dirname as p, join as m, relative as h, resolve as g, sep as _ } from "node:path";
+import { existsSync as v, readFileSync as y, readdirSync as b, statSync as x } from "node:fs";
+import { Node as S, Project as C, SyntaxKind as w } from "ts-morph";
+//#region src/vendoredDirs.ts
+var T = ".voltro-vendored", E = (e, t) => {
+	let n = [], r = /* @__PURE__ */ new Set(), i = (e, t) => {
+		let i = g(e);
+		r.has(i) || !v(i) || (r.add(i), n.push({
+			dir: i,
+			source: t
+		}));
+	}, a = m(e, "components.json");
+	if (v(a)) try {
+		let t = JSON.parse(y(a, "utf8"));
+		for (let n of ["ui"]) {
+			let r = t.aliases?.[n];
+			if (typeof r != "string" || r === "") continue;
+			let a = r.replace(/^@\//, "").replace(/^~\//, "");
+			for (let t of [m(e, a), m(e, "src", a)]) if (v(t)) {
+				i(t, `components.json (aliases.${n})`);
+				break;
+			}
+		}
+	} catch {}
+	for (let e of t) {
+		let t = e.slice(0, e.lastIndexOf(_)), n = m(t, T);
+		if (!r.has(g(t)) && v(n)) {
+			let e = "";
+			try {
+				e = y(n, "utf8").trim().split("\n")[0] ?? "";
+			} catch {}
+			i(t, e === "" ? T : `${T}: ${e}`);
+		}
+	}
+	return n;
+}, D = (e, t) => t.some((t) => e === t.dir || e.startsWith(`${t.dir}${_}`)), O = (e, t) => t.map((t) => `${h(e, t.dir) || "."}  (${t.source})`), k = [
+	{
+		id: "component.ui",
+		re: o,
+		needsTest: !0
+	},
+	{
+		id: "component",
+		re: l,
+		needsTest: !0
+	},
+	{
+		id: "hook",
+		re: u,
+		needsTest: !0
+	},
+	{
+		id: "tracking",
+		re: t,
+		needsTest: !0
+	},
+	{
+		id: "store",
+		re: e,
+		needsTest: !0
+	},
+	{
+		id: "internal",
+		re: i,
+		needsTest: !0
+	},
+	{
+		id: "fixture",
+		re: s,
+		needsTest: !1
+	},
+	{
+		id: "types",
+		re: n,
+		needsTest: !1
+	}
+], A = (e) => k.find((t) => t.re.test(e))?.id ?? null, j = (e) => r.test(e), M = /* @__PURE__ */ new Set([
+	"useMutation",
+	"useAction",
+	"useUpload",
+	"useUndo",
+	"useOutbox",
+	"useAgentChat",
+	"useAgentStream",
+	"useResumableAgentStream",
+	"useWorkflow"
+]), N = /* @__PURE__ */ new Set(["defineTracking"]), P = /* @__PURE__ */ new Set([
+	"useSubscription",
+	"useWindowedSubscription",
+	"useRecord",
+	"useQuery"
+]), F = /* @__PURE__ */ new Set([
+	"node_modules",
+	"dist",
+	"build",
+	".framework",
+	".turbo",
+	".vite",
+	".next",
+	".git",
+	"coverage",
+	".publish"
+]), I = /\.tsx?$/, L = (e, t = [], n = 0) => {
+	if (n > 12) return t;
+	let r;
+	try {
+		r = b(e);
+	} catch {
+		return t;
+	}
+	for (let i of r) {
+		if (F.has(i)) continue;
+		let r = m(e, i), a;
+		try {
+			a = x(r);
+		} catch {
+			continue;
+		}
+		a.isDirectory() ? L(r, t, n + 1) : a.isFile() && I.test(i) && !i.endsWith(".d.ts") && t.push(r);
+	}
+	return t;
+}, R = /\b(?:FC|FunctionComponent|ComponentType|ForwardRefExoticComponent|MemoExoticComponent)\b/, z = /\b(?:memo|forwardRef|observer|styled)\b/, B = (e) => S.isArrowFunction(e) || S.isFunctionExpression(e) || S.isFunctionDeclaration(e) || S.isClassDeclaration(e) || S.isClassExpression(e), V = (e) => {
+	if (B(e)) return !0;
+	if (S.isExportAssignment(e) || S.isAsExpression(e) || S.isSatisfiesExpression(e) || S.isParenthesizedExpression(e)) return V(e.getExpression());
+	if (S.isVariableDeclaration(e)) {
+		let t = e.getTypeNode();
+		if (t !== void 0 && R.test(t.getText())) return !0;
+		let n = e.getInitializer();
+		return n === void 0 || V(n);
+	}
+	return S.isCallExpression(e) ? z.test(e.getExpression().getText()) ? !0 : e.getArguments().some((e) => B(e) || S.isIdentifier(e)) : S.isTaggedTemplateExpression(e) ? !0 : !(S.isObjectLiteralExpression(e) || S.isArrayLiteralExpression(e) || S.isStringLiteral(e) || S.isNoSubstitutionTemplateLiteral(e) || S.isNumericLiteral(e) || S.isTemplateExpression(e) || S.isNewExpression(e) || S.isPropertyAccessExpression(e) || e.getKind() === w.TrueKeyword || e.getKind() === w.FalseKeyword || e.getKind() === w.NullKeyword);
+}, H = (e) => {
+	let t = [], n = [], r = [], i = /* @__PURE__ */ new Set();
+	for (let [a, o] of e.getExportedDeclarations()) {
+		let e = o[0];
+		if (e === void 0 || S.isInterfaceDeclaration(e) || S.isTypeAliasDeclaration(e) || i.has(e)) continue;
+		i.add(e);
+		let s = a === "default" ? (S.isFunctionDeclaration(e) || S.isClassDeclaration(e) || S.isVariableDeclaration(e) ? e.getName() : void 0) ?? "Default" : a;
+		if (/^use[A-Z]/.test(s)) {
+			n.push(s);
+			continue;
+		}
+		if (/^[A-Z]/.test(s) && V(e)) {
+			t.push(s);
+			continue;
+		}
+		r.push(s);
+	}
+	return {
+		components: t,
+		hooks: n,
+		others: r,
+		hasRuntimeExport: t.length + n.length + r.length > 0
+	};
+}, U = [], W = (e, t, n) => {
+	let r = p(e), i = [];
+	for (let e = r;; e = p(e)) {
+		let r = n.get(e);
+		if (r !== void 0) {
+			for (let e of i) n.set(e, r);
+			return r;
+		}
+		if (i.push(e), v(m(e, "tsconfig.json"))) {
+			let t = d(e);
+			if (t.length > 0) {
+				for (let e of i) n.set(e, t);
+				return t;
+			}
+		}
+		if (e === t || p(e) === e) break;
+	}
+	for (let e of i) n.set(e, U);
+	return U;
+}, G = (e, t, n) => {
+	let r = t.startsWith(".") ? g(p(e), t) : f(t, n);
+	if (r === void 0) return null;
+	for (let e of [
+		r,
+		`${r}.tsx`,
+		`${r}.ts`,
+		m(r, "index.tsx"),
+		m(r, "index.ts")
+	]) try {
+		if (x(e).isFile()) return e;
+	} catch {}
+	return null;
+}, K = (e, t, n) => {
+	let r = [], i = /* @__PURE__ */ new Set(), a = /* @__PURE__ */ new Map(), o = (e) => {
+		let i = G(t, e, n);
+		return i !== null && r.push(i), i;
+	};
+	for (let t of e.getImportDeclarations()) if (o(t.getModuleSpecifierValue()), !t.isTypeOnly()) for (let e of t.getNamedImports()) e.isTypeOnly() || i.add(e.getName());
+	for (let t of e.getExportDeclarations()) {
+		let e = t.getModuleSpecifierValue();
+		if (e === void 0) continue;
+		let n = o(e);
+		if (n === null || t.isTypeOnly()) continue;
+		let r = t.getNamedExports();
+		if (r.length === 0) {
+			a.set(n, "*");
+			continue;
+		}
+		let i = r.filter((e) => !e.isTypeOnly()).map((e) => e.getAliasNode()?.getText() ?? e.getName()), s = a.get(n);
+		a.set(n, s === "*" ? "*" : [...s ?? [], ...i]);
+	}
+	for (let t of e.getDescendantsOfKind(w.CallExpression)) {
+		if (t.getExpression().getKind() !== w.ImportKeyword) continue;
+		let e = t.getArguments()[0];
+		e !== void 0 && S.isStringLiteral(e) && o(e.getLiteralValue());
+	}
+	return {
+		localTargets: r,
+		namedBindings: i,
+		reExports: a
+	};
+}, q = (e) => {
+	let t = /* @__PURE__ */ new Map();
+	for (let n of e.getDescendantsOfKind(w.CallExpression)) {
+		let e = n.getExpression(), r = S.isPropertyAccessExpression(e) ? e.getName() : e.getText();
+		t.set(r, (t.get(r) ?? 0) + 1);
+	}
+	return t;
+}, J = (e) => {
+	if (e.length <= 1) return e.length === 1;
+	let t = [...e].sort((e, t) => e.length - t.length)[0];
+	return e.every((e) => e.startsWith(t));
+}, Y = (e, t) => {
+	let n = p(t);
+	return e.startsWith(`${n}${_}`) || p(e) === n;
+}, X = (e) => {
+	let t = L(e);
+	if (t.length === 0) return {
+		findings: [],
+		declared: 0,
+		scanned: 0,
+		vendored: []
+	};
+	let n = E(e, t), r = t.filter((e) => !D(e, n));
+	if (r.length === 0) return {
+		findings: [],
+		declared: 0,
+		scanned: 0,
+		vendored: n
+	};
+	let i = new C({
+		useInMemoryFileSystem: !0,
+		skipAddingFilesFromTsConfig: !0
+	}), o = [], s = (t) => h(e, t), l = /* @__PURE__ */ new Map(), u = /* @__PURE__ */ new Map(), d = /* @__PURE__ */ new Map(), f = /* @__PURE__ */ new Map();
+	for (let t of r) {
+		let n;
+		try {
+			n = y(t, "utf8");
+		} catch {
+			continue;
+		}
+		let r;
+		try {
+			r = i.createSourceFile(t.endsWith("x") ? "/scan.tsx" : "/scan.ts", n, { overwrite: !0 });
+		} catch {
+			continue;
+		}
+		l.set(t, H(r)), u.set(t, K(r, t, W(t, e, f))), d.set(t, q(r));
+	}
+	let p = /* @__PURE__ */ new Map();
+	for (let [e, t] of u) for (let n of t.localTargets) {
+		let t = p.get(n) ?? [];
+		t.push(e), p.set(n, t);
+	}
+	let m = (e) => {
+		let t = l.get(e), n = /* @__PURE__ */ new Set([
+			...t?.components ?? [],
+			...t?.hooks ?? [],
+			...t?.others ?? []
+		]), r = /* @__PURE__ */ new Set(), i = /* @__PURE__ */ new Set([e]), a = (e, t) => {
+			for (let o of p.get(e) ?? []) {
+				if (i.has(o)) continue;
+				let s = u.get(o);
+				if (s === void 0) continue;
+				let c = s.reExports.get(e);
+				if (c !== void 0) {
+					i.add(o), r.add(o);
+					let e = c === "*" ? t ?? n : new Set(c), s = t === null ? e : new Set([...e].filter((e) => t.has(e)));
+					s.size > 0 && a(o, s);
+					continue;
+				}
+				(t === null || [...s.namedBindings].some((e) => t.has(e))) && r.add(o);
+			}
+		};
+		return a(e, null), [...r];
+	}, g = 0;
+	for (let e of r) {
+		let t = A(e), n = l.get(e), r = u.get(e);
+		if (n === void 0 || r === void 0) continue;
+		let i = j(e);
+		t !== null && !i && (g += 1);
+		let f = p.get(e) ?? [];
+		if ((t === "component" || t === "component.ui") && !i) {
+			let t = J(n.components);
+			(n.components.length === 0 || !t) && o.push({
+				rule: "component/one-per-file",
+				file: s(e),
+				severity: "error",
+				detail: n.components.length === 0 ? "declares a component file but exports no component" : `exports ${n.components.length} unrelated components: ${n.components.join(", ")}`,
+				fix: "a component file exports ONE component — or one NAMESPACED family sharing its name (`Card`, `CardHeader`, `CardTitle`), which is one component with parts. Types alongside are fine. Unrelated components belong in their own files"
+			}), n.hooks.length > 0 && o.push({
+				rule: "component/no-hook-export",
+				file: s(e),
+				severity: "error",
+				detail: `also exports hook(s): ${n.hooks.join(", ")}`,
+				fix: "move the hook into its own *.hook.ts — a file exporting both is two files wearing one name, and neither can be reused without dragging the other"
+			});
+		}
+		if (t === "hook" && !i && (n.hooks.length !== 1 && o.push({
+			rule: "hook/one-per-file",
+			file: s(e),
+			severity: "error",
+			detail: n.hooks.length === 0 ? "declares a hook file but exports no use* hook" : `exports ${n.hooks.length} hooks: ${n.hooks.join(", ")}`,
+			fix: "a hook file exports exactly ONE use* hook (types alongside are fine)"
+		}), n.components.length > 0 && o.push({
+			rule: "hook/no-component-export",
+			file: s(e),
+			severity: "error",
+			detail: `also exports component(s): ${n.components.join(", ")}`,
+			fix: "move the component into its own *.component.tsx"
+		})), t === "types" && n.hasRuntimeExport && o.push({
+			rule: "types/runtime-export",
+			file: s(e),
+			severity: "error",
+			detail: `exports runtime value(s): ${[
+				...n.components,
+				...n.hooks,
+				...n.others
+			].join(", ")}`,
+			fix: "a *.types.ts has NO runtime export. That is what makes importing it provably free AND makes it impossible for it to sit in a runtime import cycle — the guarantee is the point, so move the value to a sibling module"
+		}), t === "internal") {
+			let t = f.filter((t) => !Y(t, e));
+			t.length > 0 && o.push({
+				rule: "internal/foreign-import",
+				file: s(e),
+				severity: "error",
+				detail: `imported from outside its own directory by: ${t.slice(0, 5).map(s).join(", ")}${t.length > 5 ? ` (+${t.length - 5})` : ""}`,
+				fix: "export it through the feature's public module, or move the importer inside. `.internal` is the promise that refactoring within this directory breaks nobody — a foreign import revokes it silently, which is how a feature boundary rots without a single review comment"
+			});
+		}
+		if (t === "fixture") {
+			let t = f.filter((e) => !j(e) && A(e) !== "fixture");
+			t.length > 0 && o.push({
+				rule: "fixture/production-import",
+				file: s(e),
+				severity: "error",
+				detail: `imported by non-test file(s): ${t.slice(0, 5).map(s).join(", ")}`,
+				fix: "test material must not be reachable from a production path — it ships in the bundle, and it is written to be convenient rather than correct"
+			});
+		}
+		if (t === "component.ui" && !i) {
+			let t = [...r.namedBindings].filter((e) => M.has(e)).sort();
+			t.length > 0 && o.push({
+				rule: "ui/no-write",
+				file: s(e),
+				severity: "error",
+				detail: `imports write hook(s): ${t.join(", ")}`,
+				fix: "a *.component.ui.tsx renders; it does not write. Lift the mutation into the *.component.tsx that owns it and pass a handler down. Reading (useT / useCan / usePermissions) stays allowed — threading those through props is prop-drilling, not reusability"
+			});
+			let n = m(e), i = n.filter((e) => {
+				let t = A(e);
+				return t === "component" || t === "component.ui" || c.test(e) || a.has(e.slice(e.lastIndexOf(_) + 1));
+			});
+			n.length === 0 ? o.push({
+				rule: "ui/orphaned",
+				file: s(e),
+				severity: "warn",
+				detail: "nothing imports it",
+				fix: "render it from a *.component.tsx or a page, or delete it — an unrendered presentational component is carried, reviewed and refactored forever without reaching a user"
+			}) : i.length === 0 && o.push({
+				rule: "ui/unlinked",
+				file: s(e),
+				severity: "warn",
+				detail: `reached only by: ${n.slice(0, 5).map(s).join(", ")}${n.length > 5 ? ` (+${n.length - 5})` : ""} — barrels resolved through`,
+				fix: "a presentational component should be reached from a *.component.tsx, another *.component.ui.tsx, or a page"
+			});
+		}
+		if (t === "store" && !i) {
+			let t = d.get(e)?.get("defineStore") ?? 0;
+			t !== 1 && o.push({
+				rule: "store/one-per-file",
+				file: s(e),
+				severity: "error",
+				detail: t === 0 ? "declares a store file but calls no defineStore()" : `declares ${t} stores`,
+				fix: "a store file defines exactly ONE store — the SSR seed pass and devtools address stores by name, so two in a file makes both harder to find and neither easier to reason about"
+			});
+			let n = [...d.get(e)?.keys() ?? []].filter((e) => P.has(e)).sort();
+			n.length > 0 && o.push({
+				rule: "store/mirrors-server-state",
+				file: s(e),
+				severity: "error",
+				detail: `reads server state here: ${n.join(", ")}`,
+				fix: "a store holds CLIENT state. A subscription is already live server state; copying it into a store gives you a second copy that does not live, and the page then shows the stale one — a bug that reads as \"reactivity is broken\". Read the subscription where you render it"
+			});
+		}
+		if (t !== "tracking" && !i) {
+			let t = [...d.get(e)?.keys() ?? []].filter((e) => N.has(e)).sort();
+			t.length > 0 && o.push({
+				rule: "tracking/outside-tracking-file",
+				file: s(e),
+				severity: "error",
+				detail: `calls ${t.join(", ")} outside a *.tracking.ts`,
+				fix: "move the defineTracking(...) spec into a *.tracking.ts and import it here. The event catalogue — names, property bags, the decisions about what personal data goes out — belongs in one place you can list; calling useTracking with a spec from there is fine"
+			});
+		}
+		if (k.find((e) => e.id === t)?.needsTest === !0 && !i) {
+			let t = e.replace(/\.tsx?$/, ""), n = e.endsWith("x") ? "tsx" : "ts";
+			["test", "spec"].flatMap((e) => [`${t}.${e}.ts`, `${t}.${e}.tsx`]).some((e) => {
+				try {
+					return x(e).isFile();
+				} catch {
+					return !1;
+				}
+			}) || o.push({
+				rule: "convention/missing-test",
+				file: s(e),
+				severity: "warn",
+				detail: "no test beside it",
+				fix: `add ${s(t)}.test.${n} — the name is derivable, so write it with the file. A shallow test earns its place: what it buys is that something MOUNTS the component, and a render loop, a crashing effect or a missing provider is invisible until then. One app wrote 251 of these and the first run found a render loop that made a page take 423 s and exhaust the heap — in a browser it had looked usable`
+			});
+		}
+	}
+	return o.sort((e, t) => e.file === t.file ? e.rule.localeCompare(t.rule) : e.file.localeCompare(t.file)), {
+		findings: o,
+		declared: g,
+		scanned: r.length,
+		vendored: n
+	};
+}, Z = 10, Q = (e) => {
+	let { findings: t, declared: n, scanned: r, vendored: i } = X(e);
+	console.log("");
+	for (let t of O(e, i)) console.log(`·  not ours, exempt: ${t}`);
+	if (r === 0) return console.log("•  file-taxonomy scan: no sources here — nothing to check."), 0;
+	if (t.length === 0) return console.log(`✓  file-taxonomy scan: ${n} declared file(s) keep their contract (${r} scanned).`), 0;
+	let a = /* @__PURE__ */ new Map();
+	for (let e of t) {
+		let t = a.get(e.rule) ?? [];
+		t.push(e), a.set(e.rule, t);
+	}
+	let o = t.filter((e) => e.severity === "error").length;
+	console.log(`•  file taxonomy: ${t.length} finding(s) — ${o} error, ${t.length - o} advisory (${n} declared / ${r} scanned):`);
+	for (let [e, t] of [...a].sort()) {
+		console.log(`   ${t[0].severity === "error" ? "✗" : "·"} ${e} (${t.length})`);
+		for (let e of t.slice(0, Z)) console.log(`       ${e.file} — ${e.detail}`);
+		let n = t.length - Z;
+		n > 0 && console.log(`       (+${n} more — \`voltro doctor --json\` prints every one.)`), console.log(`         → ${t[0].fix}`);
+	}
+	return t.length;
+};
+//#endregion
+export { D as a, E as i, Q as n, X as r, J as t };

package/dist/frameworkTableAssembly-BGHmck-x.js

@@ -0,0 +1,2 @@
+import { n as e } from "./frameworkTableAssembly-DkkP6BgC.js";
+export { e as assembleFrameworkTables };