vscode-apollo 2.5.6 → 2.6.1

package/sampleWorkspace/sampleWorkspace.code-workspace

@@ -1,32 +1,53 @@
 {
   "folders": [
     {
-      "path": "localSchema",
+      "path": "localSchema"
     },
     {
-      "path": "clientSchema",
+      "path": "clientSchema"
     },
     {
-      "path": "spotifyGraph",
+      "path": "spotifyGraph"
     },
     {
-      "path": "httpSchema",
+      "path": "httpSchema"
     },
     {
-      "path": "localSchemaArray",
+      "path": "localSchemaArray"
     },
     {
-      "path": "rover",
+      "path": "rover"
     },
     {
-      "path": "configFileTypes",
+      "path": "configFileTypes"
     },
     {
-      "path": "../src/language-server/__tests__/fixtures/documents",
+      "path": "../src/language-server/__tests__/fixtures/documents"
     },
+    {
+      "path": "../src/__tests__/fixtures"
+    },
+    {
+      "path": "connectors-community/connectors"
+    }
   ],
   "settings": {
     "apollographql.devTools.showPanel": "detect",
     "apollographql.devTools.serverPort": 7095,
+    "editor.tokenColorCustomizations": {
+     "textMateRules": [
+        {
+          "scope": [ "meta.repository" ],
+          "settings": { "fontStyle": "underline" }
+        },
+        {
+          "scope": ["meta.repository.Comment.identifier"],
+          "settings": {
+            "foreground": "#ffffff17",
+            "fontStyle": ""
+          }
+        }
+      ]
+    },
   },
 }

package/src/__tests__/fixtures/textmate/test.apollo.connectors.mapping

