@zxyycom/vibe-check 0.0.1 → 0.0.3

package/types/package-checks/function-metrics/analyzer/readers/plsql.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Derived from terryyin/lizard 1.24.0.
+ * Source: lizard_languages/plsql.py.
+ * Upstream revision: 308b1c3efd8c1c69bcc3eb82deeaec64fd3662ec.
+ * SPDX-License-Identifier: MIT
+ * Modified: translated to the product-owned TypeScript analyzer with the
+ * source PL/SQL preprocessing and declaration/body state lifecycle retained.
+ */
+import type { FileInfoBuilder } from "../analysis-context.ts";
+import type { TokenStream } from "../contracts.ts";
+import { CodeReader, type TokenFactory } from "../shared/code-reader.ts";
+/** PL/SQL reader for procedures, functions, triggers, package bodies, and nested declarations. */
+export declare class PLSQLReader extends CodeReader {
+    static ext: string[];
+    static languageNames: string[];
+    static controlFlowKeywords: Set<string>;
+    static logicalOperators: Set<string>;
+    static caseKeywords: Set<string>;
+    static ternaryOperators: Set<string>;
+    constructor(context: FileInfoBuilder);
+    preprocess(tokens: TokenStream): Generator<string>;
+    static generateTokens(sourceCode: string, addition?: string, tokenFactory?: TokenFactory): Generator<string>;
+    get_comment_from_token(token: string): string | undefined;
+}

package/types/package-checks/function-metrics/analyzer/readers/python.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Derived from terryyin/lizard 1.24.0.
+ * Source: lizard_languages/python.py.
+ * Upstream revision: 308b1c3efd8c1c69bcc3eb82deeaec64fd3662ec.
+ * SPDX-License-Identifier: MIT
+ * Modified: translated to TypeScript for the product-owned analyzer.
+ */
+import type { FileInfoBuilder } from "../analysis-context.ts";
+import type { TokenStream } from "../contracts.ts";
+import { CodeReader, CodeStateMachine, type TokenFactory } from "../shared/code-reader.ts";
+export declare class PythonReader extends CodeReader {
+    static ext: readonly string[];
+    static languageNames: readonly string[];
+    static controlFlowKeywords: Set<string>;
+    static logicalOperators: Set<string>;
+    static caseKeywords: Set<string>;
+    static ternaryOperators: Set<string>;
+    static readonly _SOFT_KW_VARIABLE_NEXT: Set<string>;
+    private _last_meaningful_token;
+    private _keyword_case;
+    private _keyword_match;
+    constructor(context: FileInfoBuilder, definition?: typeof CodeReader);
+    /** str/bytes f-string prefixes, excluding bare bytes/raw strings. */
+    static readonly _FSTRING_PREFIXES: Set<string>;
+    static generateTokens(sourceCode: string, addition?: string, tokenFactory?: TokenFactory): Generator<string>;
+    /** Re-tokenize f-string expressions so their control flow reaches the reader. */
+    private static _expand_fstring_interpolations;
+    /** Advance beyond one quoted literal while scanning an f-string expression. */
+    private static _skip_quoted_literal;
+    /** Find the matching brace of an interpolation while honoring quoted literals. */
+    private static _find_interpolation_end;
+    /** Preserve literal chunks and recursively tokenize each f-string expression. */
+    private static _tokenize_fstring_body;
+    preprocess(tokens: TokenStream): Generator<string>;
+    get_comment_from_token(token: string): string | undefined;
+    process_token(token: string): boolean;
+    private _soft_keyword_lookahead;
+}
+export declare class PythonStates extends CodeStateMachine {
+    private _awaiting_first_line;
+    get isFirstLine(): boolean;
+    readonly reader: PythonReader | undefined;
+    constructor(context: FileInfoBuilder, reader?: PythonReader);
+    readonly _state_global: (token: string) => void;
+    protected readonly _function: (token: string) => void;
+    private readonly _dec;
+    private readonly _state_colon;
+    private readonly _state_first_line;
+    private readonly _state_parameterized_type_annotation;
+}

