@lyse-labs/lyse 0.1.0-alpha.2 → 0.2.0-alpha.1

package/dist/rules/ai-surface-shadcn-registry-valid.js

@@ -0,0 +1,247 @@
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { join, relative } from "node:path";
+import fg from "fast-glob";
+import { isPathExcluded } from "./_exclude.js";
+import { createLyseRule } from "./_rule-module.js";
+const RULE_ID = "ai-surface/shadcn-registry-valid";
+const MAX_FILE_BYTES = 4_000_000;
+const SHADCN_MARKER = "components.json";
+const REGISTRY_CANDIDATES = [
+    "registry.json",
+    "public/registry.json",
+    "registry/*.json",
+];
+function discoverRegistryFiles(ctx) {
+    if (!ctx.repoRoot)
+        return [];
+    let entries = [];
+    try {
+        entries = fg.sync(REGISTRY_CANDIDATES, {
+            cwd: ctx.repoRoot,
+            absolute: false,
+            dot: false,
+            ignore: ["**/node_modules/**", "**/dist/**", "**/build/**", "**/.git/**"],
+            followSymbolicLinks: false,
+        });
+    }
+    catch {
+        return [];
+    }
+    const out = new Set();
+    for (const rel of entries) {
+        if (isPathExcluded(rel, ctx.excludePaths))
+            continue;
+        out.add(rel);
+    }
+    return Array.from(out).sort();
+}
+function readJsonIfSmall(absPath) {
+    try {
+        const stat = statSync(absPath);
+        if (!stat.isFile())
+            return { data: null, parseError: null };
+        if (stat.size > MAX_FILE_BYTES)
+            return { data: null, parseError: "file too large" };
+        const raw = readFileSync(absPath, "utf8");
+        if (raw.trim().length === 0)
+            return { data: null, parseError: "empty file" };
+        return { data: JSON.parse(raw), parseError: null };
+    }
+    catch (e) {
+        return { data: null, parseError: e instanceof Error ? e.message : "unknown parse error" };
+    }
+}
+function hasShadcnMarker(repoRoot) {
+    return existsSync(join(repoRoot, SHADCN_MARKER));
+}
+function validateRegistryItem(item) {
+    const reasons = [];
+    if (typeof item !== "object" || item === null) {
+        return { ok: false, reasons: ["registry item is not a JSON object"] };
+    }
+    const r = item;
+    if (typeof r.name !== "string" || r.name.trim().length === 0) {
+        reasons.push("missing or empty `name` (required, string)");
+    }
+    if (typeof r.type !== "string" || r.type.trim().length === 0) {
+        reasons.push("missing or empty `type` (required, e.g. \"registry:ui\")");
+    }
+    // Note: we don't gate on a fixed `VALID_ITEM_TYPES` set — the shadcn schema
+    // has evolved over time and accepts arbitrary `registry:*` namespaces, so
+    // checking against a hardcoded list produces false positives on legitimate
+    // custom types. We just require a non-empty string.
+    if (!Array.isArray(r.files)) {
+        reasons.push("missing `files` (required, non-empty array of `{ path, content?, type? }`)");
+    }
+    else if (r.files.length === 0) {
+        reasons.push("`files` is empty (must contain at least one `{ path }` entry)");
+    }
+    else {
+        for (let i = 0; i < r.files.length; i++) {
+            const f = r.files[i];
+            if (typeof f !== "object" || f === null) {
+                reasons.push(`files[${i}] is not an object`);
+                continue;
+            }
+            const fe = f;
+            if (typeof fe.path !== "string" || fe.path.trim().length === 0) {
+                reasons.push(`files[${i}] missing \`path\` (required, string)`);
+            }
+        }
+    }
+    return { ok: reasons.length === 0, reasons };
+}
+function looksLikeRegistryItem(data) {
+    if (typeof data !== "object" || data === null)
+        return false;
+    const r = data;
+    return "name" in r || "type" in r || "files" in r;
+}
+function looksLikeRegistryCollection(data) {
+    if (typeof data !== "object" || data === null)
+        return false;
+    const r = data;
+    if (Array.isArray(r.items))
+        return true;
+    if (Array.isArray(r.registry))
+        return true;
+    return false;
+}
+function extractRegistryItems(data) {
+    if (looksLikeRegistryCollection(data)) {
+        const r = data;
+        const arr = (Array.isArray(r.items) ? r.items : r.registry);
+        return { items: arr, shape: "collection" };
+    }
+    return { items: [data], shape: "single" };
+}
+const evaluate = async (ctx, _files) => {
+    const findings = [];
+    if (!ctx.repoRoot) {
+        return { findings, opportunities: 0 };
+    }
+    const registryFiles = discoverRegistryFiles(ctx);
+    const shadcnMarker = hasShadcnMarker(ctx.repoRoot);
+    if (registryFiles.length === 0) {
+        if (!shadcnMarker) {
+            return { findings, opportunities: 0 };
+        }
+        findings.push({
+            ruleId: RULE_ID,
+            axis: "ai-surface",
+            severity: "warning",
+            location: { file: SHADCN_MARKER, line: 1, column: 1 },
+            message: "components.json found but no shadcn registry — missed AI-Consumable surface",
+            suggestion: "publish a `registry.json` (or `public/registry.json`) describing your components so AI agents and the shadcn CLI can install them",
+        });
+        return { findings, opportunities: 1 };
+    }
+    let opportunities = 0;
+    for (const rel of registryFiles) {
+        opportunities += 1;
+        const abs = join(ctx.repoRoot, rel);
+        const { data, parseError } = readJsonIfSmall(abs);
+        const relPath = relative(ctx.repoRoot, abs) || rel;
+        if (data === null) {
+            if (parseError === "file too large") {
+                // Per doc: files larger than 4 MB are silently skipped.
+                continue;
+            }
+            findings.push({
+                ruleId: RULE_ID,
+                axis: "ai-surface",
+                severity: "error",
+                location: { file: relPath, line: 1, column: 1 },
+                message: `shadcn registry ${relPath} is not valid JSON${parseError ? ` (${parseError})` : ""}`,
+                suggestion: "ensure the registry file is parseable JSON",
+            });
+            continue;
+        }
+        if (!looksLikeRegistryItem(data) && !looksLikeRegistryCollection(data)) {
+            findings.push({
+                ruleId: RULE_ID,
+                axis: "ai-surface",
+                severity: "error",
+                location: { file: relPath, line: 1, column: 1 },
+                message: `shadcn registry ${relPath} has no \`name\`/\`type\`/\`files\` at the root and no \`items\` collection`,
+                suggestion: "each registry entry must be `{ name, type, files: [{ path, ... }] }` per https://ui.shadcn.com/docs/registry",
+            });
+            continue;
+        }
+        const parsed = extractRegistryItems(data);
+        if (parsed.items.length === 0) {
+            findings.push({
+                ruleId: RULE_ID,
+                axis: "ai-surface",
+                severity: "error",
+                location: { file: relPath, line: 1, column: 1 },
+                message: `shadcn registry ${relPath} contains no items`,
+                suggestion: "add at least one `{ name, type, files }` entry",
+            });
+            continue;
+        }
+        for (let i = 0; i < parsed.items.length; i++) {
+            const item = parsed.items[i];
+            const validation = validateRegistryItem(item);
+            if (validation.ok)
+                continue;
+            const label = parsed.shape === "collection"
+                ? `items[${i}]`
+                : (typeof item?.name === "string" ? `"${item.name}"` : "registry item");
+            for (const reason of validation.reasons) {
+                findings.push({
+                    ruleId: RULE_ID,
+                    axis: "ai-surface",
+                    severity: "error",
+                    location: { file: relPath, line: 1, column: 1 },
+                    message: `shadcn registry ${relPath} ${label}: ${reason}`,
+                    suggestion: "each entry must include `name` (string), `type` (e.g. \"registry:ui\") and a non-empty `files` array of `{ path }`",
+                });
+            }
+        }
+    }
+    return { findings, opportunities };
+};
+export const rule = createLyseRule({
+    meta: {
+        axis: "ai-surface",
+        lyseRuleId: RULE_ID,
+        defaultSeverity: "warning",
+        shortDescription: "shadcn-style registry.json must be present and valid",
+        fullDescription: "Detects whether the design system ships a shadcn-style component registry — `registry.json` at the repo root, `public/registry.json` (Next.js-hosted), or per-component `registry/*.json` files. Validates the minimal shadcn shape: each item must have `name` (string), `type` (e.g. \"registry:ui\") and a non-empty `files` array of `{ path, content?, type? }`. Optional fields (`dependencies`, `registryDependencies`, `tailwind`, `cssVars`) are not validated. When `components.json` exists but no registry is shipped, emits a warning for the missed AI-Consumable surface; malformed JSON or missing required fields are errors.",
+        helpUri: "https://github.com/lyse-labs/lyse/blob/main/docs/rules/ai-surface-shadcn-registry-valid.md",
+        rationale: `Why it matters
+
+A valid shadcn-style \`registry.json\` is the single most reliable signal that a design system is AI-Consumable today. The shadcn CLI uses it to install components into downstream apps; coding agents (Cursor, Claude, GPT) increasingly look for it to discover and pull components instead of scraping source files.
+
+Detection is conservative — we look for the canonical locations only (\`registry.json\`, \`public/registry.json\`, \`registry/*.json\`) and validate only the three required fields per the public shadcn schema. Optional fields like \`tailwind\` and \`cssVars\` vary across versions and are not part of the validity contract.
+
+A repo declaring \`components.json\` (the shadcn CLI marker) but no registry is a strong indicator the team is on the shadcn path but hasn't published the consumable surface — that's a warning, not an error. Malformed JSON or items missing \`name\`/\`type\`/\`files\` will silently break the shadcn CLI and any agent consumer, so they are errors.`,
+        examples: [
+            {
+                good: '{ "name": "button", "type": "registry:ui", "files": [{ "path": "ui/button.tsx" }] }',
+                bad: '{ "name": "button", "type": "registry:ui" }',
+            },
+            {
+                good: '{ "items": [{ "name": "button", "type": "registry:ui", "files": [{ "path": "ui/button.tsx" }] }] }',
+                bad: '{ "items": [{ "name": "button" }] }',
+            },
+        ],
+        allowlist: [
+            "repos with no `components.json` AND no `registry.json` — rule is N/A",
+            "files larger than 4 MB — skipped to avoid pathological cases",
+            "files matching `ctx.excludePaths` config",
+            "disable in `.lyse.yaml`: `rules: { ai-surface/shadcn-registry-valid: off }`",
+        ],
+    },
+    defaultOptions: [],
+    create: () => ({ evaluate }),
+});
+export const _internal = {
+    validateRegistryItem,
+    looksLikeRegistryItem,
+    looksLikeRegistryCollection,
+    extractRegistryItems,
+    REGISTRY_CANDIDATES,
+};
+//# sourceMappingURL=ai-surface-shadcn-registry-valid.js.map

