obsidian-dev-utils 76.0.0 → 77.0.0

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.
Files changed (115) hide show
  1. package/CHANGELOG.md +21 -0
  2. package/dist/dev/main.js +277 -59
  3. package/dist/lib/cjs/library.cjs +1 -1
  4. package/dist/lib/cjs/obsidian/attachment-path.cjs +2 -2
  5. package/dist/lib/cjs/obsidian/attachment-path.d.cts +11 -4
  6. package/dist/lib/cjs/obsidian/case-insensitive-file-index.cjs +238 -0
  7. package/dist/lib/cjs/obsidian/case-insensitive-file-index.d.cts +92 -0
  8. package/dist/lib/cjs/obsidian/components/case-insensitive-file-index-component.cjs +173 -0
  9. package/dist/lib/cjs/obsidian/components/case-insensitive-file-index-component.d.cts +29 -0
  10. package/dist/lib/cjs/obsidian/components/embed-extensions-component.cjs +167 -0
  11. package/dist/lib/cjs/obsidian/components/embed-extensions-component.d.cts +38 -0
  12. package/dist/lib/cjs/obsidian/components/index.cjs +7 -1
  13. package/dist/lib/cjs/obsidian/components/index.d.cts +2 -0
  14. package/dist/lib/cjs/obsidian/components/rename-delete-handler-component.cjs +17 -15
  15. package/dist/lib/cjs/obsidian/file-change.cjs +4 -4
  16. package/dist/lib/cjs/obsidian/file-change.d.cts +6 -2
  17. package/dist/lib/cjs/obsidian/file-manager.cjs +6 -6
  18. package/dist/lib/cjs/obsidian/file-manager.d.cts +6 -2
  19. package/dist/lib/cjs/obsidian/file-system.cjs +20 -19
  20. package/dist/lib/cjs/obsidian/file-system.d.cts +6 -12
  21. package/dist/lib/cjs/obsidian/index.cjs +7 -1
  22. package/dist/lib/cjs/obsidian/index.d.cts +2 -0
  23. package/dist/lib/cjs/obsidian/link.cjs +13 -14
  24. package/dist/lib/cjs/obsidian/link.d.cts +15 -7
  25. package/dist/lib/cjs/obsidian/vault.cjs +3 -3
  26. package/dist/lib/cjs/obsidian/view-registrar.cjs +156 -0
  27. package/dist/lib/cjs/obsidian/view-registrar.d.cts +39 -0
  28. package/dist/lib/cjs/script-utils/bundlers/esbuild-impl/obsidian-plugin-builder.cjs +5 -5
  29. package/dist/lib/cjs/script-utils/bundlers/esbuild-impl/obsidian-plugin-builder.d.cts +8 -8
  30. package/dist/lib/cjs/script-utils/bundlers/esbuild.cjs +1 -1
  31. package/dist/lib/cjs/script-utils/bundlers/esbuild.d.cts +1 -1
  32. package/dist/lib/cjs/script-utils/formatters/dprint.cjs +3 -3
  33. package/dist/lib/cjs/script-utils/formatters/dprint.d.cts +3 -3
  34. package/dist/lib/cjs/script-utils/json.cjs +1 -1
  35. package/dist/lib/cjs/script-utils/json.d.cts +5 -1
  36. package/dist/lib/cjs/script-utils/linters/cspell.cjs +3 -3
  37. package/dist/lib/cjs/script-utils/linters/cspell.d.cts +3 -3
  38. package/dist/lib/cjs/script-utils/linters/eslint-config.cjs +5 -5
  39. package/dist/lib/cjs/script-utils/linters/eslint-config.d.cts +3 -3
  40. package/dist/lib/cjs/script-utils/linters/eslint-rules/params-options-name-match.cjs +22 -17
  41. package/dist/lib/cjs/script-utils/linters/eslint-rules/params-options-name-match.d.cts +16 -6
  42. package/dist/lib/cjs/script-utils/linters/eslint.cjs +3 -3
  43. package/dist/lib/cjs/script-utils/linters/eslint.d.cts +3 -3
  44. package/dist/lib/cjs/script-utils/linters/index.cjs +6 -3
  45. package/dist/lib/cjs/script-utils/linters/index.d.cts +1 -0
  46. package/dist/lib/cjs/script-utils/linters/markdownlint.cjs +3 -3
  47. package/dist/lib/cjs/script-utils/linters/markdownlint.d.cts +3 -3
  48. package/dist/lib/cjs/script-utils/linters/over-exposure.cjs +453 -0
  49. package/dist/lib/cjs/script-utils/linters/over-exposure.d.cts +204 -0
  50. package/dist/lib/cjs/script-utils/npm.cjs +1 -1
  51. package/dist/lib/cjs/script-utils/npm.d.cts +20 -4
  52. package/dist/lib/cjs/script-utils/root.cjs +1 -1
  53. package/dist/lib/cjs/script-utils/root.d.cts +5 -1
  54. package/dist/lib/cjs/script-utils/test-runners/vitest.cjs +8 -8
  55. package/dist/lib/cjs/script-utils/test-runners/vitest.d.cts +14 -10
  56. package/dist/lib/esm/library.mjs +1 -1
  57. package/dist/lib/esm/obsidian/attachment-path.d.mts +11 -4
  58. package/dist/lib/esm/obsidian/attachment-path.mjs +2 -2
  59. package/dist/lib/esm/obsidian/case-insensitive-file-index.d.mts +92 -0
  60. package/dist/lib/esm/obsidian/case-insensitive-file-index.mjs +127 -0
  61. package/dist/lib/esm/obsidian/components/case-insensitive-file-index-component.d.mts +29 -0
  62. package/dist/lib/esm/obsidian/components/case-insensitive-file-index-component.mjs +69 -0
  63. package/dist/lib/esm/obsidian/components/embed-extensions-component.d.mts +38 -0
  64. package/dist/lib/esm/obsidian/components/embed-extensions-component.mjs +59 -0
  65. package/dist/lib/esm/obsidian/components/index.d.mts +2 -0
  66. package/dist/lib/esm/obsidian/components/index.mjs +5 -1
  67. package/dist/lib/esm/obsidian/components/rename-delete-handler-component.mjs +17 -15
  68. package/dist/lib/esm/obsidian/file-change.d.mts +6 -2
  69. package/dist/lib/esm/obsidian/file-change.mjs +4 -4
  70. package/dist/lib/esm/obsidian/file-manager.d.mts +6 -2
  71. package/dist/lib/esm/obsidian/file-manager.mjs +6 -6
  72. package/dist/lib/esm/obsidian/file-system.d.mts +6 -12
  73. package/dist/lib/esm/obsidian/file-system.mjs +20 -19
  74. package/dist/lib/esm/obsidian/index.d.mts +2 -0
  75. package/dist/lib/esm/obsidian/index.mjs +5 -1
  76. package/dist/lib/esm/obsidian/link.d.mts +15 -7
  77. package/dist/lib/esm/obsidian/link.mjs +13 -14
  78. package/dist/lib/esm/obsidian/vault.mjs +3 -3
  79. package/dist/lib/esm/obsidian/view-registrar.d.mts +39 -0
  80. package/dist/lib/esm/obsidian/view-registrar.mjs +48 -0
  81. package/dist/lib/esm/script-utils/bundlers/esbuild-impl/obsidian-plugin-builder.d.mts +8 -8
  82. package/dist/lib/esm/script-utils/bundlers/esbuild-impl/obsidian-plugin-builder.mjs +5 -5
  83. package/dist/lib/esm/script-utils/bundlers/esbuild.d.mts +1 -1
  84. package/dist/lib/esm/script-utils/bundlers/esbuild.mjs +1 -1
  85. package/dist/lib/esm/script-utils/formatters/dprint.d.mts +3 -3
  86. package/dist/lib/esm/script-utils/formatters/dprint.mjs +3 -3
  87. package/dist/lib/esm/script-utils/json.d.mts +5 -1
  88. package/dist/lib/esm/script-utils/json.mjs +1 -1
  89. package/dist/lib/esm/script-utils/linters/cspell.d.mts +3 -3
  90. package/dist/lib/esm/script-utils/linters/cspell.mjs +3 -3
  91. package/dist/lib/esm/script-utils/linters/eslint-config.d.mts +3 -3
  92. package/dist/lib/esm/script-utils/linters/eslint-config.mjs +5 -5
  93. package/dist/lib/esm/script-utils/linters/eslint-rules/params-options-name-match.d.mts +16 -6
  94. package/dist/lib/esm/script-utils/linters/eslint-rules/params-options-name-match.mjs +22 -17
  95. package/dist/lib/esm/script-utils/linters/eslint.d.mts +3 -3
  96. package/dist/lib/esm/script-utils/linters/eslint.mjs +3 -3
  97. package/dist/lib/esm/script-utils/linters/index.d.mts +1 -0
  98. package/dist/lib/esm/script-utils/linters/index.mjs +4 -2
  99. package/dist/lib/esm/script-utils/linters/markdownlint.d.mts +3 -3
  100. package/dist/lib/esm/script-utils/linters/markdownlint.mjs +3 -3
  101. package/dist/lib/esm/script-utils/linters/over-exposure.d.mts +204 -0
  102. package/dist/lib/esm/script-utils/linters/over-exposure.mjs +365 -0
  103. package/dist/lib/esm/script-utils/npm.d.mts +20 -4
  104. package/dist/lib/esm/script-utils/npm.mjs +1 -1
  105. package/dist/lib/esm/script-utils/root.d.mts +5 -1
  106. package/dist/lib/esm/script-utils/root.mjs +1 -1
  107. package/dist/lib/esm/script-utils/test-runners/vitest.d.mts +14 -10
  108. package/dist/lib/esm/script-utils/test-runners/vitest.mjs +8 -8
  109. package/dist/scripts/linters/over-exposure/find-overexposed.ts +12 -0
  110. package/obsidian/Components/case-insensitive-file-index-component/package.json +6 -0
  111. package/obsidian/Components/embed-extensions-component/package.json +6 -0
  112. package/obsidian/case-insensitive-file-index/package.json +6 -0
  113. package/obsidian/view-registrar/package.json +6 -0
  114. package/package.json +15 -15
  115. package/script-utils/linters/over-exposure/package.json +6 -0
