dslinter 0.0.12 → 0.0.26

package/src/components/Section.tsx

@@ -1,3 +1,5 @@
+import type { ReactNode } from "react";
+
 export function Section({
   id,
   children,
@@ -6,10 +8,10 @@ export function Section({
   actions,
 }: {
   id: string;
-  children: React.ReactNode;
+  children: ReactNode;
   title: string;
   description: string;
-  actions?: React.ReactNode;
+  actions?: ReactNode;
 }) {
   return (
     <section id={id} className="scroll-mt-20">

package/src/components/playgroundUsageHighlight.ts

@@ -6,15 +6,6 @@ import { createJavaScriptRegexEngine } from "shiki/engine/javascript";
 const THEME = "github-dark";
 const LANG = "tsx";
 
-/** When true, run Twoslash (CDN ATA + hover) before highlighting. */
-export function usageSnippetNeedsTwoslash(source: string): boolean {
-  return (
-    /\^\?/.test(source) ||
-    /\/\/\s*@(?:errors|error|log|warn|filename|noErrors)/m.test(source) ||
-    /\/\/\s*---cut---/.test(source)
-  );
-}
-
 let highlighterPromise: Promise<HighlighterCore> | null = null;
 
 function getHighlighter(): Promise<HighlighterCore> {
@@ -32,22 +23,12 @@ function assertNotAborted(signal: AbortSignal | undefined): void {
   if (signal?.aborted) throw new DOMException("Aborted", "AbortError");
 }
 
-/**
- * Renders usage source to Shiki HTML. Twoslash runs only when {@link usageSnippetNeedsTwoslash} is true
- * (loaded in a separate async chunk so the default bundle stays smaller).
- */
+/** Renders usage source to Shiki HTML. */
 export async function renderPlaygroundUsageHtml(
   source: string,
   signal?: AbortSignal,
 ): Promise<string> {
   const highlighter = await getHighlighter();
   assertNotAborted(signal);
-
-  if (!usageSnippetNeedsTwoslash(source)) {
-    return highlighter.codeToHtml(source, { lang: LANG, theme: THEME });
-  }
-
-  const { renderUsageWithTwoslash } = await import("./playgroundUsageTwoslash");
-  assertNotAborted(signal);
-  return renderUsageWithTwoslash(highlighter, source, signal);
+  return highlighter.codeToHtml(source, { lang: LANG, theme: THEME });
 }

package/scripts/ensure-dslint.mjs

@@ -1,165 +0,0 @@
-/**
- * Best-effort download of the prebuilt `dslinter` CLI for this platform.
- * Used by postinstall and on first `dslinter` / `npx dslinter` invocation.
- */
-import { readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
-import { chmod, mkdir, stat } from "node:fs/promises";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import {
-  fetchReleasesForVersion,
-  pickReleaseAsset,
-} from "./github-release.mjs";
-import {
-  githubRepoFromPackage,
-  releaseAssetCandidateNames,
-  vendorBinaryPath,
-} from "./resolve-dslint-binary.mjs";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const defaultPackageRoot = join(__dirname, "..");
-
-async function pathExists(p) {
-  try {
-    await stat(p);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function readPackageVersion(packageRoot) {
-  const pkg = JSON.parse(
-    readFileSync(join(packageRoot, "package.json"), "utf8"),
-  );
-  return pkg.version;
-}
-
-function releaseRepo(packageRoot) {
-  const override = process.env.DSLINT_GITHUB_REPO?.trim();
-  if (override) return override;
-  return githubRepoFromPackage(packageRoot);
-}
-
-/**
- * @param {string} packageRoot
- * @param {{ quiet?: boolean }} [opts]
- * @returns {Promise<boolean>} true if vendored binary exists after this call
- */
-export async function ensureDslintBinary(packageRoot = defaultPackageRoot, opts = {}) {
-  const { quiet = false } = opts;
-  const log = quiet ? () => {} : console.warn.bind(console);
-  const verbose = process.env.DSLINT_VERBOSE === "1";
-
-  if (process.env.DSLINT_SKIP_DOWNLOAD === "1") {
-    return pathExists(vendorBinaryPath(packageRoot));
-  }
-
-  const dest = vendorBinaryPath(packageRoot);
-  if (await pathExists(dest)) return true;
-
-  const candidates = releaseAssetCandidateNames();
-  if (candidates.length === 0) {
-    log(
-      `[dslinter] No prebuilt scanner for ${process.platform}-${process.arch}.`,
-    );
-    return false;
-  }
-
-  const version = readPackageVersion(packageRoot);
-  const repo = releaseRepo(packageRoot);
-  const vendorDir = join(packageRoot, "vendor");
-  await mkdir(vendorDir, { recursive: true });
-  const tmp = `${dest}.part`;
-
-  let releases;
-  try {
-    releases = await fetchReleasesForVersion(repo, version);
-  } catch (err) {
-    log(
-      `[dslinter] Could not query GitHub releases for ${repo}: ${err instanceof Error ? err.message : err}`,
-    );
-    if (process.env.GITHUB_TOKEN || process.env.GH_TOKEN) {
-      log("  (token was set but request still failed — check repo access)");
-    } else {
-      log(
-        "  For private repos, set GITHUB_TOKEN or GH_TOKEN with read access to releases.",
-      );
-    }
-    return false;
-  }
-
-  if (releases.length === 0) {
-    log(
-      `[dslinter] No GitHub release found on ${repo} for v${version}.\n` +
-        `  Publish tag v${version} with workflow release-dslint-binaries.yml (assets: ${candidates.join(" or ")}).`,
-    );
-    return false;
-  }
-
-  for (const release of releases) {
-    const asset = pickReleaseAsset(release, candidates);
-    if (!asset) {
-      if (verbose) {
-        log(
-          `[dslinter] Release ${release.tag_name} has no asset in ${candidates.join(", ")} (has: ${release.assets.map((a) => a.name).join(", ") || "none"})`,
-        );
-      }
-      continue;
-    }
-
-    if (verbose) {
-      log(`[dslinter] Downloading ${asset.name} from ${release.tag_name}…`);
-    }
-
-    try {
-      const res = await fetch(asset.browser_download_url, { redirect: "follow" });
-      if (!res.ok) {
-        log(`[dslinter] Download failed (${res.status}): ${asset.browser_download_url}`);
-        continue;
-      }
-
-      const buf = Buffer.from(await res.arrayBuffer());
-      writeFileSync(tmp, buf);
-      try {
-        if (await pathExists(dest)) unlinkSync(dest);
-      } catch {
-        /* ignore */
-      }
-      renameSync(tmp, dest);
-      if (process.platform !== "win32") {
-        await chmod(dest, 0o755);
-      }
-      if (release.tag_name !== `v${version}` && !quiet) {
-        log(
-          `[dslinter] Installed scanner from release ${release.tag_name} (npm v${version}).`,
-        );
-      }
-      return true;
-    } catch (err) {
-      log(
-        `[dslinter] Could not download ${asset.name}: ${err instanceof Error ? err.message : err}`,
-      );
-      try {
-        unlinkSync(tmp);
-      } catch {
-        /* ignore */
-      }
-    }
-  }
-
-  log(
-    `[dslinter] Found releases on ${repo} but none include ${candidates.join(" or ")} for this platform.\n` +
-      `  Upload platform binaries via .github/workflows/release-dslint-binaries.yml, or set DSLINT_BIN.`,
-  );
-  return false;
-}
-
-const isMain =
-  process.argv[1] &&
-  fileURLToPath(import.meta.url) === process.argv[1];
-
-if (isMain) {
-  await ensureDslintBinary();
-  process.exit(0);
-}

package/scripts/github-release.mjs

@@ -1,109 +0,0 @@
-/**
- * Resolve GitHub release assets via the REST API (works with exact names + legacy names).
- */
-
-const API = "https://api.github.com";
-
-function apiHeaders() {
-  const headers = {
-    Accept: "application/vnd.github+json",
-    "User-Agent": "dslinter-npm",
-    "X-GitHub-Api-Version": "2022-11-28",
-  };
-  const token =
-    process.env.GITHUB_TOKEN?.trim() || process.env.GH_TOKEN?.trim();
-  if (token) headers.Authorization = `Bearer ${token}`;
-  return headers;
-}
-
-/**
- * @param {string} repo `owner/name`
- * @param {string} path
- */
-async function githubGet(repo, path) {
-  const res = await fetch(`${API}/repos/${repo}${path}`, {
-    headers: apiHeaders(),
-    redirect: "follow",
-  });
-  if (res.status === 404) return null;
-  if (!res.ok) {
-    const body = await res.text().catch(() => "");
-    throw new Error(`GitHub API ${res.status} for ${path}: ${body.slice(0, 200)}`);
-  }
-  return res.json();
-}
-
-/**
- * @param {string} repo
- * @param {string} tag e.g. `v0.0.11` or `latest`
- */
-export async function fetchRelease(repo, tag) {
-  if (tag === "latest") {
-    return githubGet(repo, "/releases/latest");
-  }
-  const byTag = await githubGet(repo, `/releases/tags/${encodeURIComponent(tag)}`);
-  if (byTag) return byTag;
-  // Some releases use tag without `v` prefix.
-  if (tag.startsWith("v")) {
-    return githubGet(repo, `/releases/tags/${encodeURIComponent(tag.slice(1))}`);
-  }
-  return null;
-}
-
-/**
- * @param {string} repo
- * @param {string} npmVersion e.g. `0.0.11`
- */
-export async function fetchReleasesForVersion(repo, npmVersion) {
-  const out = [];
-  const seen = new Set();
-
-  const push = (release) => {
-    if (!release?.assets?.length) return;
-    const key = release.id ?? release.tag_name;
-    if (seen.has(key)) return;
-    seen.add(key);
-    out.push(release);
-  };
-
-  push(await fetchRelease(repo, `v${npmVersion}`));
-  push(await fetchRelease(repo, npmVersion));
-  push(await fetchRelease(repo, "latest"));
-
-  if (out.length > 0) return out;
-
-  const list = await githubGet(repo, "/releases?per_page=30");
-  if (!Array.isArray(list)) return out;
-
-  for (const release of list) {
-    const tag = String(release.tag_name ?? "");
-    if (tag === `v${npmVersion}` || tag === npmVersion) {
-      push(release);
-    }
-  }
-  if (out.length > 0) return out;
-
-  // Newest release that has any scanner-looking asset.
-  for (const release of list) {
-    const names = release.assets?.map((a) => a.name) ?? [];
-    if (names.some((n) => n.startsWith("dslinter-") || n.startsWith("dslint-"))) {
-      push(release);
-      break;
-    }
-  }
-
-  return out;
-}
-
-/**
- * @param {string[]} candidateNames
- * @param {{ assets: { name: string; browser_download_url: string }[] }} release
- * @returns {{ name: string; browser_download_url: string } | null}
- */
-export function pickReleaseAsset(release, candidateNames) {
-  for (const name of candidateNames) {
-    const asset = release.assets.find((a) => a.name === name);
-    if (asset?.browser_download_url) return asset;
-  }
-  return null;
-}

package/scripts/print-missing-scanner.mjs

@@ -1,27 +0,0 @@
-import { readFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const packageRoot = join(dirname(fileURLToPath(import.meta.url)), "..");
-const version = JSON.parse(
-  readFileSync(join(packageRoot, "package.json"), "utf8"),
-).version;
-
-process.stderr.write(`dslinter: scanner binary not available.
-
-This npm package is NOT the same as \`cargo install dslint\` on crates.io (that is a
-different "design file" linter and will crash or misbehave).
-
-To run the design-system scanner:
-
-  1. Re-run after a GitHub release exists for v${version} (prebuilt download), or
-  2. Build from this repo and point at it:
-       cargo install --git https://github.com/jrmybtlr/DSLinter dslinter --locked
-       export DSLINT_BIN="$(command -v dslinter)"
-       npx dslinter ...
-  3. Or set DSLINT_BIN to your local target/release/dslinter
-
-Releases: https://github.com/jrmybtlr/DSLinter/releases
-
-Tip: re-run with DSLINT_VERBOSE=1 to see which GitHub releases/assets were tried.
-`);

package/scripts/resolve-dslint-binary.mjs

@@ -1,80 +0,0 @@
-import { readFileSync } from "node:fs";
-import { join } from "node:path";
-
-/** CLI binary name (avoids collision with unrelated `dslint` on crates.io). */
-export const CLI_BINARY_NAME = "dslinter";
-
-/** Fallback when package.json has no parseable `repository` field. */
-export const DEFAULT_GITHUB_REPO = "jrmybtlr/DSLinter";
-
-/**
- * @param {string | { type?: string; url?: string } | undefined} repository
- * @returns {string | null} `owner/repo`
- */
-export function parseGitHubRepo(repository) {
-  if (!repository) return null;
-  const url = typeof repository === "string" ? repository : repository.url;
-  if (!url) return null;
-  const m = String(url).match(/github\.com[/:]([^/]+)\/([^/.]+?)(?:\.git)?\/?$/i);
-  return m ? `${m[1]}/${m[2]}` : null;
-}
-
-/**
- * @param {string} packageRoot
- */
-export function githubRepoFromPackage(packageRoot) {
-  try {
-    const pkg = JSON.parse(
-      readFileSync(join(packageRoot, "package.json"), "utf8"),
-    );
-    return parseGitHubRepo(pkg.repository) ?? DEFAULT_GITHUB_REPO;
-  } catch {
-    return DEFAULT_GITHUB_REPO;
-  }
-}
-
-/**
- * Maps the current OS/arch to the GitHub release asset basename (must match CI upload names).
- * @param {NodeJS.Process} [proc]
- * @returns {string | null}
- */
-export function releaseAssetBaseName(proc = process) {
-  const { platform, arch } = proc;
-  if (platform === "darwin" && arch === "arm64") {
-    return "dslinter-aarch64-apple-darwin";
-  }
-  if (platform === "darwin" && arch === "x64") {
-    return "dslinter-x86_64-apple-darwin";
-  }
-  if (platform === "linux" && arch === "x64") {
-    return "dslinter-x86_64-unknown-linux-gnu";
-  }
-  if (platform === "linux" && arch === "arm64") {
-    return "dslinter-aarch64-unknown-linux-gnu";
-  }
-  if (platform === "win32" && arch === "x64") {
-    return "dslinter-x86_64-pc-windows-msvc.exe";
-  }
-  return null;
-}
-
-/** Primary GitHub asset name plus legacy `dslint-*` names from older releases. */
-export function releaseAssetCandidateNames(proc = process) {
-  const primary = releaseAssetBaseName(proc);
-  if (!primary) return [];
-  const legacy = primary.replace(/^dslinter/, "dslint");
-  return legacy === primary ? [primary] : [primary, legacy];
-}
-
-/**
- * @param {string} packageRoot — directory containing package.json
- * @param {NodeJS.Process} [proc]
- */
-export function vendorBinaryPath(packageRoot, proc = process) {
-  const name =
-    proc.platform === "win32" ? `${CLI_BINARY_NAME}.exe` : CLI_BINARY_NAME;
-  return join(packageRoot, "vendor", name);
-}
-
-/** Our scanner prints this in `dslinter --version` help output (clap about line). */
-export const SCANNER_VERSION_MARKER = "design system linting";

package/src/resolve-dslint-binary.test.ts

@@ -1,101 +0,0 @@
-import { join } from "node:path";
-import { describe, expect, it } from "vitest";
-import {
-  pickReleaseAsset,
-} from "../scripts/github-release.mjs";
-import {
-  CLI_BINARY_NAME,
-  DEFAULT_GITHUB_REPO,
-  parseGitHubRepo,
-  releaseAssetBaseName,
-  releaseAssetCandidateNames,
-  vendorBinaryPath,
-} from "../scripts/resolve-dslint-binary.mjs";
-
-function proc(platform: string, arch: string): NodeJS.Process {
-  return { platform, arch } as NodeJS.Process;
-}
-
-describe("parseGitHubRepo", () => {
-  it("parses https repository url", () => {
-    expect(
-      parseGitHubRepo("https://github.com/jrmybtlr/DSLinter.git"),
-    ).toBe("jrmybtlr/DSLinter");
-  });
-
-  it("parses repository object", () => {
-    expect(
-      parseGitHubRepo({
-        type: "git",
-        url: "git+https://github.com/jrmybtlr/DSLinter.git",
-      }),
-    ).toBe("jrmybtlr/DSLinter");
-  });
-
-  it("defaults constant points at DSLinter", () => {
-    expect(DEFAULT_GITHUB_REPO).toBe("jrmybtlr/DSLinter");
-  });
-});
-
-describe("releaseAssetCandidateNames", () => {
-  it("includes legacy dslint asset name", () => {
-    expect(releaseAssetCandidateNames(proc("darwin", "arm64"))).toEqual([
-      "dslinter-aarch64-apple-darwin",
-      "dslint-aarch64-apple-darwin",
-    ]);
-  });
-});
-
-describe("pickReleaseAsset", () => {
-  it("prefers primary name then legacy", () => {
-    const release = {
-      assets: [
-        {
-          name: "dslint-aarch64-apple-darwin",
-          browser_download_url: "https://example.com/legacy",
-        },
-      ],
-    };
-    expect(
-      pickReleaseAsset(release, releaseAssetCandidateNames(proc("darwin", "arm64"))),
-    ).toMatchObject({ name: "dslint-aarch64-apple-darwin" });
-  });
-});
-
-describe("releaseAssetBaseName", () => {
-  it("maps darwin arm64", () => {
-    expect(releaseAssetBaseName(proc("darwin", "arm64"))).toBe(
-      "dslinter-aarch64-apple-darwin",
-    );
-  });
-
-  it("maps linux x64", () => {
-    expect(releaseAssetBaseName(proc("linux", "x64"))).toBe(
-      "dslinter-x86_64-unknown-linux-gnu",
-    );
-  });
-
-  it("maps win32 x64", () => {
-    expect(releaseAssetBaseName(proc("win32", "x64"))).toBe(
-      "dslinter-x86_64-pc-windows-msvc.exe",
-    );
-  });
-
-  it("returns null for unknown", () => {
-    expect(releaseAssetBaseName(proc("freebsd", "x64"))).toBeNull();
-  });
-});
-
-describe("vendorBinaryPath", () => {
-  it("uses dslinter.exe on Windows", () => {
-    expect(vendorBinaryPath(join("/", "pkg"), proc("win32", "x64"))).toBe(
-      join("/", "pkg", "vendor", `${CLI_BINARY_NAME}.exe`),
-    );
-  });
-
-  it("uses dslinter on Unix", () => {
-    expect(vendorBinaryPath(join("/", "pkg"), proc("linux", "x64"))).toBe(
-      join("/", "pkg", "vendor", CLI_BINARY_NAME),
-    );
-  });
-});