package/types/package-checks/function-metrics/analyzer/readers/r.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Derived from terryyin/lizard 1.24.0.
+ * Source: lizard_languages/r.py.
+ * Upstream revision: 308b1c3efd8c1c69bcc3eb82deeaec64fd3662ec.
+ * SPDX-License-Identifier: MIT
+ * Modified: translated to TypeScript for the product-owned analyzer.
+ */
+import type { FileInfoBuilder } from "../analysis-context.ts";
+import type { TokenStream } from "../contracts.ts";
+import { CodeReader } from "../shared/code-reader.ts";
+export declare class RReader extends CodeReader {
+    static ext: readonly string[];
+    static languageNames: readonly string[];
+    static controlFlowKeywords: Set<string>;
+    static logicalOperators: Set<string>;
+    static caseKeywords: Set<string>;
+    static ternaryOperators: Set<string>;
+    constructor(context: FileInfoBuilder);
+    preprocess(tokens: TokenStream): Generator<string>;
+    static generateTokens(sourceCode: string): Generator<string>;
+    get_comment_from_token(token: string): string | undefined;
+}

package/types/package-checks/function-metrics/analyzer/readers/ruby.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Derived from terryyin/lizard 1.24.0.
+ * Source: lizard_languages/ruby.py.
+ * Upstream revision: 308b1c3efd8c1c69bcc3eb82deeaec64fd3662ec.
+ * SPDX-License-Identifier: MIT
+ * Modified: translated to TypeScript for the product-owned analyzer.
+ */
+import type { FileInfoBuilder } from "../analysis-context.ts";
+import { RubylikeReader } from "../shared/rubylike.ts";
+export declare class RubyReader extends RubylikeReader {
+    static ext: readonly string[];
+    static languageNames: readonly string[];
+    static generateTokens: import("../shared/js-style-regex.ts").TokenGenerator;
+    constructor(context: FileInfoBuilder);
+    get_comment_from_token(token: string): string | undefined;
+}

package/types/package-checks/function-metrics/analyzer/readers/rust.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Derived from terryyin/lizard 1.24.0.
+ * Source: lizard_languages/rust.py.
+ * Upstream revision: 308b1c3efd8c1c69bcc3eb82deeaec64fd3662ec.
+ * SPDX-License-Identifier: MIT
+ * Modified: translated to the product-owned TypeScript analyzer.
+ */
+import type { FileInfoBuilder } from "../analysis-context.ts";
+import { CodeReader, type TokenFactory } from "../shared/code-reader.ts";
+export declare class RustReader extends CodeReader {
+    static ext: string[];
+    static languageNames: string[];
+    static controlFlowKeywords: Set<string>;
+    static logicalOperators: Set<string>;
+    static caseKeywords: Set<string>;
+    static ternaryOperators: Set<string>;
+    constructor(context: FileInfoBuilder);
+    static generateTokens(sourceCode: string, _addition?: string, tokenFactory?: TokenFactory): Generator<string>;
+    get_comment_from_token(token: string): string | undefined;
+}

package/types/package-checks/function-metrics/analyzer/readers/scala.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Derived from terryyin/lizard 1.24.0.
+ * Source: lizard_languages/scala.py.
+ * Upstream revision: 308b1c3efd8c1c69bcc3eb82deeaec64fd3662ec.
+ * SPDX-License-Identifier: MIT
+ * Modified: translated to the product-owned TypeScript analyzer.
+ */
+import type { FileInfoBuilder } from "../analysis-context.ts";
+import { CodeReader } from "../shared/code-reader.ts";
+export declare const __author__ = "David Baum";
+export declare class ScalaReader extends CodeReader {
+    static ext: string[];
+    static languageNames: string[];
+    static controlFlowKeywords: Set<string>;
+    static logicalOperators: Set<string>;
+    static caseKeywords: Set<string>;
+    static ternaryOperators: Set<string>;
+    constructor(context: FileInfoBuilder);
+    get_comment_from_token(token: string): string | undefined;
+}

