chore: publish libpkgx to JSR as @pkgx/libpkgx

deno.land/x is read-only; new versions go to JSR.

- deno.json: name, version 0.23.0, exports (mod + deep paths)
- deps via import map (npm:is-what, npm:outdent, jsr:@std/*)
- explicit public API return types for JSR slow-type rules
- CI: publish-jsr.yml on release (OIDC, --allow-slow-types)
- lint: waive no-slow-types for remaining declare global
  prototype extensions (follow-up)
- README: JSR import example

Author: jhheider

.github/workflows/publish-jsr.yml

@@ -0,0 +1,28 @@
+name: publish·jsr
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+concurrency:
+  group: publish/jsr/${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+  id-token: write # OIDC for tokenless JSR publish
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: denoland/setup-deno@v2
+        with:
+          deno-version: v2.x
+      - name: dry-run
+        run: deno publish --dry-run --allow-slow-types --no-check --unstable-fs --unstable-ffi
+      - name: publish
+        if: github.event_name == 'release' || github.event_name == 'workflow_dispatch'
+        run: deno publish --allow-slow-types --no-check --unstable-fs --unstable-ffi

README.md

@@ -16,12 +16,14 @@ $ npm install libpkgx
 # ^^ https://npmjs.com/libpkgx
 ```
 
-Or with [Deno]:
+Or with [Deno] via [JSR](https://jsr.io):
 
 ```ts
-import * as pkgx from "https://deno.land/x/libpkgx/mod.ts"
+import * as pkgx from "jsr:@pkgx/libpkgx"
 ```
 
+> `deno.land/x/libpkgx` is frozen (registry is read-only). Use JSR for new versions.
+
 ## Usage
 
 ```ts

deno.json

@@ -1,25 +1,69 @@
 {
+  "name": "@pkgx/libpkgx",
+  "version": "0.23.0",
+  "license": "Apache-2.0",
+  "exports": {
+    ".": "./mod.ts",
+    "./hooks/useConfig.ts": "./src/hooks/useConfig.ts",
+    "./hooks/usePantry.ts": "./src/hooks/usePantry.ts",
+    "./utils/error.ts": "./src/utils/error.ts",
+    "./utils/host.ts": "./src/utils/host.ts",
+    "./utils/read-lines.ts": "./src/utils/read-lines.ts",
+    "./utils/semver.ts": "./src/utils/semver.ts",
+    "./plumbing/hydrate.ts": "./src/plumbing/hydrate.ts"
+  },
+  "publish": {
+    "include": [
+      "LICENSE.txt",
+      "README.md",
+      "mod.ts",
+      "src/**/*.ts",
+      "vendor/**"
+    ],
+    "exclude": [
+      "src/**/*.test.ts",
+      "src/hooks/useTestConfig.ts",
+      "fixtures",
+      "examples",
+      "scripts",
+      "dist",
+      ".github"
+    ]
+  },
   "compilerOptions": {
-    "allowJs": false,
     "strict": true
   },
   "pkgx": "deno~2.0",
   "tasks": {
     "test": "deno test --parallel --unstable-fs --unstable-ffi --allow-all",
-    "typecheck": "deno check ./mod.ts"
+    "typecheck": "deno check ./mod.ts",
+    "publish:dry": "deno publish --dry-run --allow-slow-types --no-check --allow-dirty --unstable-fs --unstable-ffi"
   },
   "lint": {
-    "include": ["src/"],
-    "exclude": ["**/*.test.ts"]
+    "include": ["src/", "mod.ts"],
+    "exclude": ["**/*.test.ts", "vendor/", "src/hooks/useTestConfig.ts"],
+    "rules": {
+      // Prototype extensions (Array.compact, Promise.swallow, etc.) use
+      // `declare global`, which JSR forbids without --allow-slow-types.
+      // Explicit public return types are fixed; globals are a larger refactor.
+      "exclude": ["no-slow-types"]
+    }
   },
   "test": {
     "include": ["src/"],
     "exclude": ["dist/"]
   },
   "imports": {
     "@std/assert": "jsr:@std/assert@^1.0.6",
+    "@std/crypto": "jsr:@std/crypto@^1",
+    "@std/encoding": "jsr:@std/encoding@^1",
+    "@std/fs": "jsr:@std/fs@^1",
+    "@std/io": "jsr:@std/io@^0.225.0",
+    "@std/io/write-all": "jsr:@std/io@^0.225.0/write-all",
+    "@std/path": "jsr:@std/path@^1",
     "@std/testing": "jsr:@std/testing@^1.0.3",
-    "is-what": "https://deno.land/x/is_what@v4.1.15/src/index.ts",
-    "outdent": "https://deno.land/x/outdent@v0.8.0/mod.ts"
+    "@std/yaml": "jsr:@std/yaml@^1",
+    "is-what": "npm:is-what@4.1.15",
+    "outdent": "npm:outdent@0.8.0"
   }
 }

mod.ts

@@ -1,7 +1,8 @@
 import "./src/utils/misc.ts"
 import { flatmap, validate } from "./src/utils/misc.ts"
 
-import host, { SupportedArchitecture, SupportedPlatform } from "./src/utils/host.ts"
+import host from "./src/utils/host.ts"
+import type { SupportedArchitecture, SupportedPlatform } from "./src/utils/host.ts"
 import SemVer, * as semver from "./src/utils/semver.ts"
 import Path from "./src/utils/Path.ts"
 

src/deps.ts

@@ -1,18 +1,18 @@
-import * as is_what from "https://deno.land/x/is_what@v4.1.15/src/index.ts"
+import * as is_what from "is-what"
 export { is_what }
 
