tcl-ls 0.2.1__py3-none-any.whl

tcl_ls-0.2.1.dist-info/METADATA

@@ -0,0 +1,172 @@
+Metadata-Version: 2.4
+Name: tcl-ls
+Version: 0.2.1
+Summary: Tcl language server, checker, and metadata toolkit.
+Project-URL: Documentation, https://lewis6991.github.io/tcl-ls/
+Project-URL: Homepage, https://github.com/lewis6991/tcl-ls
+Project-URL: Issues, https://github.com/lewis6991/tcl-ls/issues
+Project-URL: Repository, https://github.com/lewis6991/tcl-ls
+Project-URL: Changelog, https://github.com/lewis6991/tcl-ls/blob/main/CHANGELOG.md
+Author-email: Lewis Russell <lewis6991@gmail.com>
+License-File: LICENSE
+Keywords: language-server,lint,lsp,static-analysis,tcl
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Typing :: Typed
+Requires-Python: >=3.14
+Requires-Dist: pygls>=2.1.0
+Description-Content-Type: text/markdown
+
+# tcl-ls
+
+A Tcl language server, checker, and metadata toolkit implemented in typed
+Python.
+
+## Install
+
+`tcl-ls` currently targets Python 3.14 or newer.
+
+Install from PyPI with:
+
+```sh
+python3 -m pip install tcl-ls
+```
+
+You can also download packaged server archives and editor assets from the
+[GitHub Releases](https://github.com/lewis6991/tcl-ls/releases) page.
+
+This installs three command-line entry points:
+
+* `tcl-ls` for the stdio language server
+* `tcl-check` for batch diagnostics
+* `tcl-meta` for Tcl metadata-helper workflows
+
+For local development from a checkout, sync the environment once and prefer
+`uv run ...` for commands you do not want to install globally:
+
+```sh
+uv sync
+```
+
+## Current Scope
+
+This is an alpha release aimed at early adopters. The server is already useful
+for diagnostics, navigation, completion, rename, signature help, semantic
+tokens, and metadata-assisted checking, but it still analyzes Tcl
+conservatively and does not try to model the full dynamic runtime.
+
+## Documentation
+
+Published docs are available at
+<https://lewis6991.github.io/tcl-ls/>.
+
+Build the Sphinx docs locally with:
+
+```sh
+make docs
+```
+
+The rendered site is written to `docs/_build/html/index.html` and covers
+getting started, editor and checker workflows, metadata authoring, support,
+and development notes.
+
+Editor-specific helpers shipped in this repository:
+
+* `editors/vscode` for the VS Code extension
+* `editors/nvim` for the Neovim 0.11+ built-in LSP config
+
+## Maintenance
+
+Refresh builtin subcommand metadata with:
+
+```sh
+python3 scripts/generate_builtin_commands.py
+```
+
+The generator updates `meta/tcl8.6/tcl.meta.tcl` in place and
+supports `--input`, `--output`, `--doc-root`, `--tcl-doc-series`, and
+`--version-label` for versioned metadata workflows.
+
+## Metadata
+
+Metadata files use the `*.meta.tcl` suffix and `meta command` entries:
+
+```tcl
+meta command regexp {args} {
+    option -start value
+    option -- stop
+    bind after-options 3..
+}
+```
+
+The optional body is declarative analysis metadata. Current annotations are:
+`option`, `keyword`, `subcommand`, `bind`, `ref`, `script-body`,
+`source`, and `package`.
+
+## Diagnostics
+
+Install the package first so the CLI entry points are available:
+
+```sh
+python3 -m pip install tcl-ls
+```
+
+Analyze a Tcl file or project tree with:
+
+```sh
+tcl-check path/to/project
+```
+
+In an interactive terminal, the checker prepares package-scoped workspaces
+(directories rooted by `pkgIndex.tcl`), then prints final grouped diagnostics
+with source context and a finished summary as each workspace is analyzed. Use
+`--color=always|never|auto` and `--context-lines=N` to tune the terminal
+output.
+
+To inspect the current diagnostics emitted for `tcllib`, use:
+
+```sh
+make check-tcllib
+```
+
+Pass extra checker flags through `make` with:
+
+```sh
+make check-tcllib TCL_CHECK_ARGS="--context-lines=1 --fail-on-diagnostics"
+```
+
+Project-local config can live in `tcllsrc.tcl`. Supported commands are:
+
+```tcl
+plugin-path .tcl-ls/sample.tcl
+lib-path ../tcllib
+```
+
+Configured paths are resolved relative to the config file. `lib-path` roots are
+scanned for `pkgIndex.tcl` files so external library trees can satisfy
+`package require` without moving them into the project.
+
+To build metadata inside a tool-specific Tcl shell, source the bundled helper
+reported by:
+
+```sh
+tcl-meta helper-path
+```
+
+Then, inside that tool Tcl shell, write metadata directly with:
+
+```tcl
+tcl-meta build-file output.meta.tcl
+```
+
+For local development in this repository, use `uv run ...` when you want to
+run the CLI without installing it first.

tcl_ls-0.2.1.dist-info/RECORD

@@ -0,0 +1,113 @@
+tcl_lsp/__init__.py,sha256=Z_jHDkh_mAq0LRipUViJMN0oNTAzHX6neKNuTUnkHGY,147
+tcl_lsp/__main__.py,sha256=2YaqmK33z90UFfgA8BPtYZ9fH1fhiZQwNojFH-iwQeI,151
+tcl_lsp/cache.py,sha256=bRIVwTgiEUcZGRC4eOeQUdKSnTqGXa8C76lZuTOUkyM,1139
+tcl_lsp/common.py,sha256=6Fj3rM05s-VjdkMKH1WO27KZhWMEa8UmE8l-zUaoTYg,2991
+tcl_lsp/meta_tools.py,sha256=RNhFSGZtik7bhXNFMLks74epgRhrmwgugsGvZd6cdUs,134
+tcl_lsp/metadata_paths.py,sha256=oZ1pEuhaC93QmZpXw8ymfLBPlvWQQnAVZLmvw_4M_kM,4277
+tcl_lsp/project_config.py,sha256=qkLYiryXKLh93D_JmTpdmEtchfFt0QeEnWiMSEDkeMs,360
+tcl_lsp/workspace.py,sha256=EZWu5Uu5VT5KB3JRVlOivdu-5ACbV_56upk5fbXUIFQ,321
+tcl_lsp/analysis/__init__.py,sha256=B6YiB56c4OTsBB4O2CUK8vLSVKs8Yrjq7xCZTJfmvig,1057
+tcl_lsp/analysis/arity.py,sha256=bl2YCEPv-wk4xOrJMzOT9jxDOtfcYmAUke9rvTpgACo,5251
+tcl_lsp/analysis/builtins.py,sha256=9VIAYyp3QIA5gsjHR-GkNSkvHV1CDkNXp4xAnEjcuuM,16778
+tcl_lsp/analysis/control_flow.py,sha256=rPKZov0Yhev1ZEJBe3XTt_HmwCJo3lpH1ikAc9FSbAE,6534
+tcl_lsp/analysis/embedded_languages.py,sha256=IL0c_m6ADdbEvv6NZa-Y0sQIv-C3xwsiqrL3Sw5WOKs,18081
+tcl_lsp/analysis/index.py,sha256=T42xz9uw-U1IjWpFrXwNJHxsRyGaT-4uFOoiT1NM3U4,15397
+tcl_lsp/analysis/metadata_commands.py,sha256=WAGpTFF_O18y6jn4mVse5rjWROZeW6NOJhHsRFRJGdM,61729
+tcl_lsp/analysis/metadata_effects.py,sha256=Vkzj60HuFIYrXdVxm3v47CswS7tyCoaiSrLo1zYbkMk,10341
+tcl_lsp/analysis/model.py,sha256=7ueeweDhw69XiFCcPFRwE6rDJJRSecNawtN0Kxl3wOw,5776
+tcl_lsp/analysis/resolver.py,sha256=OX4PQSTmmF3n-UPWL1IGYcPCZUtXUazfW7_3l4mZdO0,44103
+tcl_lsp/analysis/signature_matching.py,sha256=GI7Xtw90FHRyqfUigHROJ8zwjtaH5yZrXB6609cvld8,8488
+tcl_lsp/analysis/diagnostics/__init__.py,sha256=CQzLP8hO2utYjX40bv8GElFYK2ofpvDfhKTbIkwl874,1763
+tcl_lsp/analysis/diagnostics/ambiguous_command.py,sha256=5k3qfA6MslCtglYigjeEYI83i03Qb0FZv7UETGbXJUg,937
+tcl_lsp/analysis/diagnostics/ambiguous_variable.py,sha256=rLnuSFr9GL4qtFKK8G--BtHOcn0mBZS5gIro9hPiC7Y,1004
+tcl_lsp/analysis/diagnostics/base.py,sha256=B5_3UrHglgjooY8J6PrLLh-q_bRs6CwMVST-QwLpaI8,2071
+tcl_lsp/analysis/diagnostics/duplicate_proc.py,sha256=Zf86DcxIjr44zZ5qgrRacr_9_VV_aADIhU4OammVcFE,843
+tcl_lsp/analysis/diagnostics/helpers.py,sha256=UmVonvysV9gxjqbbOp8_s-spDeTbg6o5EYG3AqfKskw,9279
+tcl_lsp/analysis/diagnostics/invalid_arguments.py,sha256=tnMcvs9DsQsVBZPcYpJ8x4bS-4Givze1kQvTcp_NwMw,2023
+tcl_lsp/analysis/diagnostics/invalid_regex.py,sha256=9NFtZqXTidKdBQ5uH2VgikyKXtOWraZGK-v7lupsDkM,4532
+tcl_lsp/analysis/diagnostics/missing_option_value.py,sha256=KLhyGTqzRC84wcgNwmK8Ovb5UMf_Dru2dmXdKiiGoyU,1088
+tcl_lsp/analysis/diagnostics/unknown_option.py,sha256=IzEhFqlZbsRsN9WQVqFHgVJp6IIW0_MczKiq2Zez6AY,1068
+tcl_lsp/analysis/diagnostics/unknown_subcommand.py,sha256=6hWGsRUNsAAURbpEQL3K16m8SFRZkiJ9Q7MYw_bNWMw,1030
+tcl_lsp/analysis/diagnostics/unreachable_code.py,sha256=BRVFxqnjdpCa_z2RGqVLnznrL8pKh8tcP8LxaC9hSak,11033
+tcl_lsp/analysis/diagnostics/unresolved_command.py,sha256=R5gN4A67z_FlJeYyb2gtH5fC7dbJ9oy42HoQTP68CIo,919
+tcl_lsp/analysis/diagnostics/unresolved_package.py,sha256=GUmT_pRVYe9S4XHAg4QDlkRpY87Dou5kCcUs-g8fC34,999
+tcl_lsp/analysis/diagnostics/unresolved_variable.py,sha256=-Q-XTxAAe108twSGAuDhpnqlRaSHhTgFf-PT8JXe8P8,988
+tcl_lsp/analysis/diagnostics/wrong_argument_count.py,sha256=c84SuBJLAjrxZ2C-6V2YiYZVVELynSR1yVFK3KmT1xc,2979
+tcl_lsp/analysis/facts/__init__.py,sha256=P4Qx6dokoG8MK7hlnp9baWqQA-2tCejKGC0Syuse2d4,88
+tcl_lsp/analysis/facts/collector.py,sha256=iLLENMtIq_WqYe_SSUBkLafTMffoQ0CR1RnA9IKUQ-k,112276
+tcl_lsp/analysis/facts/lowering.py,sha256=dqgX2KoquUdeuHDwJ1vlMrsyQaJrS7e3FZWenhCmQ8I,47385
+tcl_lsp/analysis/facts/parsing.py,sha256=qnc-y1rsyjWSm2P7y3TjCjowGMlG9NbTRRpZuEZ2Qdg,9621
+tcl_lsp/analysis/facts/utils.py,sha256=9NA0rwZ3rllSkASrZjIl_YeOjsPb2K6WeZEZ3GL2eZQ,8697
+tcl_lsp/analysis/flow/__init__.py,sha256=8ikNrMKDvjHH0GmQ8Iqj_RID3ZpgsqjbrA8wZoCMzkY,651
+tcl_lsp/analysis/flow/exprs.py,sha256=HifYM4iaaiMIkVEhTyFfW84bQRkqNZUCCa7wkiNHczU,12893
+tcl_lsp/analysis/flow/variables.py,sha256=ZtHNSBnZaARP_FmbfTAqdJrssOt1fvHF_4Qq806u-ug,16579
+tcl_lsp/checker/__init__.py,sha256=8zH7jAyrKmGeg2hNwAa-hccY93JWZjc8ypgR4B1jDkA,304
+tcl_lsp/checker/cli.py,sha256=sDt7AlwT32PrOIv_j67j3VV4d-grXmYs6cS3jpMLqJE,3481
+tcl_lsp/checker/model.py,sha256=1908XxAhwzZNOQgBncwgm7iqet7qQZwUqGCrSafvluk,772
+tcl_lsp/checker/reporting.py,sha256=hNwUOH5r1Wsfixs1a6DIXe2fyl1r6ALdXsf0gq-vrT8,13174
+tcl_lsp/checker/service.py,sha256=Lrx3KutMXhgL8bf-tiwkuLANsXEVmszqIvRLh4xIyfE,17930
+tcl_lsp/lsp/__init__.py,sha256=uFcP3Faz7XRcwAW0hL3YQMkwGiP1LeIl0XJ7shn_4Us,94
+tcl_lsp/lsp/document_changes.py,sha256=HbsVdiDQPeZtTFWeg88irjuDOvyNB8-Wg2otZzL8U2o,5293
+tcl_lsp/lsp/semantic_tokens.py,sha256=ruuzqm0lxNHC5XtZFua8J8BfeJH8FehqicqwL3MqngE,12539
+tcl_lsp/lsp/server.py,sha256=ng5UqLdlY6BifhI0e7cTnSeGruiwtI7WS_SZn2tyToM,44132
+tcl_lsp/lsp/state.py,sha256=ERvfUwYGOLb7kZQ0NDIRjRcxO62r-asK9wDWQX_yArU,1493
+tcl_lsp/lsp/workspace_rebuild.py,sha256=m5UomA9p81eM7K9OqO6nWztL7O2Q7-Kt1oPMe_552wU,21458
+tcl_lsp/lsp/features/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+tcl_lsp/lsp/features/completion.py,sha256=oGiXwUaQLoRAGhWDP-Jbz7AqX0kZTylGvunuaeJM_G8,29996
+tcl_lsp/lsp/features/cursor_context.py,sha256=TsOHN9J7S5Pr32TqlmT9zEsWEZ9ot-6Nxef58YaKxQ8,7051
+tcl_lsp/lsp/features/document_links.py,sha256=S6qi62vR85IFTSdiswbemmZ62f_SkZa1xwbFeiSjT_A,2179
+tcl_lsp/lsp/features/folding.py,sha256=zkWUhmybb59M7x6yCbtpEcM0ZxhtEouLL5odRCTmrPM,3418
+tcl_lsp/lsp/features/highlights.py,sha256=SlNH7uOl6REG0AHGk7RQEAuIz6VAs-S_Cie4uPFVcWU,2105
+tcl_lsp/lsp/features/hover.py,sha256=BuPQ2-tqKGk7XdWK8Jril2oB0kxAdGc_NtVfnFNn1kA,664
+tcl_lsp/lsp/features/navigation.py,sha256=8_1kxmXHU0iD-vjsQXvSRtYlUQxhW6otJleHGWTgG2Q,9532
+tcl_lsp/lsp/features/rename.py,sha256=06rYI8tLKl4MXohgL7vYvmis_xD923eO7eFzihBT4iQ,10769
+tcl_lsp/lsp/features/signature_help.py,sha256=yzcHwkPI4oyBMhwn73juhX3g3ONSh4BzWu4w75G0M-U,6329
+tcl_lsp/lsp/features/symbols.py,sha256=ezX-iztPbsxuKfb0m0cjuk8hneBCNenn-zm2DcUV_-0,4319
+tcl_lsp/lsp/features/workspace_symbols.py,sha256=yFWO5IpQoAvlQbIbRmRndcN3Yk7-raTcQ2AZdthxGjo,4064
+tcl_lsp/meta/__init__.py,sha256=0BQGmFI-DN86Qk3u8sosI4jrqu5zm_WpKkjeWpQ0enY,1843
+tcl_lsp/parser/__init__.py,sha256=Xcn-8Fhc5VrUF7hNQPyZc8iadXkZsowcSqaFZL4H8tI,607
+tcl_lsp/parser/expr.py,sha256=0ME4Xgb7y8N3l5SonQDERYA95_0V7OCpIEZQ3LicKe0,14338
+tcl_lsp/parser/helpers.py,sha256=p3ZO8gNuuDa8YIkwPkLdlr421dCc6EsyzivZxrphegY,2803
+tcl_lsp/parser/model.py,sha256=FXTRIi2XgjZxbtf0P0pk1xo-YVydGa9UajyWwM28tE4,1650
+tcl_lsp/parser/parser.py,sha256=CaSHIFfK2zYTWPeQhU_q2j9gDzu3XCzAjqgZOLmZ5zE,26994
+tcl_lsp/plugins/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+tcl_lsp/plugins/host.py,sha256=VNUsONnD5v8GTr2CmXmMy3L9rIYLBWhEMsf1fhlfYY8,25309
+tcl_lsp/project/__init__.py,sha256=-OIX0tODIsxobWvnL_znXzf9Bc6-pJn14IujHZBGulM,57
+tcl_lsp/project/config.py,sha256=J-6cOlpiTrLf60SvnsJH0yVWAAuLYM8zCNeaunPX5gQ,3497
+tcl_lsp/project/indexing.py,sha256=7g7nfQEgLtnE81FQm4j9CENejY-hXyQtnnAFwyTibLg,9517
+tcl_lsp/project/paths.py,sha256=vNa1gv9G23GAnPtTxWCDs98WgVEZmLTb1MrjxJLNJMo,1828
+tcl_lsp/meta/meta.meta.tcl,sha256=l3Yzbk2ctP4esFeh9drnfL8oOm1GuI2Gt0bSLwrP7WY,10570
+tcl_lsp/meta/plugins/host.tcl,sha256=e-19IW8gTYtDhalP7N0Y61cY0MMN7q3S4kKoINyZNmA,3646
+tcl_lsp/meta/tcl8.6/msgcat.meta.tcl,sha256=N6GfkbhNCehL5CSG21sZmr1jZqWrUirXB_53exoqThs,791
+tcl_lsp/meta/tcl8.6/tcl.meta.tcl,sha256=UNW3jrypZNR29DtYM8hLGyPp85ESMSINHtF1eGlYICE,77898
+tcl_lsp/meta/tcl8.6/tcloo.meta.tcl,sha256=kxHMfZv036lcQ2wOrmfV0ymqhUY10uLu9Qsg2IRZpBA,1844
+tcl_lsp/meta/tcl8.6/tcltest.meta.tcl,sha256=Ywxvd7hlY162kmYJWiSInxXBqPtvWGr-lnSp4MYGbYQ,4331
+tcl_lsp/meta/tcl8.6/tk.meta.tcl,sha256=WmM2eQ3OFe3Ryhw9-sPFUpbS8fDtw8m4dVUYY-hr_UM,2918
+tcl_lsp/meta/tcllib/asn.meta.tcl,sha256=JSuFYV5sE2QzlznPsydoZYg0oLpcAXOk_1qCZCvdd9A,2125
+tcl_lsp/meta/tcllib/clay.meta.tcl,sha256=tI0LJ5SjS6JPhpDrgR9fDm3QnlE-2SLFcXH4xMmhPhU,1747
+tcl_lsp/meta/tcllib/cmdline.meta.tcl,sha256=Dkp3iLNhQ8X2_erqWSgLYCe4sxT0HuEH0zqwIYI6bKw,843
+tcl_lsp/meta/tcllib/fileutil.meta.tcl,sha256=BlQBd4-fmiI3ZJ9hMMiegPuhZ_tWGt8qQEOV1yICX1M,1024
+tcl_lsp/meta/tcllib/json.meta.tcl,sha256=7M5aENYJrwI6eLRop8oR-EwHsBHOhlliXdwqZrSXXx0,331
+tcl_lsp/meta/tcllib/log.meta.tcl,sha256=yKiclBUzACe_SPXHQSoZ3ebGxLYqEcjpNi-cEO2TucI,335
+tcl_lsp/meta/tcllib/logger.meta.tcl,sha256=nMB5gntetkbTp7G4Va8dy1WPk8suoY0m07YkYuM-Bv4,964
+tcl_lsp/meta/tcllib/tepam.meta.tcl,sha256=W7S_WHtCe8RbOJa5pFH9S2FDWDt56ljcfXc2drDOGFU,235
+tcl_lsp/meta/tcllib/tepam.tcl,sha256=KlLM_4Y_537VlSbE1T3YNiC0-CEGpXTvfNr9s093rpA,1763
+tcl_lsp/meta/tcllib/testutilities.meta.tcl,sha256=2pf7mGU7dJIcRceeAHZA1mry5BRGFdKGrGWfS2QxUDI,864
+tcl_lsp/meta/tcllib/doctools/text.meta.tcl,sha256=4gG8qWM_uKFL1A713K5GyXcUA5b1LWuiftjZrokYZZY,881
+tcl_lsp/meta/tcllib/json/write.meta.tcl,sha256=-lz2Mw3i9sp66jlSqmJD0GMNZuIqLsD94xWxTTCGpJo,795
+tcl_lsp/meta/tcllib/oo/meta.meta.tcl,sha256=EUbE8boQ22olznFIArckbCC3FNxrZhpIv9BywTU5tOI,262
+tcl_lsp/meta/tcllib/struct/set.meta.tcl,sha256=s6LGaXx41TziyzD8M4NvzJErzVxMoGdTz_COobI7YcM,1502
+tcl_lsp/meta/tcllib/textutil/adjust.meta.tcl,sha256=SZy3iVa-B1kaVZ37vhwWMPlOITt5Z1MQco5wIMuynzY,881
+tcl_lsp/meta/tcllib/textutil/repeat.meta.tcl,sha256=POfuzlCm18yqDDUUE-mP3pfVhUlzPTrID--b10XTuZ0,338
+tcl_lsp/meta/tcllib/textutil/split.meta.tcl,sha256=gDplp6P__nj-AayBQRJbh5WJNAyBZJRLRugYGS0PQkc,346
+tcl_lsp/meta/tcllib/textutil/string.meta.tcl,sha256=F6_0DP4Pnwcq9YXnLthJqfx1U7CuijsPN3uvAhcC7Uc,850
+tcl_lsp/meta/tcllib/textutil/tabify.meta.tcl,sha256=7LJ9tM-k5ayL8Z4gXKm9dAUtgPMAJnJ4wt9nWicgN9k,574
+tcl_lsp/meta/tcllib/textutil/textutil.meta.tcl,sha256=7E-FPNOv9BCnZF2PBFAI6DMSij0863YGLsK0tGHWnIc,2418
+tcl_lsp/meta/tcllib/textutil/trim.meta.tcl,sha256=vNfJKhvtbM7WhlxW2YMjJs7yivGWBFJ4ZvewVwzrtIQ,690
+tcl_lsp/meta/tcllib/textutil/wcswidth.meta.tcl,sha256=i8ed55gOWRuqTMttOhL7YUfX-2Bn6AGoAI2kI1HZEqk,462
+tcl_lsp/tools/tcl_meta.tcl,sha256=N_maNu6-6O3rjyB4iJVkVpUvGCM1gXplmy7maJB_hzQ,10590
+tcl_ls-0.2.1.dist-info/METADATA,sha256=FWIbSMtU_FvUmKhDGrXFOfU4_u6x1DOBBmDKC1qH_sE,4795
+tcl_ls-0.2.1.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+tcl_ls-0.2.1.dist-info/entry_points.txt,sha256=NskNMhUhsbnrx-F0dLgEbIud05yZn9rUHECWx83T9RQ,111
+tcl_ls-0.2.1.dist-info/licenses/LICENSE,sha256=0IRROPkZlOEEIQsh7ZIPstOEIqUoU1IFm1i5HntE8s8,1070
+tcl_ls-0.2.1.dist-info/RECORD,,

tcl_ls-0.2.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

tcl_ls-0.2.1.dist-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+tcl-check = tcl_lsp.checker:main
+tcl-ls = tcl_lsp.__main__:main
+tcl-meta = tcl_lsp.meta:main

tcl_ls-0.2.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lewis Russell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tcl_lsp/__init__.py

@@ -0,0 +1,7 @@
+"""Typed Tcl language server package."""
+
+__all__ = ['__version__']
+
+# x-release-please-start-version
+__version__ = '0.2.1'
+# x-release-please-end

tcl_lsp/__main__.py

@@ -0,0 +1,11 @@
+from __future__ import annotations
+
+from tcl_lsp.lsp import server
+
+
+def main() -> None:
+    server.start_io()
+
+
+if __name__ == '__main__':
+    main()

tcl_lsp/analysis/__init__.py

@@ -0,0 +1,49 @@
+from tcl_lsp.analysis.facts import FactExtractor
+from tcl_lsp.analysis.index import WorkspaceIndex
+from tcl_lsp.analysis.model import (
+    AnalysisResult,
+    AnalysisUncertainty,
+    CommandArity,
+    CommandCall,
+    CommandImport,
+    DefinitionTarget,
+    DocumentFacts,
+    NamespaceScope,
+    PackageIndexEntry,
+    PackageProvide,
+    PackageRequire,
+    ParameterDecl,
+    ProcDecl,
+    ReferenceSite,
+    ResolutionResult,
+    ResolvedReference,
+    SourceDirective,
+    VarBinding,
+    VariableReference,
+)
+from tcl_lsp.analysis.resolver import Resolver
+
+__all__ = [
+    'AnalysisResult',
+    'AnalysisUncertainty',
+    'CommandArity',
+    'CommandCall',
+    'CommandImport',
+    'DefinitionTarget',
+    'DocumentFacts',
+    'FactExtractor',
+    'NamespaceScope',
+    'PackageIndexEntry',
+    'PackageProvide',
+    'PackageRequire',
+    'ParameterDecl',
+    'ProcDecl',
+    'ReferenceSite',
+    'ResolutionResult',
+    'ResolvedReference',
+    'Resolver',
+    'SourceDirective',
+    'VarBinding',
+    'VariableReference',
+    'WorkspaceIndex',
+]

tcl_lsp/analysis/arity.py

@@ -0,0 +1,158 @@
+from __future__ import annotations
+
+from tcl_lsp.analysis.facts.parsing import ListItem, is_simple_name, split_tcl_list
+from tcl_lsp.analysis.model import CommandArity
+from tcl_lsp.common import Position
+
+_ZERO_POSITION = Position(offset=0, line=0, character=0)
+_DEFAULT_LITERAL_KEYWORDS = frozenset({'start'})
+
+
+def proc_parameter_arity(items: tuple[ListItem, ...]) -> CommandArity | None:
+    min_args = 0
+    max_args = 0
+
+    for index, item in enumerate(items):
+        parameter = _proc_parameter_spec(item)
+        if parameter is None:
+            return None
+
+        name, optional = parameter
+        if name == 'args':
+            if optional or index != len(items) - 1:
+                return None
+            return CommandArity(min_args=min_args, max_args=None)
+
+        if not optional:
+            min_args += 1
+        max_args += 1
+
+    return CommandArity(min_args=min_args, max_args=max_args)
+
+
+def metadata_signature_arity(signature: str) -> CommandArity | None:
+    text = signature.strip()
+    if not text or text == '{}':
+        return CommandArity(min_args=0, max_args=0)
+
+    items = tuple(item.text for item in split_tcl_list(text, _ZERO_POSITION))
+    if not items or items == ('',):
+        return CommandArity(min_args=0, max_args=0)
+    return _signature_items_arity(items)
+
+
+def _signature_items_arity(items: tuple[str, ...]) -> CommandArity | None:
+    min_args = 0
+    max_args = 0
+    index = 0
+
+    while index < len(items):
+        token = items[index]
+        if token == '?':
+            try:
+                group_end = items.index('?', index + 1)
+            except ValueError:
+                return None
+
+            group_arity = _optional_group_arity(items[index + 1 : group_end])
+            if group_arity is None:
+                return None
+
+            max_args += group_arity.max_args
+            index = group_end + 1
+            continue
+
+        token_arity = _signature_token_arity(token, is_last=index == len(items) - 1)
+        if token_arity is None:
+            return None
+
+        min_args += token_arity.min_args
+        if token_arity.max_args is None:
+            if index != len(items) - 1:
+                return None
+            return CommandArity(min_args=min_args, max_args=None)
+
+        max_args += token_arity.max_args
+        index += 1
+
+    return CommandArity(min_args=min_args, max_args=max_args)
+
+
+def _optional_group_arity(tokens: tuple[str, ...]) -> CommandArity | None:
+    if not tokens:
+        return None
+
+    max_args = 0
+    for token in tokens:
+        token_arity = _signature_token_arity(token, is_last=False)
+        if token_arity is None or token_arity.max_args is None:
+            return None
+        max_args += token_arity.max_args
+    return CommandArity(min_args=0, max_args=max_args)
+
+
+def _signature_token_arity(token: str, *, is_last: bool) -> CommandArity | None:
+    if not token:
+        return CommandArity(min_args=0, max_args=0)
+    if token.startswith('=') and len(token) > 1:
+        return CommandArity(min_args=1, max_args=1)
+    if token.startswith('<') and token.endswith('>') and len(token) > 2:
+        slot_name = token[1:-1]
+        if slot_name in {'selector', 'bodySelector', 'ownerSelector', 'procedureSelector'}:
+            # Selectors range from one word (`1`) to five words
+            # (`after-options list 1..last step 2`).
+            return CommandArity(min_args=1, max_args=5)
+        return CommandArity(min_args=1, max_args=1)
+    if token == 'args':
+        if not is_last:
+            return None
+        return CommandArity(min_args=0, max_args=None)
+    if _is_safe_inline_optional_literal(token):
+        return CommandArity(min_args=0, max_args=1)
+    if token == '?' or '...' in token or '|' in token or '?' in token:
+        return None
+    if not _has_internal_whitespace(token):
+        return CommandArity(min_args=1, max_args=1)
+
+    default_arity = _default_like_token_arity(token)
+    if default_arity is not None:
+        return default_arity
+    return None
+
+
+def _proc_parameter_spec(item: ListItem) -> tuple[str, bool] | None:
+    if not _has_internal_whitespace(item.text):
+        return item.text, False
+
+    subitems = split_tcl_list(item.text, item.content_start)
+    if len(subitems) != 2 or not is_simple_name(subitems[0].text):
+        return None
+    return subitems[0].text, True
+
+
+def _default_like_token_arity(token: str) -> CommandArity | None:
+    subitems = split_tcl_list(token, _ZERO_POSITION)
+    if len(subitems) != 2 or not is_simple_name(subitems[0].text):
+        return None
+
+    default_value = subitems[1].text
+    if (
+        not default_value
+        or not is_simple_name(default_value)
+        or default_value.isdigit()
+        or default_value.startswith('-')
+        or default_value in _DEFAULT_LITERAL_KEYWORDS
+    ):
+        return CommandArity(min_args=0, max_args=1)
+    return None
+
+
+def _is_safe_inline_optional_literal(token: str) -> bool:
+    if len(token) <= 2 or not token.startswith('?') or not token.endswith('?'):
+        return False
+    inner = token[1:-1]
+    return bool(inner) and inner.startswith('-') and '?' not in inner and '...' not in inner
+
+
+def _has_internal_whitespace(text: str) -> bool:
+    return any(char.isspace() for char in text)