@vltpkg/query 0.0.0-8 → 1.0.0-rc.1

package/dist/esm/pseudo/path.d.ts

@@ -0,0 +1,19 @@
+import type { ParserState } from '../types.ts';
+/**
+ * Normalizes a path by trimming whitespace and removing leading './' or '.' prefix.
+ * This ensures consistent path comparison regardless of how paths are specified.
+ */
+export declare function normalizePath(path: string): string;
+/**
+ * Creates a path matcher function that tests if
+ * a given path matches a glob pattern.
+ */
+export declare function createPathMatcher(pattern: string, loose?: boolean): (path: string) => boolean;
+/**
+ * :path("glob") Pseudo-Selector will match only workspace & file
+ * nodes whose file path matches the provided glob pattern relative
+ * to the project root. Path patterns must be quoted strings to avoid
+ * parser conflicts with special characters.
+ */
+export declare const path: (state: ParserState) => Promise<ParserState>;
+//# sourceMappingURL=path.d.ts.map

package/dist/esm/pseudo/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/pseudo/path.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAclD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,UAAQ,UAIhD,MAAM,aAwBrB;AAED;;;;;GAKG;AACH,eAAO,MAAM,IAAI,UAAiB,WAAW,yBAsE5C,CAAA"}

package/dist/esm/pseudo/path.js

@@ -0,0 +1,113 @@
+import { minimatch } from 'minimatch';
+import { error } from '@vltpkg/error-cause';
+import { splitDepID } from '@vltpkg/dep-id/browser';
+import { asError } from '@vltpkg/types';
+import { asPostcssNodeWithChildren, asStringNode, isStringNode, } from '@vltpkg/dss-parser';
+import { removeNode, removeDanglingEdges, removeQuotes, clear, } from "./helpers.js";
+/**
+ * Normalizes a path by trimming whitespace and removing leading './' or '.' prefix.
+ * This ensures consistent path comparison regardless of how paths are specified.
+ */
+export function normalizePath(path) {
+    const trimmed = path.trim();
+    // Handle root path case - normalize '.' to empty string for consistency
+    if (trimmed === '.') {
+        return '';
+    }
+    // Remove leading './' prefix
+    if (trimmed.startsWith('./')) {
+        return trimmed.slice(2);
+    }
+    return trimmed;
+}
+/**
+ * Creates a path matcher function that tests if
+ * a given path matches a glob pattern.
+ */
+export function createPathMatcher(pattern, loose = false) {
+    const normalizedPattern = normalizePath(pattern);
+    const isRoot = normalizedPattern === '' || pattern.trim() === '.';
+    return (path) => {
+        const normalizedPath = normalizePath(path);
+        if (isRoot) {
+            return normalizedPath === '' || normalizedPath === '.';
+        }
+        try {
+            return minimatch(normalizedPath, normalizedPattern, {
+                dot: true,
+                nocase: false,
+                matchBase: normalizedPattern === '*',
+            });
+        }
+        catch (err) {
+            // In loose mode, return false for invalid patterns
+            if (loose) {
+                return false;
+            }
+            // In strict mode, throw an error
+            throw error('Invalid glob pattern in :path selector', asError(err));
+        }
+    };
+}
+/**
+ * :path("glob") Pseudo-Selector will match only workspace & file
+ * nodes whose file path matches the provided glob pattern relative
+ * to the project root. Path patterns must be quoted strings to avoid
+ * parser conflicts with special characters.
+ */
+export const path = async (state) => {
+    // Extract path container and handle empty parameters
+    const pathContainer = asPostcssNodeWithChildren(state.current);
+    if (!pathContainer.nodes[0]) {
+        return clear(state);
+    }
+    // Extract the selector node and handle empty selectors
+    const selector = asPostcssNodeWithChildren(pathContainer.nodes[0]);
+    if (!selector.nodes[0]) {
+        return clear(state);
+    }
+    // Extract and validate the path pattern
+    let pathPattern = '';
+    if (isStringNode(selector.nodes[0])) {
+        pathPattern = removeQuotes(asStringNode(selector.nodes[0]).value);
+    }
+    else {
+        if (state.loose) {
+            return clear(state);
+        }
+        throw error('Failed to parse path pattern in :path selector', new Error('Path pattern must be a quoted string'));
+    }
+    // If no pattern provided, match nothing
+    if (!pathPattern) {
+        return clear(state);
+    }
+    // Check for unmatched brackets
+    if (pathPattern === '[' ||
+        (pathPattern.includes('[') && !pathPattern.includes(']'))) {
+        if (state.loose) {
+            return clear(state);
+        }
+        throw error('Invalid glob pattern in :path selector', new Error(`Unmatched bracket in pattern: ${pathPattern}`));
+    }
+    // Create path matcher function
+    const matchPath = createPathMatcher(pathPattern, state.loose);
+    // Filter nodes by path
+    for (const node of state.partial.nodes) {
+        /* c8 ignore next */
+        const nodePath = node.location || '';
+        const [type] = splitDepID(node.id);
+        // Special case for main importer with root path pattern
+        if (pathPattern === '.' && node.mainImporter) {
+            continue; // Keep main importer node for root path pattern
+        }
+        // Only match workspace or file nodes with matching paths
+        const pathBased = type === 'workspace' || type === 'file';
+        if (!pathBased || !matchPath(nodePath)) {
+            removeNode(state, node);
+        }
+    }
+    // Clean up any dangling edges
+    removeDanglingEdges(state);
+    return state;
+};
+//# sourceMappingURL=path.js.map