package/types/package-checks/function-metrics/analyzer/readers/solidity.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Derived from terryyin/lizard 1.24.0.
+ * Source: lizard_languages/solidity.py.
+ * Upstream revision: 308b1c3efd8c1c69bcc3eb82deeaec64fd3662ec.
+ * SPDX-License-Identifier: MIT
+ * Modified: translated to the product-owned TypeScript analyzer.
+ */
+import type { FileInfoBuilder } from "../analysis-context.ts";
+import { CodeReader } from "../shared/code-reader.ts";
+export declare class SolidityReader extends CodeReader {
+    static ext: string[];
+    static languageNames: string[];
+    static controlFlowKeywords: Set<string>;
+    static logicalOperators: Set<string>;
+    static caseKeywords: Set<string>;
+    static ternaryOperators: Set<string>;
+    constructor(context: FileInfoBuilder);
+    get_comment_from_token(token: string): string | undefined;
+}

package/types/package-checks/function-metrics/analyzer/readers/st.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Derived from terryyin/lizard 1.24.0.
+ * Source: lizard_languages/st.py.
+ * Upstream revision: 308b1c3efd8c1c69bcc3eb82deeaec64fd3662ec.
+ * SPDX-License-Identifier: MIT
+ * Modified: translated to the product-owned TypeScript analyzer.
+ */
+import type { FileInfoBuilder } from "../analysis-context.ts";
+import type { TokenStream } from "../contracts.ts";
+import { CodeReader, type TokenFactory } from "../shared/code-reader.ts";
+/** Source mixin retained as a constructable class despite TypeScript's single inheritance. */
+export declare class StCommentsMixin {
+    static get_comment_from_token(token: string): string | undefined;
+    static getCommentFromToken(token: string): string | undefined;
+}
+export declare class StReader extends CodeReader {
+    static ext: string[];
+    static languageNames: string[];
+    static controlFlowKeywords: Set<string>;
+    static logicalOperators: Set<string>;
+    static caseKeywords: Set<string>;
+    static ternaryOperators: Set<string>;
+    static readonly macro_pattern: RegExp;
+    static readonly _functions: Set<string>;
+    static readonly _blocks: Set<string>;
+    static readonly _ends: Set<string>;
+    /** Source `loops` class attribute consumed by the deferred nesting extension. */
+    static readonly loops: readonly ["if", "case", "for", "while", "repeat", "IF", "CASE", "FOR", "WHILE", "REPEAT"];
+    /** Source `bracket` class attribute consumed by the deferred nesting extension. */
+    static readonly bracket = "END";
+    readonly loops: readonly ["if", "case", "for", "while", "repeat", "IF", "CASE", "FOR", "WHILE", "REPEAT"];
+    readonly bracket = "END";
+    constructor(context: FileInfoBuilder);
+    static generateTokens(sourceCode: string, addition?: string, tokenFactory?: TokenFactory): Generator<string>;
+    preprocess(tokens: TokenStream): Generator<string>;
+    get_comment_from_token(token: string): string | undefined;
+}

package/types/package-checks/function-metrics/analyzer/readers/swift.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Derived from terryyin/lizard 1.24.0.
+ * Source: lizard_languages/swift.py.
+ * Upstream revision: 308b1c3efd8c1c69bcc3eb82deeaec64fd3662ec.
+ * SPDX-License-Identifier: MIT
+ * Modified: translated to the product-owned TypeScript analyzer.
+ */
+import type { FileInfoBuilder } from "../analysis-context.ts";
+import type { TokenStream } from "../contracts.ts";
+import { CodeReader, type TokenFactory } from "../shared/code-reader.ts";
+/** TypeScript composition equivalent of SwiftReplaceLabel's Python mixin. */
+export declare class SwiftReplaceLabel {
+    private readonly conditions;
+    constructor(conditions: ReadonlySet<string>);
+    preprocess(tokens: TokenStream): Generator<string>;
+}
+export declare class SwiftReader extends CodeReader {
+    static readonly FUNC_KEYWORD = "def";
+    static ext: string[];
+    static languageNames: string[];
+    static controlFlowKeywords: Set<string>;
+    static logicalOperators: Set<string>;
+    static caseKeywords: Set<string>;
+    static ternaryOperators: Set<string>;
+    private readonly replaceLabel;
+    constructor(context: FileInfoBuilder);
+    static generateTokens(sourceCode: string, addition?: string, tokenFactory?: TokenFactory): Generator<string>;
+    preprocess(tokens: TokenStream): Generator<string>;
+    get_comment_from_token(token: string): string | undefined;
+}

