@tyndall/lint 0.0.1

package/README.md

@@ -0,0 +1,28 @@
+# @tyndall/lint
+
+## Overview
+Lint and format execution package for Hyper tooling and scaffolding workflows.
+
+## Responsibilities
+- Provide `runLint` / `runFormat` programmatic APIs for Hyper CLI and scaffolding.
+- Build deterministic Biome command invocations from typed options.
+- Provide a resilient runtime path by falling back from `biome` to `bunx @biomejs/biome` when needed.
+
+## Public API Highlights
+- runLint
+- runFormat
+- `commandArgs` support for custom command prefixes (for example, `bunx --bun @biomejs/biome`).
+
+## Development
+- Build: bun run --filter @tyndall/lint build
+- Test (from workspace root): bun test
+
+## Documentation
+- Package specification: [spec.md](./spec.md)
+- Package architecture: [architecture.md](./architecture.md)
+- Package changes: [CHANGELOG.md](./CHANGELOG.md)
+
+## Maintenance Rules
+- Keep this document aligned with implemented package behavior.
+- Update spec.md and architecture.md whenever package contracts or design boundaries change.
+- Record user-visible package changes in CHANGELOG.md.

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+export interface LintOptions {
+    cwd: string;
+    fix?: boolean;
+    files?: string[];
+    command?: string;
+    commandArgs?: string[];
+    exec?: ExecFn;
+}
+export interface FormatOptions {
+    cwd: string;
+    write?: boolean;
+    files?: string[];
+    command?: string;
+    commandArgs?: string[];
+    exec?: ExecFn;
+}
+export interface ExecPayload {
+    command: string;
+    args: string[];
+    cwd: string;
+}
+export interface ExecResult {
+    code: number;
+    error?: Error;
+}
+export type ExecFn = (payload: ExecPayload) => Promise<ExecResult>;
+export interface LintResult extends ExecResult {
+    command: string;
+    args: string[];
+    cwd: string;
+}
+export declare const runLint: (options: LintOptions) => Promise<LintResult>;
+export declare const runFormat: (options: FormatOptions) => Promise<LintResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAEnE,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AA4DD,eAAO,MAAM,OAAO,GAAU,SAAS,WAAW,KAAG,OAAO,CAAC,UAAU,CAC5C,CAAC;AAE5B,eAAO,MAAM,SAAS,GAAU,SAAS,aAAa,KAAG,OAAO,CAAC,UAAU,CAC9C,CAAC"}

package/dist/index.js

@@ -0,0 +1,47 @@
+import { spawn } from "node:child_process";
+const BUNX_BIOME_FALLBACK = {
+    command: "bunx",
+    commandArgs: ["--bun", "@biomejs/biome"],
+};
+const buildArgs = (mode, options) => {
+    const args = [...(options.commandArgs ?? []), mode];
+    if (mode === "lint" && options.fix) {
+        args.push("--fix");
+    }
+    if (mode === "format" && options.write) {
+        args.push("--write");
+    }
+    // Default to the current working directory when no files are specified.
+    const files = options.files && options.files.length > 0 ? options.files : ["."];
+    args.push(...files);
+    return args;
+};
+const defaultExec = async ({ command, args, cwd }) => new Promise((resolve) => {
+    const child = spawn(command, args, { cwd, stdio: "inherit" });
+    child.once("error", (error) => {
+        const code = error.code === "ENOENT" ? 127 : 1;
+        resolve({ code, error });
+    });
+    child.once("exit", (code) => resolve({ code: code ?? 0 }));
+});
+const runBiome = async (mode, options) => {
+    const exec = options.exec ?? defaultExec;
+    const canFallbackToBunx = options.command === undefined && options.commandArgs === undefined;
+    let command = options.command ?? "biome";
+    let args = buildArgs(mode, options);
+    let result = await exec({ command, args, cwd: options.cwd });
+    if (result.code === 127 && canFallbackToBunx) {
+        command = BUNX_BIOME_FALLBACK.command;
+        args = buildArgs(mode, { ...options, commandArgs: BUNX_BIOME_FALLBACK.commandArgs });
+        result = await exec({ command, args, cwd: options.cwd });
+    }
+    return {
+        command,
+        args,
+        cwd: options.cwd,
+        code: result.code,
+        error: result.error,
+    };
+};
+export const runLint = async (options) => runBiome("lint", options);
+export const runFormat = async (options) => runBiome("format", options);

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@tyndall/lint",
+  "version": "0.0.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "bunx --bun @biomejs/biome lint .",
+    "format": "bunx --bun @biomejs/biome format --write ."
+  }
+}