@@ -0,0 +1,213 @@
+# SYNTAX TEST "source.apollo.connectors.mapping"
+
+
+foo
+#<---           repository.NamedFieldSelection
+foo bar
+#<---           repository.NamedFieldSelection
+#  ^            - repository.NamedFieldSelection
+#   ^^^         repository.NamedFieldSelection
+alias: field
+#<------------  repository.NamedFieldSelection
+
+$( foo )
+#<-------- repository.ExprPath
+$( foo ).bar
+#<------------ repository.ExprPath
+#       ^^^^ repository.PathStepDotAccess
+$( foo )->bar
+#<------------- repository.ExprPath
+#       ^^^^^ repository.PathStepArrowAccess
+$( foo )->bar("asd")
+#<-------------------- repository.ExprPath
+#       ^^^^^^^^^^^^ repository.PathStepArrowMethodArgs
+#             ^^^^^  repository.LitString
+
+
+$( foo )->ma("asd")    # not builtin function
+#         ^^          repository.PathStepArrowMethodArgs.beginCaptures.2
+#         ^^          - repository.PathStepArrowMethodArgs.beginCaptures.3
+$( foo )->map("asd")   # builtin function
+#         ^^^          repository.PathStepArrowMethodArgs.beginCaptures.2
+#         ^^^          repository.PathStepArrowMethodArgs.beginCaptures.3
+
+$foo
+#<-------- repository.VarPath
+$foo.bar
+#<-------- repository.VarPath
+#   ^^^^ repository.PathStepDotAccess
+$foo->bar
+#<--------- repository.VarPath
+#   ^^^^^ repository.PathStepArrowAccess
+$foo->bar("asd")
+#<---------------- repository.VarPath
+#   ^^^^^^^^^^^^ repository.PathStepArrowMethodArgs
+#         ^^^^^  repository.LitString
+
+
+asd.bar
+#<------- repository.KeyPath
+#  ^^^^ repository.PathStepDotAccess
+asd->bar
+#<-------- repository.KeyPath
+#  ^^^^^ repository.PathStepArrowAccess
+asd->bar("asd")
+#<--------------- repository.KeyPath
+#  ^^^^^^^^^^^^ repository.PathStepArrowMethodArgs
+#        ^^^^^  repository.LitString
+
+
+"asd".bar
+#<--------- repository.KeyPath
+#    ^^^^ repository.PathStepDotAccess
+"asd"->bar
+#<---------- repository.KeyPath
+#    ^^^^^ repository.PathStepArrowAccess
+"asd"->bar("asd")
+#<----------------- repository.KeyPath
+#    ^^^^^^^^^^^^ repository.PathStepArrowMethodArgs
+#          ^^^^^  repository.LitString
+
+## AtPath
+@
+#<~ repository.AtPath
+@.bar
+#<----- repository.AtPath
+#^^^^ repository.PathStepDotAccess
+@->bar
+#<------ repository.AtPath
+#^^^^^ repository.PathStepArrowAccess
+@->bar("asd")
+#<------------- repository.AtPath
+#^^^^^^^^^^^^ repository.PathStepArrowMethodArgs
+#      ^^^^^  repository.LitString
+
+
+@->a("asd")
+#    ^^^^^  repository.LitString
+#^^^^     ^ - repository.LitString
+@->a("a'd")
+#    ^^^^^  repository.LitString
+#^^^^     ^ - repository.LitString
+@->a("asd\\")
+#    ^^^^^^^  repository.LitString
+#^^^^       ^ - repository.LitString
+@->a("asd\"")
+#    ^^^^^^^  repository.LitString
+#^^^^       ^ - repository.LitString
+@->a("asd\\\"")
+#    ^^^^^^^^^  repository.LitString
+#^^^^         ^ - repository.LitString
+@->a("asd\\\\")
+#    ^^^^^^^^^  repository.LitString
+#^^^^         ^ - repository.LitString
+@->a("as\"d
+#    ^^^^^^ repository.LitString
+#^^^^       - repository.LitString
+as\\d")
+#<----- repository.LitString
+#     ^ - repository.LitString
+@->a('asd')
+#    ^^^^^  repository.LitString
+#^^^^     ^ - repository.LitString
+@->a('a"d')
+#    ^^^^^  repository.LitString
+#^^^^     ^ - repository.LitString
+@->a('asd\\')
+#    ^^^^^^^  repository.LitString
+#^^^^       ^ - repository.LitString
+@->a('asd\'')
+#    ^^^^^^^  repository.LitString
+#^^^^       ^ - repository.LitString
+@->a('asd\\\'')
+#    ^^^^^^^^^  repository.LitString
+#^^^^         ^ - repository.LitString
+@->a('asd\\\\')
+#    ^^^^^^^^^  repository.LitString
+#^^^^         ^ - repository.LitString
+@->a('as\'d
+#    ^^^^^^ repository.LitString
+#^^^^       - repository.LitString
+as\\d')
+#<----- repository.LitString
+#     ^ - repository.LitString
+
+
+@->a(1)
+#    ^  repository.LitNumber
+@->a(-1)
+#    ^^  repository.LitNumber
+@->a(1.0)
+#    ^^^  repository.LitNumber
+@->a(-1.0)
+#    ^^^^  repository.LitNumber
+@->a(1.)
+#    ^^  repository.LitNumber
+@->a(-1.)
+#    ^^^  repository.LitNumber
+@->a(.0)
+#    ^^  repository.LitNumber
+@->a(-.0)
+#    ^^^  repository.LitNumber
+
+@->a(true)
+#    ^^^^  repository.LitPrimitive.patterns.2
+@->a(false)
+#    ^^^^^  repository.LitPrimitive.patterns.2
+@->a(null)
+#    ^^^^  repository.LitPrimitive.patterns.2
+
+
+@->a({ foo: 1, bar: "baz" })
+#    ^^^^^^^^^^^^^^^^^^^^^^  repository.LitObject
+#      ^^^^^^  ^^^^^^^^^^    repository.LitProperty
+#    ^^      ^^          ^^  - repository.LitProperty
+
+@->a({
+#    ^                      repository.LitObject
+  a: 1,
+#<--------------------------- repository.LitObject
+#    ^                      repository.LitNumber
+# ^^^^                      repository.LitProperty
+#     ^                     - repository.LitProperty
+  b: "asd",
+#<--------------------------- repository.LitObject
+#    ^^^^^                  repository.LitString
+# ^^^^^^^^                  repository.LitProperty
+#         ^                 - repository.LitProperty
+  c: { foo: 1, bar: "baz" }
+#<--------------------------- repository.LitObject
+})
+#<~                         repository.LitObject
+
+
+@->a([ 1, "a", { foo: 1 } ])
+#    ^^^^^^^^^^^^^^^^^^^^^^  repository.LitArray
+#      ^                     repository.LitNumber
+#         ^^^                repository.LitString
+#              ^^^^^^^^^^    repository.LitObject
+#                ^^^^^^      repository.LitProperty
+#                     ^      repository.LitNumber
+
+@->a([
+#    ^      repository.LitArray
+  1,
+#<---------   repository.LitArray
+# ^                     repository.LitNumber
+  "a",
+#<---------   repository.LitArray
+# ^^^                repository.LitString
+  {foo:1}
+#<---------   repository.LitArray
+# ^^^^^^^   repository.LitObject
+#  ^^^^^    repository.LitProperty
+#      ^    repository.LitNumber
+])
+#<~         repository.LitArray
+
+
+@->a("y"->foo)
+#       ^^^^^ repository.LitPathTail
+
+@->a("y" || "foo" + $asd)
+#        ^^       ^        repository.LitOpChainCenter

package/src/__tests__/fixtures/textmate/test.connect.graphql

@@ -0,0 +1,104 @@
+# SYNTAX TEST "source.graphql"
+
+type Query {
+  post(id: ID!): Post
+    @connect(
+      source: "jsonPlaceholder"
+#             ^^^^^^^^^^^^^^^^^^       - repository.JSONSelectionString
+      http: {
+        GET:    "/posts/{ $args.id }"
+#               ^^^^^^^^^^^^^^^^^^^^^  repository.JSONSelectionString
+#                       ^^^^^^^^^^^^   repository.JSONSelectionString.patterns.embedded
+#               ^^^^^^^^            ^  - repository.JSONSelectionString.patterns.embedded
+#                         ^^^^^^^^     repository.VarPath
+#               ^^^^^^^^^^        ^^^  - repository.VarPath
+        POST:   "/posts/{ $args.id }"
+#               ^^^^^^^^^^^^^^^^^^^^^  repository.JSONSelectionString
+#                       ^^^^^^^^^^^^   repository.JSONSelectionString.patterns.embedded
+#               ^^^^^^^^            ^  - repository.JSONSelectionString.patterns.embedded
+#                         ^^^^^^^^     repository.VarPath
+#               ^^^^^^^^^^        ^^^  - repository.VarPath
+        PATCH:  "/posts/{ $args.id }"
+#               ^^^^^^^^^^^^^^^^^^^^^  repository.JSONSelectionString
+#                       ^^^^^^^^^^^^   repository.JSONSelectionString.patterns.embedded
+#               ^^^^^^^^            ^  - repository.JSONSelectionString.patterns.embedded
+#                         ^^^^^^^^     repository.VarPath
+#               ^^^^^^^^^^        ^^^  - repository.VarPath
+        DELETE: "/posts/{ $args.id }"
+#               ^^^^^^^^^^^^^^^^^^^^^  repository.JSONSelectionString
+#                       ^^^^^^^^^^^^   repository.JSONSelectionString.patterns.embedded
+#               ^^^^^^^^            ^  - repository.JSONSelectionString.patterns.embedded
+#                         ^^^^^^^^     repository.VarPath
+#               ^^^^^^^^^^        ^^^  - repository.VarPath
+        PUT:    "/posts/{ $args.id }"
+#               ^^^^^^^^^^^^^^^^^^^^^  repository.JSONSelectionString
+#                       ^^^^^^^^^^^^   repository.JSONSelectionString.patterns.embedded
+#               ^^^^^^^^            ^  - repository.JSONSelectionString.patterns.embedded
+#                         ^^^^^^^^     repository.VarPath
+#               ^^^^^^^^^^        ^^^  - repository.VarPath
+        headers: [{ name: "Authorization", value: "Bearer {$config.apiKey}" }]
+#                         ^^^^^^^^^^^^^^^         ^^^^^^^^^^^^^^^^^^^^^^^^    repository.JSONSelectionString
+#                                                         ^^^^^^^^^^^^^^^^    repository.JSONSelectionString.patterns.embedded
+#                                                          ^^^^^^^^^^^^^^     repository.VarPath
+        headers: [
+          { name: "Authorization", value: "Bearer {$config.apiKey}" }
+#                 ^^^^^^^^^^^^^^^         ^^^^^^^^^^^^^^^^^^^^^^^^            repository.JSONSelectionString
+#                                                 ^^^^^^^^^^^^^^^^            repository.JSONSelectionString.patterns.embedded
+#                                                  ^^^^^^^^^^^^^^             repository.VarPath
+        ]
+        headers: [
+          {
+            name: "Authorization",
+#                 ^^^^^^^^^^^^^^^            repository.JSONSelectionString
+            value: "Bearer {$config.apiKey}"
+#                  ^^^^^^^^^^^^^^^^^^^^^^^^  repository.JSONSelectionString
+#                           ^^^^^^^^^^^^^^   repository.JSONSelectionString.patterns.embedded repository.VarPath
+          }
+        ]
+        body: """  
+# ^^^^^^^^^^^^^^^                      - meta.embedded.block.connectors.mapping.graphql
+#                ^^^^^^^^^^^^^^^^^^^^^ meta.embedded.block.connectors.mapping.graphql
+        listing: {
+#<------------------------------------ meta.embedded.block.connectors.mapping.graphql
+#       ^^^^^^^                        repository.NamedSelection.patterns.3.beginCaptures.1
+#                ^                     repository.SubSelection
+          title: $args.input.title
+#<------------------------------------ meta.embedded.block.connectors.mapping.graphql
+#<------------------------------------ repository.SubSelection
+#         ^^^^^                        repository.NamedSelection.patterns.0.beginCaptures.1
+#                ^^^^^^^^^^^^^^^^^     repository.VarPath
+        }
+#<------------------------------------ meta.embedded.block.connectors.mapping.graphql
+#<--------                             repository.SubSelection
+        """
+#^^^^^^^                               meta.embedded.block.connectors.mapping.graphql
+#       ^^^^^^^^^^^^^^^^^^^^^^^^^      - meta.embedded.block.connectors.mapping.graphql
+      body: "foo: bar $.root { a }"
+#            ^^^^^^^^^^^^^^^^^^^^^     meta.embedded.line.connectors.mapping.graphql
+#^^^^^^^^^^^^                     ^    - meta.embedded.line.connectors.mapping.graphql
+#            ^^^^^^^^          ^       repository.NamedFieldSelection
+#                     ^^^^^^           repository.VarPath
+      }
+      selection: """  
+# ^^^^^^^^^^^^^^^^^^                   - meta.embedded.block.connectors.mapping.graphql
+#                   ^^^^^^^^^^^^^^^^^^ meta.embedded.block.connectors.mapping.graphql
+      foo: bar
+#<------------------------------------ meta.embedded.block.connectors.mapping.graphql
+#     ^^^^^^^^                         repository.NamedFieldSelection
+      $.root {
+#<------------------------------------ meta.embedded.block.connectors.mapping.graphql
+#     ^^^^^^                           repository.VarPath
+        a
+#<------------------------------------ meta.embedded.block.connectors.mapping.graphql
+      }
+#<------------------------------------ meta.embedded.block.connectors.mapping.graphql
+      """
+#^^^^^                                 meta.embedded.block.connectors.mapping.graphql
+#     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - meta.embedded.block.connectors.mapping.graphql
+      selection: "foo: bar $.root { a }"
+#                 ^^^^^^^^^^^^^^^^^^^^^    meta.embedded.line.connectors.mapping.graphql
+#^^^^^^^^^^^^^^^^^                     ^ - meta.embedded.line.connectors.mapping.graphql
+#                 ^^^^^^^^          ^    repository.NamedFieldSelection
+#                          ^^^^^^        repository.VarPath
+    )
+}

package/src/language-server/__tests__/fixtures/documents/functionCall.ts.snap

@@ -413,11 +413,11 @@
 #^^^ source.ts variable.other.readwrite.ts
 >(
 #^ source.ts meta.brace.round.ts
->  `query { test }`
+>  `query Q11 { test }`
 #^^ source.ts
 #  ^ source.ts string.template.ts punctuation.definition.string.template.begin.ts
-#   ^^^^^^^^^^^^^^ source.ts string.template.ts
-#                 ^ source.ts string.template.ts punctuation.definition.string.template.end.ts
+#   ^^^^^^^^^^^^^^^^^^ source.ts string.template.ts
+#                     ^ source.ts string.template.ts punctuation.definition.string.template.end.ts
 >  )
 #^^ source.ts
 #  ^ source.ts meta.brace.round.ts

package/syntaxes/build.ts

@@ -0,0 +1,266 @@
+#!/usr/bin/env node
+import { parseArgs, styleText } from "node:util";
+import {
+  watch as nodeWatch,
+  readdir,
+  readFile,
+  writeFile,
+} from "node:fs/promises";
+import yaml from "js-yaml";
+import { format, parse } from "node:path";
+import { optimize } from "oniguruma-parser/optimizer";
+
+const dir = import.meta.dirname;
+const {
+  values: { watch, debug, snapshot },
+  positionals,
+} = parseArgs({
+  options: {
+    watch: { type: "boolean", default: false },
+    debug: {
+      type: "boolean",
+      default: false,
+      description: "pattern names will be concatenated with the pattern path",
+    },
+    snapshot: {
+      type: "boolean",
+      default: false,
+      description: "pattern names will be replaced with the pattern path",
+    },
+  },
+  allowPositionals: true,
+});
+
+const colors = {
+  variable: "red",
+  availableVariable: "green",
+  style: "red",
+  availableStyle: "green",
+  regex: "magenta",
+  reference: "yellow",
+  path: "blue",
+  filename: ["blue", "underline"],
+} satisfies Record<string, Parameters<typeof styleText>[0]>;
+
+const files = new Set<string>();
+
+for (const filename of await readdir(dir)) {
+  if (positionals.length > 0) {
+    if (positionals.includes(parse(filename).base)) {
+      files.add(filename);
+    }
+  } else if (filename.endsWith(".yaml")) {
+    files.add(filename);
+  }
+}
+
+for (const filename of files) {
+  await build(filename);
+}
+
+if (watch) {
+  (async () => {
+    try {
+      const watcher = nodeWatch(dir);
+      for await (const event of watcher) {
+        if (event.eventType === "rename" || event.eventType === "change") {
+          const filename = event.filename;
+          if (files.has(filename)) {
+            await build(filename);
+          }
+        }
+      }
+    } catch (err) {
+      throw err;
+    }
+  })();
+}
+
+async function build(filename: string) {
+  const pathOverrides = new WeakMap<object, string[]>();
+  console.log(`Building ${filename}...`);
+  const { name, ext } = parse(filename);
+
+  try {
+    const content = await readFile(format({ dir, name, ext }), "utf8");
+    const parsed = yaml.load(content, {
+      filename,
+    }) as Record<string, any>;
+    const { variables = {}, styles = {} } = parsed;
+    delete parsed.variables;
+    delete parsed.styles;
+    const paths = new Map<object, string[]>();
+    const knownPatterns = new Map<string, object>();
+    const output =
+      JSON.stringify(
+        parsed,
+        function replacer(key, value) {
+          const currentPath = (paths.get(this) || []).concat(key);
+          if (value && typeof value === "object" && key !== "") {
+            paths.set(value, currentPath);
+          }
+          const isPattern =
+            currentPath.length == 2 && currentPath[0] === "repository";
+          if (isPattern) {
+            knownPatterns.set("#" + key, value);
+          }
+          if (debug || snapshot) {
+            // attach the respository pattern name for debugging
+            if (
+              typeof value === "object" &&
+              value !== null &&
+              currentPath[0] === "repository" &&
+              // top-level patterns
+              (currentPath.length == 2 ||
+                // nested inline patterns
+                (currentPath.length > 2 &&
+                  currentPath.at(-2) === "patterns" &&
+                  typeof value === "object" &&
+                  !("include" in value)) ||
+                // anything with a `debugName` property
+                "debugName" in value)
+            ) {
+              let debugPath = currentPath;
+              if ("debugName" in value) {
+                debugPath = currentPath.slice(0, -1).concat(value.debugName);
+                pathOverrides.set(value, debugPath);
+                delete value.debugName;
+              }
+
+              if (snapshot) {
+                // in snapshot mode we only are interested in the pattern names, not colorization details
+                delete value.name;
+              }
+              value.name =
+                (value.name ?? "meta") + "." + pathToString(debugPath, false);
+            }
+            if (snapshot && currentPath[0] === "repository" && key === "name") {
+              return pathToString(
+                pathOverrides.get(this) || currentPath.slice(0, -1),
+                false,
+              );
+            }
+          }
+          if (typeof value === "string") {
+            if (key === "begin" || key === "end" || key === "match") {
+              let regexString = value.replace(
+                /\{\{([\w#.]+)\}\}/g,
+                function replacer(_, reference: string) {
+                  let replaced: string;
+                  const patternMatch = /^(#\w+)\.(\w+)/.exec(reference);
+                  if (patternMatch) {
+                    const [, pattern, key] = patternMatch;
+                    const patternObject = knownPatterns.get(pattern);
+                    if (!patternObject) {
+                      throw new Error(
+                        `Pattern not found: ${styleText(colors.reference, pattern)}` +
+                          ` accessed from ${pathToString(currentPath)}`,
+                      );
+                    }
+                    replaced = patternObject[key];
+                  } else {
+                    if (!(reference in variables)) {
+                      throw new Error(
+                        `Variable not found: ${styleText(colors.variable, reference)}` +
+                          ` accessed from ${pathToString(currentPath)}` +
+                          ` with available variables: ${Object.keys(variables)
+                            .map((v) => styleText(colors.availableVariable, v))
+                            .join(", ")}`,
+                      );
+                    }
+                    replaced = variables[reference];
+                  }
+                  return `(?:${verify(
+                    replaced.replace(/\{\{(\w+)\}\}/g, replacer),
+                    `reference ${styleText(colors.variable, reference)} accessed from ` +
+                      pathToString(currentPath),
+                  )})`;
+                },
+              );
+
+              return verify(regexString, pathToString(currentPath));
+            } else if (key === "include" && value.startsWith("#")) {
+              if (!(value.slice(1) in parsed.repository)) {
+                console.warn(
+                  `Include pattern not found: ${styleText(colors.reference, value)} at path ${pathToString(currentPath)}`,
+                );
+              }
+            } else if (key === "name" || key === "contentName") {
+              return value.replace(
+                /\{\{\.([\w]+)\}\}/g,
+                function replacer(_, reference: string) {
+                  if (!(reference in styles)) {
+                    throw new Error(
+                      `Style not found: ${styleText(colors.style, reference)}` +
+                        ` accessed from ${pathToString(currentPath)}` +
+                        ` with available styles: ${Object.keys(styles)
+                          .map((v) => styleText(colors.availableStyle, v))
+                          .join(", ")}`,
+                    );
+                  }
+                  return styles[reference].replace(
+                    /\{\{\.([\w]+)\}\}/g,
+                    replacer,
+                  );
+                },
+              );
+            }
+          } else if (typeof value === "object" && value !== null) {
+            if (isPattern) {
+              if (typeof value.inherit === "string") {
+                const { inherit, ...rest } = value;
+                const inheritedPattern = knownPatterns.get(inherit);
+                if (!inheritedPattern) {
+                  throw new Error(
+                    `Pattern to inherit from not found: ${styleText(
+                      colors.reference,
+                      value.inherit,
+                    )} at path ${pathToString(currentPath)}`,
+                  );
+                }
+                if (inheritedPattern) {
+                  value = { ...inheritedPattern, ...rest };
+                }
+              }
+            }
+          }
+          return value;
+        },
+        2,
+      ) + "\n";
+
+    await writeFile(format({ dir, name, ext: ".json" }), output, "utf8");
+  } catch (err) {
+    console.log(
+      `Error building ${styleText(colors.filename, filename)}:\n`,
+      err instanceof Error ? err.message : err.toString(),
+    );
+  }
+}
+function verify(regexString: string, context: string) {
+  try {
+    return optimize(regexString, {
+      rules: {
+        // end rules might reference begin rules, so we allow orphan backreferences
+        allowOrphanBackrefs: true,
+        // Follow `vscode-oniguruma` which enables this Oniguruma option by default (see https://github.com/RedCMD/TmLanguage-Syntax-Highlighter/blob/973552cf6ea41646d0f8b1c1eb2430408e36b25e/src/Providers/CodeActionsProvider.ts#L230)
+        captureGroup: true,
+      },
+    }).pattern;
+  } catch (err) {
+    throw new Error(
+      `Invalid regex: ${styleText(colors.regex, regexString)} in context: ${context}\n${err}`,
+    );
+  }
+}
+function pathToString(path: string[], colorize = true) {
+  const text = path.reduce(
+    (acc, part) =>
+      acc +
+      (colorize && isFinite(+part)
+        ? "[" + part + "]"
+        : (acc ? "." : "") + part),
+    "",
+  );
+  return colorize ? styleText(colors.path, text) : text;
+}