A package indexer with BETA 997 snapshots, a scanner that reads more of each package, and a shorter Documentation Development section by KubaO · Pull Request #227 · twinbasic/documentation

Build-tools documentation: editorial pass over docs/Documentation/ (about 13% shorter): long paragraphs split, rationale and history a contributor does not act on cut, plainer register; Tools-Toolc…

KubaO

committed

153e138

Nav: IDE moves up to nav_order 9 and Documentation Development to the end; the toolchain diagram's boxes link to their tool entries and sections; every link in the Tools map has a tooltip saying wh…

KubaO

committed

c25bf92

Attribute census: a bracket group alone on its line in an Enum body is a member, not an attribute (BETA 1005); the scanner moves to scripts/lib/census-scan.mjs and check_twin_parsers pins it

KubaO

committed

49bed0c

Enum members take no attribute: Hidden's Applicable to no longer lists one, Enum says a bracket group on its own line is a member and an inline attribute TB5182, Open's Encoding constants are Const…

KubaO

committed

4db9924

Import the package indexer from claude/elegant-elion-ba6399 as it stood: code, manifests and plans, without its snapshots

KubaO

committed

b5fd335

Format indexer/ with Biome

KubaO

committed

ec5a079

Put indexer/ under the lint, format and regex-safety gates: unused import and variable removed, an exponential attribute-line regex made unambiguous, tooling-folder lists name it

KubaO

committed

5bc3b42

indexer: command line through lib/cli.mjs (strict parse, usage with exit codes, exit 2 on refusal), recorded in cli-cases; survey_tooling covers indexer/

KubaO

committed

cd19c5e

indexer: built-in and default packages read from the local twinBASIC install by default (--ide, TB_IDE), --release for the GitHub release; the manifest records source and build; TWINSERV skipped wh…

KubaO

committed

f1c1984

