@kilnai/tools 1.0.1

package/README.md

@@ -0,0 +1,6 @@
+# @kilnai/tools
+
+Platform-aware resolver for Kiln vendored developer tool binaries.
+
+This package resolves candidate platform packages for `rg`, `fd`, and `jq`.
+It does not execute binaries and does not modify runtime tool selection by itself.

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+declare const VENDORED_TOOLS: readonly ["rg", "fd", "jq"];
+export type VendoredToolBinary = (typeof VENDORED_TOOLS)[number];
+export interface VendoredPlatformPackageDescriptor {
+    readonly packageName: string;
+    readonly platform: string;
+    readonly arch: string;
+    readonly binaries: readonly VendoredToolBinary[];
+}
+export interface ResolvedVendoredPlatformPackage extends VendoredPlatformPackageDescriptor {
+    readonly packageJsonPath: string;
+}
+export interface VendoredPackageTarget {
+    readonly platform: string;
+    readonly arch: string;
+}
+export interface ResolveVendoredPackageOptions {
+    readonly platform?: string;
+    readonly arch?: string;
+    readonly resolvePackageJson?: (specifier: string) => string;
+}
+export declare function listVendoredPlatformPackages(): readonly VendoredPlatformPackageDescriptor[];
+export declare function getVendoredPackageCandidates(target?: VendoredPackageTarget): readonly VendoredPlatformPackageDescriptor[];
+export declare function resolveVendoredPlatformPackage(options?: ResolveVendoredPackageOptions): ResolvedVendoredPlatformPackage | undefined;
+export {};
+//# 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":"AAGA,QAAA,MAAM,cAAc,6BAA8B,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAClD;AAED,MAAM,WAAW,+BAAgC,SAAQ,iCAAiC;IACxF,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CAC7D;AA6BD,wBAAgB,4BAA4B,IAAI,SAAS,iCAAiC,EAAE,CAE3F;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,GAAE,qBAA0E,GACjF,SAAS,iCAAiC,EAAE,CAU9C;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,GAAE,6BAAkC,GAC1C,+BAA+B,GAAG,SAAS,CAkB7C"}

package/dist/index.js

@@ -0,0 +1,59 @@
+import { createRequire } from "node:module";
+const requireFromHere = createRequire(import.meta.url);
+const VENDORED_TOOLS = ["rg", "fd", "jq"];
+const PLATFORM_PACKAGES = [
+    {
+        packageName: "@kilnai/tools-win32-x64",
+        platform: "win32",
+        arch: "x64",
+        binaries: VENDORED_TOOLS,
+    },
+    {
+        packageName: "@kilnai/tools-darwin-arm64",
+        platform: "darwin",
+        arch: "arm64",
+        binaries: VENDORED_TOOLS,
+    },
+    {
+        packageName: "@kilnai/tools-darwin-x64",
+        platform: "darwin",
+        arch: "x64",
+        binaries: VENDORED_TOOLS,
+    },
+    {
+        packageName: "@kilnai/tools-linux-x64",
+        platform: "linux",
+        arch: "x64",
+        binaries: VENDORED_TOOLS,
+    },
+];
+export function listVendoredPlatformPackages() {
+    return PLATFORM_PACKAGES;
+}
+export function getVendoredPackageCandidates(target = { platform: process.platform, arch: process.arch }) {
+    const preferred = PLATFORM_PACKAGES.filter((candidate) => candidate.platform === target.platform && candidate.arch === target.arch);
+    const remaining = PLATFORM_PACKAGES.filter((candidate) => candidate.platform !== target.platform || candidate.arch !== target.arch);
+    return [...preferred, ...remaining];
+}
+export function resolveVendoredPlatformPackage(options = {}) {
+    const platform = options.platform ?? process.platform;
+    const arch = options.arch ?? process.arch;
+    const resolvePackageJson = options.resolvePackageJson ?? defaultResolvePackageJson;
+    for (const candidate of getVendoredPackageCandidates({ platform, arch })) {
+        try {
+            const packageJsonPath = resolvePackageJson(`${candidate.packageName}/package.json`);
+            return {
+                ...candidate,
+                packageJsonPath,
+            };
+        }
+        catch {
+            // Continue probing candidates until one resolves.
+        }
+    }
+    return undefined;
+}
+function defaultResolvePackageJson(specifier) {
+    return requireFromHere.resolve(specifier);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvD,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AA0BnD,MAAM,iBAAiB,GAAiD;IACtE;QACE,WAAW,EAAE,yBAAyB;QACtC,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,KAAK;QACX,QAAQ,EAAE,cAAc;KACzB;IACD;QACE,WAAW,EAAE,4BAA4B;QACzC,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,cAAc;KACzB;IACD;QACE,WAAW,EAAE,0BAA0B;QACvC,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,KAAK;QACX,QAAQ,EAAE,cAAc;KACzB;IACD;QACE,WAAW,EAAE,yBAAyB;QACtC,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,KAAK;QACX,QAAQ,EAAE,cAAc;KACzB;CACO,CAAC;AAEX,MAAM,UAAU,4BAA4B;IAC1C,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,SAAgC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;IAElF,MAAM,SAAS,GAAG,iBAAiB,CAAC,MAAM,CACxC,CAAC,SAAS,EAAE,EAAE,CACZ,SAAS,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAC3E,CAAC;IACF,MAAM,SAAS,GAAG,iBAAiB,CAAC,MAAM,CACxC,CAAC,SAAS,EAAE,EAAE,CACZ,SAAS,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAC3E,CAAC;IACF,OAAO,CAAC,GAAG,SAAS,EAAE,GAAG,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,UAAyC,EAAE;IAE3C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACtD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAC1C,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,IAAI,yBAAyB,CAAC;IAEnF,KAAK,MAAM,SAAS,IAAI,4BAA4B,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACzE,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,kBAAkB,CAAC,GAAG,SAAS,CAAC,WAAW,eAAe,CAAC,CAAC;YACpF,OAAO;gBACL,GAAG,SAAS;gBACZ,eAAe;aAChB,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;QACpD,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,yBAAyB,CAAC,SAAiB;IAClD,OAAO,eAAe,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@kilnai/tools",
+  "version": "1.0.1",
+  "description": "Vendored developer tool binary resolver for Kiln",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sequelcore/kiln.git",
+    "directory": "packages/tools"
+  },
+  "homepage": "https://github.com/sequelcore/kiln/tree/main/packages/tools",
+  "keywords": [
+    "kiln",
+    "tools",
+    "ripgrep",
+    "fd",
+    "jq"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "optionalDependencies": {
+    "@kilnai/tools-darwin-arm64": "1.0.1",
+    "@kilnai/tools-darwin-x64": "1.0.1",
+    "@kilnai/tools-linux-x64": "1.0.1",
+    "@kilnai/tools-win32-x64": "1.0.1"
+  }
+}