@vltpkg/cli-js 1.5.0 → 1.6.0

package/{setup-XPAM5U3Z.js → setup-SYYUEHZL.js}

@@ -11,37 +11,58 @@ import {createRequire as _vlt_createRequire} from "node:module";
 var require = _vlt_createRequire(import.meta.filename);
 import {
   stdout
-} from "./chunk-WHWPAYZY.js";
-import "./chunk-X6JKMIOU.js";
-import "./chunk-4TSHLSRK.js";
+} from "./chunk-KVWGMSPW.js";
+import "./chunk-LGQVZTYR.js";
+import "./chunk-EYGOEAJM.js";
 import {
   commandUsage
-} from "./chunk-CW56EJIL.js";
+} from "./chunk-HT6FS4VB.js";
 import {
   configWriteTarget,
   registrySelectionFields
-} from "./chunk-XCQCYB6G.js";
-import "./chunk-VR7NRWAD.js";
+} from "./chunk-LP3ORD3D.js";
+import "./chunk-LCLRP64K.js";
 import "./chunk-SRWDPPLX.js";
-import "./chunk-IFEZ6BFV.js";
-import "./chunk-C6ZVVEFV.js";
+import {
+  applyPathSetup,
+  ask,
+  editPathHint,
+  pathSetupChanged,
+  pathSetupFiles,
+  pathSetupLines,
+  planPathSetup,
+  rcList,
+  resolveGlobalBinDir,
+  sourceCommand
+} from "./chunk-O6MQ7NN6.js";
+import {
+  detectShell,
+  prettyPath,
+  shellPathCommand
+} from "./chunk-BH5CVXNY.js";
+import "./chunk-JV5XR5JQ.js";
+import "./chunk-EMTGRCSE.js";
+import "./chunk-TQQO2F56.js";
 import "./chunk-4KCU2KZL.js";
 import "./chunk-WGDTG44V.js";
+import "./chunk-E74WGW5C.js";
+import "./chunk-GCTREKA4.js";
+import "./chunk-MCDLJZXT.js";
 import {
   normalizeRegistryURL
-} from "./chunk-UZ6ICZE3.js";
-import "./chunk-CMLDLZZ3.js";
-import "./chunk-F7NPYSI2.js";
-import "./chunk-LUVDMEW4.js";
+} from "./chunk-7M2VTFLP.js";
+import "./chunk-EFHOWRKU.js";
+import "./chunk-CAV7FKWQ.js";
+import "./chunk-6D3QAFNZ.js";
 import "./chunk-HTOTG4TS.js";
 import {
   RegistryClient,
   getKC,
   normalizeRegistryKey
-} from "./chunk-35EG6T3J.js";
+} from "./chunk-44AWMA4F.js";
 import "./chunk-QNHBAGXQ.js";
-import "./chunk-G3FZ2ZJK.js";
-import "./chunk-5KW6AOTT.js";
+import "./chunk-GEQFMH5M.js";
+import "./chunk-4GMNWW4C.js";
 import "./chunk-SUU2WETN.js";
 import "./chunk-B6RIGNEO.js";
 import "./chunk-XNLSTHDK.js";
@@ -53,7 +74,7 @@ import {
   defaultRegistries,
   isErrorWithCause,
   isObject
-} from "./chunk-6LZM3I4Q.js";
+} from "./chunk-BF5DRGRZ.js";
 import {
   error
 } from "./chunk-WZWDS3W4.js";
@@ -89,8 +110,43 @@ var accountAuthError = (account, er) => isErrorWithCause(er) && isObject(er.caus
   ].join("\n"),
   { code: "ECONFIG", cause: er }
 ) : asError(er);