package/types/package-checks/function-metrics/analyzer/readers/tsx.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Derived from terryyin/lizard 1.24.0.
+ * Source: lizard_languages/tsx.py.
+ * Upstream revision: 308b1c3efd8c1c69bcc3eb82deeaec64fd3662ec.
+ * SPDX-License-Identifier: MIT
+ * Modified: translated to the product-owned TypeScript analyzer.
+ */
+import type { FileInfoBuilder } from "../analysis-context.ts";
+import { TypeScriptReader } from "./typescript.ts";
+export declare class TSXReader extends TypeScriptReader {
+    static ext: string[];
+    static languageNames: string[];
+    constructor(context: FileInfoBuilder);
+    static generateTokens: import("../shared/js-style-regex.ts").TokenGenerator;
+}

package/types/package-checks/function-metrics/analyzer/readers/ttcn.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Derived from terryyin/lizard 1.24.0.
+ * Source: lizard_languages/ttcn.py.
+ * Upstream revision: 308b1c3efd8c1c69bcc3eb82deeaec64fd3662ec.
+ * SPDX-License-Identifier: MIT
+ * Modified: translated to TypeScript while retaining TTCN's C-like parser,
+ * preprocessing, declaration and implementation state transitions.
+ */
+import type { FileInfoBuilder } from "../analysis-context.ts";
+import { CLikeReader } from "../shared/clike.ts";
+import { type TokenFactory } from "../shared/code-reader.ts";
+/** TTCN-3 reader with source-derived tokenizer additions and condition categories. */
+export declare class TTCNReader extends CLikeReader {
+    static ext: readonly string[];
+    static languageNames: readonly string[];
+    static controlFlowKeywords: Set<string>;
+    static logicalOperators: Set<string>;
+    static caseKeywords: Set<string>;
+    static ternaryOperators: Set<string>;
+    constructor(context: FileInfoBuilder);
+    static generateTokens(sourceCode: string, _addition?: string, tokenFactory?: TokenFactory): Generator<string>;
+}

package/types/package-checks/function-metrics/analyzer/readers/typescript.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Derived from terryyin/lizard 1.24.0.
+ * Source: lizard_languages/typescript.py.
+ * Upstream revision: 308b1c3efd8c1c69bcc3eb82deeaec64fd3662ec.
+ * SPDX-License-Identifier: MIT
+ * Modified: translated to the product-owned TypeScript analyzer.
+ */
+import type { FileInfoBuilder } from "../analysis-context.ts";
+import { CodeReader } from "../shared/code-reader.ts";
+export declare class TypeScriptReader extends CodeReader {
+    static ext: string[];
+    static languageNames: string[];
+    static controlFlowKeywords: Set<string>;
+    static logicalOperators: Set<string>;
+    static caseKeywords: Set<string>;
+    static ternaryOperators: Set<string>;
+    constructor(context: FileInfoBuilder);
+    static generateTokens: import("../shared/js-style-regex.ts").TokenGenerator;
+    get_comment_from_token(token: string): string | undefined;
+}
+/** Source-aligned tokenizer base shared with the TSX reader. */
+export declare class Tokenizer {
+    sub_tokenizer: Tokenizer | undefined;
+    _ended: boolean;
+    constructor();
+    __call__(token: string): Generator<string>;
+    stop(): void;
+    process_token(_token: string): Generator<string>;
+}
+/** Source-aligned JavaScript brace tokenizer used by TSX embedded expressions. */
+export declare class JSTokenizer extends Tokenizer {
+    private depth;
+    constructor();
+    process_token(token: string): Generator<string>;
+}

