@conformetry/languages 0.0.65 → 0.0.67

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## 0.0.67 (2026-11-04)
+
+### 🧱 Updated Dependencies
+
+- Updated conformetry-configuration to 0.0.68
+- Updated conformetry-core to 0.0.66
+
+## 0.0.66 (2026-11-04)
+
+### 🧱 Updated Dependencies
+
+- Updated conformetry-configuration to 0.0.67
+- Updated conformetry-core to 0.0.65
+
 ## 0.0.65 (2026-11-04)
 
 ### 🧱 Updated Dependencies

package/README.md

@@ -754,7 +754,7 @@ graph LR
 ### Project
 
 ![Lines of Code](https://img.shields.io/badge/Lines_of_Code-7515-22c55e?style=flat-square)
-![Repository Size](https://img.shields.io/badge/Repository_Size-254.95_kB-6b7280?style=flat-square)
+![Repository Size](https://img.shields.io/badge/Repository_Size-255.22_kB-6b7280?style=flat-square)
 ![Folders](https://img.shields.io/badge/Folders-14-4a4a4a?style=flat-square)
 ![Source Files](https://img.shields.io/badge/Source_Files-94-3178c6?style=flat-square)
 
@@ -942,16 +942,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-671-1f6feb?style=flat-square)
+![Markdown Lines](https://img.shields.io/badge/Markdown_Lines-685-1f6feb?style=flat-square)
 ![H1](https://img.shields.io/badge/H1-1-7c3aed?style=flat-square)
-![H2](https://img.shields.io/badge/H2-68-8b5cf6?style=flat-square)
-![H3](https://img.shields.io/badge/H3-79-a78bfa?style=flat-square)
+![H2](https://img.shields.io/badge/H2-70-8b5cf6?style=flat-square)
+![H3](https://img.shields.io/badge/H3-81-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-172-64748b?style=flat-square)
-![Lists](https://img.shields.io/badge/Lists-73-16a34a?style=flat-square)
-![List Items](https://img.shields.io/badge/List_Items-152-22c55e?style=flat-square)
+![Paragraphs](https://img.shields.io/badge/Paragraphs-176-64748b?style=flat-square)
+![Lists](https://img.shields.io/badge/Lists-75-16a34a?style=flat-square)
+![List Items](https://img.shields.io/badge/List_Items-156-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)
@@ -969,94 +969,94 @@ graph LR
 
 The words this project uses that the root glossary does not define, regenerated with `nx run conformetry-languages:coinagerie-check:write`.
 
-- **abc**:
-- **absent**:
-- **alt**:
-- **anchor**:
-- **asdict**:
-- **ast**:
-- **attr**:
-- **best**:
-- **big**:
-- **bool**:
-- **breadcrumb**:
-- **breadth**:
-- **bridge**:
-- **calculate**:
-- **callable**:
-- **callee**:
-- **camel**:
-- **capitalize**:
-- **claim**:
-- **closest**:
-- **combine**:
-- **comparison**:
-- **conform**:
-- **consume**:
-- **converter**:
-- **dataclass**:
-- **descriptor**:
-- **dict**:
-- **differ**:
-- **dot**:
-- **dump**:
-- **enumerate**:
-- **envelope**:
-- **executable**:
-- **func**:
-- **getattr**:
-- **grandchild**:
-- **hasattr**:
-- **html**:
-- **human**:
-- **isinstance**:
-- **jupyter**:
-- **kebab**:
-- **kernelspec**:
-- **lang**:
-- **leaf**:
-- **len**:
-- **nbformat**:
-- **notebook**:
-- **numeric**:
-- **paragraph**:
-- **pascal**:
-- **payload**:
-- **perfect**:
-- **pid**:
-- **po**:
-- **primitive**:
-- **processor**:
-- **pythonpath**:
-- **re**:
-- **readable**:
-- **readline**:
-- **remain**:
-- **same**:
-- **scol**:
-- **scramble**:
-- **snake**:
-- **sourceless**:
-- **spec**:
-- **srow**:
-- **stdin**:
-- **stem**:
-- **str**:
-- **subtree**:
-- **sum**:
-- **sy**:
-- **syntax**:
-- **thematic**:
-- **todo**:
-- **tok**:
-- **tokenize**:
-- **tuple**:
-- **unavailable**:
-- **unclaimed**:
-- **unshift**:
-- **validator**:
-- **weigh**:
-- **weight**:
-- **widen**:
+- **abc**: Standard-library abstraction module, reached only through collections.abc for the Callable type in constants.py.
+- **absent**: Comparison state for an optional field missing on one side, which the comparison treats as an empty string.
+- **alt**: Alternative text field of a markdown image node, compared so the description must match the template.
+- **anchor**: Offset in an instance file where a TypeScript error is pinned when known, carried on the difference type.
+- **asdict**: Python dataclasses helper imported in the bridge, turning a difference dataclass into a plain dict for JSON output.
+- **ast**: Python abstract syntax tree module that the Python validator walks to compare structure rather than text.
+- **attr**: Attribute name read off a Python AST node, such as the field accessed in a call expression.
+- **best**: Candidate chosen during JSON comparison as the one whose differences weigh least against the template.
+- **big**: Part of isBigIntLiteral, the TypeScript check that recognizes a BigInt literal when keying a node.
+- **bool**: Python bool call that coerces a regex search result to true or false when detecting a TODO comment line.
+- **breadcrumb**: Path label built for a missing node, such as Missing ClassDeclaration, shown in the finding message.
+- **breadth**: Callidescope measure of how many callees one callable calls directly, shown in the README breadth table.
+- **bridge**: Interface to the Python validator, a child process fed one JSON request on stdin and answering on stdout.
+- **calculate**: Method name in scoring that computes a score from weighted findings, exposed as calculateScore.
+- **callable**: Function or method identified by file and qualified name, the unit callidescope measures for depth and breadth.
+- **callee**: Expression naming the function a call invokes, from which a dotted name like Nest.Injectable is built.
+- **camel**: Case variant of a name in camelCase, produced by the string case converters in constants.
+- **capitalize**: Python str.capitalize call that uppercases the first letter of each word when building PascalCase names.
+- **claim**: Verb for a Language declaring which file extensions it handles, leaving unclaimed ones to the Fallback.
+- **closest**: Tie-breaking choice in TypeScript matching, picking the closest of two equally plausible sibling nodes.
+- **combine**: Private JSON comparison method that merges child comparisons into one parent comparison result.
+- **comparison**: Core act of weighing a template against an instance, the engine work each Language performs per file.
+- **conform**: Verb for a comparison finding no difference, as in the report saying checked files conform.
+- **consume**: Verb for taking a matched notebook source out of the pool of unpaired instance cells.
+- **converter**: Function in the Python constants table that converts a string into one case variant, keyed by StringCase.
+- **dataclass**: Python decorator marking the typed records in types.py that carry differences across the bridge.
+- **descriptor**: Static object each Language exposes naming its validator and listing the file extensions it claims.
+- **dict**: Python dictionary type used in constants and validator signatures, such as the case-name lookup table.
+- **differ**: Verb for a comparison reporting each mismatch as a Difference for what does not match.
+- **dot**: Leading character of each file extension a Language claims, so .json and .ts keep their dots.
+- **dump**: Python json.dumps call that prints the difference payload as one JSON line back to the Node bridge.
+- **enumerate**: Python builtin used in comments.py to pair each instance comment with its index while scanning.
+- **envelope**: Top-level notebook wrapper holding kernel, language, and format metadata, compared separately from its cells.
+- **executable**: Python interpreter name used to launch the bridge process, supplied by PYTHON_EXECUTABLE in the python constants.
+- **func**: Python AST field holding the called expression of a Call node, read by get_key to build keys.
+- **getattr**: Python builtin reading optional line and column off an AST node, defaulting to None when absent.
+- **grandchild**: Second-level child node in a markdown tree, read to compare nested structure one level below children.
+- **hasattr**: Python builtin checking for the dataclass marker field before converting a difference to a dict.
+- **html**: Markdown node type for raw HTML, compared by value so a changed raw block counts as a difference.
+- **human**: Readable label in human_readable_string_case, mapping each case variant to a display name like PascalCase.
+- **isinstance**: Python builtin test for AST node type in nodes.py, choosing how to read each node key or children.
+- **jupyter**: Language module for ipynb notebooks, delegating cells to the json, markdown, and python validators.
+- **kebab**: Case variant with lowercase words joined by hyphens, one entry in the Python StringCase constants table.
+- **kernelspec**: Notebook metadata block naming the kernel and language, read when comparing the notebook envelope.
+- **lang**: Info-string tag on a markdown code fence, compared between template and instance to match code blocks.
+- **leaf**: Node with no children, matched on its own identity without descending into the tree.
+- **len**: Python builtin giving the number of template comments, used as the total weight of a comment comparison.
+- **nbformat**: Notebook format version key, checked against the instance so a notebook of another version differs.
+- **notebook**: Jupyter file as a JSON document of cells, parsed into envelope and cell pairs before comparison.
+- **numeric**: Narrowing helper for numbers in the bridge payload, checking an untrusted number before use.
+- **paragraph**: Markdown block node type for ordinary prose text, compared as a node in the document tree.
+- **pascal**: Case variant with capitalized words joined without separators, produced by the Python constants converter.
+- **payload**: Untrusted JSON response the Python bridge returns to Node, narrowed field by field before use.
+- **perfect**: Full score of 1 that a comparison earns when it has nothing to weigh, exported as PERFECT_SCORE.
+- **pid**: Process identifier in mocked bridge results, set to zero in the Python bridge unit tests.
+- **po**: Not used as an identifier in the languages code; it appears only as a glossary entry.
+- **primitive**: JSON value that is a scalar rather than an object or array, tested by isJsonPrimitive before comparing.
+- **processor**: Remark processor instance that parses markdown into syntax trees for both template and instance.
+- **pythonpath**: Environment variable the Python bridge sets so the child process can import the bundled validator module.
+- **re**: Python regular expression module, used in constants.py to split names on hyphens and underscores.
+- **readable**: Human-facing in human_readable_string_case, meaning a display label rather than an identifier or key.
+- **readline**: Python stream method passed to tokenize so comments.py reads source one line at a time.
+- **remain**: Stem of variables like remainingLines that track cells or lines not yet matched.
+- **same**: Function name stem sameField, comparing one optional field across two markdown nodes for equality.
+- **scol**: Column index of a Python comment token, the start-column value saved beside each comment.
+- **scramble**: Verb for a test fixture that reorders a file so comments no longer sit where the template expects them.
+- **snake**: Case variant with lowercase words joined by underscores, mapped in the Python constants table.
+- **sourceless**: Notebook with no source on its cells, used in a test to check that paired cells still compare.
+- **spec**: Not used as code in this project; only the glossary entry names it, with no project-specific sense.
+- **srow**: Row index of a Python comment token, the start-row value saved beside each extracted comment.
+- **stdin**: Standard input stream the Python bridge reads one JSON request from, then writes its answer to stdout.
+- **stem**: Name of a file without its extension, carried as nameStem by the files service for each instance.
+- **str**: Python built-in text type annotating source parameters across the validator and abstract syntax tree modules.
+- **subtree**: Nested part of a template compared as one unit, whose missing key costs its whole weight in JSON.
+- **sum**: Python builtin adding up difference weights or subtree node counts, used in the abstract syntax tree and nodes modules.
+- **sy**: Fragment appearing only in glossary text; no project identifier here carries this exact name or meaning.
+- **syntax**: Parse tree a language validator compares node by node, instead of comparing raw file text.
+- **thematic**: Markdown horizontal-rule node type that carries no content, so it compares as nothing to check.
+- **todo**: Marker that makes a template comment accept any wording in the instance, counted in the TODO badge.
+- **tok**: Prefix of tokenizer variables tok_type and tok_str in comments.py, holding each token kind and text.
+- **tokenize**: Python module that splits source into tokens, used in comments.py to find comment tokens.
+- **tuple**: Python tuple type in the comment and location helpers, returning position pairs such as line and column.
+- **unavailable**: Failure state when the Python interpreter cannot be launched, reported with PYTHON_UNAVAILABLE_FIX as the fix.
+- **unclaimed**: Extension no Language claims, which LanguagesService widens the Fallback to cover so it still compares.
+- **unshift**: Array method prepending a name segment in typescript-nodes while building a dotted name from the leaf upward.
+- **validator**: Per-language comparison module, such as the Python or TypeScript validator, that returns differences for one file.
+- **weigh**: Verb for assigning comparison importance, where structure counts syntax nodes and comments count separately.
+- **weight**: Numeric importance a difference or comparison carries, summed into the score as total weight.
+- **widen**: Verb for extending the Fallback Language to also claim extensions that no other Language claims.
 
 <!-- coinagerie:end -->

package/package.json

@@ -4,8 +4,8 @@
     "url": "https://github.com/organizzolini/codebase/issues"
   },
   "dependencies": {
-    "@conformetry/configuration": "0.0.66",
-    "@conformetry/core": "0.0.64",
+    "@conformetry/configuration": "0.0.68",
+    "@conformetry/core": "0.0.66",
     "@nestjs/common": "^11.1.21 || ^12.0.1",
     "jsonc-parser": "^3.3.1",
     "mdast-util-to-string": "^4.0.0",
@@ -66,5 +66,5 @@
     "strict": true
   },
   "types": "./dist/src/index.d.ts",
-  "version": "0.0.65"
+  "version": "0.0.67"
 }