@tyndall/oxc 0.0.2

package/README.md

@@ -0,0 +1,28 @@
+# @tyndall/oxc
+
+## Overview
+Shared OXC lint/format execution utilities for Hyper tooling.
+
+## Responsibilities
+- Provide `runLint` / `runFormat` programmatic APIs that invoke `oxlint` and `oxfmt`.
+- Translate typed options into deterministic CLI arguments.
+- Fall back to `bunx --bun oxlint` / `bunx --bun oxfmt` when binaries are missing.
+
+## Public API Highlights
+- runLint
+- runFormat
+- `commandArgs` support for custom command prefixes (for example, `bunx --bun oxlint`).
+
+## Development
+- Build: bun run --filter @tyndall/oxc 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;AA0FD,eAAO,MAAM,OAAO,GAAU,SAAS,WAAW,KAAG,OAAO,CAAC,UAAU,CAAwB,CAAC;AAEhG,eAAO,MAAM,SAAS,GAAU,SAAS,aAAa,KAAG,OAAO,CAAC,UAAU,CAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,75 @@
+import { spawn } from "node:child_process";
+const BUNX_OXLINT_FALLBACK = {
+    command: "bunx",
+    commandArgs: ["--bun", "oxlint"],
+};
+const BUNX_OXFMT_FALLBACK = {
+    command: "bunx",
+    commandArgs: ["--bun", "oxfmt"],
+};
+const buildLintArgs = (options) => {
+    const args = [...(options.commandArgs ?? [])];
+    if (options.fix) {
+        args.push("--fix");
+    }
+    const files = options.files && options.files.length > 0 ? options.files : ["."];
+    args.push(...files);
+    return args;
+};
+const buildFormatArgs = (options) => {
+    const args = [...(options.commandArgs ?? [])];
+    if (!options.write) {
+        args.push("--check");
+    }
+    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 runOxcLint = async (options) => {
+    const exec = options.exec ?? defaultExec;
+    const canFallbackToBunx = options.command === undefined && options.commandArgs === undefined;
+    let command = options.command ?? "oxlint";
+    let args = buildLintArgs(options);
+    let result = await exec({ command, args, cwd: options.cwd });
+    if (result.code === 127 && canFallbackToBunx) {
+        command = BUNX_OXLINT_FALLBACK.command;
+        args = buildLintArgs({ ...options, commandArgs: BUNX_OXLINT_FALLBACK.commandArgs });
+        result = await exec({ command, args, cwd: options.cwd });
+    }
+    return {
+        command,
+        args,
+        cwd: options.cwd,
+        code: result.code,
+        error: result.error,
+    };
+};
+const runOxcFormat = async (options) => {
+    const exec = options.exec ?? defaultExec;
+    const canFallbackToBunx = options.command === undefined && options.commandArgs === undefined;
+    let command = options.command ?? "oxfmt";
+    let args = buildFormatArgs(options);
+    let result = await exec({ command, args, cwd: options.cwd });
+    if (result.code === 127 && canFallbackToBunx) {
+        command = BUNX_OXFMT_FALLBACK.command;
+        args = buildFormatArgs({ ...options, commandArgs: BUNX_OXFMT_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) => runOxcLint(options);
+export const runFormat = async (options) => runOxcFormat(options);

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@tyndall/oxc",
+  "version": "0.0.2",
+  "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": "oxlint .",
+    "format": "oxfmt ."
+  },
+  "dependencies": {
+    "oxfmt": "^0.35.0",
+    "oxlint": "^1.50.0"
+  }
+}