package/types/package-checks/function-metrics/analyzer/readers/vue.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Derived from terryyin/lizard 1.24.0.
+ * Source: lizard_languages/vue.py.
+ * Upstream revision: 308b1c3efd8c1c69bcc3eb82deeaec64fd3662ec.
+ * SPDX-License-Identifier: MIT
+ * Modified: translated to the product-owned TypeScript analyzer.
+ */
+import type { FileInfoBuilder } from "../analysis-context.ts";
+import type { TokenStream } from "../contracts.ts";
+import { type TokenFactory } from "../shared/code-reader.ts";
+import { TypeScriptReader } from "./typescript.ts";
+export declare class VueReader extends TypeScriptReader {
+    static ext: string[];
+    static languageNames: string[];
+    constructor(context: FileInfoBuilder);
+    static generateTokens(sourceCode: string, addition?: string, tokenFactory?: TokenFactory): Generator<string>;
+    preprocess(tokens: TokenStream): Generator<string>;
+}

package/types/package-checks/function-metrics/analyzer/readers/zig.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Derived from terryyin/lizard 1.24.0.
+ * Source: lizard_languages/zig.py.
+ * Upstream revision: 308b1c3efd8c1c69bcc3eb82deeaec64fd3662ec.
+ * SPDX-License-Identifier: MIT
+ * Modified: translated to the product-owned TypeScript analyzer.
+ */
+import type { FileInfoBuilder } from "../analysis-context.ts";
+import { CodeReader } from "../shared/code-reader.ts";
+export declare class ZigReader extends CodeReader {
+    static ext: string[];
+    static languageNames: string[];
+    static controlFlowKeywords: Set<string>;
+    static logicalOperators: Set<string>;
+    static caseKeywords: Set<string>;
+    static ternaryOperators: Set<string>;
+    constructor(context: FileInfoBuilder);
+    get_comment_from_token(token: string): string | undefined;
+}