package/dist/rules/ai-surface-shadcn-registry-valid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-surface-shadcn-registry-valid.js","sourceRoot":"","sources":["../../src/rules/ai-surface-shadcn-registry-valid.ts"],"names":[],"mappings":"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"}

package/dist/rules/components-contracts-strictness.d.ts

@@ -0,0 +1,48 @@
+import type { Rule } from "../types.js";
+interface ComponentPropFinding {
+    componentName: string;
+    propName: string;
+    kind: "any" | "unknown" | "string-variant";
+    line: number;
+    column: number;
+}
+/**
+ * Walk a parsed .tsx/.jsx source for exported PascalCase component declarations
+ * and collect their typed prop violations.
+ *
+ * Resolves prop type references to same-file interface / type-alias declarations.
+ * Cross-file references are skipped (v0.1 limitation, mirrors loaders/components.ts).
+ */
+export declare function scanComponentContracts(source: string): {
+    findings: ComponentPropFinding[];
+    componentCount: number;
+};
+interface PackageJsonShape {
+    name?: unknown;
+    private?: unknown;
+    types?: unknown;
+    typings?: unknown;
+    main?: unknown;
+    module?: unknown;
+    exports?: unknown;
+}
+type PackageCheckOutcome = {
+    kind: "missing-types";
+} | {
+    kind: "types-points-to-missing-file";
+    typesPath: string;
+} | {
+    kind: "ok";
+    typesPath: string;
+};
+export declare function checkPackageJsonTypes(pkg: PackageJsonShape, packageDir: string): PackageCheckOutcome;
+declare function looksLikePublishablePackage(pkg: PackageJsonShape): boolean;
+export declare const rule: Rule;
+export declare const _internal: {
+    scanComponentContracts: typeof scanComponentContracts;
+    checkPackageJsonTypes: typeof checkPackageJsonTypes;
+    looksLikePublishablePackage: typeof looksLikePublishablePackage;
+    VARIANT_PROP_RE: RegExp;
+    FRAMEWORK_ALLOWED_PROPS: Set<string>;
+};
+export {};