@neuledge/context 1.2.0 → 1.2.1

package/dist/store.d.ts

@@ -12,22 +12,47 @@ export interface PackageInfo extends PackageMeta {
 }
 /** Create a filesystem-safe filename for an installed package database. */
 export declare function getPackageFileName(name: string, version: string): string;
+/** Identity of an installed package, and the spec users type: `name@version`. */
+export declare function packageKey(pkg: PackageMeta): string;
+/**
+ * Match a package against a `--libs` allow-list holding bare names (every
+ * installed version) and `name@version` keys (that version only).
+ */
+export declare function isAllowedLibrary(pkg: PackageMeta, allowed: ReadonlySet<string>): boolean;
+/**
+ * Order two version strings, lowest first.
+ *
+ * Rules, all chosen so a bare-name lookup lands on the version a user expects:
+ * - segments compare as numbers, so `1.15.9` < `1.15.10` (text order gets this
+ *   backwards — the bug behind #102);
+ * - a missing segment counts as zero, so `1.2` and `1.2.0` are the same release;
+ * - a prerelease sorts below its release (`2.0.0-rc.1` < `2.0.0`); two
+ *   prereleases compare as text;
+ * - versions with no numeric part (`latest`, `main`) sort below every numeric
+ *   version, so a floating label never hides a real release;
+ * - anything still tied falls back to text, so results never depend on
+ *   insertion or filesystem order.
+ */
+export declare function compareVersions(a: string, b: string): number;
 /**
  * Registry of documentation packages.
  * Manages an in-memory list of packages without file system operations.
  */
 export declare class PackageStore {
     private packages;
-    /** Add a package to the registry. */
+    /** Add a package to the registry. Replaces the same name@version only. */
     add(info: PackageInfo): void;
-    /** Remove a package from the registry by name. Returns true if removed. */
-    remove(name: string): boolean;
-    /** Get all registered packages. */
+    /** Remove a package resolved from `spec` (see `get`). Returns true if removed. */
+    remove(spec: string): boolean;
+    /** Get all registered packages, grouped by name with the highest version first. */
     list(): PackageInfo[];
-    /** Get a package by name. */
-    get(name: string): PackageInfo | null;
-    /** Open a package database for searching. */
-    openDb(name: string): DatabaseConnection | null;
+    /**
+     * Get a package by spec: `name@version` returns that exact version, a bare
+     * `name` returns the highest installed version.
+     */
+    get(spec: string): PackageInfo | null;
+    /** Open a package database for searching. Accepts the same specs as `get`. */
+    openDb(spec: string): DatabaseConnection | null;
 }
 /** Read package info from a database file. */
 export declare function readPackageInfo(packagePath: string): PackageInfo;

package/dist/store.js

@@ -7,31 +7,114 @@ export function getPackageFileName(name, version) {
     const safeVersion = version.replaceAll("/", "__");
     return `${safeName}@${safeVersion}.db`;
 }