package/types/package-checks/function-metrics/analyzer/shared/clike.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Derived from terryyin/lizard 1.24.0.
+ * Source: lizard_languages/clike.py.
+ * Upstream revision: 308b1c3efd8c1c69bcc3eb82deeaec64fd3662ec.
+ * SPDX-License-Identifier: MIT
+ * Modified: translated to TypeScript with the upstream state ordering and
+ * intermediate reader context preserved.
+ */
+import type { FileInfoBuilder } from "../analysis-context.ts";
+import type { TokenStream } from "../contracts.ts";
+import { CodeReader, CodeStateMachine, type TokenFactory } from "./code-reader.ts";
+/** Source-aligned C/C++ comment extraction shared by C-like readers. */
+export declare class CCppCommentsMixin {
+    static get_comment_from_token(token: string): string | undefined;
+    /** TS-facing call sites share the source method's one implementation. */
+    static getCommentFromToken(token: string): string | undefined;
+}
+/** Base reader for C, C++, and Java-like source structures. */
+export declare class CLikeReader extends CodeReader {
+    static ext: readonly string[];
+    static languageNames: readonly string[];
+    private static readonly macro_pattern;
+    constructor(context: FileInfoBuilder);
+    static generateTokens(sourceCode: string, addition?: string, tokenFactory?: TokenFactory): Generator<string>;
+    get_comment_from_token(token: string): string | undefined;
+    preprocess(tokens: TokenStream): Generator<string>;
+}
+/** Tracks C-like namespace/class and brace nesting independently of functions. */
+export declare class CLikeNestingStackStates extends CodeStateMachine {
+    private static readonly __namespace_separators;
+    statemachine_clone(): CLikeNestingStackStates;
+    _state_global(token: string): void;
+    private readonly _dot;
+    private readonly _read_namespace;
+    private readonly _read_namespace_name;
+    private readonly finishNamespaceName;
+    private readonly _template_declaration;
+    private readonly _read_attribute;
+    private readonly ignoreToken;
+}
+/**
+ * Finds C-like declarations, parameters, and implementations.
+ *
+ * The following virtual methods are intentionally retained as unbound state
+ * slots. `CodeStateMachine` invokes its stored state as `this.state(token)`,
+ * which restores this instance as the receiver; preserving the method identity
+ * is required for source-derived subclass override and state comparisons.
+ */
+export declare class CLikeStates extends CodeStateMachine {
+    /** Source class attribute `parameter_bracket_open`; TTCN overrides it. */
+    protected static readonly parameter_bracket_open: ReadonlySet<string>;
+    /** Source class attribute `parameter_bracket_close`; TTCN overrides it. */
+    protected static readonly parameter_bracket_close: ReadonlySet<string>;
+    private readonly bracket_stack;
+    private _saved_tokens;
+    constructor(context: FileInfoBuilder);
+    statemachine_clone(): CLikeStates;
+    protected get parameter_bracket_open(): ReadonlySet<string>;
+    protected get parameter_bracket_close(): ReadonlySet<string>;
+    try_new_function(name: string): void;
+    _state_global(token: string): void;
+    protected readonly _state_function: (token: string) => void;
+    private readonly _state_template_in_name;
+    private readonly addTemplateToken;
+    private readonly _state_operator;
+    private readonly _state_operator_next;
+    private readonly _state_name_with_space;
+    /** Source override seam: _state_dec. */
+    protected _state_dec(token: string): void;
+    private readonly readDeclarationToken;
+    /** Source override seam: _state_dec_to_imp. */
+    protected _state_dec_to_imp(token: string): void;
+    private readonly _state_throw;
+    private readonly finishThrow;
+    private readonly _state_throws;
+    private readonly finishThrows;
+    private readonly _state_noexcept;
+    private readonly _state_trailing_return;
+    private readonly finishTrailingReturn;
+    /** Source override seam: _state_old_c_params. */
+    protected _state_old_c_params(token: string): void;
+    private readonly _state_initialization_list;
+    private readonly _state_one_initialization;
+    private readonly finishOneInitialization;
+    private readonly _state_initialization_value1;
+    private readonly _state_initialization_value2;
+    private readonly finishInitializationValue;
+    /** Source override seam: _state_entering_imp. */
+    protected _state_entering_imp(token: string): void;
+    /** Source override seam: _state_imp. */
+    protected _state_imp(token: string): void;
+    private readonly finishImplementation;
+    private readonly _state_attribute;
+    private readonly _state_lambda_check;
+    private readonly _state_lambda_params;
+    private readonly _state_lambda_param_list;
+    private readonly _state_lambda_body;
+    private readonly _state_lambda_body_skip;
+    private readonly _state_lambda_capture;
+    private readonly ignoreToken;
+}