-import { type PlainObject } from "https://deno.land/x/is_what@v4.1.15/src/index.ts"
+import type { PlainObject } from "is-what"
 export type { PlainObject }
 
-import * as outdent from "https://deno.land/x/outdent@v0.8.0/mod.ts"
+import * as outdent from "outdent"
 export { outdent }
 
 // importing super specifically to reduce final npm bundle size
-import * as crypto from "jsr:@std/crypto@1"
-import { moveSync } from "jsr:@std/fs@1"
-import { writeAll } from "jsr:@std/io@^0.225.0"
-import { parse as parseYaml, parseAll as parseYamlALL } from "jsr:@std/yaml@1"
-import { SEPARATOR as SEP, fromFileUrl } from "jsr:@std/path@1"
+import * as crypto from "@std/crypto"
+import { moveSync } from "@std/fs"
+import { writeAll } from "@std/io/write-all"
+import { parse as parseYaml, parseAll as parseYamlALL } from "@std/yaml"
+import { SEPARATOR as SEP, fromFileUrl } from "@std/path"
 
 const streams = { writeAll }
 const fs = { moveSync }

src/hooks/useCache.ts

@@ -1,12 +1,13 @@
-import { Stowage } from "../types.ts"
+import type { Stowage } from "../types.ts"
 import useConfig from "./useConfig.ts"
 import host from "../utils/host.ts"
+import type Path from "../utils/Path.ts"
 
-export default function useCache() {
+export default function useCache(): { path: (stowage: Stowage) => Path } {
   return { path }
 }
 
-const path = (stowage: Stowage) => {
+const path = (stowage: Stowage): Path => {
   const { pkg, type } = stowage
   const stem = pkg.project.replaceAll("/", "∕")
 

src/hooks/useCellar.ts

@@ -1,4 +1,4 @@
-import { Package, PackageRequirement, Installation } from "../types.ts"
+import type { Package, PackageRequirement, Installation } from "../types.ts"
 import { PkgxError } from "../utils/error.ts"
 import * as pkgutils from "../utils/pkg.ts"
 import SemVer from "../utils/semver.ts"
@@ -14,7 +14,15 @@ export class InstallationNotFoundError extends PkgxError {
   }
 }
 
-export default function useCellar() {
+export type UseCellar = {
+  has: (pkg: Package | PackageRequirement | Path) => Promise<Installation | undefined>
+  ls: (project: string) => Promise<Installation[]>
+  keg: (pkg: Package) => Path
+  resolve: (pkg: Package | PackageRequirement | Path | Installation) => Promise<Installation>
+  shelf: (project: string) => Path
+}
+
+export default function useCellar(): UseCellar {
   const config = useConfig()
 
   /// eg. ~/.pkgx/deno.land

src/hooks/useConfig.ts

@@ -49,7 +49,7 @@ function platform_data_home_default(home: Path, { LOCALAPPDATA }: { LOCALAPPDATA
 
 const SEP = Deno.build.os == 'windows' ? ';' : ':'
 
-export function ConfigDefault(env = Deno.env.toObject()): Config {
+export function ConfigDefault(env: Record<string, string> = Deno.env.toObject()): Config {
   const home = flatmap(env['PKGX_HOME'], x => new Path(x)) ?? Path.home()
   const prefix = flatmap(env['PKGX_DIR']?.trim(), x => new Path(x)) ??
     flatmap(env['XDG_DATA_HOME'], x => new Path(x).join("pkgx")) ??
@@ -115,7 +115,7 @@ function boolize(input: string | undefined): boolean | undefined {
   }
 }
 
-function initialized() {
+function initialized(): boolean {
   return gt.sh_pkgx_config !== undefined
 }
 

src/hooks/useDownload.ts

@@ -1,7 +1,7 @@
 import { deno } from "../deps.ts"
 const { crypto: crypto_, streams: { writeAll } } = deno
 const { crypto } = crypto_
-import { encodeHex } from "jsr:@std/encoding@1"
+import { encodeHex } from "@std/encoding"
 import { PkgxError, panic } from "../utils/error.ts"
 import useConfig from "./useConfig.ts"
 import useFetch from "./useFetch.ts"
@@ -80,7 +80,10 @@ function cache({ for: url }: {for: URL}): Path {
   }
 }
 
-export default function useDownload() {
+export default function useDownload(): {
+  download: typeof download
+  cache: typeof cache
+} {
   return {
     download,
     cache

src/hooks/useInventory.ts

@@ -1,4 +1,4 @@
-import { Package, PackageRequirement } from "../types.ts"
+import type { Package, PackageRequirement } from "../types.ts"
 import { DownloadError } from "./useDownload.ts"
 import SemVer from "../utils/semver.ts"
 import useFetch from "./useFetch.ts"
@@ -14,7 +14,7 @@ export interface Inventory {
   }
 }
 
-const select = async (rq: PackageRequirement | Package) => {
+const select = async (rq: PackageRequirement | Package): Promise<SemVer | undefined> => {
   const versions = await _internals.get(rq)
 
   if ("constraint" in rq) {
@@ -24,7 +24,7 @@ const select = async (rq: PackageRequirement | Package) => {
   }
 }
 
-const get = async (rq: PackageRequirement | Package) => {
+const get = async (rq: PackageRequirement | Package): Promise<SemVer[]> => {
   const { platform, arch } = host()
   const url = new URL(`${useConfig().dist}/${rq.project}/${platform}/${arch}/versions.txt`)
   const rsp = await useFetch(url)
@@ -47,7 +47,10 @@ const get = async (rq: PackageRequirement | Package) => {
   return versions
 }
 
-export default function useInventory() {
+export default function useInventory(): {
+  select: typeof select
+  get: typeof get
+} {
   return { select, get }
 }