@codometer/languages 0.0.63 → 0.0.65

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## 0.0.65 (2026-11-04)
+
+### 🧱 Updated Dependencies
+
+- Updated codometer-configuration to 0.0.65
+- Updated codometer-core to 0.0.65
+
+## 0.0.64 (2026-11-04)
+
+### 🧱 Updated Dependencies
+
+- Updated codometer-configuration to 0.0.64
+- Updated codometer-core to 0.0.64
+
 ## 0.0.63 (2026-11-04)
 
 ### 🧱 Updated Dependencies

package/README.md

@@ -761,7 +761,7 @@ graph LR
 ### Project
 
 ![Lines of Code](https://img.shields.io/badge/Lines_of_Code-10329-22c55e?style=flat-square)
-![Repository Size](https://img.shields.io/badge/Repository_Size-322.77_kB-6b7280?style=flat-square)
+![Repository Size](https://img.shields.io/badge/Repository_Size-323.04_kB-6b7280?style=flat-square)
 ![Folders](https://img.shields.io/badge/Folders-16-4a4a4a?style=flat-square)
 ![Source Files](https://img.shields.io/badge/Source_Files-106-3178c6?style=flat-square)
 
@@ -949,16 +949,16 @@ graph LR
 ### Markdown
 
 ![Markdown Files](https://img.shields.io/badge/Markdown_Files-2-083fa1?style=flat-square)
-![Markdown Lines](https://img.shields.io/badge/Markdown_Lines-654-1f6feb?style=flat-square)
+![Markdown Lines](https://img.shields.io/badge/Markdown_Lines-668-1f6feb?style=flat-square)
 ![H1](https://img.shields.io/badge/H1-1-7c3aed?style=flat-square)
-![H2](https://img.shields.io/badge/H2-66-8b5cf6?style=flat-square)
-![H3](https://img.shields.io/badge/H3-76-a78bfa?style=flat-square)
+![H2](https://img.shields.io/badge/H2-68-8b5cf6?style=flat-square)
+![H3](https://img.shields.io/badge/H3-78-a78bfa?style=flat-square)
 ![H4](https://img.shields.io/badge/H4-0-c4b5fd?style=flat-square)
 ![H5](https://img.shields.io/badge/H5-0-ddd6fe?style=flat-square)
 ![H6](https://img.shields.io/badge/H6-0-ede9fe?style=flat-square)
-![Paragraphs](https://img.shields.io/badge/Paragraphs-168-64748b?style=flat-square)
-![Lists](https://img.shields.io/badge/Lists-70-16a34a?style=flat-square)
-![List Items](https://img.shields.io/badge/List_Items-148-22c55e?style=flat-square)
+![Paragraphs](https://img.shields.io/badge/Paragraphs-172-64748b?style=flat-square)
+![Lists](https://img.shields.io/badge/Lists-72-16a34a?style=flat-square)
+![List Items](https://img.shields.io/badge/List_Items-152-22c55e?style=flat-square)
 ![Task List Items](https://img.shields.io/badge/Task_List_Items-0-4ade80?style=flat-square)
 ![Tables](https://img.shields.io/badge/Tables-2-0284c7?style=flat-square)
 ![Table Rows](https://img.shields.io/badge/Table_Rows-10-0ea5e9?style=flat-square)
@@ -976,104 +976,104 @@ graph LR
 
 The words this project uses that the root glossary does not define, regenerated with `nx run codometer-languages:coinagerie-check:write`.
 
-- **advance**:
-- **analyze**:
-- **anchor**:
-- **arrow**:
-- **ast**:
-- **backslash**:
-- **blockquote**:
-- **bool**:
-- **breach**:
-- **breadth**:
-- **budget**:
-- **carry**:
-- **claim**:
-- **col**:
-- **conditional**:
-- **consume**:
-- **counter**:
-- **delimiter**:
-- **dict**:
-- **doc**:
-- **docstring**:
-- **dump**:
-- **excerpt**:
-- **execution**:
-- **explicit**:
-- **explore**:
-- **flatten**:
-- **generic**:
-- **getattr**:
-- **good**:
-- **handle**:
-- **hcl**:
-- **interpolation**:
-- **ipynb**:
-- **isinstance**:
-- **isupper**:
-- **javascript**:
-- **jsonl**:
-- **jupyter**:
-- **len**:
-- **level1**:
-- **level2**:
-- **level3**:
-- **level4**:
-- **level5**:
-- **level6**:
-- **marker**:
-- **measure**:
-- **measurement**:
-- **multi**:
-- **multiline**:
-- **nbformat**:
-- **notebook**:
-- **nullish**:
-- **odd**:
-- **overlap**:
-- **paragraph**:
-- **pathlib**:
-- **pipeline**:
-- **po**:
-- **primitive**:
-- **processor**:
-- **prop**:
-- **prose**:
-- **py**:
-- **pyproject**:
-- **re**:
-- **reader**:
-- **readline**:
-- **sample**:
-- **sanitize**:
-- **scalar**:
-- **scan**:
-- **scanner**:
-- **selector**:
-- **seq**:
-- **severity**:
-- **shebang**:
-- **should**:
-- **single**:
-- **slash**:
-- **span**:
-- **sparse**:
-- **splice**:
-- **splitline**:
-- **startswith**:
-- **stdin**:
-- **str**:
-- **sub**:
-- **sy**:
-- **syntax**:
-- **temp**:
-- **thematic**:
-- **todo**:
-- **tokenize**:
-- **toml**:
-- **trail**:
-- **trivia**:
-- **variant**:
+- **advance**: Verb in the JSON parser's shouldAdvanceIndex flag, telling its state machine whether to step to the next character.
+- **analyze**: Verb for the language dispatcher's analyze function, which routes each file to the analyzer for its language.
+- **anchor**: YAML node property holding a reusable node's name, which the YAML comment service reads as a string when present.
+- **arrow**: TypeScript arrow function syntax, which the declaration comment reader classifies as a function rather than a method.
+- **ast**: Python standard library abstract syntax tree module that the Python analyzer script walks to count classes and functions.
+- **backslash**: Test helper that builds a literal backslash character, used by the JSON service tests to check escaped newlines.
+- **blockquote**: Markdown block quote node type mapped to the blockQuotes counter in the markdown constants table.
+- **bool**: Boolean return annotation on is_shebang in the Python analyzer script, which decides whether a first line is a shebang.
+- **breach**: Wording for a comment that exceeds its budget, which the comments service shortens so the report line stays readable.
+- **breadth**: Limit on how many calls a function may make, which the languages service keeps within by avoiding an extra split.
+- **budget**: Per-statistic allowance of words, lines, or characters for one comment block, judged by the comment measurement.
+- **carry**: Verb for what a comment node or measurement holds, such as the explicit length a comment budget carries.
+- **claim**: Verb for a counter taking a TypeScript declaration when its kind matches, so the declaration is tallied once.
+- **col**: Fragment of column, the yaml package's col field that the YAML comment service destructures as a line position.
+- **conditional**: Shell conditional opening pattern in the shell constants, which the shell analyzer matches to count control structures.
+- **consume**: Verb for the JSON comment reader advancing past one character, as its parser state machine does in each step.
+- **counter**: Custom statistic that tallies matching declarations or comments, configured per selector and shared by the TypeScript and comment services.
+- **delimiter**: Multi-line string delimiter, such as the triple quotes the TOML constants match, which the reader must pair correctly.
+- **dict**: Python dict annotation on read_comment and count_docstring in the Python analyzer script, carrying per-file statistics.
+- **doc**: JSDoc or TSDoc documentation comment form, which the TypeScript constants recognize through a regex for doc tags.
+- **docstring**: Python docstring text returned by ast.get_docstring, which the Python analyzer counts into its docstringLines statistic.
+- **dump**: Fragment of json.dumps in the Python analyzer script, which prints its per-file statistics as JSON to standard output.
+- **excerpt**: Short leading slice of a comment, capped at COMMENT_EXCERPT_LENGTH of 48 characters, kept to identify a measured block.
+- **execution**: Notebook run state such as execution counts, which the Jupyter service leaves out of the cells and outputs it measures.
+- **explicit**: Adjective for a value spelled out in configuration, such as an explicit comment length budget or a YAML key with no value.
+- **explore**: Name of a notebook test fixture, explore.ipynb, used by the Jupyter service tests to exercise cell counting.
+- **flatten**: Test helper flattenDeclarationComments that collects every declaration comment measurement into one list for assertions.
+- **generic**: Type-parameter flag that the TypeScript service increments for each generic class or function it tallies as a declaration.
+- **getattr**: Python builtin in the Python analyzer script that reads a base class's id, used to recognize Protocol inheritance.
+- **good**: Name of a well-formed notebook test fixture, good.ipynb, that the Jupyter service measures without raising an error.
+- **handle**: Prefix of the TypeScript service's per-node methods, each dispatched from dispatchNode, and of the JSON comment handlers.
+- **hcl**: Terraform configuration language whose module and comment reader handle hash, double-slash, and block comment forms.
+- **interpolation**: HCL template expression matched by a constants regex, so the HCL service can recognize interpolation syntax in its text.
+- **ipynb**: Jupyter notebook file extension read by the Jupyter service, and the suffix of many unit test fixture names.
+- **isinstance**: Python builtin that the Python analyzer script uses to sort AST nodes into class, function, and assignment counts.
+- **isupper**: Python string method that the analyzer script calls on a target name to detect constant-style module assignments.
+- **javascript**: JavaScript language read by the TypeScript and comment services in every dialect the workspace uses.
+- **jsonl**: JSON Lines extension that the JSON service parses one document per line, alongside its JSONC comment support.
+- **jupyter**: Notebook format read by the Jupyter module, which measures its markdown and code cells along with their outputs.
+- **len**: Python builtin that counts lines in source and docstring text, feeding the Python analyzer's lines and docstringLines totals.
+- **level1**: Count of level one headings, the first of six heading-depth counters that the markdown analyzer tallies.
+- **level2**: Count of level two headings, one of six heading-depth counters the markdown analyzer tallies per document.
+- **level3**: Count of level three headings, one of six heading-depth counters the markdown analyzer tallies per document.
+- **level4**: Count of level four headings, one of six heading-depth counters the markdown analyzer tallies per document.
+- **level5**: Count of level five headings, one of six heading-depth counters the markdown analyzer tallies per document.
+- **level6**: Count of level six headings, the deepest of six heading-depth counters the markdown analyzer tallies per document.
+- **marker**: Comment opening token, such as a hash or slash, that the comment constants treat as the only sign of a comment.
+- **measure**: Verb for computing a comment's length against its budget, exposed as the measure method of the comments service.
+- **measurement**: Result of checking one comment block against its budget, carried as a CommentMeasurement record per block.
+- **multi**: Prefix in multi-line comments and multi-line strings, which the CSS and TOML readers treat as a single token.
+- **multiline**: Spelling variant of multi-line, appearing only in this package's glossary and not as a code identifier.
+- **nbformat**: Jupyter notebook format specification, whose null-for-never-run convention the Jupyter service follows for execution counts.
+- **notebook**: Jupyter document of cells, which the Jupyter service reads to count code cells, markdown cells, and their outputs.
+- **nullish**: Zod schema modifier accepting null or undefined, so a notebook missing an execution count still parses without rejection.
+- **odd**: Describes a malformed fixture such as odd.ipynb, whose cells are not an array, and the TOML rule for odd delimiter counts.
+- **overlap**: Overlap between a comment marker and prose, such as a double dash written inside a SQL block comment, which the reader must split.
+- **paragraph**: Markdown paragraph node type mapped to the paragraphs counter in the markdown constants table.
+- **pathlib**: Python module imported by the Python analyzer script to turn each line read from standard input into a file path.
+- **pipeline**: Shell pipe operator counted as joining two commands, and the measurement pipeline collaborator the languages service holds.
+- **po**: Two-letter fragment appearing only in this package's glossary, with no code identifier of that exact spelling.
+- **primitive**: JSON scalar value counted as a primitive, alongside objects, arrays, and nesting depth, by the JSON service.
+- **processor**: Remark markdown processor instance in the markdown service that parses each document into a syntax tree.
+- **prop**: Shortened CSS declaration property, read as node.prop so custom properties beginning with a double dash can be counted.
+- **prose**: The words of a comment left once its markers are stripped, which the comments service counts against a budget.
+- **py**: File extension of the Python analyzer script, python.service.py, which the TypeScript service runs in a subprocess.
+- **pyproject**: Python project file pyproject.toml, which the TOML reader and the languages service tests treat as a recognized config file.
+- **re**: Prefix in re-parse and re-read, which the markdown service avoids by parsing each document only once.
+- **reader**: Per-syntax comment reader that the comments module provides, one for each comment syntax, such as Python or HCL.
+- **readline**: Python readline method used to read a source string line by line inside the Python analyzer script.
+- **sample**: Name of a fixture file or sampleNotebook constant in the comment and Jupyter unit tests, not a measurement concept.
+- **sanitize**: Fragment of sanitizedContent, the JSON reader's comment-free copy of a document built character by character.
+- **scalar**: YAML or JSON scalar value, where the YAML comment service ignores a hash sign that sits inside a quoted scalar.
+- **scan**: In-progress state object for one file during comment measurement, holding its text, its lines, and what has been read.
+- **scanner**: Lexical pass over source that hands the comment readers their tokens, so each measurement does not rescan the file text.
+- **selector**: Config key naming which comments a custom statistic counts, such as the comment selector a budget is attached to.
+- **seq**: Fragment of sequence, the YAML list counter and the isSeq type guard from the yaml package used by the YAML service.
+- **severity**: Breach level for a comment or limit, carried from configuration into the comment measurement record unchanged.
+- **shebang**: Leading hash-bang line that the hash comment reader skips so it is not counted as a comment.
+- **should**: Modal word in the Jupyter constants comment saying a notebook missing a field is still measured for what it holds.
+- **single**: Single-node measurement helper in the markdown service that records one node against the running totals.
+- **slash**: Two-character comment marker, the double slash that the HCL and TypeScript comment readers recognize.
+- **span**: Character range of a comment token, which the HCL comment reader records for each block comment in source order.
+- **sparse**: Name of a minimal test fixture, such as sparse.ipynb or sparse.toml, that checks readers tolerate incomplete input.
+- **splice**: Array splice call that empties a list of temporary directories in the CSS and language comment tests.
+- **splitline**: Fragment of splitlines, the Python string method the analyzer script uses to count docstring and source lines.
+- **startswith**: String prefix test used by the comment readers to detect shebangs, JSDoc openings, and custom CSS properties.
+- **stdin**: Standard input stream from which the Python analyzer script reads its newline-delimited list of files to measure.
+- **str**: Python str annotation in the analyzer script, such as the dict of str to int stats and the list of paths read from stdin.
+- **sub**: Python regex substitution call that strips the comment marker from token text to leave the prose of a comment.
+- **sy**: Two-letter fragment of sys, as in sys.stdin read by the Python analyzer script to receive its file list.
+- **syntax**: Comment syntax that one reader handles, which the comments module keeps separate per language, as CSS has only one form.
+- **temp**: Fragment of temporary, used in tests and in the Python service, which avoids measuring a project under the system temp directory.
+- **thematic**: Markdown horizontal rule node counted as thematicBreaks by the markdown analyzer, one of its node-type counters.
+- **todo**: Literal TODO marker in source comments, such as the note in the JSON module that the measureJson module needs documenting.
+- **tokenize**: Python standard tokenizer that the Python analyzer script runs to read comment tokens with their positions in the source.
+- **toml**: TOML configuration language the TOML module reads, including its multi-line string delimiters and comment syntax.
+- **trail**: Fragment of trailing, a comment after a value that never joins the block above it, per the comments service.
+- **trivia**: Leading and trailing comment or whitespace text attached to a TypeScript token, which the comment reader must account for.
+- **variant**: Fragment of LanguageVariant, the TypeScript compiler enum value the TypeScript analyzer passes when parsing standard source.
 
 <!-- coinagerie:end -->

package/package.json

@@ -4,8 +4,8 @@
     "url": "https://github.com/organizzolini/codebase/issues"
   },
   "dependencies": {
-    "@codometer/configuration": "0.0.63",
-    "@codometer/core": "0.0.63",
+    "@codometer/configuration": "0.0.65",
+    "@codometer/core": "0.0.65",
     "@nestjs/common": "^11.1.21 || ^12.0.1",
     "mdast": "^3.0.0",
     "pino": "^10.3.1",
@@ -71,5 +71,5 @@
     "strict": true
   },
   "types": "./dist/src/index.d.ts",
-  "version": "0.0.63"
+  "version": "0.0.65"
 }