package/types/package-checks/function-metrics/analyzer/shared/code-reader.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Derived from terryyin/lizard 1.24.0.
+ * Source: lizard_languages/code_reader.py.
+ * Upstream revision: 308b1c3efd8c1c69bcc3eb82deeaec64fd3662ec.
+ * SPDX-License-Identifier: MIT
+ * Modified: translated to TypeScript while retaining the tokenizer and
+ * state-machine sequencing used by concrete Lizard language readers.
+ */
+import type { AnalyzerReader, TokenStream } from "../contracts.ts";
+import type { FileInfoBuilder } from "../analysis-context.ts";
+/** A regex match passed to language-specific token factories. */
+export declare class TokenMatch {
+    readonly text: string;
+    readonly startOffset: number;
+    constructor(text: string, startOffset: number);
+    /** Python's re.Match.group(0), retained for direct reader translations. */
+    group(index?: number): string | undefined;
+    /** Python's re.Match.start(), retained for direct reader translations. */
+    start(): number;
+}
+/** Converts one tokenizer match into the token stream representation. */
+export type TokenFactory = (match: TokenMatch) => string;
+export type StateHandler = (this: CodeStateMachine, token: string) => boolean | void;
+export type UntilStateHandler = (this: CodeStateMachine, token: string, savedTokens: readonly string[]) => boolean | void;
+export type State = CodeStateMachine | StateHandler;
+export type SourceStateHandler = (state: CodeStateMachine, token: string) => boolean | void;
+export type SourceUntilStateHandler = (state: CodeStateMachine, token: string, savedTokens: string[]) => boolean | void;
+export interface ReaderDefinition {
+    readonly controlFlowKeywords: ReadonlySet<string>;
+    readonly logicalOperators: ReadonlySet<string>;
+    readonly caseKeywords: ReadonlySet<string>;
+    readonly ternaryOperators: ReadonlySet<string>;
+    buildConditions(): Set<string>;
+}
+/** Python str.isspace(), including its four extra C0 information separators. */
+export declare function isPythonWhitespace(value: string): boolean;
+/** Python str.splitlines() without retaining source line-boundary characters. */
+export declare function splitPythonLines(value: string): string[];
+/**
+ * The small state-machine foundation used by source-aligned language readers.
+ * It deliberately preserves upstream's one saved sub-state and callback slot.
+ */
+export declare class CodeStateMachine {
+    context: FileInfoBuilder;
+    lastToken: string | undefined;
+    protected state: State;
+    protected savedState: State;
+    protected toExit: boolean;
+    callback: (() => void) | undefined;
+    protected readUntilTokens: string[];
+    protected bracketCount: number;
+    protected readonly stateMachineConstructor: typeof CodeStateMachine;
+    protected readonly globalState: StateHandler;
+    constructor(context: FileInfoBuilder);
+    /** Source field aliases retain one state slot for translated state machines. */
+    get saved_state(): State;
+    set saved_state(value: State);
+    get _state(): State;
+    set _state(value: State);
+    get last_token(): string | undefined;
+    set last_token(value: string | undefined);
+    get to_exit(): boolean;
+    set to_exit(value: boolean);
+    get rut_tokens(): string[];
+    set rut_tokens(value: string[]);
+    get br_count(): number;
+    set br_count(value: number);
+    /** TS-facing alias for the source clone hook. */
+    cloneState(): CodeStateMachine;
+    /** Equivalent to Python's statemachine_clone. */
+    statemachine_clone(): CodeStateMachine;
+    next(state: State, token?: string): boolean | void;
+    nextIf(state: State, token: string, expected: string): boolean | void;
+    next_if(state: State, token: string, expected: string): boolean | void;
+    returnFromState(): void;
+    statemachine_return(): void;
+    subState(state: State, callback?: () => void, token?: string): boolean | void;
+    sub_state(state: State, callback?: () => void, token?: string): boolean | void;
+    /** Feed one token through the current state. */
+    consume(token: string): boolean;
+    /** Invoke only the current state; ExtensionBase retains this upstream seam. */
+    protected invokeCurrentState(token: string): boolean;
+    /** TS-facing state hook used by existing translated reader subclasses. */
+    protected stateGlobal(_token: string): void;
+    /** Source readers/extensions may retain this source-spelled state hook. */
+    _state_global(token: string): void;
+    /** Source readers/extensions may retain this source-spelled return hook. */
+    statemachine_before_return(): void;
+    /** TS-facing alias for the source pre-return hook. */
+    beforeReturn(): void;
+    /** Source decorator factory retained for translated reader/extension state methods. */
+    static read_inside_brackets_then(brackets: string, endState?: string): (action: SourceStateHandler) => StateHandler;
+    /** Source decorator factory retained for translated reader/extension state methods. */
+    static read_until_then(tokens: string): (action: SourceUntilStateHandler) => StateHandler;
+    /**
+     * Source-aligned replacement for read_inside_brackets_then.  Call from a
+     * reader state for the token currently being consumed.
+     */
+    protected readInsideBracketsThen(brackets: string, token: string, action: StateHandler, endState?: State): void;
+    /** Source-aligned replacement for read_until_then. */
+    protected readUntilThen(stopTokens: string, token: string, action: UntilStateHandler): void;
+}
+/** Base tokenizer and state fan-out used by all translated concrete readers. */
+export declare class CodeReader implements AnalyzerReader {
+    static ext: readonly string[];
+    static languages: unknown;
+    static languageNames: readonly string[];
+    /** Source `language_names` shares storage with the TS-facing class field. */
+    static get language_names(): readonly string[];
+    static set language_names(value: readonly string[]);
+    static extraSubclasses: Set<typeof CodeReader>;
+    /** Source `extra_subclasses` shares storage with the TS-facing class field. */
+    static get extra_subclasses(): Set<typeof CodeReader>;
+    static set extra_subclasses(value: Set<typeof CodeReader>);
+    static controlFlowKeywords: ReadonlySet<string>;
+    static logicalOperators: ReadonlySet<string>;
+    static caseKeywords: ReadonlySet<string>;
+    static ternaryOperators: ReadonlySet<string>;
+    /** Source class-level condition categories retain their source spellings. */
+    static get _control_flow_keywords(): ReadonlySet<string>;
+    static set _control_flow_keywords(value: ReadonlySet<string>);
+    static get _logical_operators(): ReadonlySet<string>;
+    static set _logical_operators(value: ReadonlySet<string>);
+    static get _case_keywords(): ReadonlySet<string>;
+    static set _case_keywords(value: ReadonlySet<string>);
+    static get _ternary_operators(): ReadonlySet<string>;
+    static set _ternary_operators(value: ReadonlySet<string>);
+    conditions: Set<string>;
+    controlFlowKeywords: Set<string>;
+    logicalOperators: Set<string>;
+    caseKeywords: Set<string>;
+    ternaryOperators: Set<string>;
+    parallelStates: CodeStateMachine[];
+    context: FileInfoBuilder;
+    private readonly readerClass;
+    constructor(context: FileInfoBuilder, readerDefinition?: ReaderDefinition);
+    /** Source `parallel_states` shares the mutable per-reader state list. */
+    get parallel_states(): CodeStateMachine[];
+    set parallel_states(value: CodeStateMachine[]);
+    /** Python class attributes are visible through each reader instance. */
+    get languages(): unknown;
+    get extraSubclasses(): Set<typeof CodeReader>;
+    get extra_subclasses(): Set<typeof CodeReader>;
+    get control_flow_keywords(): Set<string>;
+    set control_flow_keywords(value: Set<string>);
+    get logical_operators(): Set<string>;
+    set logical_operators(value: Set<string>);
+    get case_keywords(): Set<string>;
+    set case_keywords(value: Set<string>);
+    get ternary_operators(): Set<string>;
+    set ternary_operators(value: Set<string>);
+    /** Python exposes the concrete class's ext through each reader instance. */
+    get ext(): readonly string[];
+    /** Python exposes the concrete class's language_names through each reader instance. */
+    get languageNames(): readonly string[];
+    /** Source `language_names` instance accessor, aliased to `languageNames`. */
+    get language_names(): readonly string[];
+    static buildConditions(this: typeof CodeReader): Set<string>;
+    static _build_conditions(this: typeof CodeReader): Set<string>;
+    static matchFilename(this: typeof CodeReader, filename: string): boolean;
+    static match_filename(this: typeof CodeReader, filename: string): boolean;
+    /** The shared source-aligned tokenizer used by all language readers. */
+    static generateTokens(sourceCode: string, addition?: string, tokenFactory?: TokenFactory): Generator<string>;
+    static generate_tokens(sourceCode: string, addition?: string, tokenFactory?: TokenFactory): TokenStream;
+    /** Source `CodeReader.__call__` updates context before draining the reader pipeline. */
+    __call__(tokens: TokenStream, reader: AnalyzerReader): TokenStream;
+    process(tokens: TokenStream): Generator<string>;
+    get_comment_from_token(_token: string): string | undefined;
+    /** TS-facing analyzer interface alias for the source reader hook. */
+    getCommentFromToken(token: string): string | undefined;
+    eof(): void;
+    /** Return true only when a reader intentionally bypasses normal state work. */
+    process_token(_token: string): boolean;
+    /** TS-facing alias retained for the AnalyzerReader host interface. */
+    processToken(token: string): boolean;
+}