@feiyoug/skill-lab 0.0.0 → 0.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +73 -0
- package/esm/analyzer/astgrep/client.d.ts +20 -8
- package/esm/analyzer/astgrep/client.d.ts.map +1 -1
- package/esm/analyzer/astgrep/client.js +58 -31
- package/esm/analyzer/config/default.d.ts +8 -0
- package/esm/analyzer/config/default.d.ts.map +1 -0
- package/esm/analyzer/config/default.js +91 -0
- package/esm/analyzer/config/helpers.d.ts +8 -0
- package/esm/analyzer/config/helpers.d.ts.map +1 -0
- package/esm/analyzer/config/helpers.js +72 -0
- package/esm/analyzer/config/mod.d.ts +4 -0
- package/esm/analyzer/config/mod.d.ts.map +1 -0
- package/esm/analyzer/config/mod.js +3 -0
- package/esm/analyzer/config/types.d.ts +58 -0
- package/esm/analyzer/config/types.d.ts.map +1 -0
- package/esm/analyzer/{config.js → config/types.js} +0 -28
- package/esm/analyzer/logging.d.ts +3 -0
- package/esm/analyzer/logging.d.ts.map +1 -0
- package/esm/analyzer/logging.js +6 -0
- package/esm/analyzer/mod.d.ts +12 -5
- package/esm/analyzer/mod.d.ts.map +1 -1
- package/esm/analyzer/mod.js +25 -12
- package/esm/analyzer/result.d.ts +35 -0
- package/esm/analyzer/result.d.ts.map +1 -0
- package/esm/analyzer/result.js +311 -0
- package/esm/analyzer/rules/bash/commands/mod.d.ts +1 -0
- package/esm/analyzer/rules/bash/commands/mod.d.ts.map +1 -1
- package/esm/analyzer/rules/bash/commands/mod.js +3 -0
- package/esm/analyzer/rules/bash/commands/pip.d.ts +3 -0
- package/esm/analyzer/rules/bash/commands/pip.d.ts.map +1 -0
- package/esm/analyzer/rules/bash/commands/pip.js +14 -0
- package/esm/analyzer/rules/bash/extractFileRefs.d.ts +1 -1
- package/esm/analyzer/rules/bash/extractFileRefs.d.ts.map +1 -1
- package/esm/analyzer/rules/bash/extractFileRefs.js +2 -2
- package/esm/analyzer/rules/bash/inline-command-classifier.d.ts +1 -1
- package/esm/analyzer/rules/bash/inline-command-classifier.d.ts.map +1 -1
- package/esm/analyzer/rules/bash/inline-command-classifier.js +4 -4
- package/esm/analyzer/rules/javascript/extractFileRefs.d.ts +3 -4
- package/esm/analyzer/rules/javascript/extractFileRefs.d.ts.map +1 -1
- package/esm/analyzer/rules/javascript/extractFileRefs.js +3 -4
- package/esm/analyzer/rules/markdown/extractCodeBlocks.d.ts.map +1 -1
- package/esm/analyzer/rules/markdown/extractCodeBlocks.js +6 -3
- package/esm/analyzer/rules/markdown/extractFileRefs.d.ts.map +1 -1
- package/esm/analyzer/rules/markdown/extractFileRefs.js +2 -0
- package/esm/analyzer/rules/python/extractFileRefs.d.ts +1 -1
- package/esm/analyzer/rules/python/extractFileRefs.d.ts.map +1 -1
- package/esm/analyzer/rules/python/extractFileRefs.js +2 -2
- package/esm/analyzer/steps/001-discovery/discover-files.d.ts +4 -0
- package/esm/analyzer/steps/001-discovery/discover-files.d.ts.map +1 -1
- package/esm/analyzer/steps/001-discovery/discover-files.js +18 -2
- package/esm/analyzer/steps/001-discovery/mod.d.ts.map +1 -1
- package/esm/analyzer/steps/001-discovery/mod.js +39 -9
- package/esm/analyzer/steps/002-permissions/mod.d.ts.map +1 -1
- package/esm/analyzer/steps/002-permissions/mod.js +156 -73
- package/esm/analyzer/steps/002-permissions/scan-file.d.ts +1 -1
- package/esm/analyzer/steps/002-permissions/scan-file.d.ts.map +1 -1
- package/esm/analyzer/steps/002-permissions/scan-file.js +40 -5
- package/esm/analyzer/steps/002-permissions/seed-frontmatter.js +2 -2
- package/esm/analyzer/steps/003-risks/dep-risks.d.ts +3 -0
- package/esm/analyzer/steps/003-risks/dep-risks.d.ts.map +1 -0
- package/esm/analyzer/steps/003-risks/dep-risks.js +74 -0
- package/esm/analyzer/steps/003-risks/helpers.d.ts +1 -0
- package/esm/analyzer/steps/003-risks/helpers.d.ts.map +1 -1
- package/esm/analyzer/steps/003-risks/helpers.js +1 -0
- package/esm/analyzer/steps/003-risks/mod.d.ts +3 -2
- package/esm/analyzer/steps/003-risks/mod.d.ts.map +1 -1
- package/esm/analyzer/steps/003-risks/mod.js +41 -4
- package/esm/analyzer/steps/003-risks/policy.d.ts +7 -0
- package/esm/analyzer/steps/003-risks/policy.d.ts.map +1 -0
- package/esm/analyzer/steps/003-risks/policy.js +23 -0
- package/esm/analyzer/steps/003-risks/rule-mapped.d.ts +2 -2
- package/esm/analyzer/steps/003-risks/rule-mapped.d.ts.map +1 -1
- package/esm/analyzer/steps/003-risks/rule-mapped.js +83 -2
- package/esm/analyzer/steps/003-risks/scoring.d.ts +9 -1
- package/esm/analyzer/steps/003-risks/scoring.d.ts.map +1 -1
- package/esm/analyzer/steps/003-risks/scoring.js +55 -42
- package/esm/analyzer/treesitter/client.d.ts +31 -0
- package/esm/analyzer/treesitter/client.d.ts.map +1 -0
- package/esm/analyzer/{treesiter → treesitter}/client.js +43 -39
- package/esm/analyzer/treesitter/registry.d.ts +73 -0
- package/esm/analyzer/treesitter/registry.d.ts.map +1 -0
- package/esm/analyzer/treesitter/registry.js +165 -0
- package/esm/analyzer/types.d.ts +14 -28
- package/esm/analyzer/types.d.ts.map +1 -1
- package/esm/deps/jsr.io/@deno-library/progress/1.5.1/deps.d.ts +3 -0
- package/esm/deps/jsr.io/@deno-library/progress/1.5.1/deps.d.ts.map +1 -0
- package/esm/deps/jsr.io/@deno-library/progress/1.5.1/deps.js +3 -0
- package/esm/deps/jsr.io/@deno-library/progress/1.5.1/mod.d.ts +93 -0
- package/esm/deps/jsr.io/@deno-library/progress/1.5.1/mod.d.ts.map +1 -0
- package/esm/deps/jsr.io/@deno-library/progress/1.5.1/mod.js +297 -0
- package/esm/deps/jsr.io/@deno-library/progress/1.5.1/multi.d.ts +84 -0
- package/esm/deps/jsr.io/@deno-library/progress/1.5.1/multi.d.ts.map +1 -0
- package/esm/deps/jsr.io/@deno-library/progress/1.5.1/multi.js +268 -0
- package/esm/deps/jsr.io/@deno-library/progress/1.5.1/time.d.ts +18 -0
- package/esm/deps/jsr.io/@deno-library/progress/1.5.1/time.d.ts.map +1 -0
- package/esm/deps/jsr.io/@deno-library/progress/1.5.1/time.js +45 -0
- package/esm/deps/jsr.io/@std/fmt/1.0.3/colors.d.ts +700 -0
- package/esm/deps/jsr.io/@std/fmt/1.0.3/colors.d.ts.map +1 -0
- package/esm/deps/jsr.io/@std/fmt/1.0.3/colors.js +903 -0
- package/esm/deps/jsr.io/@std/io/0.225.0/types.d.ts +146 -0
- package/esm/deps/jsr.io/@std/io/0.225.0/types.d.ts.map +1 -0
- package/esm/deps/jsr.io/@std/io/0.225.0/types.js +15 -0
- package/esm/deps/jsr.io/@std/io/0.225.0/write_all.d.ts +51 -0
- package/esm/deps/jsr.io/@std/io/0.225.0/write_all.d.ts.map +1 -0
- package/esm/deps/jsr.io/@std/io/0.225.0/write_all.js +61 -0
- package/esm/shared/deep_merge.d.ts +12 -0
- package/esm/shared/deep_merge.d.ts.map +1 -0
- package/esm/shared/deep_merge.js +49 -0
- package/esm/shared/mod.d.ts +1 -0
- package/esm/shared/mod.d.ts.map +1 -1
- package/esm/shared/mod.js +1 -0
- package/esm/shared/types/filetypes.d.ts +2 -2
- package/esm/shared/types/filetypes.d.ts.map +1 -1
- package/esm/shared/types/permissions.d.ts +1 -1
- package/esm/shared/types/permissions.d.ts.map +1 -1
- package/esm/shared/types/risks.d.ts +4 -1
- package/esm/shared/types/risks.d.ts.map +1 -1
- package/esm/skillreader/types.d.ts +2 -2
- package/esm/skillreader/types.d.ts.map +1 -1
- package/esm/skillreader/types.js +2 -2
- package/package.json +1 -1
- package/script/analyzer/astgrep/client.d.ts +20 -8
- package/script/analyzer/astgrep/client.d.ts.map +1 -1
- package/script/analyzer/astgrep/client.js +58 -64
- package/script/analyzer/config/default.d.ts +8 -0
- package/script/analyzer/config/default.d.ts.map +1 -0
- package/script/analyzer/config/default.js +94 -0
- package/script/analyzer/config/helpers.d.ts +8 -0
- package/script/analyzer/config/helpers.d.ts.map +1 -0
- package/script/analyzer/config/helpers.js +76 -0
- package/script/analyzer/config/mod.d.ts +4 -0
- package/script/analyzer/config/mod.d.ts.map +1 -0
- package/script/analyzer/config/mod.js +21 -0
- package/script/analyzer/config/types.d.ts +58 -0
- package/script/analyzer/config/types.d.ts.map +1 -0
- package/script/analyzer/{config.js → config/types.js} +1 -29
- package/script/analyzer/logging.d.ts +3 -0
- package/script/analyzer/logging.d.ts.map +1 -0
- package/script/analyzer/logging.js +9 -0
- package/script/analyzer/mod.d.ts +12 -5
- package/script/analyzer/mod.d.ts.map +1 -1
- package/script/analyzer/mod.js +35 -20
- package/script/analyzer/result.d.ts +35 -0
- package/script/analyzer/result.d.ts.map +1 -0
- package/script/analyzer/result.js +315 -0
- package/script/analyzer/rules/bash/commands/mod.d.ts +1 -0
- package/script/analyzer/rules/bash/commands/mod.d.ts.map +1 -1
- package/script/analyzer/rules/bash/commands/mod.js +3 -0
- package/script/analyzer/rules/bash/commands/pip.d.ts +3 -0
- package/script/analyzer/rules/bash/commands/pip.d.ts.map +1 -0
- package/script/analyzer/rules/bash/commands/pip.js +17 -0
- package/script/analyzer/rules/bash/extractFileRefs.d.ts +1 -1
- package/script/analyzer/rules/bash/extractFileRefs.d.ts.map +1 -1
- package/script/analyzer/rules/bash/extractFileRefs.js +2 -2
- package/script/analyzer/rules/bash/inline-command-classifier.d.ts +1 -1
- package/script/analyzer/rules/bash/inline-command-classifier.d.ts.map +1 -1
- package/script/analyzer/rules/bash/inline-command-classifier.js +4 -4
- package/script/analyzer/rules/javascript/extractFileRefs.d.ts +3 -4
- package/script/analyzer/rules/javascript/extractFileRefs.d.ts.map +1 -1
- package/script/analyzer/rules/javascript/extractFileRefs.js +3 -4
- package/script/analyzer/rules/markdown/extractCodeBlocks.d.ts.map +1 -1
- package/script/analyzer/rules/markdown/extractCodeBlocks.js +6 -3
- package/script/analyzer/rules/markdown/extractFileRefs.d.ts.map +1 -1
- package/script/analyzer/rules/markdown/extractFileRefs.js +2 -0
- package/script/analyzer/rules/python/extractFileRefs.d.ts +1 -1
- package/script/analyzer/rules/python/extractFileRefs.d.ts.map +1 -1
- package/script/analyzer/rules/python/extractFileRefs.js +2 -2
- package/script/analyzer/steps/001-discovery/discover-files.d.ts +4 -0
- package/script/analyzer/steps/001-discovery/discover-files.d.ts.map +1 -1
- package/script/analyzer/steps/001-discovery/discover-files.js +18 -2
- package/script/analyzer/steps/001-discovery/mod.d.ts.map +1 -1
- package/script/analyzer/steps/001-discovery/mod.js +77 -11
- package/script/analyzer/steps/002-permissions/mod.d.ts.map +1 -1
- package/script/analyzer/steps/002-permissions/mod.js +194 -75
- package/script/analyzer/steps/002-permissions/scan-file.d.ts +1 -1
- package/script/analyzer/steps/002-permissions/scan-file.d.ts.map +1 -1
- package/script/analyzer/steps/002-permissions/scan-file.js +40 -5
- package/script/analyzer/steps/002-permissions/seed-frontmatter.js +3 -3
- package/script/analyzer/steps/003-risks/dep-risks.d.ts +3 -0
- package/script/analyzer/steps/003-risks/dep-risks.d.ts.map +1 -0
- package/script/analyzer/steps/003-risks/dep-risks.js +77 -0
- package/script/analyzer/steps/003-risks/helpers.d.ts +1 -0
- package/script/analyzer/steps/003-risks/helpers.d.ts.map +1 -1
- package/script/analyzer/steps/003-risks/helpers.js +1 -0
- package/script/analyzer/steps/003-risks/mod.d.ts +3 -2
- package/script/analyzer/steps/003-risks/mod.d.ts.map +1 -1
- package/script/analyzer/steps/003-risks/mod.js +77 -4
- package/script/analyzer/steps/003-risks/policy.d.ts +7 -0
- package/script/analyzer/steps/003-risks/policy.d.ts.map +1 -0
- package/script/analyzer/steps/003-risks/policy.js +29 -0
- package/script/analyzer/steps/003-risks/rule-mapped.d.ts +2 -2
- package/script/analyzer/steps/003-risks/rule-mapped.d.ts.map +1 -1
- package/script/analyzer/steps/003-risks/rule-mapped.js +83 -2
- package/script/analyzer/steps/003-risks/scoring.d.ts +9 -1
- package/script/analyzer/steps/003-risks/scoring.d.ts.map +1 -1
- package/script/analyzer/steps/003-risks/scoring.js +55 -42
- package/script/analyzer/treesitter/client.d.ts +31 -0
- package/script/analyzer/treesitter/client.d.ts.map +1 -0
- package/script/analyzer/treesitter/client.js +136 -0
- package/script/analyzer/treesitter/registry.d.ts +73 -0
- package/script/analyzer/treesitter/registry.d.ts.map +1 -0
- package/script/analyzer/treesitter/registry.js +206 -0
- package/script/analyzer/types.d.ts +14 -28
- package/script/analyzer/types.d.ts.map +1 -1
- package/script/deps/jsr.io/@deno-library/progress/1.5.1/deps.d.ts +3 -0
- package/script/deps/jsr.io/@deno-library/progress/1.5.1/deps.d.ts.map +1 -0
- package/script/deps/jsr.io/@deno-library/progress/1.5.1/deps.js +10 -0
- package/script/deps/jsr.io/@deno-library/progress/1.5.1/mod.d.ts +93 -0
- package/script/deps/jsr.io/@deno-library/progress/1.5.1/mod.d.ts.map +1 -0
- package/script/deps/jsr.io/@deno-library/progress/1.5.1/mod.js +334 -0
- package/script/deps/jsr.io/@deno-library/progress/1.5.1/multi.d.ts +84 -0
- package/script/deps/jsr.io/@deno-library/progress/1.5.1/multi.d.ts.map +1 -0
- package/script/deps/jsr.io/@deno-library/progress/1.5.1/multi.js +305 -0
- package/script/deps/jsr.io/@deno-library/progress/1.5.1/time.d.ts +18 -0
- package/script/deps/jsr.io/@deno-library/progress/1.5.1/time.d.ts.map +1 -0
- package/script/deps/jsr.io/@deno-library/progress/1.5.1/time.js +48 -0
- package/script/deps/jsr.io/@std/fmt/1.0.3/colors.d.ts +700 -0
- package/script/deps/jsr.io/@std/fmt/1.0.3/colors.d.ts.map +1 -0
- package/script/deps/jsr.io/@std/fmt/1.0.3/colors.js +986 -0
- package/script/deps/jsr.io/@std/io/0.225.0/types.d.ts +146 -0
- package/script/deps/jsr.io/@std/io/0.225.0/types.d.ts.map +1 -0
- package/script/deps/jsr.io/@std/io/0.225.0/types.js +18 -0
- package/script/deps/jsr.io/@std/io/0.225.0/write_all.d.ts +51 -0
- package/script/deps/jsr.io/@std/io/0.225.0/write_all.d.ts.map +1 -0
- package/script/deps/jsr.io/@std/io/0.225.0/write_all.js +65 -0
- package/script/shared/deep_merge.d.ts +12 -0
- package/script/shared/deep_merge.d.ts.map +1 -0
- package/script/shared/deep_merge.js +53 -0
- package/script/shared/mod.d.ts +1 -0
- package/script/shared/mod.d.ts.map +1 -1
- package/script/shared/mod.js +1 -0
- package/script/shared/types/filetypes.d.ts +2 -2
- package/script/shared/types/filetypes.d.ts.map +1 -1
- package/script/shared/types/permissions.d.ts +1 -1
- package/script/shared/types/permissions.d.ts.map +1 -1
- package/script/shared/types/risks.d.ts +4 -1
- package/script/shared/types/risks.d.ts.map +1 -1
- package/script/skillreader/types.d.ts +2 -2
- package/script/skillreader/types.d.ts.map +1 -1
- package/script/skillreader/types.js +2 -2
- package/src/_dnt.polyfills.ts +27 -0
- package/src/_dnt.shims.ts +64 -0
- package/src/analyzer/astgrep/client.ts +184 -0
- package/src/analyzer/astgrep/mod.ts +2 -0
- package/src/analyzer/config/default.ts +98 -0
- package/src/analyzer/config/helpers.ts +107 -0
- package/src/analyzer/config/mod.ts +3 -0
- package/src/analyzer/config/types.ts +103 -0
- package/src/analyzer/logging.ts +8 -0
- package/src/analyzer/mod.ts +118 -0
- package/src/analyzer/result.ts +393 -0
- package/src/analyzer/rules/bash/astTypes.ts +5 -0
- package/src/analyzer/rules/bash/commands/bd.ts +23 -0
- package/src/analyzer/rules/bash/commands/cron.ts +21 -0
- package/src/analyzer/rules/bash/commands/docker.ts +37 -0
- package/src/analyzer/rules/bash/commands/eval.ts +52 -0
- package/src/analyzer/rules/bash/commands/generic.ts +16 -0
- package/src/analyzer/rules/bash/commands/gh.ts +21 -0
- package/src/analyzer/rules/bash/commands/git.ts +28 -0
- package/src/analyzer/rules/bash/commands/mod.ts +38 -0
- package/src/analyzer/rules/bash/commands/node.ts +64 -0
- package/src/analyzer/rules/bash/commands/openspec.ts +16 -0
- package/src/analyzer/rules/bash/commands/pip.ts +16 -0
- package/src/analyzer/rules/bash/commands/sudo.ts +21 -0
- package/src/analyzer/rules/bash/destructive.ts +28 -0
- package/src/analyzer/rules/bash/extractFileRefs.ts +101 -0
- package/src/analyzer/rules/bash/filesystem.ts +50 -0
- package/src/analyzer/rules/bash/injection.ts +21 -0
- package/src/analyzer/rules/bash/inline-command-classifier.ts +94 -0
- package/src/analyzer/rules/bash/mod.ts +23 -0
- package/src/analyzer/rules/bash/network.ts +64 -0
- package/src/analyzer/rules/bash/secret-detection.ts +43 -0
- package/src/analyzer/rules/javascript/astTypes.ts +8 -0
- package/src/analyzer/rules/javascript/extractFileRefs.ts +131 -0
- package/src/analyzer/rules/javascript/filesystem.ts +28 -0
- package/src/analyzer/rules/javascript/injection.ts +21 -0
- package/src/analyzer/rules/javascript/mod.ts +26 -0
- package/src/analyzer/rules/javascript/network.ts +27 -0
- package/src/analyzer/rules/javascript/secret-detection.ts +68 -0
- package/src/analyzer/rules/javascript/subprocess.ts +16 -0
- package/src/analyzer/rules/markdown/astTypes.ts +35 -0
- package/src/analyzer/rules/markdown/extractCodeBlocks.ts +101 -0
- package/src/analyzer/rules/markdown/extractFileRefs.ts +179 -0
- package/src/analyzer/rules/markdown/mod.ts +12 -0
- package/src/analyzer/rules/mod.ts +77 -0
- package/src/analyzer/rules/python/astTypes.ts +9 -0
- package/src/analyzer/rules/python/extractFileRefs.ts +92 -0
- package/src/analyzer/rules/python/mod.ts +15 -0
- package/src/analyzer/rules/python/network.ts +26 -0
- package/src/analyzer/rules/python/secret-detection.ts +30 -0
- package/src/analyzer/rules/shared/file-refs.ts +38 -0
- package/src/analyzer/rules/shared/network-evaluators.ts +107 -0
- package/src/analyzer/rules/shared/prompt-injection.ts +48 -0
- package/src/analyzer/rules/shared/secret-evaluators.ts +13 -0
- package/src/analyzer/rules/text/mod.ts +12 -0
- package/src/analyzer/rules/typescript/mod.ts +7 -0
- package/src/analyzer/steps/001-discovery/discover-files.ts +211 -0
- package/src/analyzer/steps/001-discovery/filter-files.ts +72 -0
- package/src/analyzer/steps/001-discovery/mod.ts +103 -0
- package/src/analyzer/steps/002-permissions/mod.ts +329 -0
- package/src/analyzer/steps/002-permissions/scan-file.ts +258 -0
- package/src/analyzer/steps/002-permissions/seed-frontmatter.ts +66 -0
- package/src/analyzer/steps/002-permissions/synthesize.ts +42 -0
- package/src/analyzer/steps/003-risks/dep-risks.ts +89 -0
- package/src/analyzer/steps/003-risks/helpers.ts +41 -0
- package/src/analyzer/steps/003-risks/mod.ts +86 -0
- package/src/analyzer/steps/003-risks/policy.ts +38 -0
- package/src/analyzer/steps/003-risks/rule-mapped.ts +206 -0
- package/src/analyzer/steps/003-risks/scoring.ts +117 -0
- package/src/analyzer/steps/mod.ts +3 -0
- package/src/analyzer/treesitter/client.ts +120 -0
- package/src/analyzer/treesitter/registry.ts +198 -0
- package/src/analyzer/types.ts +78 -0
- package/src/analyzer/utils/code-block-path.ts +33 -0
- package/src/analyzer/utils/id-generator.ts +59 -0
- package/src/analyzer/utils/secret-validator.ts +29 -0
- package/src/analyzer/utils/url-parser.ts +25 -0
- package/src/deps/jsr.io/@deno-library/progress/1.5.1/deps.ts +3 -0
- package/src/deps/jsr.io/@deno-library/progress/1.5.1/mod.ts +265 -0
- package/src/deps/jsr.io/@deno-library/progress/1.5.1/multi.ts +250 -0
- package/src/deps/jsr.io/@deno-library/progress/1.5.1/time.ts +69 -0
- package/src/deps/jsr.io/@std/fmt/1.0.3/colors.ts +1004 -0
- package/src/deps/jsr.io/@std/internal/1.0.12/_os.ts +15 -0
- package/src/deps/jsr.io/@std/internal/1.0.12/os.ts +7 -0
- package/src/deps/jsr.io/@std/io/0.225.0/types.ts +157 -0
- package/src/deps/jsr.io/@std/io/0.225.0/write_all.ts +65 -0
- package/src/deps/jsr.io/@std/path/1.1.4/_common/assert_path.ts +10 -0
- package/src/deps/jsr.io/@std/path/1.1.4/_common/basename.ts +53 -0
- package/src/deps/jsr.io/@std/path/1.1.4/_common/common.ts +26 -0
- package/src/deps/jsr.io/@std/path/1.1.4/_common/constants.ts +49 -0
- package/src/deps/jsr.io/@std/path/1.1.4/_common/dirname.ts +9 -0
- package/src/deps/jsr.io/@std/path/1.1.4/_common/format.ts +25 -0
- package/src/deps/jsr.io/@std/path/1.1.4/_common/from_file_url.ts +12 -0
- package/src/deps/jsr.io/@std/path/1.1.4/_common/glob_to_reg_exp.ts +295 -0
- package/src/deps/jsr.io/@std/path/1.1.4/_common/normalize.ts +9 -0
- package/src/deps/jsr.io/@std/path/1.1.4/_common/normalize_string.ts +74 -0
- package/src/deps/jsr.io/@std/path/1.1.4/_common/relative.ts +10 -0
- package/src/deps/jsr.io/@std/path/1.1.4/_common/strip_trailing_separators.ts +25 -0
- package/src/deps/jsr.io/@std/path/1.1.4/_common/to_file_url.ts +17 -0
- package/src/deps/jsr.io/@std/path/1.1.4/basename.ts +37 -0
- package/src/deps/jsr.io/@std/path/1.1.4/common.ts +35 -0
- package/src/deps/jsr.io/@std/path/1.1.4/constants.ts +18 -0
- package/src/deps/jsr.io/@std/path/1.1.4/dirname.ts +30 -0
- package/src/deps/jsr.io/@std/path/1.1.4/extname.ts +29 -0
- package/src/deps/jsr.io/@std/path/1.1.4/format.ts +30 -0
- package/src/deps/jsr.io/@std/path/1.1.4/from_file_url.ts +30 -0
- package/src/deps/jsr.io/@std/path/1.1.4/glob_to_regexp.ts +94 -0
- package/src/deps/jsr.io/@std/path/1.1.4/is_absolute.ts +30 -0
- package/src/deps/jsr.io/@std/path/1.1.4/is_glob.ts +49 -0
- package/src/deps/jsr.io/@std/path/1.1.4/join.ts +31 -0
- package/src/deps/jsr.io/@std/path/1.1.4/join_globs.ts +42 -0
- package/src/deps/jsr.io/@std/path/1.1.4/mod.ts +217 -0
- package/src/deps/jsr.io/@std/path/1.1.4/normalize.ts +33 -0
- package/src/deps/jsr.io/@std/path/1.1.4/normalize_glob.ts +45 -0
- package/src/deps/jsr.io/@std/path/1.1.4/parse.ts +44 -0
- package/src/deps/jsr.io/@std/path/1.1.4/posix/_util.ts +10 -0
- package/src/deps/jsr.io/@std/path/1.1.4/posix/basename.ts +62 -0
- package/src/deps/jsr.io/@std/path/1.1.4/posix/constants.ts +15 -0
- package/src/deps/jsr.io/@std/path/1.1.4/posix/dirname.ts +72 -0
- package/src/deps/jsr.io/@std/path/1.1.4/posix/extname.ts +96 -0
- package/src/deps/jsr.io/@std/path/1.1.4/posix/format.ts +31 -0
- package/src/deps/jsr.io/@std/path/1.1.4/posix/from_file_url.ts +25 -0
- package/src/deps/jsr.io/@std/path/1.1.4/posix/glob_to_regexp.ts +94 -0
- package/src/deps/jsr.io/@std/path/1.1.4/posix/is_absolute.ts +25 -0
- package/src/deps/jsr.io/@std/path/1.1.4/posix/join.ts +46 -0
- package/src/deps/jsr.io/@std/path/1.1.4/posix/join_globs.ts +45 -0
- package/src/deps/jsr.io/@std/path/1.1.4/posix/normalize.ts +63 -0
- package/src/deps/jsr.io/@std/path/1.1.4/posix/normalize_glob.ts +43 -0
- package/src/deps/jsr.io/@std/path/1.1.4/posix/parse.ts +121 -0
- package/src/deps/jsr.io/@std/path/1.1.4/posix/relative.ts +103 -0
- package/src/deps/jsr.io/@std/path/1.1.4/posix/resolve.ts +71 -0
- package/src/deps/jsr.io/@std/path/1.1.4/posix/to_file_url.ts +32 -0
- package/src/deps/jsr.io/@std/path/1.1.4/posix/to_namespaced_path.ts +21 -0
- package/src/deps/jsr.io/@std/path/1.1.4/relative.ts +32 -0
- package/src/deps/jsr.io/@std/path/1.1.4/resolve.ts +32 -0
- package/src/deps/jsr.io/@std/path/1.1.4/to_file_url.ts +30 -0
- package/src/deps/jsr.io/@std/path/1.1.4/to_namespaced_path.ts +31 -0
- package/src/deps/jsr.io/@std/path/1.1.4/types.ts +40 -0
- package/src/deps/jsr.io/@std/path/1.1.4/windows/_util.ts +28 -0
- package/src/deps/jsr.io/@std/path/1.1.4/windows/basename.ts +54 -0
- package/src/deps/jsr.io/@std/path/1.1.4/windows/constants.ts +15 -0
- package/src/deps/jsr.io/@std/path/1.1.4/windows/dirname.ts +118 -0
- package/src/deps/jsr.io/@std/path/1.1.4/windows/extname.ts +90 -0
- package/src/deps/jsr.io/@std/path/1.1.4/windows/format.ts +31 -0
- package/src/deps/jsr.io/@std/path/1.1.4/windows/from_file_url.ts +34 -0
- package/src/deps/jsr.io/@std/path/1.1.4/windows/glob_to_regexp.ts +92 -0
- package/src/deps/jsr.io/@std/path/1.1.4/windows/is_absolute.ts +40 -0
- package/src/deps/jsr.io/@std/path/1.1.4/windows/join.ts +78 -0
- package/src/deps/jsr.io/@std/path/1.1.4/windows/join_globs.ts +46 -0
- package/src/deps/jsr.io/@std/path/1.1.4/windows/normalize.ts +136 -0
- package/src/deps/jsr.io/@std/path/1.1.4/windows/normalize_glob.ts +43 -0
- package/src/deps/jsr.io/@std/path/1.1.4/windows/parse.ts +184 -0
- package/src/deps/jsr.io/@std/path/1.1.4/windows/relative.ts +128 -0
- package/src/deps/jsr.io/@std/path/1.1.4/windows/resolve.ts +178 -0
- package/src/deps/jsr.io/@std/path/1.1.4/windows/to_file_url.ts +38 -0
- package/src/deps/jsr.io/@std/path/1.1.4/windows/to_namespaced_path.ts +60 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/_chars.ts +55 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/_dumper_state.ts +841 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/_loader_state.ts +1780 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/_schema.ts +183 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/_type/binary.ts +127 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/_type/bool.ts +37 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/_type/float.ts +112 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/_type/int.ts +174 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/_type/map.ts +17 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/_type/merge.ts +13 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/_type/nil.ts +27 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/_type/omap.ts +30 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/_type/pairs.ts +22 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/_type/regexp.ts +33 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/_type/seq.ts +13 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/_type/set.ts +17 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/_type/str.ts +12 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/_type/timestamp.ts +101 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/_type/undefined.ts +23 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/_type.ts +49 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/_utils.ts +16 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/mod.ts +54 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/parse.ts +128 -0
- package/src/deps/jsr.io/@std/yaml/1.0.11/stringify.ts +118 -0
- package/src/shared/deep_merge.ts +73 -0
- package/src/shared/mod.ts +2 -0
- package/src/shared/types/filetypes.ts +101 -0
- package/src/shared/types/findings.ts +7 -0
- package/src/shared/types/mod.ts +6 -0
- package/src/shared/types/permissions.ts +17 -0
- package/src/shared/types/references.ts +62 -0
- package/src/shared/types/risks.ts +72 -0
- package/src/shared/types/syntaxNode.ts +7 -0
- package/src/skillreader/cloudStorage/mod.ts +170 -0
- package/src/skillreader/factory.ts +71 -0
- package/src/skillreader/fs/git.ts +153 -0
- package/src/skillreader/fs/mod.ts +84 -0
- package/src/skillreader/github/base.ts +162 -0
- package/src/skillreader/github/githubApi.ts +40 -0
- package/src/skillreader/github/githubRaw.ts +24 -0
- package/src/skillreader/github/mod.ts +45 -0
- package/src/skillreader/github/utils.ts +40 -0
- package/src/skillreader/manifest.ts +67 -0
- package/src/skillreader/mod.ts +26 -0
- package/src/skillreader/types.ts +150 -0
- package/src/skillreader/utils/frontmatter-parser.ts +72 -0
- package/src/skillreader/utils/http-range.ts +38 -0
- package/src/skillreader/utils/mod.ts +12 -0
- package/esm/analyzer/astgrep/registry.d.ts +0 -18
- package/esm/analyzer/astgrep/registry.d.ts.map +0 -1
- package/esm/analyzer/astgrep/registry.js +0 -71
- package/esm/analyzer/config.d.ts +0 -27
- package/esm/analyzer/config.d.ts.map +0 -1
- package/esm/analyzer/steps/003-risks/output.d.ts +0 -3
- package/esm/analyzer/steps/003-risks/output.d.ts.map +0 -1
- package/esm/analyzer/steps/003-risks/output.js +0 -16
- package/esm/analyzer/treesiter/client.d.ts +0 -26
- package/esm/analyzer/treesiter/client.d.ts.map +0 -1
- package/script/analyzer/astgrep/registry.d.ts +0 -18
- package/script/analyzer/astgrep/registry.d.ts.map +0 -1
- package/script/analyzer/astgrep/registry.js +0 -109
- package/script/analyzer/config.d.ts +0 -27
- package/script/analyzer/config.d.ts.map +0 -1
- package/script/analyzer/steps/003-risks/output.d.ts +0 -3
- package/script/analyzer/steps/003-risks/output.d.ts.map +0 -1
- package/script/analyzer/steps/003-risks/output.js +0 -19
- package/script/analyzer/treesiter/client.d.ts +0 -26
- package/script/analyzer/treesiter/client.d.ts.map +0 -1
- package/script/analyzer/treesiter/client.js +0 -165
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
// Copyright 2018-2025 the Deno authors. MIT license.
|
|
2
|
+
// This module is browser compatible.
|
|
3
|
+
|
|
4
|
+
import type { GlobOptions } from "./_common/glob_to_reg_exp.js";
|
|
5
|
+
import { isWindows } from "../../internal/1.0.12/os.js";
|
|
6
|
+
|
|
7
|
+
import { globToRegExp as posixGlobToRegExp } from "./posix/glob_to_regexp.js";
|
|
8
|
+
import {
|
|
9
|
+
globToRegExp as windowsGlobToRegExp,
|
|
10
|
+
} from "./windows/glob_to_regexp.js";
|
|
11
|
+
|
|
12
|
+
export type { GlobOptions };
|
|
13
|
+
|
|
14
|
+
/**
|
|
15
|
+
* Converts a glob string to a regular expression.
|
|
16
|
+
*
|
|
17
|
+
* Tries to match bash glob expansion as closely as possible.
|
|
18
|
+
*
|
|
19
|
+
* Basic glob syntax:
|
|
20
|
+
* - `*` - Matches everything without leaving the path segment.
|
|
21
|
+
* - `?` - Matches any single character.
|
|
22
|
+
* - `{foo,bar}` - Matches `foo` or `bar`.
|
|
23
|
+
* - `[abcd]` - Matches `a`, `b`, `c` or `d`.
|
|
24
|
+
* - `[a-d]` - Matches `a`, `b`, `c` or `d`.
|
|
25
|
+
* - `[!abcd]` - Matches any single character besides `a`, `b`, `c` or `d`.
|
|
26
|
+
* - `[[:<class>:]]` - Matches any character belonging to `<class>`.
|
|
27
|
+
* - `[[:alnum:]]` - Matches any digit or letter.
|
|
28
|
+
* - `[[:digit:]abc]` - Matches any digit, `a`, `b` or `c`.
|
|
29
|
+
* - See https://facelessuser.github.io/wcmatch/glob/#posix-character-classes
|
|
30
|
+
* for a complete list of supported character classes.
|
|
31
|
+
* - `\` - Escapes the next character for an `os` other than `"windows"`.
|
|
32
|
+
* - \` - Escapes the next character for `os` set to `"windows"`.
|
|
33
|
+
* - `/` - Path separator.
|
|
34
|
+
* - `\` - Additional path separator only for `os` set to `"windows"`.
|
|
35
|
+
*
|
|
36
|
+
* Extended syntax:
|
|
37
|
+
* - Requires `{ extended: true }`.
|
|
38
|
+
* - `?(foo|bar)` - Matches 0 or 1 instance of `{foo,bar}`.
|
|
39
|
+
* - `@(foo|bar)` - Matches 1 instance of `{foo,bar}`. They behave the same.
|
|
40
|
+
* - `*(foo|bar)` - Matches _n_ instances of `{foo,bar}`.
|
|
41
|
+
* - `+(foo|bar)` - Matches _n > 0_ instances of `{foo,bar}`.
|
|
42
|
+
* - `!(foo|bar)` - Matches anything other than `{foo,bar}`.
|
|
43
|
+
* - See https://www.linuxjournal.com/content/bash-extended-globbing.
|
|
44
|
+
*
|
|
45
|
+
* Globstar syntax:
|
|
46
|
+
* - Requires `{ globstar: true }`.
|
|
47
|
+
* - `**` - Matches any number of any path segments.
|
|
48
|
+
* - Must comprise its entire path segment in the provided glob.
|
|
49
|
+
* - See https://www.linuxjournal.com/content/globstar-new-bash-globbing-option.
|
|
50
|
+
*
|
|
51
|
+
* Note the following properties:
|
|
52
|
+
* - The generated `RegExp` is anchored at both start and end.
|
|
53
|
+
* - Repeating and trailing separators are tolerated. Trailing separators in the
|
|
54
|
+
* provided glob have no meaning and are discarded.
|
|
55
|
+
* - Absolute globs will only match absolute paths, etc.
|
|
56
|
+
* - Empty globs will match nothing.
|
|
57
|
+
* - Any special glob syntax must be contained to one path segment. For example,
|
|
58
|
+
* `?(foo|bar/baz)` is invalid. The separator will take precedence and the
|
|
59
|
+
* first segment ends with an unclosed group.
|
|
60
|
+
* - If a path segment ends with unclosed groups or a dangling escape prefix, a
|
|
61
|
+
* parse error has occurred. Every character for that segment is taken
|
|
62
|
+
* literally in this event.
|
|
63
|
+
*
|
|
64
|
+
* Limitations:
|
|
65
|
+
* - A negative group like `!(foo|bar)` will wrongly be converted to a negative
|
|
66
|
+
* look-ahead followed by a wildcard. This means that `!(foo).js` will wrongly
|
|
67
|
+
* fail to match `foobar.js`, even though `foobar` is not `foo`. Effectively,
|
|
68
|
+
* `!(foo|bar)` is treated like `!(@(foo|bar)*)`. This will work correctly if
|
|
69
|
+
* the group occurs not nested at the end of the segment.
|
|
70
|
+
*
|
|
71
|
+
* @example Usage
|
|
72
|
+
* ```ts
|
|
73
|
+
* import { globToRegExp } from "@std/path/glob-to-regexp";
|
|
74
|
+
* import { assertEquals } from "@std/assert";
|
|
75
|
+
*
|
|
76
|
+
* if (Deno.build.os === "windows") {
|
|
77
|
+
* assertEquals(globToRegExp("*.js"), /^[^\\/]*\.js(?:\\|\/)*$/);
|
|
78
|
+
* } else {
|
|
79
|
+
* assertEquals(globToRegExp("*.js"), /^[^/]*\.js\/*$/);
|
|
80
|
+
* }
|
|
81
|
+
* ```
|
|
82
|
+
*
|
|
83
|
+
* @param glob Glob string to convert.
|
|
84
|
+
* @param options Conversion options.
|
|
85
|
+
* @returns The regular expression equivalent to the glob.
|
|
86
|
+
*/
|
|
87
|
+
export function globToRegExp(
|
|
88
|
+
glob: string,
|
|
89
|
+
options: GlobOptions = {},
|
|
90
|
+
): RegExp {
|
|
91
|
+
return isWindows
|
|
92
|
+
? windowsGlobToRegExp(glob, options)
|
|
93
|
+
: posixGlobToRegExp(glob, options);
|
|
94
|
+
}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
// Copyright 2018-2025 the Deno authors. MIT license.
|
|
2
|
+
// This module is browser compatible.
|
|
3
|
+
|
|
4
|
+
import { isWindows } from "../../internal/1.0.12/os.js";
|
|
5
|
+
import { isAbsolute as posixIsAbsolute } from "./posix/is_absolute.js";
|
|
6
|
+
import { isAbsolute as windowsIsAbsolute } from "./windows/is_absolute.js";
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* Verifies whether provided path is absolute.
|
|
10
|
+
*
|
|
11
|
+
* @example Usage
|
|
12
|
+
* ```ts
|
|
13
|
+
* import { isAbsolute } from "@std/path/is-absolute";
|
|
14
|
+
* import { assert, assertFalse } from "@std/assert";
|
|
15
|
+
*
|
|
16
|
+
* if (Deno.build.os === "windows") {
|
|
17
|
+
* assert(isAbsolute("C:\\home\\foo"));
|
|
18
|
+
* assertFalse(isAbsolute("home\\foo"));
|
|
19
|
+
* } else {
|
|
20
|
+
* assert(isAbsolute("/home/foo"));
|
|
21
|
+
* assertFalse(isAbsolute("home/foo"));
|
|
22
|
+
* }
|
|
23
|
+
* ```
|
|
24
|
+
*
|
|
25
|
+
* @param path Path to be verified as absolute.
|
|
26
|
+
* @returns `true` if path is absolute, `false` otherwise
|
|
27
|
+
*/
|
|
28
|
+
export function isAbsolute(path: string): boolean {
|
|
29
|
+
return isWindows ? windowsIsAbsolute(path) : posixIsAbsolute(path);
|
|
30
|
+
}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
// Copyright 2018-2025 the Deno authors. MIT license.
|
|
2
|
+
// This module is browser compatible.
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* Test whether the given string is a glob.
|
|
6
|
+
*
|
|
7
|
+
* @example Usage
|
|
8
|
+
* ```ts
|
|
9
|
+
* import { isGlob } from "@std/path/is-glob";
|
|
10
|
+
* import { assert } from "@std/assert";
|
|
11
|
+
*
|
|
12
|
+
* assert(!isGlob("foo/bar/../baz"));
|
|
13
|
+
* assert(isGlob("foo/*ar/../baz"));
|
|
14
|
+
* ```
|
|
15
|
+
*
|
|
16
|
+
* @param str String to test.
|
|
17
|
+
* @returns `true` if the given string is a glob, otherwise `false`
|
|
18
|
+
*/
|
|
19
|
+
export function isGlob(str: string): boolean {
|
|
20
|
+
const chars: Record<string, string> = { "{": "}", "(": ")", "[": "]" };
|
|
21
|
+
const regex =
|
|
22
|
+
/\\(.)|(^!|\*|\?|[\].+)]\?|\[[^[\\\]]+\]|\{[^{\\}]+\}|\(\?[:!=][^\\)]+\)|\([^(|]+\|[^\\)]+\)|@\([^)]+\))/;
|
|
23
|
+
|
|
24
|
+
if (str === "") {
|
|
25
|
+
return false;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
let match: RegExpExecArray | null;
|
|
29
|
+
|
|
30
|
+
while ((match = regex.exec(str))) {
|
|
31
|
+
if (match[2]) return true;
|
|
32
|
+
let idx = match.index + match[0].length;
|
|
33
|
+
|
|
34
|
+
// if an open bracket/brace/paren is escaped,
|
|
35
|
+
// set the index to the next closing character
|
|
36
|
+
const open = match[1];
|
|
37
|
+
const close = open ? chars[open] : null;
|
|
38
|
+
if (open && close) {
|
|
39
|
+
const n = str.indexOf(close, idx);
|
|
40
|
+
if (n !== -1) {
|
|
41
|
+
idx = n + 1;
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
str = str.slice(idx);
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
return false;
|
|
49
|
+
}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
// Copyright 2018-2025 the Deno authors. MIT license.
|
|
2
|
+
// This module is browser compatible.
|
|
3
|
+
|
|
4
|
+
import { isWindows } from "../../internal/1.0.12/os.js";
|
|
5
|
+
import { join as posixJoin } from "./posix/join.js";
|
|
6
|
+
import { join as windowsJoin } from "./windows/join.js";
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* Joins a sequence of paths, then normalizes the resulting path.
|
|
10
|
+
*
|
|
11
|
+
* @example Usage
|
|
12
|
+
* ```ts
|
|
13
|
+
* import { join } from "@std/path/join";
|
|
14
|
+
* import { assertEquals } from "@std/assert";
|
|
15
|
+
*
|
|
16
|
+
* if (Deno.build.os === "windows") {
|
|
17
|
+
* assertEquals(join("C:\\foo", "bar", "baz\\quux", "garply", ".."), "C:\\foo\\bar\\baz\\quux");
|
|
18
|
+
* assertEquals(join(new URL("file:///C:/foo"), "bar", "baz/asdf", "quux", ".."), "C:\\foo\\bar\\baz\\asdf");
|
|
19
|
+
* } else {
|
|
20
|
+
* assertEquals(join("/foo", "bar", "baz/quux", "garply", ".."), "/foo/bar/baz/quux");
|
|
21
|
+
* assertEquals(join(new URL("file:///foo"), "bar", "baz/asdf", "quux", ".."), "/foo/bar/baz/asdf");
|
|
22
|
+
* }
|
|
23
|
+
* ```
|
|
24
|
+
*
|
|
25
|
+
* @param path The path to join. This can be string or file URL.
|
|
26
|
+
* @param paths Paths to be joined and normalized.
|
|
27
|
+
* @returns The joined and normalized path.
|
|
28
|
+
*/
|
|
29
|
+
export function join(path: string | URL, ...paths: string[]): string {
|
|
30
|
+
return isWindows ? windowsJoin(path, ...paths) : posixJoin(path, ...paths);
|
|
31
|
+
}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
// Copyright 2018-2025 the Deno authors. MIT license.
|
|
2
|
+
// This module is browser compatible.
|
|
3
|
+
|
|
4
|
+
import type { GlobOptions } from "./_common/glob_to_reg_exp.js";
|
|
5
|
+
import { isWindows } from "../../internal/1.0.12/os.js";
|
|
6
|
+
import { joinGlobs as posixJoinGlobs } from "./posix/join_globs.js";
|
|
7
|
+
import { joinGlobs as windowsJoinGlobs } from "./windows/join_globs.js";
|
|
8
|
+
|
|
9
|
+
export type { GlobOptions };
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* Joins a sequence of globs, then normalizes the resulting glob.
|
|
13
|
+
*
|
|
14
|
+
* Behaves like {@linkcode https://jsr.io/@std/path/doc/~/join | join()}, but
|
|
15
|
+
* doesn't collapse `**\/..` when `globstar` is true.
|
|
16
|
+
*
|
|
17
|
+
* @example Usage
|
|
18
|
+
* ```ts
|
|
19
|
+
* import { joinGlobs } from "@std/path/join-globs";
|
|
20
|
+
* import { assertEquals } from "@std/assert";
|
|
21
|
+
*
|
|
22
|
+
* if (Deno.build.os === "windows") {
|
|
23
|
+
* assertEquals(joinGlobs(["foo", "bar", "..", "baz"]), "foo\\baz");
|
|
24
|
+
* assertEquals(joinGlobs(["foo", "**", "bar", "..", "baz"], { globstar: true }), "foo\\**\\baz");
|
|
25
|
+
* } else {
|
|
26
|
+
* assertEquals(joinGlobs(["foo", "bar", "..", "baz"]), "foo/baz");
|
|
27
|
+
* assertEquals(joinGlobs(["foo", "**", "bar", "..", "baz"], { globstar: true }), "foo/**\/baz");
|
|
28
|
+
* }
|
|
29
|
+
* ```
|
|
30
|
+
*
|
|
31
|
+
* @param globs Globs to be joined and normalized.
|
|
32
|
+
* @param options Glob options.
|
|
33
|
+
* @returns The joined and normalized glob string.
|
|
34
|
+
*/
|
|
35
|
+
export function joinGlobs(
|
|
36
|
+
globs: string[],
|
|
37
|
+
options: GlobOptions = {},
|
|
38
|
+
): string {
|
|
39
|
+
return isWindows
|
|
40
|
+
? windowsJoinGlobs(globs, options)
|
|
41
|
+
: posixJoinGlobs(globs, options);
|
|
42
|
+
}
|
|
@@ -0,0 +1,217 @@
|
|
|
1
|
+
// Copyright 2018-2025 the Deno authors. MIT license.
|
|
2
|
+
// Copyright the Browserify authors. MIT License.
|
|
3
|
+
// Ported mostly from https://github.com/browserify/path-browserify/
|
|
4
|
+
// This module is browser compatible.
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Utilities for working with OS-specific file paths.
|
|
8
|
+
*
|
|
9
|
+
* Functions from this module will automatically switch to support the path style
|
|
10
|
+
* of the current OS, either `windows` for Microsoft Windows, or `posix` for
|
|
11
|
+
* every other operating system, eg. Linux, MacOS, BSD etc.
|
|
12
|
+
*
|
|
13
|
+
* To use functions for a specific path style regardless of the current OS
|
|
14
|
+
* import the modules from the platform sub directory instead.
|
|
15
|
+
*
|
|
16
|
+
* ## Basic Path Operations
|
|
17
|
+
*
|
|
18
|
+
* ```ts
|
|
19
|
+
* import * as path from "@std/path";
|
|
20
|
+
* import { assertEquals } from "@std/assert";
|
|
21
|
+
*
|
|
22
|
+
* // Get components of a path
|
|
23
|
+
* if (Deno.build.os === "windows") {
|
|
24
|
+
* assertEquals(path.basename("C:\\Users\\user\\file.txt"), "file.txt");
|
|
25
|
+
* assertEquals(path.dirname("C:\\Users\\user\\file.txt"), "C:\\Users\\user");
|
|
26
|
+
* assertEquals(path.extname("C:\\Users\\user\\file.txt"), ".txt");
|
|
27
|
+
* } else {
|
|
28
|
+
* assertEquals(path.basename("/home/user/file.txt"), "file.txt");
|
|
29
|
+
* assertEquals(path.dirname("/home/user/file.txt"), "/home/user");
|
|
30
|
+
* assertEquals(path.extname("/home/user/file.txt"), ".txt");
|
|
31
|
+
* }
|
|
32
|
+
*
|
|
33
|
+
* // Join path segments
|
|
34
|
+
* if (Deno.build.os === "windows") {
|
|
35
|
+
* assertEquals(path.join("C:\\", "Users", "docs", "file.txt"), "C:\\Users\\docs\\file.txt");
|
|
36
|
+
* } else {
|
|
37
|
+
* assertEquals(path.join("/home", "user", "docs", "file.txt"), "/home/user/docs/file.txt");
|
|
38
|
+
* }
|
|
39
|
+
*
|
|
40
|
+
* // Normalize a path
|
|
41
|
+
* if (Deno.build.os === "windows") {
|
|
42
|
+
* assertEquals(path.normalize("C:\\Users\\user\\..\\temp\\.\\file.txt"), "C:\\Users\\temp\\file.txt");
|
|
43
|
+
* } else {
|
|
44
|
+
* assertEquals(path.normalize("/home/user/../temp/./file.txt"), "/home/temp/file.txt");
|
|
45
|
+
* }
|
|
46
|
+
*
|
|
47
|
+
* // Resolve absolute path
|
|
48
|
+
* if (Deno.build.os === "windows") {
|
|
49
|
+
* const resolved = path.resolve("C:\\foo", "docs", "file.txt");
|
|
50
|
+
* assertEquals(resolved, "C:\\foo\\docs\\file.txt");
|
|
51
|
+
* assertEquals(path.isAbsolute(resolved), true);
|
|
52
|
+
* } else {
|
|
53
|
+
* const resolved = path.resolve("/foo", "docs", "file.txt");
|
|
54
|
+
* assertEquals(resolved, "/foo/docs/file.txt");
|
|
55
|
+
* assertEquals(path.isAbsolute(resolved), true);
|
|
56
|
+
* }
|
|
57
|
+
*
|
|
58
|
+
* // Get relative path
|
|
59
|
+
* if (Deno.build.os === "windows") {
|
|
60
|
+
* assertEquals(path.relative("C:\\Users", "C:\\Users\\docs\\file.txt"), "docs\\file.txt");
|
|
61
|
+
* assertEquals(path.relative("C:\\Users", "D:\\Programs"), "D:\\Programs");
|
|
62
|
+
* } else {
|
|
63
|
+
* assertEquals(path.relative("/home/user", "/home/user/docs/file.txt"), "docs/file.txt");
|
|
64
|
+
* assertEquals(path.relative("/home/user", "/var/data"), "../../var/data");
|
|
65
|
+
* }
|
|
66
|
+
* ```
|
|
67
|
+
*
|
|
68
|
+
* ## Path Parsing and Formatting
|
|
69
|
+
*
|
|
70
|
+
* ```ts
|
|
71
|
+
* import * as path from "@std/path";
|
|
72
|
+
* import { assertEquals } from "@std/assert";
|
|
73
|
+
*
|
|
74
|
+
* if (Deno.build.os === "windows") {
|
|
75
|
+
* const parsedWindows = path.parse("C:\\Users\\user\\file.txt");
|
|
76
|
+
* assertEquals(parsedWindows.root, "C:\\");
|
|
77
|
+
* assertEquals(parsedWindows.dir, "C:\\Users\\user");
|
|
78
|
+
* assertEquals(parsedWindows.base, "file.txt");
|
|
79
|
+
* assertEquals(parsedWindows.ext, ".txt");
|
|
80
|
+
* assertEquals(parsedWindows.name, "file");
|
|
81
|
+
*
|
|
82
|
+
* // Format path from components (Windows)
|
|
83
|
+
* assertEquals(
|
|
84
|
+
* path.format({ dir: "C:\\Users\\user", base: "file.txt" }),
|
|
85
|
+
* "C:\\Users\\user\\file.txt"
|
|
86
|
+
* );
|
|
87
|
+
* } else {
|
|
88
|
+
* const parsedPosix = path.parse("/home/user/file.txt");
|
|
89
|
+
* assertEquals(parsedPosix.root, "/");
|
|
90
|
+
* assertEquals(parsedPosix.dir, "/home/user");
|
|
91
|
+
* assertEquals(parsedPosix.base, "file.txt");
|
|
92
|
+
* assertEquals(parsedPosix.ext, ".txt");
|
|
93
|
+
* assertEquals(parsedPosix.name, "file");
|
|
94
|
+
*
|
|
95
|
+
* // Format path from components (POSIX)
|
|
96
|
+
* assertEquals(
|
|
97
|
+
* path.format({ dir: "/home/user", base: "file.txt" }),
|
|
98
|
+
* "/home/user/file.txt"
|
|
99
|
+
* );
|
|
100
|
+
* }
|
|
101
|
+
* ```
|
|
102
|
+
*
|
|
103
|
+
* ## URL Conversion
|
|
104
|
+
*
|
|
105
|
+
* ```ts
|
|
106
|
+
* import * as path from "@std/path";
|
|
107
|
+
* import { assertEquals } from "@std/assert";
|
|
108
|
+
*
|
|
109
|
+
* // Convert between file URLs and paths
|
|
110
|
+
* if (Deno.build.os === "windows") {
|
|
111
|
+
* assertEquals(path.fromFileUrl("file:///C:/Users/user/file.txt"), "C:\\Users\\user\\file.txt");
|
|
112
|
+
* assertEquals(path.toFileUrl("C:\\Users\\user\\file.txt").href, "file:///C:/Users/user/file.txt");
|
|
113
|
+
* } else {
|
|
114
|
+
* assertEquals(path.fromFileUrl("file:///home/user/file.txt"), "/home/user/file.txt");
|
|
115
|
+
* assertEquals(path.toFileUrl("/home/user/file.txt").href, "file:///home/user/file.txt");
|
|
116
|
+
* }
|
|
117
|
+
* ```
|
|
118
|
+
*
|
|
119
|
+
* ## Path Properties
|
|
120
|
+
*
|
|
121
|
+
* ```ts
|
|
122
|
+
* import * as path from "@std/path";
|
|
123
|
+
* import { assertEquals } from "@std/assert";
|
|
124
|
+
*
|
|
125
|
+
* // Check if path is absolute
|
|
126
|
+
* if (Deno.build.os === "windows") {
|
|
127
|
+
* assertEquals(path.isAbsolute("C:\\Users"), true);
|
|
128
|
+
* assertEquals(path.isAbsolute("\\\\Server\\share"), true);
|
|
129
|
+
* assertEquals(path.isAbsolute("C:relative\\path"), false);
|
|
130
|
+
* assertEquals(path.isAbsolute("..\\relative\\path"), false);
|
|
131
|
+
* } else {
|
|
132
|
+
* assertEquals(path.isAbsolute("/home/user"), true);
|
|
133
|
+
* assertEquals(path.isAbsolute("./relative/path"), false);
|
|
134
|
+
* assertEquals(path.isAbsolute("../relative/path"), false);
|
|
135
|
+
* }
|
|
136
|
+
*
|
|
137
|
+
* // Convert to namespaced path (Windows-specific)
|
|
138
|
+
* if (Deno.build.os === "windows") {
|
|
139
|
+
* assertEquals(path.toNamespacedPath("C:\\Users\\file.txt"), "\\\\?\\C:\\Users\\file.txt");
|
|
140
|
+
* assertEquals(path.toNamespacedPath("\\\\server\\share\\file.txt"), "\\\\?\\UNC\\server\\share\\file.txt");
|
|
141
|
+
* } else {
|
|
142
|
+
* // On POSIX, toNamespacedPath returns the path unchanged
|
|
143
|
+
* assertEquals(path.toNamespacedPath("/home/user/file.txt"), "/home/user/file.txt");
|
|
144
|
+
* }
|
|
145
|
+
* ```
|
|
146
|
+
*
|
|
147
|
+
* ## Glob Pattern Utilities
|
|
148
|
+
*
|
|
149
|
+
* ```ts
|
|
150
|
+
* import * as path from "@std/path";
|
|
151
|
+
* import { assertEquals } from "@std/assert";
|
|
152
|
+
*
|
|
153
|
+
* // Check if a string is a glob pattern
|
|
154
|
+
* assertEquals(path.isGlob("*.txt"), true);
|
|
155
|
+
*
|
|
156
|
+
* // Convert glob pattern to RegExp
|
|
157
|
+
* const pattern = path.globToRegExp("*.txt");
|
|
158
|
+
* assertEquals(pattern.test("file.txt"), true);
|
|
159
|
+
*
|
|
160
|
+
* // Join multiple glob patterns
|
|
161
|
+
* if (Deno.build.os === "windows") {
|
|
162
|
+
* assertEquals(path.joinGlobs(["src", "**\\*.ts"]), "src\\**\\*.ts");
|
|
163
|
+
* } else {
|
|
164
|
+
* assertEquals(path.joinGlobs(["src", "**\/*.ts"]), "src/**\/*.ts");
|
|
165
|
+
* }
|
|
166
|
+
*
|
|
167
|
+
* // Normalize a glob pattern
|
|
168
|
+
* if (Deno.build.os === "windows") {
|
|
169
|
+
* assertEquals(path.normalizeGlob("src\\..\\**\\*.ts"), "**\\*.ts");
|
|
170
|
+
* } else {
|
|
171
|
+
* assertEquals(path.normalizeGlob("src/../**\/*.ts"), "**\/*.ts");
|
|
172
|
+
* }
|
|
173
|
+
* ```
|
|
174
|
+
*
|
|
175
|
+
* For POSIX-specific functions:
|
|
176
|
+
*
|
|
177
|
+
* ```ts
|
|
178
|
+
* import { fromFileUrl } from "@std/path/posix/from-file-url";
|
|
179
|
+
* import { assertEquals } from "@std/assert";
|
|
180
|
+
*
|
|
181
|
+
* assertEquals(fromFileUrl("file:///home/foo"), "/home/foo");
|
|
182
|
+
* ```
|
|
183
|
+
*
|
|
184
|
+
* For Windows-specific functions:
|
|
185
|
+
*
|
|
186
|
+
* ```ts
|
|
187
|
+
* import { fromFileUrl } from "@std/path/windows/from-file-url";
|
|
188
|
+
* import { assertEquals } from "@std/assert";
|
|
189
|
+
*
|
|
190
|
+
* assertEquals(fromFileUrl("file:///home/foo"), "\\home\\foo");
|
|
191
|
+
* ```
|
|
192
|
+
*
|
|
193
|
+
* Functions for working with URLs can be found in
|
|
194
|
+
* {@link ./doc/posix/~ | @std/path/posix}.
|
|
195
|
+
*
|
|
196
|
+
* @module
|
|
197
|
+
*/
|
|
198
|
+
export * from "./basename.js";
|
|
199
|
+
export * from "./constants.js";
|
|
200
|
+
export * from "./dirname.js";
|
|
201
|
+
export * from "./extname.js";
|
|
202
|
+
export * from "./format.js";
|
|
203
|
+
export * from "./from_file_url.js";
|
|
204
|
+
export * from "./is_absolute.js";
|
|
205
|
+
export * from "./join.js";
|
|
206
|
+
export * from "./normalize.js";
|
|
207
|
+
export * from "./parse.js";
|
|
208
|
+
export * from "./relative.js";
|
|
209
|
+
export * from "./resolve.js";
|
|
210
|
+
export * from "./to_file_url.js";
|
|
211
|
+
export * from "./to_namespaced_path.js";
|
|
212
|
+
export * from "./common.js";
|
|
213
|
+
export * from "./types.js";
|
|
214
|
+
export * from "./glob_to_regexp.js";
|
|
215
|
+
export * from "./is_glob.js";
|
|
216
|
+
export * from "./join_globs.js";
|
|
217
|
+
export * from "./normalize_glob.js";
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
// Copyright 2018-2025 the Deno authors. MIT license.
|
|
2
|
+
// This module is browser compatible.
|
|
3
|
+
|
|
4
|
+
import { isWindows } from "../../internal/1.0.12/os.js";
|
|
5
|
+
import { normalize as posixNormalize } from "./posix/normalize.js";
|
|
6
|
+
import { normalize as windowsNormalize } from "./windows/normalize.js";
|
|
7
|
+
/**
|
|
8
|
+
* Normalize the path, resolving `'..'` and `'.'` segments.
|
|
9
|
+
*
|
|
10
|
+
* Note: Resolving these segments does not necessarily mean that all will be
|
|
11
|
+
* eliminated. A `'..'` at the top-level will be preserved, and an empty path is
|
|
12
|
+
* canonically `'.'`.
|
|
13
|
+
*
|
|
14
|
+
* @example Usage
|
|
15
|
+
* ```ts
|
|
16
|
+
* import { normalize } from "@std/path/normalize";
|
|
17
|
+
* import { assertEquals } from "@std/assert";
|
|
18
|
+
*
|
|
19
|
+
* if (Deno.build.os === "windows") {
|
|
20
|
+
* assertEquals(normalize("C:\\foo\\bar\\..\\baz\\quux"), "C:\\foo\\baz\\quux");
|
|
21
|
+
* assertEquals(normalize(new URL("file:///C:/foo/bar/../baz/quux")), "C:\\foo\\baz\\quux");
|
|
22
|
+
* } else {
|
|
23
|
+
* assertEquals(normalize("/foo/bar/../baz/quux"), "/foo/baz/quux");
|
|
24
|
+
* assertEquals(normalize(new URL("file:///foo/bar/../baz/quux")), "/foo/baz/quux");
|
|
25
|
+
* }
|
|
26
|
+
* ```
|
|
27
|
+
*
|
|
28
|
+
* @param path Path to be normalized
|
|
29
|
+
* @returns The normalized path.
|
|
30
|
+
*/
|
|
31
|
+
export function normalize(path: string | URL): string {
|
|
32
|
+
return isWindows ? windowsNormalize(path) : posixNormalize(path);
|
|
33
|
+
}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
// Copyright 2018-2025 the Deno authors. MIT license.
|
|
2
|
+
// This module is browser compatible.
|
|
3
|
+
|
|
4
|
+
import type { GlobOptions } from "./_common/glob_to_reg_exp.js";
|
|
5
|
+
import { isWindows } from "../../internal/1.0.12/os.js";
|
|
6
|
+
import { normalizeGlob as posixNormalizeGlob } from "./posix/normalize_glob.js";
|
|
7
|
+
import {
|
|
8
|
+
normalizeGlob as windowsNormalizeGlob,
|
|
9
|
+
} from "./windows/normalize_glob.js";
|
|
10
|
+
|
|
11
|
+
export type { GlobOptions };
|
|
12
|
+
|
|
13
|
+
/**
|
|
14
|
+
* Normalizes a glob string.
|
|
15
|
+
*
|
|
16
|
+
* Behaves like
|
|
17
|
+
* {@linkcode https://jsr.io/@std/path/doc/~/normalize | normalize()}, but
|
|
18
|
+
* doesn't collapse "**\/.." when `globstar` is true.
|
|
19
|
+
*
|
|
20
|
+
* @example Usage
|
|
21
|
+
* ```ts
|
|
22
|
+
* import { normalizeGlob } from "@std/path/normalize-glob";
|
|
23
|
+
* import { assertEquals } from "@std/assert";
|
|
24
|
+
*
|
|
25
|
+
* if (Deno.build.os === "windows") {
|
|
26
|
+
* assertEquals(normalizeGlob("foo\\bar\\..\\baz"), "foo\\baz");
|
|
27
|
+
* assertEquals(normalizeGlob("foo\\**\\..\\bar\\..\\baz", { globstar: true }), "foo\\**\\..\\baz");
|
|
28
|
+
* } else {
|
|
29
|
+
* assertEquals(normalizeGlob("foo/bar/../baz"), "foo/baz");
|
|
30
|
+
* assertEquals(normalizeGlob("foo/**\/../bar/../baz", { globstar: true }), "foo/**\/../baz");
|
|
31
|
+
* }
|
|
32
|
+
* ```
|
|
33
|
+
*
|
|
34
|
+
* @param glob Glob string to normalize.
|
|
35
|
+
* @param options Glob options.
|
|
36
|
+
* @returns The normalized glob string.
|
|
37
|
+
*/
|
|
38
|
+
export function normalizeGlob(
|
|
39
|
+
glob: string,
|
|
40
|
+
options: GlobOptions = {},
|
|
41
|
+
): string {
|
|
42
|
+
return isWindows
|
|
43
|
+
? windowsNormalizeGlob(glob, options)
|
|
44
|
+
: posixNormalizeGlob(glob, options);
|
|
45
|
+
}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
// Copyright 2018-2025 the Deno authors. MIT license.
|
|
2
|
+
// This module is browser compatible.
|
|
3
|
+
|
|
4
|
+
import { isWindows } from "../../internal/1.0.12/os.js";
|
|
5
|
+
import type { ParsedPath } from "./types.js";
|
|
6
|
+
import { parse as posixParse } from "./posix/parse.js";
|
|
7
|
+
import { parse as windowsParse } from "./windows/parse.js";
|
|
8
|
+
|
|
9
|
+
export type { ParsedPath } from "./types.js";
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* Return an object containing the parsed components of the path.
|
|
13
|
+
*
|
|
14
|
+
* Use {@linkcode https://jsr.io/@std/path/doc/~/format | format()} to reverse
|
|
15
|
+
* the result.
|
|
16
|
+
*
|
|
17
|
+
* @example Usage
|
|
18
|
+
* ```ts
|
|
19
|
+
* import { parse } from "@std/path/parse";
|
|
20
|
+
* import { assertEquals } from "@std/assert";
|
|
21
|
+
*
|
|
22
|
+
* if (Deno.build.os === "windows") {
|
|
23
|
+
* const parsedPathObj = parse("C:\\path\\to\\script.ts");
|
|
24
|
+
* assertEquals(parsedPathObj.root, "C:\\");
|
|
25
|
+
* assertEquals(parsedPathObj.dir, "C:\\path\\to");
|
|
26
|
+
* assertEquals(parsedPathObj.base, "script.ts");
|
|
27
|
+
* assertEquals(parsedPathObj.ext, ".ts");
|
|
28
|
+
* assertEquals(parsedPathObj.name, "script");
|
|
29
|
+
* } else {
|
|
30
|
+
* const parsedPathObj = parse("/path/to/dir/script.ts");
|
|
31
|
+
* parsedPathObj.root; // "/"
|
|
32
|
+
* parsedPathObj.dir; // "/path/to/dir"
|
|
33
|
+
* parsedPathObj.base; // "script.ts"
|
|
34
|
+
* parsedPathObj.ext; // ".ts"
|
|
35
|
+
* parsedPathObj.name; // "script"
|
|
36
|
+
* }
|
|
37
|
+
* ```
|
|
38
|
+
*
|
|
39
|
+
* @param path Path to process
|
|
40
|
+
* @returns An object with the parsed path components.
|
|
41
|
+
*/
|
|
42
|
+
export function parse(path: string): ParsedPath {
|
|
43
|
+
return isWindows ? windowsParse(path) : posixParse(path);
|
|
44
|
+
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
// Copyright 2018-2025 the Deno authors. MIT license.
|
|
2
|
+
// Copyright the Browserify authors. MIT License.
|
|
3
|
+
// Ported from https://github.com/browserify/path-browserify/
|
|
4
|
+
// This module is browser compatible.
|
|
5
|
+
|
|
6
|
+
import { CHAR_FORWARD_SLASH } from "../_common/constants.js";
|
|
7
|
+
|
|
8
|
+
export function isPosixPathSeparator(code: number): boolean {
|
|
9
|
+
return code === CHAR_FORWARD_SLASH;
|
|
10
|
+
}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
// Copyright 2018-2025 the Deno authors. MIT license.
|
|
2
|
+
// This module is browser compatible.
|
|
3
|
+
|
|
4
|
+
import {
|
|
5
|
+
assertArgs,
|
|
6
|
+
lastPathSegment,
|
|
7
|
+
stripSuffix,
|
|
8
|
+
} from "../_common/basename.js";
|
|
9
|
+
import { fromFileUrl } from "./from_file_url.js";
|
|
10
|
+
import { stripTrailingSeparators } from "../_common/strip_trailing_separators.js";
|
|
11
|
+
import { isPosixPathSeparator } from "./_util.js";
|
|
12
|
+
|
|
13
|
+
/**
|
|
14
|
+
* Return the last portion of a `path`.
|
|
15
|
+
* Trailing directory separators are ignored, and optional suffix is removed.
|
|
16
|
+
*
|
|
17
|
+
* @example Usage
|
|
18
|
+
* ```ts
|
|
19
|
+
* import { basename } from "@std/path/posix/basename";
|
|
20
|
+
* import { assertEquals } from "@std/assert";
|
|
21
|
+
*
|
|
22
|
+
* assertEquals(basename("/home/user/Documents/"), "Documents");
|
|
23
|
+
* assertEquals(basename("/home/user/Documents/image.png"), "image.png");
|
|
24
|
+
* assertEquals(basename("/home/user/Documents/image.png", ".png"), "image");
|
|
25
|
+
* assertEquals(basename(new URL("file:///home/user/Documents/image.png")), "image.png");
|
|
26
|
+
* assertEquals(basename(new URL("file:///home/user/Documents/image.png"), ".png"), "image");
|
|
27
|
+
* ```
|
|
28
|
+
*
|
|
29
|
+
* @example Working with URLs
|
|
30
|
+
*
|
|
31
|
+
* Note: This function doesn't automatically strip hash and query parts from
|
|
32
|
+
* URLs. If your URL contains a hash or query, remove them before passing the
|
|
33
|
+
* URL to the function. This can be done by passing the URL to `new URL(url)`,
|
|
34
|
+
* and setting the `hash` and `search` properties to empty strings.
|
|
35
|
+
*
|
|
36
|
+
* ```ts
|
|
37
|
+
* import { basename } from "@std/path/posix/basename";
|
|
38
|
+
* import { assertEquals } from "@std/assert";
|
|
39
|
+
*
|
|
40
|
+
* assertEquals(basename("https://deno.land/std/path/mod.ts"), "mod.ts");
|
|
41
|
+
* assertEquals(basename("https://deno.land/std/path/mod.ts", ".ts"), "mod");
|
|
42
|
+
* assertEquals(basename("https://deno.land/std/path/mod.ts?a=b"), "mod.ts?a=b");
|
|
43
|
+
* assertEquals(basename("https://deno.land/std/path/mod.ts#header"), "mod.ts#header");
|
|
44
|
+
* ```
|
|
45
|
+
*
|
|
46
|
+
* @param path The path to extract the name from.
|
|
47
|
+
* @param suffix The suffix to remove from extracted name.
|
|
48
|
+
* @returns The extracted name.
|
|
49
|
+
*/
|
|
50
|
+
export function basename(path: string | URL, suffix = ""): string {
|
|
51
|
+
if (path instanceof URL) {
|
|
52
|
+
path = fromFileUrl(path);
|
|
53
|
+
}
|
|
54
|
+
assertArgs(path, suffix);
|
|
55
|
+
|
|
56
|
+
const lastSegment = lastPathSegment(path, isPosixPathSeparator);
|
|
57
|
+
const strippedSegment = stripTrailingSeparators(
|
|
58
|
+
lastSegment,
|
|
59
|
+
isPosixPathSeparator,
|
|
60
|
+
);
|
|
61
|
+
return suffix ? stripSuffix(strippedSegment, suffix) : strippedSegment;
|
|
62
|
+
}
|