twin-api: signatures, attribute arguments, descriptions, return types, accessors, aliases and the project name; keyword-named fields, one-line procedures and modifier-named enum values read right (…

KubaO

committed

8afad55

indexer: packages read through impexp's parser (parseProject, CATEGORY exported) in package-files.mjs, which replaces twinpack-parser.mjs

KubaO

committed

94f2836

indexer: api.json (format 2) built from the shared twinBASIC scanner; differ and analyze on it; lexer, extractor, json-emitter and the markdown emitter retired; VB6 files with no VB_Name named by t…

KubaO

committed

ef5d502

indexer: README describes api.json format 2 and the new modules; plans marked as superseded

KubaO

committed

fc829d0

twin-api: a line of only [Name] in an Enum body is a value, as the compiler reads it, not the next line's attribute; 94 enums gain values (the [_] LongPtr shim, GridCellEffectEnum, ReportSizeConsta…

KubaO

committed

bff6584

test.bat gate: test/indexer.test.mjs tests the package indexer (VB6 preprocessing, package files, api.json model, differ); gate counts read twenty-five

KubaO

committed

e3ceee5

indexer: sync state moves out of the repository into the store (indexer/.packages/manifests); a package is current by what the store holds (sources, api.json format and version), so a pulled or fil…

KubaO

committed

79ccfce

indexer: committed snapshots only for packages the reference documents; a section's landing page ties it to its packages (package_name, indexed_from) through lib/doc-pages.mjs

KubaO

committed

bc2d5da

indexer: BETA 997 snapshots of the 14 packages the reference documents (3.2 MB); their 13 landing pages carry package_name where the folder is not the package, and indexed_from: beta-x-0997

KubaO

committed

7b4f018

indexer: analyze reads a snapshot larger than 1 MB (VB's fell back to an audit) and says when it has none; the store keeps long paths on and line endings off

KubaO

committed

e114db1

twin-declarations: Abstract and Virtual are not modifiers (BETA 1005 reads them as a variable name and refuses the Sub after them, TB5182); the other words it refuses everywhere are noted

KubaO

committed

da2952b

twin-api: Inherits and Implements lists, qualified CoClass interfaces, [Hidden(False)], modifier-named and initialised fields, Type-body brackets, result types before Overrides/Handles clauses, #If…

KubaO

committed

e1b9fb9

indexer test: the forms the scanner once lost reach api.json; the check_symbol_index descriptions list them

KubaO

committed

2bcb648

twin-api: colon-joined statements are each read, identifiers hold every character past ASCII, a type-declaration character ends a name and gives its type; pinned in check_symbol_index, check_twin_p…

KubaO

committed

3eb82e6

twin-api, twin-declarations: the identifier classes spell U+FFFF as an escape, not as the raw character the editor tool wrote

KubaO

committed

6dba167

api.json format 3: the declarations in the branches of an #If are one member with a signature and a condition for each; twin-api records the condition and block of every member; the differ reads th…

KubaO

committed

9c939b5

indexer: the store records a fingerprint of the scanner and model beside each api.json, keeps Settings, and sync indexes a package again from its stored sources, with no download, when the fingerpr…

KubaO

committed

5010010

indexer analyze: by default only the packages the reference documents; --all takes every package in the store, --package and --packages still name any; recorded in cli-cases

KubaO

committed

e63347f

Tools map regenerated after the rebase: the indexer test's box

KubaO

committed

87853e3

Tools and Scripts: twin-index.mjs, the package indexer, gets its entry on the Build and Generation page and a box in the Tools map; Authoring and the indexer test's entry link to it

KubaO

committed

5757261

WIP.Indexer.md says why the indexer is built as it is and replaces indexer/PLAN-pipeline.md and PLAN-auto-sync.md; the README points at it and at the Tools entry, TWINSERV-protocol.md says the inde…

KubaO

committed

bda9f2e

WIP.md: a row for WIP.Indexer.md and the rules for running the indexer; the per-symbol workflow says how to find the symbols to write with analyze

KubaO

committed

c86e044

indexer derive writes builder/package-api.json from the packages sync reads, byte-identical to scripts/build_package_api.mjs, which is retired; the docs, the Tools map and the CLI cases follow

KubaO

committed

114a483

builder/package-api.json derived again from BETA 997: VB's ReportSizeConstants gets the 17 values the scanner now reads

KubaO

committed

8d7773b

Navigation Menu

Repository navigation

A package indexer with BETA 997 snapshots, a scanner that reads more of each package, and a shorter Documentation Development section - #227

A package indexer with BETA 997 snapshots, a scanner that reads more of each package, and a shorter Documentation Development section#227
KubaO merged 33 commits into
twinbasic:mainfrom
KubaO:staging

Commits on Oct 11, 2026

Build-tools documentation: editorial pass over docs/Documentation/ (about 13% shorter): long paragraphs split, rationale and history a contributor does not act on cut, plainer register; Tools-Toolc…

Nav: IDE moves up to nav_order 9 and Documentation Development to the end; the toolchain diagram's boxes link to their tool entries and sections; every link in the Tools map has a tooltip saying wh…

Attribute census: a bracket group alone on its line in an Enum body is a member, not an attribute (BETA 1005); the scanner moves to scripts/lib/census-scan.mjs and check_twin_parsers pins it

Enum members take no attribute: Hidden's Applicable to no longer lists one, Enum says a bracket group on its own line is a member and an inline attribute TB5182, Open's Encoding constants are Const…

Import the package indexer from claude/elegant-elion-ba6399 as it stood: code, manifests and plans, without its snapshots

Format indexer/ with Biome

Put indexer/ under the lint, format and regex-safety gates: unused import and variable removed, an exponential attribute-line regex made unambiguous, tooling-folder lists name it

indexer: command line through lib/cli.mjs (strict parse, usage with exit codes, exit 2 on refusal), recorded in cli-cases; survey_tooling covers indexer/

indexer: built-in and default packages read from the local twinBASIC install by default (--ide, TB_IDE), --release for the GitHub release; the manifest records source and build; TWINSERV skipped wh…

twin-api: signatures, attribute arguments, descriptions, return types, accessors, aliases and the project name; keyword-named fields, one-line procedures and modifier-named enum values read right (…

indexer: packages read through impexp's parser (parseProject, CATEGORY exported) in package-files.mjs, which replaces twinpack-parser.mjs

indexer: api.json (format 2) built from the shared twinBASIC scanner; differ and analyze on it; lexer, extractor, json-emitter and the markdown emitter retired; VB6 files with no VB_Name named by t…

indexer: README describes api.json format 2 and the new modules; plans marked as superseded

twin-api: a line of only [Name] in an Enum body is a value, as the compiler reads it, not the next line's attribute; 94 enums gain values (the [_] LongPtr shim, GridCellEffectEnum, ReportSizeConsta…

test.bat gate: test/indexer.test.mjs tests the package indexer (VB6 preprocessing, package files, api.json model, differ); gate counts read twenty-five

indexer: sync state moves out of the repository into the store (indexer/.packages/manifests); a package is current by what the store holds (sources, api.json format and version), so a pulled or fil…

indexer: committed snapshots only for packages the reference documents; a section's landing page ties it to its packages (package_name, indexed_from) through lib/doc-pages.mjs

indexer: BETA 997 snapshots of the 14 packages the reference documents (3.2 MB); their 13 landing pages carry package_name where the folder is not the package, and indexed_from: beta-x-0997

indexer: analyze reads a snapshot larger than 1 MB (VB's fell back to an audit) and says when it has none; the store keeps long paths on and line endings off

twin-declarations: Abstract and Virtual are not modifiers (BETA 1005 reads them as a variable name and refuses the Sub after them, TB5182); the other words it refuses everywhere are noted

twin-api: Inherits and Implements lists, qualified CoClass interfaces, [Hidden(False)], modifier-named and initialised fields, Type-body brackets, result types before Overrides/Handles clauses, #If…

indexer test: the forms the scanner once lost reach api.json; the check_symbol_index descriptions list them

twin-api: colon-joined statements are each read, identifiers hold every character past ASCII, a type-declaration character ends a name and gives its type; pinned in check_symbol_index, check_twin_p…

twin-api, twin-declarations: the identifier classes spell U+FFFF as an escape, not as the raw character the editor tool wrote

api.json format 3: the declarations in the branches of an #If are one member with a signature and a condition for each; twin-api records the condition and block of every member; the differ reads th…

indexer: the store records a fingerprint of the scanner and model beside each api.json, keeps Settings, and sync indexes a package again from its stored sources, with no download, when the fingerpr…

indexer analyze: by default only the packages the reference documents; --all takes every package in the store, --package and --packages still name any; recorded in cli-cases

Tools map regenerated after the rebase: the indexer test's box

Tools and Scripts: twin-index.mjs, the package indexer, gets its entry on the Build and Generation page and a box in the Tools map; Authoring and the indexer test's entry link to it

WIP.Indexer.md says why the indexer is built as it is and replaces indexer/PLAN-pipeline.md and PLAN-auto-sync.md; the README points at it and at the Tools entry, TWINSERV-protocol.md says the inde…

WIP.md: a row for WIP.Indexer.md and the rules for running the indexer; the per-symbol workflow says how to find the symbols to write with analyze

indexer derive writes builder/package-api.json from the packages sync reads, byte-identical to scripts/build_package_api.mjs, which is retired; the docs, the Tools map and the CLI cases follow

builder/package-api.json derived again from BETA 997: VB's ReportSizeConstants gets the 17 values the scanner now reads