+/** Identity of an installed package, and the spec users type: `name@version`. */
+export function packageKey(pkg) {
+    return `${pkg.name}@${pkg.version}`;
+}
+/**
+ * Match a package against a `--libs` allow-list holding bare names (every
+ * installed version) and `name@version` keys (that version only).
+ */
+export function isAllowedLibrary(pkg, allowed) {
+    return allowed.has(pkg.name) || allowed.has(packageKey(pkg));
+}
+/** Numeric segments of a version plus its prerelease suffix, or null if not numeric. */
+function parseVersionParts(version) {
+    const core = version.startsWith("v") ? version.slice(1) : version;
+    const dash = core.indexOf("-");
+    const segments = (dash === -1 ? core : core.slice(0, dash)).split(".");
+    if (!segments.every((s) => /^\d+$/.test(s)))
+        return null;
+    return {
+        numbers: segments.map((s) => Number.parseInt(s, 10)),
+        prerelease: dash === -1 ? "" : core.slice(dash + 1),
+    };
+}
+function compareText(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+/**
+ * Order two version strings, lowest first.
+ *
+ * Rules, all chosen so a bare-name lookup lands on the version a user expects:
+ * - segments compare as numbers, so `1.15.9` < `1.15.10` (text order gets this
+ *   backwards — the bug behind #102);
+ * - a missing segment counts as zero, so `1.2` and `1.2.0` are the same release;
+ * - a prerelease sorts below its release (`2.0.0-rc.1` < `2.0.0`); two
+ *   prereleases compare as text;
+ * - versions with no numeric part (`latest`, `main`) sort below every numeric
+ *   version, so a floating label never hides a real release;
+ * - anything still tied falls back to text, so results never depend on
+ *   insertion or filesystem order.
+ */
+export function compareVersions(a, b) {
+    const partsA = parseVersionParts(a);
+    const partsB = parseVersionParts(b);
+    if (!partsA || !partsB) {
+        if (partsA)
+            return 1;
+        if (partsB)
+            return -1;
+        return compareText(a, b);
+    }
+    const length = Math.max(partsA.numbers.length, partsB.numbers.length);
+    for (let i = 0; i < length; i++) {
+        const diff = (partsA.numbers[i] ?? 0) - (partsB.numbers[i] ?? 0);
+        if (diff !== 0)
+            return diff;
+    }
+    if (partsA.prerelease !== partsB.prerelease) {
+        if (!partsA.prerelease)
+            return 1;
+        if (!partsB.prerelease)
+            return -1;
+        return compareText(partsA.prerelease, partsB.prerelease);
+    }
+    return compareText(a, b);
+}
 /**
  * Registry of documentation packages.
  * Manages an in-memory list of packages without file system operations.
  */
 export class PackageStore {
+    // Keyed by `name@version`: several versions of the same package can be
+    // installed side by side, and each one has to stay addressable.
     packages = new Map();
-    /** Add a package to the registry. */
+    /** Add a package to the registry. Replaces the same name@version only. */
     add(info) {
-        this.packages.set(info.name, info);
+        this.packages.set(packageKey(info), info);
     }
-    /** Remove a package from the registry by name. Returns true if removed. */
-    remove(name) {
-        return this.packages.delete(name);
+    /** Remove a package resolved from `spec` (see `get`). Returns true if removed. */
+    remove(spec) {
+        const pkg = this.get(spec);
+        if (!pkg)
+            return false;
+        return this.packages.delete(packageKey(pkg));
     }
-    /** Get all registered packages. */
+    /** Get all registered packages, grouped by name with the highest version first. */
     list() {
-        return [...this.packages.values()].sort((a, b) => a.name.localeCompare(b.name));
+        return [...this.packages.values()].sort((a, b) => a.name.localeCompare(b.name) || compareVersions(b.version, a.version));
     }
-    /** Get a package by name. */
-    get(name) {
-        return this.packages.get(name) ?? null;
+    /**
+     * Get a package by spec: `name@version` returns that exact version, a bare
+     * `name` returns the highest installed version.
+     */
+    get(spec) {
+        const exact = this.packages.get(spec);
+        if (exact)
+            return exact;
+        let best = null;
+        for (const pkg of this.packages.values()) {
+            if (pkg.name !== spec)
+                continue;
+            if (!best || compareVersions(pkg.version, best.version) > 0)
+                best = pkg;
+        }
+        return best;
     }
-    /** Open a package database for searching. */
-    openDb(name) {
-        const pkg = this.packages.get(name);
+    /** Open a package database for searching. Accepts the same specs as `get`. */
+    openDb(spec) {
+        const pkg = this.get(spec);
         if (!pkg)
             return null;
         return openDatabase(pkg.path, { readonly: true });

package/dist/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAA2B,YAAY,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAe/E,2EAA2E;AAC3E,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,OAAe;IAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAClD,OAAO,GAAG,QAAQ,IAAI,WAAW,KAAK,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,YAAY;IACf,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAElD,qCAAqC;IACrC,GAAG,CAAC,IAAiB;QACnB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,2EAA2E;IAC3E,MAAM,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,mCAAmC;IACnC,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC/C,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAC7B,CAAC;IACJ,CAAC;IAED,6BAA6B;IAC7B,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IACzC,CAAC;IAED,6CAA6C;IAC7C,MAAM,CAAC,IAAY;QACjB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;CACF;AAED,8CAA8C;AAC9C,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,MAAM,EAAE,GAAG,YAAY,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC;QACH,qBAAqB,CAAC,EAAE,CAAC,CAAC;QAE1B,MAAM,IAAI,GAAG,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,YAAY,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAE5C,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QAED,OAAO;YACL,IAAI;YACJ,OAAO;YACP,WAAW,EAAE,YAAY,CAAC,EAAE,EAAE,aAAa,CAAC;YAC5C,SAAS,EAAE,YAAY,CAAC,EAAE,EAAE,YAAY,CAAC;YACzC,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,IAAI;YACrC,YAAY,EAAE,eAAe,CAAC,EAAE,CAAC;SAClC,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neuledge/context",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "mcpName": "io.github.neuledge/context",
   "description": "Context management for Neuledge packages",
   "keywords": [],