package/dist/esm/pseudo/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../../src/pseudo/path.ts"],"names":[],"mappings":"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","sourcesContent":["import { minimatch } from 'minimatch'\nimport { error } from '@vltpkg/error-cause'\nimport { splitDepID } from '@vltpkg/dep-id/browser'\nimport { asError } from '@vltpkg/types'\nimport {\n  asPostcssNodeWithChildren,\n  asStringNode,\n  isStringNode,\n} from '@vltpkg/dss-parser'\nimport {\n  removeNode,\n  removeDanglingEdges,\n  removeQuotes,\n  clear,\n} from './helpers.ts'\nimport type { ParserState } from '../types.ts'\n\n/**\n * Normalizes a path by trimming whitespace and removing leading './' or '.' prefix.\n * This ensures consistent path comparison regardless of how paths are specified.\n */\nexport function normalizePath(path: string): string {\n  const trimmed = path.trim()\n\n  // Handle root path case - normalize '.' to empty string for consistency\n  if (trimmed === '.') {\n    return ''\n  }\n\n  // Remove leading './' prefix\n  if (trimmed.startsWith('./')) {\n    return trimmed.slice(2)\n  }\n\n  return trimmed\n}\n\n/**\n * Creates a path matcher function that tests if\n * a given path matches a glob pattern.\n */\nexport function createPathMatcher(pattern: string, loose = false) {\n  const normalizedPattern = normalizePath(pattern)\n  const isRoot = normalizedPattern === '' || pattern.trim() === '.'\n\n  return (path: string) => {\n    const normalizedPath = normalizePath(path)\n\n    if (isRoot) {\n      return normalizedPath === '' || normalizedPath === '.'\n    }\n    try {\n      return minimatch(normalizedPath, normalizedPattern, {\n        dot: true,\n        nocase: false,\n        matchBase: normalizedPattern === '*',\n      })\n    } catch (err) {\n      // In loose mode, return false for invalid patterns\n      if (loose) {\n        return false\n      }\n      // In strict mode, throw an error\n      throw error(\n        'Invalid glob pattern in :path selector',\n        asError(err),\n      )\n    }\n  }\n}\n\n/**\n * :path(\"glob\") Pseudo-Selector will match only workspace & file\n * nodes whose file path matches the provided glob pattern relative\n * to the project root. Path patterns must be quoted strings to avoid\n * parser conflicts with special characters.\n */\nexport const path = async (state: ParserState) => {\n  // Extract path container and handle empty parameters\n  const pathContainer = asPostcssNodeWithChildren(state.current)\n  if (!pathContainer.nodes[0]) {\n    return clear(state)\n  }\n\n  // Extract the selector node and handle empty selectors\n  const selector = asPostcssNodeWithChildren(pathContainer.nodes[0])\n  if (!selector.nodes[0]) {\n    return clear(state)\n  }\n\n  // Extract and validate the path pattern\n  let pathPattern = ''\n  if (isStringNode(selector.nodes[0])) {\n    pathPattern = removeQuotes(asStringNode(selector.nodes[0]).value)\n  } else {\n    if (state.loose) {\n      return clear(state)\n    }\n    throw error(\n      'Failed to parse path pattern in :path selector',\n      new Error('Path pattern must be a quoted string'),\n    )\n  }\n\n  // If no pattern provided, match nothing\n  if (!pathPattern) {\n    return clear(state)\n  }\n\n  // Check for unmatched brackets\n  if (\n    pathPattern === '[' ||\n    (pathPattern.includes('[') && !pathPattern.includes(']'))\n  ) {\n    if (state.loose) {\n      return clear(state)\n    }\n    throw error(\n      'Invalid glob pattern in :path selector',\n      new Error(`Unmatched bracket in pattern: ${pathPattern}`),\n    )\n  }\n\n  // Create path matcher function\n  const matchPath = createPathMatcher(pathPattern, state.loose)\n\n  // Filter nodes by path\n  for (const node of state.partial.nodes) {\n    /* c8 ignore next */\n    const nodePath = node.location || ''\n    const [type] = splitDepID(node.id)\n\n    // Special case for main importer with root path pattern\n    if (pathPattern === '.' && node.mainImporter) {\n      continue // Keep main importer node for root path pattern\n    }\n\n    // Only match workspace or file nodes with matching paths\n    const pathBased = type === 'workspace' || type === 'file'\n    if (!pathBased || !matchPath(nodePath)) {\n      removeNode(state, node)\n    }\n  }\n\n  // Clean up any dangling edges\n  removeDanglingEdges(state)\n  return state\n}\n"]}

package/dist/esm/pseudo/peer.d.ts

@@ -0,0 +1,6 @@
+import type { ParserState } from '../types.ts';
+/**
+ * :peer Pseudo-Selector will only match peer dependencies.
+ */
+export declare const peer: (state: ParserState) => Promise<ParserState>;
+//# sourceMappingURL=peer.d.ts.map

package/dist/esm/pseudo/peer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer.d.ts","sourceRoot":"","sources":["../../../src/pseudo/peer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAG9C;;GAEG;AACH,eAAO,MAAM,IAAI,UAAiB,WAAW,yBAW5C,CAAA"}

package/dist/esm/pseudo/peer.js

@@ -0,0 +1,15 @@
+import { removeEdge, removeUnlinkedNodes } from "./helpers.js";
+/**
+ * :peer Pseudo-Selector will only match peer dependencies.
+ */
+export const peer = async (state) => {
+    // filter edges that aren't marked as peer
+    for (const edge of state.partial.edges) {
+        if (!edge.peer) {
+            removeEdge(state, edge);
+        }
+    }
+    removeUnlinkedNodes(state);
+    return state;
+};
+//# sourceMappingURL=peer.js.map

package/dist/esm/pseudo/peer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer.js","sourceRoot":"","sources":["../../../src/pseudo/peer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAE9D;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,EAAE,KAAkB,EAAE,EAAE;IAC/C,0CAA0C;IAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QACzB,CAAC;IACH,CAAC;IAED,mBAAmB,CAAC,KAAK,CAAC,CAAA;IAE1B,OAAO,KAAK,CAAA;AACd,CAAC,CAAA","sourcesContent":["import type { ParserState } from '../types.ts'\nimport { removeEdge, removeUnlinkedNodes } from './helpers.ts'\n\n/**\n * :peer Pseudo-Selector will only match peer dependencies.\n */\nexport const peer = async (state: ParserState) => {\n  // filter edges that aren't marked as peer\n  for (const edge of state.partial.edges) {\n    if (!edge.peer) {\n      removeEdge(state, edge)\n    }\n  }\n\n  removeUnlinkedNodes(state)\n\n  return state\n}\n"]}

package/dist/esm/pseudo/prerelease.d.ts

@@ -0,0 +1,18 @@
+import type { ParserState } from '../types.ts';
+/**
+ * :prerelease Pseudo-selector, matches only nodes that have prerelease
+ * elements in their parsed semver value.
+ *
+ * Examples of versions that should match:
+ * - 19.2.0-canary-fa3feba6-20250623
+ * - 1.0.0-beta.0
+ * - 0.0.0-16
+ * - 1.2.3-rc.1+rev.2
+ *
+ * Examples of versions that should NOT match:
+ * - 1.0.0
+ * - 99.9.9
+ * - 0.0.1
+ */
+export declare const prerelease: (state: ParserState) => Promise<ParserState>;
+//# sourceMappingURL=prerelease.d.ts.map

package/dist/esm/pseudo/prerelease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prerelease.d.ts","sourceRoot":"","sources":["../../../src/pseudo/prerelease.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,UAAU,UAAiB,WAAW,yBA2BlD,CAAA"}

package/dist/esm/pseudo/prerelease.js

@@ -0,0 +1,41 @@
+import { parse } from '@vltpkg/semver';
+import { removeNode, removeDanglingEdges } from "./helpers.js";
+/**
+ * :prerelease Pseudo-selector, matches only nodes that have prerelease
+ * elements in their parsed semver value.
+ *
+ * Examples of versions that should match:
+ * - 19.2.0-canary-fa3feba6-20250623
+ * - 1.0.0-beta.0
+ * - 0.0.0-16
+ * - 1.2.3-rc.1+rev.2
+ *
+ * Examples of versions that should NOT match:
+ * - 1.0.0
+ * - 99.9.9
+ * - 0.0.1
+ */
+export const prerelease = async (state) => {
+    for (const node of state.partial.nodes) {
+        const version = node.manifest?.version;
+        // Skip nodes without a version (like root/importer nodes)
+        if (!version) {
+            removeNode(state, node);
+            continue;
+        }
+        const parsedVersion = parse(version);
+        if (!parsedVersion) {
+            // Remove nodes with invalid semver versions
+            removeNode(state, node);
+            continue;
+        }
+        // Check if the version has prerelease identifiers
+        if (!parsedVersion.prerelease?.length) {
+            // Remove nodes that don't have prerelease identifiers
+            removeNode(state, node);
+        }
+    }
+    removeDanglingEdges(state);
+    return state;
+};
+//# sourceMappingURL=prerelease.js.map

package/dist/esm/pseudo/prerelease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prerelease.js","sourceRoot":"","sources":["../../../src/pseudo/prerelease.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAG9D;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAE,KAAkB,EAAE,EAAE;IACrD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAA;QAEtC,0DAA0D;QAC1D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;YACvB,SAAQ;QACV,CAAC;QAED,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,CAAA;QACpC,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,4CAA4C;YAC5C,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;YACvB,SAAQ;QACV,CAAC;QAED,kDAAkD;QAClD,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;YACtC,sDAAsD;YACtD,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QACzB,CAAC;IACH,CAAC;IAED,mBAAmB,CAAC,KAAK,CAAC,CAAA;IAE1B,OAAO,KAAK,CAAA;AACd,CAAC,CAAA","sourcesContent":["import { parse } from '@vltpkg/semver'\nimport { removeNode, removeDanglingEdges } from './helpers.ts'\nimport type { ParserState } from '../types.ts'\n\n/**\n * :prerelease Pseudo-selector, matches only nodes that have prerelease\n * elements in their parsed semver value.\n *\n * Examples of versions that should match:\n * - 19.2.0-canary-fa3feba6-20250623\n * - 1.0.0-beta.0\n * - 0.0.0-16\n * - 1.2.3-rc.1+rev.2\n *\n * Examples of versions that should NOT match:\n * - 1.0.0\n * - 99.9.9\n * - 0.0.1\n */\nexport const prerelease = async (state: ParserState) => {\n  for (const node of state.partial.nodes) {\n    const version = node.manifest?.version\n\n    // Skip nodes without a version (like root/importer nodes)\n    if (!version) {\n      removeNode(state, node)\n      continue\n    }\n\n    const parsedVersion = parse(version)\n    if (!parsedVersion) {\n      // Remove nodes with invalid semver versions\n      removeNode(state, node)\n      continue\n    }\n\n    // Check if the version has prerelease identifiers\n    if (!parsedVersion.prerelease?.length) {\n      // Remove nodes that don't have prerelease identifiers\n      removeNode(state, node)\n    }\n  }\n\n  removeDanglingEdges(state)\n\n  return state\n}\n"]}

package/dist/esm/pseudo/private.d.ts

@@ -0,0 +1,7 @@
+import type { ParserState } from '../types.ts';
+/**
+ * :private Pseudo-Selector will only match packages that have
+ * a `private: true` key set in their `package.json` metadata.
+ */
+export declare const privateParser: (state: ParserState) => Promise<ParserState>;
+//# sourceMappingURL=private.d.ts.map

package/dist/esm/pseudo/private.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"private.d.ts","sourceRoot":"","sources":["../../../src/pseudo/private.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAG9C;;;GAGG;AACH,eAAO,MAAM,aAAa,UAAiB,WAAW,yBAUrD,CAAA"}

package/dist/esm/pseudo/private.js

@@ -0,0 +1,16 @@
+import { asManifest } from '@vltpkg/types';
+import { removeNode, removeDanglingEdges } from "./helpers.js";
+/**
+ * :private Pseudo-Selector will only match packages that have
+ * a `private: true` key set in their `package.json` metadata.
+ */
+export const privateParser = async (state) => {
+    for (const node of state.partial.nodes) {
+        if (!node.manifest || !asManifest(node.manifest).private) {
+            removeNode(state, node);
+        }
+    }
+    removeDanglingEdges(state);
+    return state;
+};
+//# sourceMappingURL=private.js.map

package/dist/esm/pseudo/private.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"private.js","sourceRoot":"","sources":["../../../src/pseudo/private.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE1C,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAE9D;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,KAAkB,EAAE,EAAE;IACxD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;YACzD,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QACzB,CAAC;IACH,CAAC;IAED,mBAAmB,CAAC,KAAK,CAAC,CAAA;IAE1B,OAAO,KAAK,CAAA;AACd,CAAC,CAAA","sourcesContent":["import { asManifest } from '@vltpkg/types'\nimport type { ParserState } from '../types.ts'\nimport { removeNode, removeDanglingEdges } from './helpers.ts'\n\n/**\n * :private Pseudo-Selector will only match packages that have\n * a `private: true` key set in their `package.json` metadata.\n */\nexport const privateParser = async (state: ParserState) => {\n  for (const node of state.partial.nodes) {\n    if (!node.manifest || !asManifest(node.manifest).private) {\n      removeNode(state, node)\n    }\n  }\n\n  removeDanglingEdges(state)\n\n  return state\n}\n"]}

package/dist/esm/pseudo/prod.d.ts

@@ -0,0 +1,6 @@
+import type { ParserState } from '../types.ts';
+/**
+ * :prod Pseudo-Selector will only match production dependencies.
+ */
+export declare const prod: (state: ParserState) => Promise<ParserState>;
+//# sourceMappingURL=prod.d.ts.map

package/dist/esm/pseudo/prod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prod.d.ts","sourceRoot":"","sources":["../../../src/pseudo/prod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAG9C;;GAEG;AACH,eAAO,MAAM,IAAI,UAAiB,WAAW,yBAW5C,CAAA"}

package/dist/esm/pseudo/prod.js

@@ -0,0 +1,15 @@
+import { removeEdge, removeUnlinkedNodes } from "./helpers.js";
+/**
+ * :prod Pseudo-Selector will only match production dependencies.
+ */
+export const prod = async (state) => {
+    // filter edges that don't have type 'prod'
+    for (const edge of state.partial.edges) {
+        if (edge.type !== 'prod') {
+            removeEdge(state, edge);
+        }
+    }
+    removeUnlinkedNodes(state);
+    return state;
+};
+//# sourceMappingURL=prod.js.map

package/dist/esm/pseudo/prod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prod.js","sourceRoot":"","sources":["../../../src/pseudo/prod.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAE9D;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,EAAE,KAAkB,EAAE,EAAE;IAC/C,2CAA2C;IAC3C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QACzB,CAAC;IACH,CAAC;IAED,mBAAmB,CAAC,KAAK,CAAC,CAAA;IAE1B,OAAO,KAAK,CAAA;AACd,CAAC,CAAA","sourcesContent":["import type { ParserState } from '../types.ts'\nimport { removeEdge, removeUnlinkedNodes } from './helpers.ts'\n\n/**\n * :prod Pseudo-Selector will only match production dependencies.\n */\nexport const prod = async (state: ParserState) => {\n  // filter edges that don't have type 'prod'\n  for (const edge of state.partial.edges) {\n    if (edge.type !== 'prod') {\n      removeEdge(state, edge)\n    }\n  }\n\n  removeUnlinkedNodes(state)\n\n  return state\n}\n"]}

package/dist/esm/pseudo/published.d.ts

@@ -0,0 +1,40 @@
+import type { NodeLike } from '@vltpkg/types';
+import type { ParserState } from '../types.ts';
+import type { PostcssNode } from '@vltpkg/dss-parser';
+/**
+ * The possible comparator values accepted by the :published() pseudo selector.
+ */
+export type PublishedComparator = '>' | '<' | '>=' | '<=' | undefined;
+/**
+ * Result of the internal parsing of the :published() pseudo selector.
+ */
+export type PublishedInternals = {
+    relativeDate: string;
+    comparator: PublishedComparator;
+};
+/**
+ * Fetches the published date of a package version from the npm registry.
+ */
+export declare const retrieveRemoteDate: (node: NodeLike, signal?: AbortSignal) => Promise<string | undefined>;
+/**
+ * Retrieves what kind of check the :published selector should perform.
+ */
+export declare const parseInternals: (nodes: PostcssNode[]) => PublishedInternals;
+/**
+ * Filter nodes by queueing up for removal those that don't match the date criteria.
+ */
+export declare const queueNode: (state: ParserState, node: NodeLike, relativeDate: string, comparator: PublishedComparator) => Promise<NodeLike | undefined>;
+/**
+ * Filters out nodes that don't match the published date criteria.
+ *
+ * The :published() pseudo selector supports a date parameter that can be prefixed
+ * with a comparator (>, <, >=, <=). If no comparator is provided, it will match
+ * exact dates.
+ *
+ * Examples:
+ * - :published("2024-01-01") - Matches packages published exactly on January 1st, 2024
+ * - :published(">2024-01-01") - Matches packages published after January 1st, 2024
+ * - :published("<=2023-12-31") - Matches packages published on or before December 31st, 2023
+ */
+export declare const published: (state: ParserState) => Promise<ParserState>;
+//# sourceMappingURL=published.d.ts.map

package/dist/esm/pseudo/published.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"published.d.ts","sourceRoot":"","sources":["../../../src/pseudo/published.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,QAAQ,EAAa,MAAM,eAAe,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAA;AAErE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,mBAAmB,CAAA;CAChC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,SACvB,QAAQ,WACL,WAAW,KACnB,OAAO,CAAC,MAAM,GAAG,SAAS,CA0B5B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,UAClB,WAAW,EAAE,KACnB,kBAoCF,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,UACb,WAAW,QACZ,QAAQ,gBACA,MAAM,cACR,mBAAmB,KAC9B,OAAO,CAAC,QAAQ,GAAG,SAAS,CAkD9B,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,SAAS,UAAiB,WAAW,yBAiEjD,CAAA"}

package/dist/esm/pseudo/published.js

@@ -0,0 +1,180 @@
+import pRetry, { AbortError } from 'p-retry';
+import { hydrate, splitDepID } from '@vltpkg/dep-id/browser';
+import { error } from '@vltpkg/error-cause';
+import { asError } from '@vltpkg/types';
+import { asPostcssNodeWithChildren, asStringNode, asTagNode, isStringNode, isTagNode, } from '@vltpkg/dss-parser';
+import { removeDanglingEdges, removeNode, removeQuotes, } from "./helpers.js";
+/**
+ * Fetches the published date of a package version from the npm registry.
+ */
+export const retrieveRemoteDate = async (node, signal) => {
+    const spec = hydrate(node.id, String(node.name), node.options);
+    if (!spec.registry || !node.name || !node.version) {
+        return undefined;
+    }
+    const url = new URL(spec.registry);
+    url.pathname = `/${node.name}`;
+    const response = await fetch(String(url), {
+        signal,
+    });
+    // on missing valid auth or API, it should abort the retry logic
+    if (response.status === 404) {
+        throw new AbortError('Missing API');
+    }
+    if (!response.ok) {
+        throw error('Failed to fetch packument', {
+            name: node.name,
+            spec,
+            response,
+        });
+    }
+    const packument = (await response.json());
+    const res = packument.time?.[node.version];
+    return res;
+};
+/**
+ * Retrieves what kind of check the :published selector should perform.
+ */
+export const parseInternals = (nodes) => {
+    let value = '';
+    if (isStringNode(asPostcssNodeWithChildren(nodes[0]).nodes[0])) {
+        value = removeQuotes(asStringNode(asPostcssNodeWithChildren(nodes[0]).nodes[0])
+            .value);
+    }
+    else if (isTagNode(asPostcssNodeWithChildren(nodes[0]).nodes[0])) {
+        const tagNode = asTagNode(asPostcssNodeWithChildren(nodes[0]).nodes[0]);
+        value = tagNode.value;
+    }
+    // Check if the value starts with a comparator
+    let comparator;
+    let relativeDate = value;
+    if (value.startsWith('>=')) {
+        comparator = '>=';
+        relativeDate = value.slice(2);
+    }
+    else if (value.startsWith('<=')) {
+        comparator = '<=';
+        relativeDate = value.slice(2);
+    }
+    else if (value.startsWith('>')) {
+        comparator = '>';
+        relativeDate = value.slice(1);
+    }
+    else if (value.startsWith('<')) {
+        comparator = '<';
+        relativeDate = value.slice(1);
+    }
+    return { relativeDate, comparator };
+};
+/**
+ * Filter nodes by queueing up for removal those that don't match the date criteria.
+ */
+export const queueNode = async (state, node, relativeDate, comparator) => {
+    if (!node.name || !node.version) {
+        return node;
+    }
+    let publishedDate;
+    try {
+        publishedDate = await pRetry(() => retrieveRemoteDate(node, state.signal), {
+            retries: state.retries,
+            signal: state.signal,
+        });
+    }
+    catch (err) {
+        // eslint-disable-next-line no-console
+        console.warn(error('Could not retrieve registry publish date', {
+            name: node.name,
+            cause: err,
+        }));
+        return node;
+    }
+    if (!publishedDate) {
+        return node;
+    }
+    // only matches the same amount of date information
+    // as provided in the relative date
+    const nodeDate = new Date(publishedDate.slice(0, relativeDate.length));
+    const compareDate = new Date(relativeDate);
+    switch (comparator) {
+        case '>':
+            return nodeDate > compareDate ? undefined : node;
+        case '<':
+            return nodeDate < compareDate ? undefined : node;
+        case '>=':
+            return nodeDate >= compareDate ? undefined : node;
+        case '<=':
+            return nodeDate <= compareDate ? undefined : node;
+        default:
+            return nodeDate.getTime() === compareDate.getTime() ?
+                undefined
+                : node;
+    }
+};
+/**
+ * Filters out nodes that don't match the published date criteria.
+ *
+ * The :published() pseudo selector supports a date parameter that can be prefixed
+ * with a comparator (>, <, >=, <=). If no comparator is provided, it will match
+ * exact dates.
+ *
+ * Examples:
+ * - :published("2024-01-01") - Matches packages published exactly on January 1st, 2024
+ * - :published(">2024-01-01") - Matches packages published after January 1st, 2024
+ * - :published("<=2023-12-31") - Matches packages published on or before December 31st, 2023
+ */
+export const published = async (state) => {
+    let internals;
+    try {
+        internals = parseInternals(asPostcssNodeWithChildren(state.current).nodes);
+    }
+    catch (err) {
+        if (asError(err).message === 'Expected a query node') {
+            // No parameters provided - pseudo state form: match ANY published metadata
+            for (const node of state.partial.nodes) {
+                // filter out nodes that are always ignored by the published selector
+                if (node.mainImporter ||
+                    node.manifest?.private ||
+                    splitDepID(node.id)[0] !== 'registry') {
+                    removeNode(state, node);
+                    continue;
+                }
+                // For pseudo state form, we just check if the node has published metadata
+                // This is equivalent to checking if it's a registry package with version info
+                if (!node.name || !node.version) {
+                    removeNode(state, node);
+                }
+            }
+            removeDanglingEdges(state);
+            return state;
+        }
+        else {
+            throw error('Failed to parse :published selector', {
+                cause: err,
+            });
+        }
+    }
+    const { relativeDate, comparator } = internals;
+    const queue = [];
+    for (const node of state.partial.nodes) {
+        // filter out nodes that are always ignored by the published selector
+        if (node.mainImporter ||
+            node.manifest?.private ||
+            splitDepID(node.id)[0] !== 'registry') {
+            removeNode(state, node);
+            continue;
+        }
+        // fetch published date info and perform checks to define
+        // whether or not a node should be filtered out
+        queue.push(queueNode(state, node, relativeDate, comparator));
+    }
+    // nodes queued for removal are then finally removed
+    const removeNodeQueue = await Promise.all(queue);
+    for (const node of removeNodeQueue) {
+        if (node) {
+            removeNode(state, node);
+        }
+    }
+    removeDanglingEdges(state);
+    return state;
+};
+//# sourceMappingURL=published.js.map

package/dist/esm/pseudo/published.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"published.js","sourceRoot":"","sources":["../../../src/pseudo/published.ts"],"names":[],"mappings":"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","sourcesContent":["import pRetry, { AbortError } from 'p-retry'\nimport { hydrate, splitDepID } from '@vltpkg/dep-id/browser'\nimport { error } from '@vltpkg/error-cause'\nimport { asError } from '@vltpkg/types'\nimport {\n  asPostcssNodeWithChildren,\n  asStringNode,\n  asTagNode,\n  isStringNode,\n  isTagNode,\n} from '@vltpkg/dss-parser'\nimport {\n  removeDanglingEdges,\n  removeNode,\n  removeQuotes,\n} from './helpers.ts'\nimport type { NodeLike, Packument } from '@vltpkg/types'\nimport type { ParserState } from '../types.ts'\nimport type { PostcssNode } from '@vltpkg/dss-parser'\n\n/**\n * The possible comparator values accepted by the :published() pseudo selector.\n */\nexport type PublishedComparator = '>' | '<' | '>=' | '<=' | undefined\n\n/**\n * Result of the internal parsing of the :published() pseudo selector.\n */\nexport type PublishedInternals = {\n  relativeDate: string\n  comparator: PublishedComparator\n}\n\n/**\n * Fetches the published date of a package version from the npm registry.\n */\nexport const retrieveRemoteDate = async (\n  node: NodeLike,\n  signal?: AbortSignal,\n): Promise<string | undefined> => {\n  const spec = hydrate(node.id, String(node.name), node.options)\n  if (!spec.registry || !node.name || !node.version) {\n    return undefined\n  }\n\n  const url = new URL(spec.registry)\n  url.pathname = `/${node.name}`\n\n  const response = await fetch(String(url), {\n    signal,\n  })\n  // on missing valid auth or API, it should abort the retry logic\n  if (response.status === 404) {\n    throw new AbortError('Missing API')\n  }\n  if (!response.ok) {\n    throw error('Failed to fetch packument', {\n      name: node.name,\n      spec,\n      response,\n    })\n  }\n  const packument = (await response.json()) as Packument\n  const res = packument.time?.[node.version]\n  return res\n}\n\n/**\n * Retrieves what kind of check the :published selector should perform.\n */\nexport const parseInternals = (\n  nodes: PostcssNode[],\n): PublishedInternals => {\n  let value = ''\n\n  if (isStringNode(asPostcssNodeWithChildren(nodes[0]).nodes[0])) {\n    value = removeQuotes(\n      asStringNode(asPostcssNodeWithChildren(nodes[0]).nodes[0])\n        .value,\n    )\n  } else if (\n    isTagNode(asPostcssNodeWithChildren(nodes[0]).nodes[0])\n  ) {\n    const tagNode = asTagNode(\n      asPostcssNodeWithChildren(nodes[0]).nodes[0],\n    )\n    value = tagNode.value\n  }\n\n  // Check if the value starts with a comparator\n  let comparator: PublishedComparator\n  let relativeDate = value\n\n  if (value.startsWith('>=')) {\n    comparator = '>='\n    relativeDate = value.slice(2)\n  } else if (value.startsWith('<=')) {\n    comparator = '<='\n    relativeDate = value.slice(2)\n  } else if (value.startsWith('>')) {\n    comparator = '>'\n    relativeDate = value.slice(1)\n  } else if (value.startsWith('<')) {\n    comparator = '<'\n    relativeDate = value.slice(1)\n  }\n\n  return { relativeDate, comparator }\n}\n\n/**\n * Filter nodes by queueing up for removal those that don't match the date criteria.\n */\nexport const queueNode = async (\n  state: ParserState,\n  node: NodeLike,\n  relativeDate: string,\n  comparator: PublishedComparator,\n): Promise<NodeLike | undefined> => {\n  if (!node.name || !node.version) {\n    return node\n  }\n\n  let publishedDate: string | undefined\n  try {\n    publishedDate = await pRetry(\n      () => retrieveRemoteDate(node, state.signal),\n      {\n        retries: state.retries,\n        signal: state.signal,\n      },\n    )\n  } catch (err) {\n    // eslint-disable-next-line no-console\n    console.warn(\n      error('Could not retrieve registry publish date', {\n        name: node.name,\n        cause: err,\n      }),\n    )\n    return node\n  }\n\n  if (!publishedDate) {\n    return node\n  }\n\n  // only matches the same amount of date information\n  // as provided in the relative date\n  const nodeDate = new Date(\n    publishedDate.slice(0, relativeDate.length),\n  )\n  const compareDate = new Date(relativeDate)\n\n  switch (comparator) {\n    case '>':\n      return nodeDate > compareDate ? undefined : node\n    case '<':\n      return nodeDate < compareDate ? undefined : node\n    case '>=':\n      return nodeDate >= compareDate ? undefined : node\n    case '<=':\n      return nodeDate <= compareDate ? undefined : node\n    default:\n      return nodeDate.getTime() === compareDate.getTime() ?\n          undefined\n        : node\n  }\n}\n\n/**\n * Filters out nodes that don't match the published date criteria.\n *\n * The :published() pseudo selector supports a date parameter that can be prefixed\n * with a comparator (>, <, >=, <=). If no comparator is provided, it will match\n * exact dates.\n *\n * Examples:\n * - :published(\"2024-01-01\") - Matches packages published exactly on January 1st, 2024\n * - :published(\">2024-01-01\") - Matches packages published after January 1st, 2024\n * - :published(\"<=2023-12-31\") - Matches packages published on or before December 31st, 2023\n */\nexport const published = async (state: ParserState) => {\n  let internals\n  try {\n    internals = parseInternals(\n      asPostcssNodeWithChildren(state.current).nodes,\n    )\n  } catch (err) {\n    if (asError(err).message === 'Expected a query node') {\n      // No parameters provided - pseudo state form: match ANY published metadata\n      for (const node of state.partial.nodes) {\n        // filter out nodes that are always ignored by the published selector\n        if (\n          node.mainImporter ||\n          node.manifest?.private ||\n          splitDepID(node.id)[0] !== 'registry'\n        ) {\n          removeNode(state, node)\n          continue\n        }\n\n        // For pseudo state form, we just check if the node has published metadata\n        // This is equivalent to checking if it's a registry package with version info\n        if (!node.name || !node.version) {\n          removeNode(state, node)\n        }\n      }\n      removeDanglingEdges(state)\n      return state\n    } else {\n      throw error('Failed to parse :published selector', {\n        cause: err,\n      })\n    }\n  }\n\n  const { relativeDate, comparator } = internals\n  const queue = []\n\n  for (const node of state.partial.nodes) {\n    // filter out nodes that are always ignored by the published selector\n    if (\n      node.mainImporter ||\n      node.manifest?.private ||\n      splitDepID(node.id)[0] !== 'registry'\n    ) {\n      removeNode(state, node)\n      continue\n    }\n\n    // fetch published date info and perform checks to define\n    // whether or not a node should be filtered out\n    queue.push(queueNode(state, node, relativeDate, comparator))\n  }\n\n  // nodes queued for removal are then finally removed\n  const removeNodeQueue = await Promise.all(queue)\n  for (const node of removeNodeQueue) {\n    if (node) {\n      removeNode(state, node)\n    }\n  }\n\n  removeDanglingEdges(state)\n\n  return state\n}\n"]}

package/dist/esm/pseudo/root.d.ts

@@ -0,0 +1,7 @@
+import type { ParserState } from '../types.ts';
+/**
+ * :root Pseudo-Element will return the project root node for the graph.
+ * It matches only nodes marked as `mainImporter`.
+ */
+export declare const root: (state: ParserState) => Promise<ParserState>;
+//# sourceMappingURL=root.d.ts.map

package/dist/esm/pseudo/root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../../../src/pseudo/root.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C;;;GAGG;AACH,eAAO,MAAM,IAAI,UAAiB,WAAW,yBAY5C,CAAA"}

package/dist/esm/pseudo/root.js

@@ -0,0 +1,18 @@
+/**
+ * :root Pseudo-Element will return the project root node for the graph.
+ * It matches only nodes marked as `mainImporter`.
+ */
+export const root = async (state) => {
+    for (const edge of state.partial.edges) {
+        if (!edge.to?.mainImporter) {
+            state.partial.edges.delete(edge);
+        }
+    }
+    for (const node of state.partial.nodes) {
+        if (!node.mainImporter) {
+            state.partial.nodes.delete(node);
+        }
+    }
+    return state;
+};
+//# sourceMappingURL=root.js.map

package/dist/esm/pseudo/root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.js","sourceRoot":"","sources":["../../../src/pseudo/root.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,EAAE,KAAkB,EAAE,EAAE;IAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,YAAY,EAAE,CAAC;YAC3B,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAClC,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAClC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA","sourcesContent":["import type { ParserState } from '../types.ts'\n\n/**\n * :root Pseudo-Element will return the project root node for the graph.\n * It matches only nodes marked as `mainImporter`.\n */\nexport const root = async (state: ParserState) => {\n  for (const edge of state.partial.edges) {\n    if (!edge.to?.mainImporter) {\n      state.partial.edges.delete(edge)\n    }\n  }\n  for (const node of state.partial.nodes) {\n    if (!node.mainImporter) {\n      state.partial.nodes.delete(node)\n    }\n  }\n  return state\n}\n"]}

package/dist/esm/pseudo/scanned.d.ts

@@ -1,7 +1,9 @@
 import type { ParserState } from '../types.ts';
 /**
- * Ensures that security report data is available for all packages in the current graph.
- * Throws an error if security data is not available.
+ * :scanned pseudo selector.
+ *
+ * Remove all nodes that do not have available metadata
+ * in the security archive.
  */
 export declare const scanned: (state: ParserState) => Promise<ParserState>;
 //# sourceMappingURL=scanned.d.ts.map

package/dist/esm/pseudo/scanned.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scanned.d.ts","sourceRoot":"","sources":["../../../src/pseudo/scanned.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C;;;GAGG;AACH,eAAO,MAAM,OAAO,UAAiB,WAAW,yBAK/C,CAAA"}
+{"version":3,"file":"scanned.d.ts","sourceRoot":"","sources":["../../../src/pseudo/scanned.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,OAAO,UAAiB,WAAW,yBAU/C,CAAA"}