@@ -41,8 +41,8 @@ import {
41
41
  getRootFolder,
42
42
  resolvePathFromRootSafe
43
43
  } from "../root.mjs";
44
- async function lint(params) {
45
- const { paths, shouldFix = false } = params ?? {};
44
+ async function lint(options) {
45
+ const { paths, shouldFix = false } = options ?? {};
46
46
  const configFiles = [
47
47
  ObsidianPluginRepoPaths.MarkdownlintCli2ConfigJsonc,
48
48
  ObsidianPluginRepoPaths.MarkdownlintCli2ConfigYaml,
@@ -101,4 +101,4 @@ async function lint(params) {
101
101
  export {
102
102
  lint
103
103
  };
104
- //# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL3NjcmlwdC11dGlscy9saW50ZXJzL21hcmtkb3dubGludC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIExpbnQgbWFya2Rvd24gZG9jdW1lbnRhdGlvbiB1c2luZyBgbWFya2Rvd25saW50LWNsaTJgIGFuZCBgbGlua2luYXRvcmAuXG4gKi9cblxuaW1wb3J0IHsgZXhpc3RzU3luYyB9IGZyb20gJ25vZGU6ZnMnO1xuaW1wb3J0IHtcbiAgY3AsXG4gIGdsb2Jcbn0gZnJvbSAnbm9kZTpmcy9wcm9taXNlcyc7XG5pbXBvcnQgeyByZWxhdGl2ZSB9IGZyb20gJ25vZGU6cGF0aCc7XG5cbmltcG9ydCB7IHRvQXJyYXkgfSBmcm9tICcuLi8uLi9hc3luYy50cyc7XG5pbXBvcnQgeyBnZXRMaWJEZWJ1Z2dlciB9IGZyb20gJy4uLy4uL2RlYnVnLnRzJztcbmltcG9ydCB7IE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzIH0gZnJvbSAnLi4vLi4vb2JzaWRpYW4vcGx1Z2luL29ic2lkaWFuLXBsdWdpbi1yZXBvLXBhdGhzLnRzJztcbmltcG9ydCB7XG4gIGdldEZvbGRlck5hbWUsXG4gIGpvaW5cbn0gZnJvbSAnLi4vLi4vcGF0aC50cyc7XG5pbXBvcnQgeyBhc3NlcnROb25OdWxsYWJsZSB9IGZyb20gJy4uLy4uL3R5cGUtZ3VhcmRzLnRzJztcbmltcG9ydCB7IE9ic2lkaWFuRGV2VXRpbHNSZXBvUGF0aHMgfSBmcm9tICcuLi9vYnNpZGlhbi1kZXYtdXRpbHMtcmVwby1wYXRocy50cyc7XG5pbXBvcnQge1xuICBleGVjRnJvbVJvb3QsXG4gIGdldFJvb3RGb2xkZXIsXG4gIHJlc29sdmVQYXRoRnJvbVJvb3RTYWZlXG59IGZyb20gJy4uL3Jvb3QudHMnO1xuXG4vKipcbiAqIFBhcmFtZXRlcnMgZm9yIHRoZSB7QGxpbmsgbGludH0gZnVuY3Rpb24uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgTGludFBhcmFtcyB7XG4gIC8qKlxuICAgKiBPcHRpb25hbCBmaWxlIHBhdGhzIHRvIGxpbnQuIElmIG9taXR0ZWQsIGxpbnRzIHRoZSBlbnRpcmUgcHJvamVjdC5cbiAgICovXG4gIHJlYWRvbmx5IHBhdGhzPzogc3RyaW5nW10gfCB1bmRlZmluZWQ7XG5cbiAgLyoqXG4gICAqIFdoZXRoZXIgdG8gZml4IGxpbnRpbmcgaXNzdWVzIGF1dG9tYXRpY2FsbHkuXG4gICAqL1xuICByZWFkb25seSBzaG91bGRGaXg/OiBib29sZWFuIHwgdW5kZWZpbmVkO1xufVxuXG4vKipcbiAqIExpbnQgbWFya2Rvd24gZG9jdW1lbnRhdGlvbiB1c2luZyBgbWFya2Rvd25saW50LWNsaTJgIGFuZCBgbGlua2luYXRvcmAuXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSB7QGxpbmsgTGludFBhcmFtc30uXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBsaW50KHBhcmFtcz86IExpbnRQYXJhbXMpOiBQcm9taXNlPHZvaWQ+IHtcbiAgY29uc3QgeyBwYXRocywgc2hvdWxkRml4ID0gZmFsc2UgfSA9IHBhcmFtcyA/PyB7fTtcbiAgY29uc3QgY29uZmlnRmlsZXMgPSBbXG4gICAgT2JzaWRpYW5QbHVnaW5SZXBvUGF0aHMuTWFya2Rvd25saW50Q2xpMkNvbmZpZ0pzb25jLFxuICAgIE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzLk1hcmtkb3dubGludENsaTJDb25maWdZYW1sLFxuICAgIE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzLk1hcmtkb3dubGludENsaTJDb25maWdDanMsXG4gICAgT2JzaWRpYW5QbHVnaW5SZXBvUGF0aHMuTWFya2Rvd25saW50Q2xpMkNvbmZpZ01qcyxcbiAgICBPYnNpZGlhblBsdWdpblJlcG9QYXRocy5NYXJrZG93bmxpbnRDb25maWdKc29uYyxcbiAgICBPYnNpZGlhblBsdWdpblJlcG9QYXRocy5NYXJrZG93bmxpbnRDb25maWdKc29uLFxuICAgIE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzLk1hcmtkb3dubGludENvbmZpZ1lhbWwsXG4gICAgT2JzaWRpYW5QbHVnaW5SZXBvUGF0aHMuTWFya2Rvd25saW50Q29uZmlnWW1sLFxuICAgIE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzLk1hcmtkb3dubGludENvbmZpZ0NqcyxcbiAgICBPYnNpZGlhblBsdWdpblJlcG9QYXRocy5NYXJrZG93bmxpbnRDb25maWdNanNcbiAgXTtcblxuICBjb25zdCBjb25maWdGaWxlRXhpc3QgPSBjb25maWdGaWxlcy5zb21lKChjb25maWdGaWxlKSA9PiB7XG4gICAgY29uc3QgY29uZmlnRmlsZVBhdGggPSByZXNvbHZlUGF0aEZyb21Sb290U2FmZShjb25maWdGaWxlKTtcbiAgICByZXR1cm4gZXhpc3RzU3luYyhjb25maWdGaWxlUGF0aCk7XG4gIH0pO1xuXG4gIGlmICghY29uZmlnRmlsZUV4aXN0KSB7XG4gICAgZ2V0TGliRGVidWdnZXIoJ21hcmtkb3dubGludDpsaW50JykoJ21hcmtkb3dubGludCBjb25maWd1cmF0aW9uIGZpbGUgbm90IGZvdW5kLiBDcmVhdGluZyBkZWZhdWx0IGNvbmZpZy4uLicpO1xuICAgIGNvbnN0IHBhY2thZ2VGb2xkZXIgPSBnZXRSb290Rm9sZGVyKGdldEZvbGRlck5hbWUoaW1wb3J0Lm1ldGEudXJsKSk7XG4gICAgYXNzZXJ0Tm9uTnVsbGFibGUocGFja2FnZUZvbGRlciwgJ1BhY2thZ2UgZm9sZGVyIG5vdCBmb3VuZCcpO1xuICAgIGF3YWl0IGNwKFxuICAgICAgam9pbihwYWNrYWdlRm9sZGVyLCBPYnNpZGlhbkRldlV0aWxzUmVwb1BhdGhzLkRpc3QsIE9ic2lkaWFuRGV2VXRpbHNSZXBvUGF0aHMuTWFya2Rvd25saW50Q2xpMkNvbmZpZ01qcyksXG4gICAgICByZXNvbHZlUGF0aEZyb21Sb290U2FmZShPYnNpZGlhblBsdWdpblJlcG9QYXRocy5NYXJrZG93bmxpbnRDbGkyQ29uZmlnTWpzKVxuICAgICk7XG5cbiAgICBhd2FpdCBjcChcbiAgICAgIGpvaW4ocGFja2FnZUZvbGRlciwgT2JzaWRpYW5EZXZVdGlsc1JlcG9QYXRocy5EaXN0LCBPYnNpZGlhbkRldlV0aWxzUmVwb1BhdGhzLk1hcmtkb3dubGludENsaTJDb25maWdNdHMpLFxuICAgICAgcmVzb2x2ZVBhdGhGcm9tUm9vdFNhZmUoT2JzaWRpYW5QbHVnaW5SZXBvUGF0aHMuTWFya2Rvd25saW50Q2xpMkNvbmZpZ010cylcbiAgICApO1xuICB9XG5cbiAgLyogdjggaWdub3JlIHN0YXJ0IC0tIFRoZSBwYXRocy1wcm92aWRlZCBicmFuY2hlcyBhcmUgb25seSBleGVyY2lzZWQgYnkgY29uc3VtZXIgcHJvamVjdHMgcGFzc2luZyBmaWxlIGxpc3RzLiAqL1xuICBjb25zdCB0YXJnZXRzID0gcGF0aHM/Lmxlbmd0aCA/IHBhdGhzIDogW09ic2lkaWFuUGx1Z2luUmVwb1BhdGhzLkN1cnJlbnRGb2xkZXJdO1xuICAvKiB2OCBpZ25vcmUgc3RvcCAqL1xuICBhd2FpdCBleGVjRnJvbVJvb3QoWyducHgnLCAnbWFya2Rvd25saW50LWNsaTInLCAuLi4oc2hvdWxkRml4ID8gWyctLWZpeCddIDogW10pLCB7IGJhdGNoZWRBcmdzOiB0YXJnZXRzIH1dKTtcblxuICAvKiB2OCBpZ25vcmUgc3RhcnQgLS0gVGhlIHBhdGhzLXByb3ZpZGVkIGJyYW5jaCBpcyBvbmx5IGV4ZXJjaXNlZCBieSBjb25zdW1lciBwcm9qZWN0cyBwYXNzaW5nIGZpbGUgbGlzdHMuICovXG4gIGNvbnN0IHJvb3RGb2xkZXIgPSBnZXRSb290Rm9sZGVyKCkgPz8gcHJvY2Vzcy5jd2QoKTtcbiAgY29uc3QgbWRGaWxlcyA9IHBhdGhzPy5sZW5ndGhcbiAgICA/IHBhdGhzLm1hcCgocCkgPT4gcmVsYXRpdmUocm9vdEZvbGRlciwgcCkucmVwbGFjZSgvXFxcXC9nLCAnLycpIHx8IHApXG4gICAgOiBhd2FpdCB0b0FycmF5KGdsb2IoWycqKi8qLm1kJ10sIHtcbiAgICAgIGV4Y2x1ZGU6IFtcbiAgICAgICAgJy5naXQvKionLFxuICAgICAgICAnZGlzdC8qKicsXG4gICAgICAgICdub2RlX21vZHVsZXMvKionXG4gICAgICBdXG4gICAgfSkpO1xuICAvKiB2OCBpZ25vcmUgc3RvcCAqL1xuICBhd2FpdCBleGVjRnJvbVJvb3QoW1xuICAgICducHgnLFxuICAgICdsaW5raW5hdG9yJyxcbiAgICAnLS1yZXRyeScsXG4gICAgJy0tcmV0cnktZXJyb3JzJyxcbiAgICAnLS1yZXRyeS1lcnJvcnMtY291bnQnLFxuICAgICczJyxcbiAgICAnLS1yZXRyeS1lcnJvcnMtaml0dGVyJyxcbiAgICAnNScsXG4gICAgJy0tdXJsLXJld3JpdGUtc2VhcmNoJyxcbiAgICAnaHR0cHM6Ly93d3dcXFxcLm5wbWpzXFxcXC5jb20vcGFja2FnZS8nLFxuICAgICctLXVybC1yZXdyaXRlLXJlcGxhY2UnLFxuICAgICdodHRwczovL3JlZ2lzdHJ5Lm5wbWpzLm9yZy8nLFxuICAgIHsgYmF0Y2hlZEFyZ3M6IG1kRmlsZXMgfVxuICBdKTtcbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBTUEsU0FBUyxrQkFBa0I7QUFDM0I7QUFBQSxFQUNFO0FBQUEsRUFDQTtBQUFBLE9BQ0s7QUFDUCxTQUFTLGdCQUFnQjtBQUV6QixTQUFTLGVBQWU7QUFDeEIsU0FBUyxzQkFBc0I7QUFDL0IsU0FBUywrQkFBK0I7QUFDeEM7QUFBQSxFQUNFO0FBQUEsRUFDQTtBQUFBLE9BQ0s7QUFDUCxTQUFTLHlCQUF5QjtBQUNsQyxTQUFTLGlDQUFpQztBQUMxQztBQUFBLEVBQ0U7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBLE9BQ0s7QUFzQlAsZUFBc0IsS0FBSyxRQUFvQztBQUM3RCxRQUFNLEVBQUUsT0FBTyxZQUFZLE1BQU0sSUFBSSxVQUFVLENBQUM7QUFDaEQsUUFBTSxjQUFjO0FBQUEsSUFDbEIsd0JBQXdCO0FBQUEsSUFDeEIsd0JBQXdCO0FBQUEsSUFDeEIsd0JBQXdCO0FBQUEsSUFDeEIsd0JBQXdCO0FBQUEsSUFDeEIsd0JBQXdCO0FBQUEsSUFDeEIsd0JBQXdCO0FBQUEsSUFDeEIsd0JBQXdCO0FBQUEsSUFDeEIsd0JBQXdCO0FBQUEsSUFDeEIsd0JBQXdCO0FBQUEsSUFDeEIsd0JBQXdCO0FBQUEsRUFDMUI7QUFFQSxRQUFNLGtCQUFrQixZQUFZLEtBQUssQ0FBQyxlQUFlO0FBQ3ZELFVBQU0saUJBQWlCLHdCQUF3QixVQUFVO0FBQ3pELFdBQU8sV0FBVyxjQUFjO0FBQUEsRUFDbEMsQ0FBQztBQUVELE1BQUksQ0FBQyxpQkFBaUI7QUFDcEIsbUJBQWUsbUJBQW1CLEVBQUUsdUVBQXVFO0FBQzNHLFVBQU0sZ0JBQWdCLGNBQWMsY0FBYyxZQUFZLEdBQUcsQ0FBQztBQUNsRSxzQkFBa0IsZUFBZSwwQkFBMEI7QUFDM0QsVUFBTTtBQUFBLE1BQ0osS0FBSyxlQUFlLDBCQUEwQixNQUFNLDBCQUEwQix5QkFBeUI7QUFBQSxNQUN2Ryx3QkFBd0Isd0JBQXdCLHlCQUF5QjtBQUFBLElBQzNFO0FBRUEsVUFBTTtBQUFBLE1BQ0osS0FBSyxlQUFlLDBCQUEwQixNQUFNLDBCQUEwQix5QkFBeUI7QUFBQSxNQUN2Ryx3QkFBd0Isd0JBQXdCLHlCQUF5QjtBQUFBLElBQzNFO0FBQUEsRUFDRjtBQUdBLFFBQU0sVUFBVSxPQUFPLFNBQVMsUUFBUSxDQUFDLHdCQUF3QixhQUFhO0FBRTlFLFFBQU0sYUFBYSxDQUFDLE9BQU8scUJBQXFCLEdBQUksWUFBWSxDQUFDLE9BQU8sSUFBSSxDQUFDLEdBQUksRUFBRSxhQUFhLFFBQVEsQ0FBQyxDQUFDO0FBRzFHLFFBQU0sYUFBYSxjQUFjLEtBQUssUUFBUSxJQUFJO0FBQ2xELFFBQU0sVUFBVSxPQUFPLFNBQ25CLE1BQU0sSUFBSSxDQUFDLE1BQU0sU0FBUyxZQUFZLENBQUMsRUFBRSxRQUFRLE9BQU8sR0FBRyxLQUFLLENBQUMsSUFDakUsTUFBTSxRQUFRLEtBQUssQ0FBQyxTQUFTLEdBQUc7QUFBQSxJQUNoQyxTQUFTO0FBQUEsTUFDUDtBQUFBLE1BQ0E7QUFBQSxNQUNBO0FBQUEsSUFDRjtBQUFBLEVBQ0YsQ0FBQyxDQUFDO0FBRUosUUFBTSxhQUFhO0FBQUEsSUFDakI7QUFBQSxJQUNBO0FBQUEsSUFDQTtBQUFBLElBQ0E7QUFBQSxJQUNBO0FBQUEsSUFDQTtBQUFBLElBQ0E7QUFBQSxJQUNBO0FBQUEsSUFDQTtBQUFBLElBQ0E7QUFBQSxJQUNBO0FBQUEsSUFDQTtBQUFBLElBQ0EsRUFBRSxhQUFhLFFBQVE7QUFBQSxFQUN6QixDQUFDO0FBQ0g7IiwKICAibmFtZXMiOiBbXQp9Cg==
104
+ //# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL3NjcmlwdC11dGlscy9saW50ZXJzL21hcmtkb3dubGludC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIExpbnQgbWFya2Rvd24gZG9jdW1lbnRhdGlvbiB1c2luZyBgbWFya2Rvd25saW50LWNsaTJgIGFuZCBgbGlua2luYXRvcmAuXG4gKi9cblxuaW1wb3J0IHsgZXhpc3RzU3luYyB9IGZyb20gJ25vZGU6ZnMnO1xuaW1wb3J0IHtcbiAgY3AsXG4gIGdsb2Jcbn0gZnJvbSAnbm9kZTpmcy9wcm9taXNlcyc7XG5pbXBvcnQgeyByZWxhdGl2ZSB9IGZyb20gJ25vZGU6cGF0aCc7XG5cbmltcG9ydCB7IHRvQXJyYXkgfSBmcm9tICcuLi8uLi9hc3luYy50cyc7XG5pbXBvcnQgeyBnZXRMaWJEZWJ1Z2dlciB9IGZyb20gJy4uLy4uL2RlYnVnLnRzJztcbmltcG9ydCB7IE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzIH0gZnJvbSAnLi4vLi4vb2JzaWRpYW4vcGx1Z2luL29ic2lkaWFuLXBsdWdpbi1yZXBvLXBhdGhzLnRzJztcbmltcG9ydCB7XG4gIGdldEZvbGRlck5hbWUsXG4gIGpvaW5cbn0gZnJvbSAnLi4vLi4vcGF0aC50cyc7XG5pbXBvcnQgeyBhc3NlcnROb25OdWxsYWJsZSB9IGZyb20gJy4uLy4uL3R5cGUtZ3VhcmRzLnRzJztcbmltcG9ydCB7IE9ic2lkaWFuRGV2VXRpbHNSZXBvUGF0aHMgfSBmcm9tICcuLi9vYnNpZGlhbi1kZXYtdXRpbHMtcmVwby1wYXRocy50cyc7XG5pbXBvcnQge1xuICBleGVjRnJvbVJvb3QsXG4gIGdldFJvb3RGb2xkZXIsXG4gIHJlc29sdmVQYXRoRnJvbVJvb3RTYWZlXG59IGZyb20gJy4uL3Jvb3QudHMnO1xuXG4vKipcbiAqIFBhcmFtZXRlcnMgZm9yIHRoZSB7QGxpbmsgbGludH0gZnVuY3Rpb24uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgTGludE9wdGlvbnMge1xuICAvKipcbiAgICogT3B0aW9uYWwgZmlsZSBwYXRocyB0byBsaW50LiBJZiBvbWl0dGVkLCBsaW50cyB0aGUgZW50aXJlIHByb2plY3QuXG4gICAqL1xuICByZWFkb25seSBwYXRocz86IHN0cmluZ1tdIHwgdW5kZWZpbmVkO1xuXG4gIC8qKlxuICAgKiBXaGV0aGVyIHRvIGZpeCBsaW50aW5nIGlzc3VlcyBhdXRvbWF0aWNhbGx5LlxuICAgKi9cbiAgcmVhZG9ubHkgc2hvdWxkRml4PzogYm9vbGVhbiB8IHVuZGVmaW5lZDtcbn1cblxuLyoqXG4gKiBMaW50IG1hcmtkb3duIGRvY3VtZW50YXRpb24gdXNpbmcgYG1hcmtkb3dubGludC1jbGkyYCBhbmQgYGxpbmtpbmF0b3JgLlxuICpcbiAqIEBwYXJhbSBvcHRpb25zIC0gVGhlIHtAbGluayBMaW50T3B0aW9uc30uXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBsaW50KG9wdGlvbnM/OiBMaW50T3B0aW9ucyk6IFByb21pc2U8dm9pZD4ge1xuICBjb25zdCB7IHBhdGhzLCBzaG91bGRGaXggPSBmYWxzZSB9ID0gb3B0aW9ucyA/PyB7fTtcbiAgY29uc3QgY29uZmlnRmlsZXMgPSBbXG4gICAgT2JzaWRpYW5QbHVnaW5SZXBvUGF0aHMuTWFya2Rvd25saW50Q2xpMkNvbmZpZ0pzb25jLFxuICAgIE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzLk1hcmtkb3dubGludENsaTJDb25maWdZYW1sLFxuICAgIE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzLk1hcmtkb3dubGludENsaTJDb25maWdDanMsXG4gICAgT2JzaWRpYW5QbHVnaW5SZXBvUGF0aHMuTWFya2Rvd25saW50Q2xpMkNvbmZpZ01qcyxcbiAgICBPYnNpZGlhblBsdWdpblJlcG9QYXRocy5NYXJrZG93bmxpbnRDb25maWdKc29uYyxcbiAgICBPYnNpZGlhblBsdWdpblJlcG9QYXRocy5NYXJrZG93bmxpbnRDb25maWdKc29uLFxuICAgIE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzLk1hcmtkb3dubGludENvbmZpZ1lhbWwsXG4gICAgT2JzaWRpYW5QbHVnaW5SZXBvUGF0aHMuTWFya2Rvd25saW50Q29uZmlnWW1sLFxuICAgIE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzLk1hcmtkb3dubGludENvbmZpZ0NqcyxcbiAgICBPYnNpZGlhblBsdWdpblJlcG9QYXRocy5NYXJrZG93bmxpbnRDb25maWdNanNcbiAgXTtcblxuICBjb25zdCBjb25maWdGaWxlRXhpc3QgPSBjb25maWdGaWxlcy5zb21lKChjb25maWdGaWxlKSA9PiB7XG4gICAgY29uc3QgY29uZmlnRmlsZVBhdGggPSByZXNvbHZlUGF0aEZyb21Sb290U2FmZShjb25maWdGaWxlKTtcbiAgICByZXR1cm4gZXhpc3RzU3luYyhjb25maWdGaWxlUGF0aCk7XG4gIH0pO1xuXG4gIGlmICghY29uZmlnRmlsZUV4aXN0KSB7XG4gICAgZ2V0TGliRGVidWdnZXIoJ21hcmtkb3dubGludDpsaW50JykoJ21hcmtkb3dubGludCBjb25maWd1cmF0aW9uIGZpbGUgbm90IGZvdW5kLiBDcmVhdGluZyBkZWZhdWx0IGNvbmZpZy4uLicpO1xuICAgIGNvbnN0IHBhY2thZ2VGb2xkZXIgPSBnZXRSb290Rm9sZGVyKGdldEZvbGRlck5hbWUoaW1wb3J0Lm1ldGEudXJsKSk7XG4gICAgYXNzZXJ0Tm9uTnVsbGFibGUocGFja2FnZUZvbGRlciwgJ1BhY2thZ2UgZm9sZGVyIG5vdCBmb3VuZCcpO1xuICAgIGF3YWl0IGNwKFxuICAgICAgam9pbihwYWNrYWdlRm9sZGVyLCBPYnNpZGlhbkRldlV0aWxzUmVwb1BhdGhzLkRpc3QsIE9ic2lkaWFuRGV2VXRpbHNSZXBvUGF0aHMuTWFya2Rvd25saW50Q2xpMkNvbmZpZ01qcyksXG4gICAgICByZXNvbHZlUGF0aEZyb21Sb290U2FmZShPYnNpZGlhblBsdWdpblJlcG9QYXRocy5NYXJrZG93bmxpbnRDbGkyQ29uZmlnTWpzKVxuICAgICk7XG5cbiAgICBhd2FpdCBjcChcbiAgICAgIGpvaW4ocGFja2FnZUZvbGRlciwgT2JzaWRpYW5EZXZVdGlsc1JlcG9QYXRocy5EaXN0LCBPYnNpZGlhbkRldlV0aWxzUmVwb1BhdGhzLk1hcmtkb3dubGludENsaTJDb25maWdNdHMpLFxuICAgICAgcmVzb2x2ZVBhdGhGcm9tUm9vdFNhZmUoT2JzaWRpYW5QbHVnaW5SZXBvUGF0aHMuTWFya2Rvd25saW50Q2xpMkNvbmZpZ010cylcbiAgICApO1xuICB9XG5cbiAgLyogdjggaWdub3JlIHN0YXJ0IC0tIFRoZSBwYXRocy1wcm92aWRlZCBicmFuY2hlcyBhcmUgb25seSBleGVyY2lzZWQgYnkgY29uc3VtZXIgcHJvamVjdHMgcGFzc2luZyBmaWxlIGxpc3RzLiAqL1xuICBjb25zdCB0YXJnZXRzID0gcGF0aHM/Lmxlbmd0aCA/IHBhdGhzIDogW09ic2lkaWFuUGx1Z2luUmVwb1BhdGhzLkN1cnJlbnRGb2xkZXJdO1xuICAvKiB2OCBpZ25vcmUgc3RvcCAqL1xuICBhd2FpdCBleGVjRnJvbVJvb3QoWyducHgnLCAnbWFya2Rvd25saW50LWNsaTInLCAuLi4oc2hvdWxkRml4ID8gWyctLWZpeCddIDogW10pLCB7IGJhdGNoZWRBcmdzOiB0YXJnZXRzIH1dKTtcblxuICAvKiB2OCBpZ25vcmUgc3RhcnQgLS0gVGhlIHBhdGhzLXByb3ZpZGVkIGJyYW5jaCBpcyBvbmx5IGV4ZXJjaXNlZCBieSBjb25zdW1lciBwcm9qZWN0cyBwYXNzaW5nIGZpbGUgbGlzdHMuICovXG4gIGNvbnN0IHJvb3RGb2xkZXIgPSBnZXRSb290Rm9sZGVyKCkgPz8gcHJvY2Vzcy5jd2QoKTtcbiAgY29uc3QgbWRGaWxlcyA9IHBhdGhzPy5sZW5ndGhcbiAgICA/IHBhdGhzLm1hcCgocCkgPT4gcmVsYXRpdmUocm9vdEZvbGRlciwgcCkucmVwbGFjZSgvXFxcXC9nLCAnLycpIHx8IHApXG4gICAgOiBhd2FpdCB0b0FycmF5KGdsb2IoWycqKi8qLm1kJ10sIHtcbiAgICAgIGV4Y2x1ZGU6IFtcbiAgICAgICAgJy5naXQvKionLFxuICAgICAgICAnZGlzdC8qKicsXG4gICAgICAgICdub2RlX21vZHVsZXMvKionXG4gICAgICBdXG4gICAgfSkpO1xuICAvKiB2OCBpZ25vcmUgc3RvcCAqL1xuICBhd2FpdCBleGVjRnJvbVJvb3QoW1xuICAgICducHgnLFxuICAgICdsaW5raW5hdG9yJyxcbiAgICAnLS1yZXRyeScsXG4gICAgJy0tcmV0cnktZXJyb3JzJyxcbiAgICAnLS1yZXRyeS1lcnJvcnMtY291bnQnLFxuICAgICczJyxcbiAgICAnLS1yZXRyeS1lcnJvcnMtaml0dGVyJyxcbiAgICAnNScsXG4gICAgJy0tdXJsLXJld3JpdGUtc2VhcmNoJyxcbiAgICAnaHR0cHM6Ly93d3dcXFxcLm5wbWpzXFxcXC5jb20vcGFja2FnZS8nLFxuICAgICctLXVybC1yZXdyaXRlLXJlcGxhY2UnLFxuICAgICdodHRwczovL3JlZ2lzdHJ5Lm5wbWpzLm9yZy8nLFxuICAgIHsgYmF0Y2hlZEFyZ3M6IG1kRmlsZXMgfVxuICBdKTtcbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBTUEsU0FBUyxrQkFBa0I7QUFDM0I7QUFBQSxFQUNFO0FBQUEsRUFDQTtBQUFBLE9BQ0s7QUFDUCxTQUFTLGdCQUFnQjtBQUV6QixTQUFTLGVBQWU7QUFDeEIsU0FBUyxzQkFBc0I7QUFDL0IsU0FBUywrQkFBK0I7QUFDeEM7QUFBQSxFQUNFO0FBQUEsRUFDQTtBQUFBLE9BQ0s7QUFDUCxTQUFTLHlCQUF5QjtBQUNsQyxTQUFTLGlDQUFpQztBQUMxQztBQUFBLEVBQ0U7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBLE9BQ0s7QUFzQlAsZUFBc0IsS0FBSyxTQUFzQztBQUMvRCxRQUFNLEVBQUUsT0FBTyxZQUFZLE1BQU0sSUFBSSxXQUFXLENBQUM7QUFDakQsUUFBTSxjQUFjO0FBQUEsSUFDbEIsd0JBQXdCO0FBQUEsSUFDeEIsd0JBQXdCO0FBQUEsSUFDeEIsd0JBQXdCO0FBQUEsSUFDeEIsd0JBQXdCO0FBQUEsSUFDeEIsd0JBQXdCO0FBQUEsSUFDeEIsd0JBQXdCO0FBQUEsSUFDeEIsd0JBQXdCO0FBQUEsSUFDeEIsd0JBQXdCO0FBQUEsSUFDeEIsd0JBQXdCO0FBQUEsSUFDeEIsd0JBQXdCO0FBQUEsRUFDMUI7QUFFQSxRQUFNLGtCQUFrQixZQUFZLEtBQUssQ0FBQyxlQUFlO0FBQ3ZELFVBQU0saUJBQWlCLHdCQUF3QixVQUFVO0FBQ3pELFdBQU8sV0FBVyxjQUFjO0FBQUEsRUFDbEMsQ0FBQztBQUVELE1BQUksQ0FBQyxpQkFBaUI7QUFDcEIsbUJBQWUsbUJBQW1CLEVBQUUsdUVBQXVFO0FBQzNHLFVBQU0sZ0JBQWdCLGNBQWMsY0FBYyxZQUFZLEdBQUcsQ0FBQztBQUNsRSxzQkFBa0IsZUFBZSwwQkFBMEI7QUFDM0QsVUFBTTtBQUFBLE1BQ0osS0FBSyxlQUFlLDBCQUEwQixNQUFNLDBCQUEwQix5QkFBeUI7QUFBQSxNQUN2Ryx3QkFBd0Isd0JBQXdCLHlCQUF5QjtBQUFBLElBQzNFO0FBRUEsVUFBTTtBQUFBLE1BQ0osS0FBSyxlQUFlLDBCQUEwQixNQUFNLDBCQUEwQix5QkFBeUI7QUFBQSxNQUN2Ryx3QkFBd0Isd0JBQXdCLHlCQUF5QjtBQUFBLElBQzNFO0FBQUEsRUFDRjtBQUdBLFFBQU0sVUFBVSxPQUFPLFNBQVMsUUFBUSxDQUFDLHdCQUF3QixhQUFhO0FBRTlFLFFBQU0sYUFBYSxDQUFDLE9BQU8scUJBQXFCLEdBQUksWUFBWSxDQUFDLE9BQU8sSUFBSSxDQUFDLEdBQUksRUFBRSxhQUFhLFFBQVEsQ0FBQyxDQUFDO0FBRzFHLFFBQU0sYUFBYSxjQUFjLEtBQUssUUFBUSxJQUFJO0FBQ2xELFFBQU0sVUFBVSxPQUFPLFNBQ25CLE1BQU0sSUFBSSxDQUFDLE1BQU0sU0FBUyxZQUFZLENBQUMsRUFBRSxRQUFRLE9BQU8sR0FBRyxLQUFLLENBQUMsSUFDakUsTUFBTSxRQUFRLEtBQUssQ0FBQyxTQUFTLEdBQUc7QUFBQSxJQUNoQyxTQUFTO0FBQUEsTUFDUDtBQUFBLE1BQ0E7QUFBQSxNQUNBO0FBQUEsSUFDRjtBQUFBLEVBQ0YsQ0FBQyxDQUFDO0FBRUosUUFBTSxhQUFhO0FBQUEsSUFDakI7QUFBQSxJQUNBO0FBQUEsSUFDQTtBQUFBLElBQ0E7QUFBQSxJQUNBO0FBQUEsSUFDQTtBQUFBLElBQ0E7QUFBQSxJQUNBO0FBQUEsSUFDQTtBQUFBLElBQ0E7QUFBQSxJQUNBO0FBQUEsSUFDQTtBQUFBLElBQ0EsRUFBRSxhQUFhLFFBQVE7QUFBQSxFQUN6QixDQUFDO0FBQ0g7IiwKICAibmFtZXMiOiBbXQp9Cg==
@@ -0,0 +1,204 @@
1
+ /// <reference path="../../library.d.mts" />
2
+ /**
3
+ * @file
4
+ *
5
+ * Over-exposure analyzer.
6
+ *
7
+ * Finds declarations exposed more broadly than their references require, so the exposure can be
8
+ * tightened:
9
+ *
10
+ * - `export`ed symbols referenced only within their own file — the `export` can be dropped.
11
+ * - `public` class members referenced only inside their own class — they can be `private`.
12
+ * - `public` class members referenced only inside their own class and its subclasses — they can be
13
+ * `protected`.
14
+ * - `protected` class members referenced only inside their own class — they can be `private`.
15
+ *
16
+ * The analysis is whole-program and type-aware: it uses the TypeScript language service's
17
+ * find-all-references to locate every use of each declaration, then classifies the tightest
18
+ * exposure that still covers all references. Members invoked by the framework via registration
19
+ * rather than by visible references (Obsidian lifecycle hooks, settings-tab `display`, etc.) are
20
+ * excluded via {@link LIFECYCLE_ALLOWLIST}, as are `override` and `static` members whose exposure is
21
+ * constrained by a base declaration.
22
+ *
23
+ * A member referenced only from test files is reported with {@link OverExposureFinding.isForcedByTestOnly}
24
+ * set, surfacing members widened purely for testability — the canonical case for extracting logic
25
+ * into an independently testable component instead.
26
+ */
27
+ import type { CompilerOptions, LanguageService, LanguageServiceHost } from 'typescript';
28
+ /**
29
+ * Parameters for {@link analyzeOverExposure}.
30
+ */
31
+ export interface AnalyzeOverExposureParams {
32
+ /** The language service to query for references and types. */
33
+ readonly languageService: LanguageService;
34
+ /**
35
+ * Optional callback invoked once per analyzed source file, before that file is processed. The
36
+ * whole-program reference analysis is slow, so this lets callers report live progress instead of
37
+ * appearing to hang.
38
+ */
39
+ onProgress?(this: void, progress: OverExposureProgress): void;
40
+ /**
41
+ * Absolute (canonical) path of the project's `src` folder. Only declarations in non-test files
42
+ * under this folder are analyzed; declarations elsewhere (test files, dependencies) are ignored
43
+ * but still counted as reference sites.
44
+ */
45
+ readonly srcFolder: string;
46
+ }
47
+ /**
48
+ * Parameters for {@link createLanguageServiceHost}.
49
+ */
50
+ export interface CreateLanguageServiceHostParams {
51
+ /** The compiler options. */
52
+ readonly compilerOptions: CompilerOptions;
53
+ /** The files to include in the program. */
54
+ readonly fileNames: readonly string[];
55
+ /** The file-system operations used to read sources. */
56
+ readonly fileSystem: OverExposureFileSystem;
57
+ }
58
+ /**
59
+ * Parameters for {@link createProjectLanguageService}.
60
+ */
61
+ export interface CreateProjectLanguageServiceParams {
62
+ /** Absolute path to the project's `tsconfig.json`. */
63
+ readonly tsConfigPath: string;
64
+ }
65
+ /**
66
+ * The exposure level a declaration currently has.
67
+ */
68
+ export type CurrentExposure = 'export' | 'protected' | 'public';
69
+ /**
70
+ * Parameters for {@link findOverExposure}.
71
+ */
72
+ export interface FindOverExposureParams {
73
+ /**
74
+ * Optional callback invoked once per analyzed source file, for live progress reporting. Forwarded
75
+ * to {@link analyzeOverExposure}.
76
+ */
77
+ onProgress?(this: void, progress: OverExposureProgress): void;
78
+ /** Absolute path to the project root (the folder containing `tsconfig.json` and `src`). */
79
+ readonly projectFolder: string;
80
+ }
81
+ /**
82
+ * The subset of file-system operations the language-service host needs. Injecting this (rather than
83
+ * always using `typescript`'s `sys`) lets tests drive the analyzer against in-memory sources with no
84
+ * real file-system access.
85
+ */
86
+ export interface OverExposureFileSystem {
87
+ /**
88
+ * @param path - Directory path.
89
+ * @returns `true` when the directory exists.
90
+ */
91
+ directoryExists(this: void, path: string): boolean;
92
+ /**
93
+ * @param path - File path.
94
+ * @returns `true` when the file exists.
95
+ */
96
+ fileExists(this: void, path: string): boolean;
97
+ /**
98
+ * @returns The current working directory.
99
+ */
100
+ getCurrentDirectory(this: void): string;
101
+ /**
102
+ * @param path - Directory path.
103
+ * @returns The immediate subdirectory names.
104
+ */
105
+ getDirectories(this: void, path: string): string[];
106
+ /**
107
+ * @param path - Root directory.
108
+ * @param extensions - Extensions to include.
109
+ * @param exclude - Patterns to exclude.
110
+ * @param include - Patterns to include.
111
+ * @param depth - Maximum recursion depth.
112
+ * @returns The matching file paths.
113
+ */
114
+ readDirectory(this: void, path: string, extensions?: readonly string[], exclude?: readonly string[], include?: readonly string[], depth?: number): string[];
115
+ /**
116
+ * @param path - File path.
117
+ * @returns The file contents, or `undefined` when absent.
118
+ */
119
+ readFile(this: void, path: string): string | undefined;
120
+ }
121
+ /**
122
+ * A single over-exposed declaration.
123
+ */
124
+ export interface OverExposureFinding {
125
+ /** 1-based column of the declaration's name. */
126
+ readonly column: number;
127
+ /** The current exposure level. */
128
+ readonly currentExposure: CurrentExposure;
129
+ /** Absolute path of the file declaring the symbol. */
130
+ readonly filePath: string;
131
+ /** `true` when the declaration has no references at all (besides itself). */
132
+ readonly hasNoReferences: boolean;
133
+ /**
134
+ * `true` when the declaration would qualify for a tighter exposure if not for references coming
135
+ * exclusively from test files — i.e. it is exposed purely for testability.
136
+ */
137
+ readonly isForcedByTestOnly: boolean;
138
+ /** `true` for a class member, `false` for a top-level export. */
139
+ readonly isMember: boolean;
140
+ /** 1-based line of the declaration's name. */
141
+ readonly line: number;
142
+ /** The declared name. */
143
+ readonly name: string;
144
+ /** The exposure the declaration could be tightened to. */
145
+ readonly suggestedExposure: SuggestedExposure;
146
+ }
147
+ /**
148
+ * Progress reported while analyzing a project, one event per analyzed source file.
149
+ */
150
+ export interface OverExposureProgress {
151
+ /** Number of source files fully analyzed before the current one (0-based). */
152
+ readonly analyzedFileCount: number;
153
+ /** Absolute (canonical) path of the source file about to be analyzed. */
154
+ readonly currentFilePath: string;
155
+ /** Total number of source files that will be analyzed. */
156
+ readonly totalFileCount: number;
157
+ }
158
+ /**
159
+ * The (tighter) exposure level a declaration could be reduced to.
160
+ */
161
+ export type SuggestedExposure = 'file-local' | 'private' | 'protected';
162
+ /**
163
+ * Lifecycle and framework members invoked by Obsidian or a base class via registration rather than
164
+ * by references the language service can see. Tightening these would break the framework contract,
165
+ * so they are never reported.
166
+ */
167
+ export declare const LIFECYCLE_ALLOWLIST: ReadonlySet<string>;
168
+ /**
169
+ * Analyzes a project (already loaded into a language service) for over-exposed declarations.
170
+ *
171
+ * @param params - The {@link AnalyzeOverExposureParams}.
172
+ * @returns The over-exposed declarations, in discovery order.
173
+ */
174
+ export declare function analyzeOverExposure(params: AnalyzeOverExposureParams): OverExposureFinding[];
175
+ /**
176
+ * Builds a {@link LanguageServiceHost} backed by an explicit file list and file system.
177
+ *
178
+ * @param params - The {@link CreateLanguageServiceHostParams}.
179
+ * @returns The language-service host.
180
+ */
181
+ export declare function createLanguageServiceHost(params: CreateLanguageServiceHostParams): LanguageServiceHost;
182
+ /**
183
+ * Builds a language service over every file in a project's `tsconfig.json`.
184
+ *
185
+ * @param params - The {@link CreateProjectLanguageServiceParams}.
186
+ * @returns A language service ready for {@link analyzeOverExposure}.
187
+ */
188
+ export declare function createProjectLanguageService(params: CreateProjectLanguageServiceParams): LanguageService;
189
+ /**
190
+ * Finds over-exposed declarations in a project on disk.
191
+ *
192
+ * @param params - The {@link FindOverExposureParams}.
193
+ * @returns The over-exposed declarations.
194
+ */
195
+ export declare function findOverExposure(params: FindOverExposureParams): OverExposureFinding[];
196
+ /**
197
+ * Formats over-exposure findings as a human-readable report. Findings are grouped by file and each
198
+ * line begins with a `path:line:column` location so terminals (e.g. VS Code) render it as a
199
+ * clickable link that jumps to the declaration.
200
+ *
201
+ * @param findings - The findings to format.
202
+ * @returns The report text. Empty-finding input yields a single "no findings" line.
203
+ */
204
+ export declare function formatOverExposureFindings(findings: readonly OverExposureFinding[]): string;