+var pathView = (r, wizard = false) => {
+  if (r.status === "failed") {
+    return `\u26A0\uFE0F  Could not add the global bin folder to your PATH: ${r.message}`;
+  }
+  const dir = prettyPath(r.dir);
+  const rcs = rcList(r.files);
+  const keep = process.platform === "win32" ? [`  To keep it: ${editPathHint}`] : [];
+  switch (r.status) {
+    case "added":
+      return pathSetupLines(r, r.source).join("\n");
+    case "unchanged":
+      return [
+        `\u2705 ${dir} is already added to your PATH in ${rcs}`,
+        `   Open a new terminal, or run: ${r.source}`
+      ].join("\n");
+    case "in-path":
+      return wizard ? "" : `\u2705 ${dir} is already on your PATH`;
+    case "disabled":
+      return [
+        `\u2139\uFE0F  no-modify-path is set, so nothing was changed. To add ${dir} to your PATH, run:`,
+        `  ${r.command}`,
+        ...keep
+      ].join("\n");
+    case "cancelled":
+      if (wizard) {
+        return `\u2139\uFE0F  Skipped. Run \`vlt setup --path\` later to add ${dir} to your PATH.`;
+      }
+      return [
+        `Nothing changed. To add ${dir} to your PATH, run:`,
+        `  ${r.command}`,
+        ...keep
+      ].join("\n");
+  }
+};
 var views = {
   human: (result) => {
+    if (!("account" in result)) return pathView(result.path);
     const lines = [
       `Configured ${Object.keys(result.registries).length} registry ${Object.keys(result.registries).length === 1 ? "alias" : "aliases"} for "${result.account}" in ${result.which} config:`
     ];
@@ -105,6 +161,8 @@ var views = {
         "to configure this project instead."
       );
     }
+    const path = result.path && pathView(result.path, true);
+    if (path) lines.push("", path);
     lines.push(
       "",
       "You can now install packages, e.g.:",
@@ -115,7 +173,10 @@ var views = {
 };
 var usage = () => commandUsage({
   command: "setup",
-  usage: "[<account>]",
+  usage: [
+    "[<account>]",
+    "--path [--yes] [--global-bin-dir=<path>]"
+  ],
   description: `Configure the registry aliases for your vlt.io account so
                   that \`vlt install\` and \`vlx\` work out of the box.
 
@@ -123,7 +184,19 @@ var usage = () => commandUsage({
                   authenticates against your account, stores the token
                   for both the \`npm\` and \`main\` registries, and writes
                   those aliases (and any additional aliases you add) to
-                  your user \`vlt.json\`.`,
+                  your user \`vlt.json\`.
+
+                  In a terminal, if the global bin folder isn't on
+                  your \`PATH\` or set up yet, it ends by asking
+                  \`Setup PATH for global installs? (Y/n)\`: yes adds
+                  it (same as \`--path\`), no skips it. Run
+                  \`vlt setup --path\` later to do just that step.
+
+                  With \`--path\`, add the global bin folder
+                  (\`--global-bin-dir\`) to your \`PATH\` instead: writes
+                  \`<global-dir>/env\` and a marked section that loads
+                  it into your shell config. On Windows it adds it to
+                  your user \`Path\` (\`HKCU\\Environment\`).`,
   options: {
     config: {
       value: "<user | project>",
@@ -134,15 +207,119 @@ var usage = () => commandUsage({
       description: "Additional registry aliases to stage non-interactively. Combine with `--yes` to run setup unattended."
     },
     yes: {
-      description: "Skip interactive prompts (requires <account> and does not open a browser for authentication)."
+      description: "Skip interactive prompts (requires <account> and does not open a browser for authentication). With --path: edit without asking. Without --path: skips the PATH prompt."
+    },
+    path: {
+      description: "Only add the global bin folder to your PATH via your shell config (user Path on Windows)."
+    },
+    "global-bin-dir": {
+      value: "<path>",
+      description: "The folder to add to your PATH."
     }
   }
 });
+var runPathSetup = async (o) => {
+  const root = o.globalDir;
+  const bin = await resolveGlobalBinDir({
+    projectRoot: root,
+    globalBinDir: o.globalBinDir
+  });
+  const shell = detectShell();
+  const base = {
+    dir: bin.dir,
+    shell,
+    files: [],
+    backups: [],
+    command: shellPathCommand(shell, bin.dir),
+    source: sourceCommand(shell, root, bin.dir)
+  };
+  if (bin.inPath) {
+    return { ...base, status: "in-path" };
+  }
+  if (o.noModifyPath) {
+    return { ...base, status: "disabled" };
+  }
+  const opts = { globalDir: root, dir: bin.dir, shell };
+  let plan = await planPathSetup(opts);
+  const files = pathSetupFiles(plan);
+  if (!pathSetupChanged(plan)) {
+    return { ...base, status: "unchanged", files };
+  }
+  if (!o.yes) {
+    if (!process.stdin.isTTY) {
+      throw error(
+        "Not a terminal: pass --yes to add it to your PATH",
+        {
+          code: "EUSAGE"
+        }
+      );
+    }
+    const answer = await (o.ask ?? ask)(
+      o.question({ dir: prettyPath(bin.dir), rcs: rcList(files) })
+    ).catch((er) => {
+      if (asError(er).name !== "AbortError") throw er;
+      process.stdout.write("\n");
+      return "n";
+    });
+    if (/^n/i.test(answer)) {
+      return { ...base, status: "cancelled", files };
+    }
+    plan = await planPathSetup(opts);
+  }
+  const r = await applyPathSetup(plan);
+  return {
+    ...base,
+    status: "added",
+    files: r.files,
+    backups: r.backups
+  };
+};
+var setupPath = async (conf, root) => {
+  if (conf.positionals.length) {
+    throw error("`vlt setup --path` takes no arguments", {
+      code: "EUSAGE",
+      found: conf.positionals[0]
+    });
+  }
+  return {
+    path: await runPathSetup({
+      globalDir: root,
+      globalBinDir: conf.globalBinDir,
+      yes: !!conf.get("yes"),
+      noModifyPath: !!conf.get("no-modify-path"),
+      question: ({ dir, rcs }) => `Add ${dir} to your PATH in ${rcs}? (Y/n) `
+    })
+  };
+};
+var offerPath = async (conf, yes, ask2) => {
+  if (yes || !process.stdin.isTTY || conf.get("no-modify-path")) {
+    return;
+  }
+  const g = conf.globalProject();
+  if (!g) return;
+  try {
+    return await runPathSetup({
+      globalDir: g.root,
+      globalBinDir: g.binDir,
+      question: () => "Setup PATH for global installs? (Y/n) ",
+      ask: ask2
+    });
+  } catch (er) {
+    const e = asError(er);
+    const found = isErrorWithCause(e) && isObject(e.cause) && typeof e.cause.found === "string" ? prettyPath(e.cause.found) : void 0;
+    return {
+      status: "failed",
+      message: found && !e.message.includes(found) ? `${e.message}: ${found}` : e.message
+    };
+  }
+};
 var command = async (conf) => {
+  const root = conf.globalRoot;
+  if (root) return setupPath(conf, root);
   const yes = !!conf.get("yes");
   const which = configWriteTarget(conf, "user");
   let rl;
-  const ask = async (question) => {
+  const ask2 = async (question) => {
     rl ??= createInterface(process.stdin, process.stdout);
     return (await rl.question(question)).trim();
   };
@@ -158,7 +335,7 @@ var command = async (conf) => {
           { code: "ECONFIG" }
         );
       }
-      account = await ask("vlt.io account or organization slug: ");
+      account = await ask2("vlt.io account or organization slug: ");
       if (!account) {
         throw error("No account slug provided.", { code: "ECONFIG" });
       }
@@ -181,7 +358,7 @@ var command = async (conf) => {
     }
     const rc = new RegistryClient(conf.options);
     if (!yes) {
-      const doAuth = await ask(
+      const doAuth = await ask2(
         "Authenticate with your vlt.io account now? (Y/n) "
       );
       if (!/^n/i.test(doAuth)) {
@@ -201,9 +378,9 @@ var command = async (conf) => {
         }
       }
       for (; ; ) {
-        const more = await ask("Add another registry alias? (y/N) ");
+        const more = await ask2("Add another registry alias? (y/N) ");
         if (!/^y/i.test(more)) break;
-        const name = await ask("  alias name: ");
+        const name = await ask2("  alias name: ");
         if (!name) {
           stdout("  alias name is required, skipping.");
           continue;
@@ -212,14 +389,14 @@ var command = async (conf) => {
           stdout(`  alias "${name}" is already staged, skipping.`);
           continue;
         }
-        const url = await ask("  registry url: ");
+        const url = await ask2("  registry url: ");
         if (!url) {
           stdout("  registry url is required, skipping.");
           continue;
         }
         const normalized = normalizeRegistryURL(url);
         registries[name] = normalized;
-        const auth = await ask(
+        const auth = await ask2(
           `  authenticate against "${name}" now? (y/N) `
         );
         if (/^y/i.test(auth)) {
@@ -232,11 +409,13 @@ var command = async (conf) => {
     const shadowedByProject = which === "user" && registrySelectionFields.some(
       (f) => f in (conf.layers.project ?? {})
     );
+    const path = await offerPath(conf, yes, ask2);
     return {
       account,
       which,
       registries,
-      ...shadowedByProject ? { shadowedByProject } : void 0
+      ...shadowedByProject ? { shadowedByProject } : void 0,
+      ...path ? { path } : void 0
     };
   } finally {
     if (rl) {

package/{skills-YD2TB2VD.js → skills-KA2VR5Q5.js}

@@ -10,6 +10,7 @@ globalThis.clearInterval = _vlt_clearInterval;
 import {createRequire as _vlt_createRequire} from "node:module";
 var require = _vlt_createRequire(import.meta.filename);
 import {
+  editGitignore,
   filterNodesByQueryParts,
   load2 as load,
   lstat,
@@ -22,21 +23,23 @@ import {
   skillsDirs,
   unmountSkill,
   unshare
-} from "./chunk-2U4PVHP4.js";
-import "./chunk-SMXXFQPI.js";
-import "./chunk-C6ZVVEFV.js";
+} from "./chunk-F5LZMLAQ.js";
+import "./chunk-YTDABXPD.js";
+import {
+  Monorepo
+} from "./chunk-TQQO2F56.js";
 import {
   splitDepID
-} from "./chunk-F7NPYSI2.js";
-import "./chunk-LUVDMEW4.js";
+} from "./chunk-CAV7FKWQ.js";
+import "./chunk-6D3QAFNZ.js";
 import "./chunk-HTOTG4TS.js";
-import "./chunk-G3FZ2ZJK.js";
+import "./chunk-GEQFMH5M.js";
 import "./chunk-B6RIGNEO.js";
 import "./chunk-XNLSTHDK.js";
 import "./chunk-Y5PA7DVK.js";
 import {
   parse
-} from "./chunk-6LZM3I4Q.js";
+} from "./chunk-BF5DRGRZ.js";
 import "./chunk-WZWDS3W4.js";
 import "./chunk-PZLD7RTK.js";
 
@@ -144,6 +147,7 @@ var scan = (dir, pkgName) => {
   return found;
 };
 var rank = (node) => {
+  if (node.importer) return 0;
   let r = 2;
   for (const { from } of node.edgesIn) {
     if (from.mainImporter) return 0;
@@ -163,7 +167,7 @@ var aliasOf = (node) => {
   const n = (edges.find((e) => e.from.mainImporter) ?? edges.find((e) => e.from.importer))?.name;
   return n === node.name ? void 0 : n;
 };
-var scannable = (node) => !node.importer && node.inVltStore() && splitDepID(node.id)[0] !== "file";
+var scannable = (node) => node.importer ? !node.mainImporter : node.inVltStore() && splitDepID(node.id)[0] !== "file";
 var shipsSkills = (node) => scannable(node) && scan(realOr(resolve(node.projectRoot, node.location)), node.name).length > 0;
 var discoverSkills = (nodes, scurry, mounts = []) => {
   const key = (name, path) => `${lc(name)}\0${norm(path)}`;
@@ -220,49 +224,6 @@ var discoverSkills = (nodes, scurry, mounts = []) => {
   return { skills, scanned };
 };
 
-// ../../src/graph/src/skills/gitignore.ts
-import { lstatSync, readFileSync as readFileSync2, writeFileSync } from "node:fs";
-import { join } from "node:path";
-var GITIGNORE_BEGIN = "# >>> vlt agent skills (links into node_modules)";
-var GITIGNORE_END = "# <<< vlt agent skills";
-var sorted = (names) => [...names].sort((a, b) => a.localeCompare(b, "en")).map((n) => `/${n}`);
-var update = (file, { add, remove }) => {
-  const st = lstatSync(file, { throwIfNoEntry: false });
-  if (st && !st.isFile()) return "refused";
-  const text = st ? readFileSync2(file, "utf8") : "";
-  const eol = text.includes("\r\n") ? "\r\n" : "\n";
-  const lines = text.split(eol);
-  const begin = lines.findIndex((l) => l.trim() === GITIGNORE_BEGIN);
-  const end = lines.findIndex(
-    (l, i) => begin !== -1 && i > begin && l.trim() === GITIGNORE_END
-  );
-  let out;
-  if (end === -1) {
-    if (!add.length) return "ok";
-    out = (text && !text.endsWith(eol) ? text + eol : text) + [GITIGNORE_BEGIN, ...sorted(add), GITIGNORE_END].join(eol) + eol;
-  } else {
-    const rm = new Set(sorted(remove));
-    const block = lines.slice(begin + 1, end).filter((l) => !rm.has(l.trim()));
-    const have = new Set(block.map((l) => l.trim()));
-    lines.splice(
-      begin + 1,
-      end - begin - 1,
-      ...block,
-      ...sorted(add).filter((l) => !have.has(l))
-    );
-    out = lines.join(eol);
-  }
-  if (out !== text) writeFileSync(file, out);
-  return "ok";
-};
-var editGitignore = (dir, edit) => {
-  try {
-    return update(join(dir, ".gitignore"), edit);
-  } catch {
-    return "refused";
-  }
-};
-
 // ../../src/graph/src/skills/mask.ts
 var escape = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 var globRegExp = (pattern) => new RegExp(`^${pattern.split("*").map(escape).join(".*")}$`, "i");
@@ -316,6 +277,17 @@ var dirsOf = (o, create = false) => skillsDirs({
   env: o.env,
   create
 });
+var workspaceDirs = (graph, scurry) => [...graph.importers].filter((n) => !n.mainImporter).map((n) => ({
+  id: n.id,
+  path: realOr(n.resolvedLocation(scurry))
+}));
+var allWorkspaces = (m) => m ? [
+  ...Monorepo.load(m.projectRoot, {
+    config: m.config,
+    scurry: m.scurry,
+    packageJson: m.packageJson
+  }).values()
+].map((ws) => ({ id: ws.id, path: realOr(ws.fullpath) })) : [];
 var liveOwners = (mounts) => mounts.flatMap(
   (m) => m.owner && existsSync(m.target) ? [m.owner] : []
 );
@@ -347,7 +319,11 @@ var report = (dropped, unscanned) => unscanned && dropped.length ? {
 var listSkills = async (o) => {
   const { graph, nodes, parts, unscanned } = await selectNodes(o);
   const { targets, scan: scan2, skipped } = dirsOf(o);
-  const { skills } = discoverSkills(nodes, o.scurry, readMounts(scan2));
+  const { skills } = discoverSkills(
+    nodes,
+    o.scurry,
+    readMounts(scan2, { workspaces: workspaceDirs(graph, o.scurry) })
+  );
   const { picked, dropped } = pick(skills, parts, unscanned);
   return {
     project: graph.mainImporter.name,
@@ -375,7 +351,8 @@ var linkSkills = async (o) => {
     conflicts: [],
     dirs: targets.map((d) => d.dir)
   };
-  const mounts = readMounts(scan2);
+  const workspaces = workspaceDirs(graph, o.scurry);
+  const mounts = readMounts(scan2, { workspaces });
   const byName = new Map(
     mounts.map((m) => [`${m.dir.dir}\0${lc2(m.name)}`, m])
   );
@@ -431,7 +408,9 @@ var linkSkills = async (o) => {
   const gone = [];
   const foreign = [];
   const kept = /* @__PURE__ */ new Set();
+  const made = /* @__PURE__ */ new Set();
   const where = /* @__PURE__ */ new Map();
+  let every;
   for (const { dir, winner, losers, m } of picks) {
     if (winner) {
       if (m && m.name !== winner.skill) {
@@ -439,10 +418,16 @@ var linkSkills = async (o) => {
         gone.push(m);
       }
       const mount = `${dir.dir}/${winner.skill}`;
-      const r = mountSkill(winner, dir);
+      const r = mountSkill(winner, dir, m?.name === winner.skill);
+      if (r === "linked") made.add(mount);
       if (r === "conflict") {
         res.conflicts.push(mount);
-        foreign.push({ dir, name: winner.skill });
+        every ??= allWorkspaces(o.monorepo);
+        if (!readMounts([dir], { workspaces: every }).some(
+          (l) => l.name === winner.skill
+        )) {
+          foreign.push({ dir, name: winner.skill });
+        }
       } else {
         const k = `${winner.id}\0${winner.skill}`;
         const linked = where.get(k) ?? [];
@@ -455,7 +440,7 @@ var linkSkills = async (o) => {
     for (const s of losers)
       res.conflicts.push(`${dir.dir}/${s.skill} (${label(s)})`);
   }
-  const after = readMounts(scan2);
+  const after = readMounts(scan2, { workspaces, made });
   const present = [];
   for (const m of after) {
     if (o.apply ? kept.has(m.mount) : !stale(m)) {

package/{skills-LR6GXW3X.js → skills-UBBMSBDQ.js}

@@ -11,21 +11,21 @@ import {createRequire as _vlt_createRequire} from "node:module";
 var require = _vlt_createRequire(import.meta.filename);
 import {
   mermaidOutput
-} from "./chunk-4UH3KMTD.js";
+} from "./chunk-36UIE654.js";
 import {
   assertQuery,
   linkSkills,
   listSkills
-} from "./chunk-2U4PVHP4.js";
-import "./chunk-SMXXFQPI.js";
+} from "./chunk-F5LZMLAQ.js";
+import "./chunk-YTDABXPD.js";
 import {
   styleTextStdout
-} from "./chunk-WHWPAYZY.js";
-import "./chunk-X6JKMIOU.js";
-import "./chunk-4TSHLSRK.js";
+} from "./chunk-KVWGMSPW.js";
+import "./chunk-LGQVZTYR.js";
+import "./chunk-EYGOEAJM.js";
 import {
   commandUsage
-} from "./chunk-CW56EJIL.js";
+} from "./chunk-HT6FS4VB.js";
 import {
   configLabel,
   savedLine,
@@ -35,20 +35,24 @@ import {
 } from "./chunk-W4T5CGCO.js";
 import {
   configWriteTarget
-} from "./chunk-XCQCYB6G.js";
-import "./chunk-VR7NRWAD.js";
+} from "./chunk-LP3ORD3D.js";
+import "./chunk-LCLRP64K.js";
 import "./chunk-SRWDPPLX.js";
-import "./chunk-IFEZ6BFV.js";
-import "./chunk-C6ZVVEFV.js";
+import "./chunk-JV5XR5JQ.js";
+import "./chunk-EMTGRCSE.js";
+import "./chunk-TQQO2F56.js";
 import "./chunk-4KCU2KZL.js";
 import "./chunk-WGDTG44V.js";
-import "./chunk-UZ6ICZE3.js";
-import "./chunk-CMLDLZZ3.js";
-import "./chunk-F7NPYSI2.js";
-import "./chunk-LUVDMEW4.js";
+import "./chunk-E74WGW5C.js";
+import "./chunk-GCTREKA4.js";
+import "./chunk-MCDLJZXT.js";
+import "./chunk-7M2VTFLP.js";
+import "./chunk-EFHOWRKU.js";
+import "./chunk-CAV7FKWQ.js";
+import "./chunk-6D3QAFNZ.js";
 import "./chunk-HTOTG4TS.js";
-import "./chunk-G3FZ2ZJK.js";
-import "./chunk-5KW6AOTT.js";
+import "./chunk-GEQFMH5M.js";
+import "./chunk-4GMNWW4C.js";
 import "./chunk-SUU2WETN.js";
 import "./chunk-B6RIGNEO.js";
 import "./chunk-XNLSTHDK.js";
@@ -57,7 +61,7 @@ import "./chunk-PDWPFR5T.js";
 import "./chunk-Y5PA7DVK.js";
 import {
   asError
-} from "./chunk-6LZM3I4Q.js";
+} from "./chunk-BF5DRGRZ.js";
 import {
   error
 } from "./chunk-WZWDS3W4.js";
@@ -154,9 +158,8 @@ var usage = () => commandUsage({
       \`.agents/skills\`, plus \`<folder>/skills\` for each agent folder
       at the project root (e.g. \`.claude/\`), or the \`skills-dir\`
       config. When packages ship skills with the same name, one is
-      linked and the others are reported. Only links made by vlt
-      (pointing into \`node_modules/.vlt\`) are ever replaced or
-      removed; anything else in the way is skipped.
+      linked and the others are reported. Only links made by vlt are
+      ever replaced or removed; anything else in the way is skipped.
 
       Use --target or a query after the subcommand to select packages
       using DSS query syntax. End a selector with