@drskillissue/ganko 0.3.1 → 0.3.3

package/dist/index.d.cts

@@ -1,7 +1,168 @@
 import ts from 'typescript';
-import { RuleOverrides, Logger, StringInterner, WorkspaceLayout } from '@drskillissue/ganko-shared';
+import { R as RuleOverrides } from './rules-manifest-BvNUyXdr.cjs';
+export { a as RULES, b as RULES_BY_CATEGORY, c as RuleEntry, g as getRule } from './rules-manifest-BvNUyXdr.cjs';
 import { Declaration, AtRule, Root, Rule } from 'postcss';
-export { RULES, RULES_BY_CATEGORY, RuleEntry, getRule } from './rules-manifest.cjs';
+
+/**
+ * Resolved project root — a nominal wrapper that cannot be constructed
+ * from a raw string without going through a factory function.
+ *
+ * The `path` field is the canonical (realpath-resolved, absolute) directory.
+ * Use `.path` wherever a string is needed. The wrapper exists so that
+ * "project root" is a distinct type from "arbitrary string" in every
+ * function signature — you cannot accidentally pass a file path or URI.
+ */
+declare class ProjectRoot {
+    readonly path: string;
+    /** @param canonical - Canonical absolute path */
+    private constructor();
+    /** String coercion returns the canonical path. */
+    toString(): string;
+    /** JSON serialization returns the canonical path. */
+    toJSON(): string;
+    /** @internal Factory — only used by the module-level factory functions below. */
+    static _create(canonical: string): ProjectRoot;
+}
+
+/** Canonical list of log level names, most verbose to least verbose. */
+declare const LOG_LEVELS: readonly ["trace", "debug", "info", "warning", "error", "critical", "off"];
+/** String log level name — used for configuration, parsing, and display. */
+type LogLevel = (typeof LOG_LEVELS)[number];
+/**
+ * Numeric log level constants for hot-path level checks.
+ *
+ * Lower numbers are more verbose. Use with `isLevelEnabled`:
+ *
+ * ```ts
+ * if (log.isLevelEnabled(Level.Debug)) log.debug(`rebuilt ${count} graphs`);
+ * ```
+ */
+declare const Level: {
+    readonly Trace: 0;
+    readonly Debug: 1;
+    readonly Info: 2;
+    readonly Warning: 3;
+    readonly Error: 4;
+    readonly Critical: 5;
+    readonly Off: 6;
+};
+/** Numeric log level value (0–6). */
+type LevelValue = (typeof Level)[keyof typeof Level];
+/**
+ * Logger — shared logging interface for all packages.
+ *
+ * Levels match VS Code's LogLevel enum: Trace, Debug, Info, Warning, Error, Critical, Off.
+ *
+ * Backends are environment-specific (LSP connection, CLI stderr, noop for tests).
+ * The interface lives here so ganko and @drskillissue/ganko-shared consumers can log
+ * without depending on ganko.
+ *
+ * Use `isLevelEnabled` to guard expensive log argument computation:
+ *
+ * ```ts
+ * if (log.isLevelEnabled(Level.Debug)) log.debug(`rebuilt ${count} graphs in ${elapsed}ms`);
+ * ```
+ *
+ * This checks against the actual log level threshold — a single integer
+ * comparison with no lookup table. Template literals and function calls
+ * inside the guard are never evaluated when the level is disabled.
+ */
+interface Logger {
+    /** The active log level threshold. Messages below this level are suppressed. */
+    readonly level: LogLevel;
+    /** Check whether a specific level would produce output at the current threshold. */
+    isLevelEnabled(level: LevelValue): boolean;
+    trace(message: string): void;
+    debug(message: string): void;
+    info(message: string): void;
+    warning(message: string): void;
+    error(message: string, err?: Error): void;
+    critical(message: string, err?: Error): void;
+}
+
+interface WorkspacePackage {
+    readonly path: string;
+    readonly name: string | null;
+    readonly dependencies: ReadonlySet<string>;
+    readonly packageJsonPath: string;
+}
+interface WorkspaceLayout {
+    readonly root: ProjectRoot;
+    readonly packages: readonly WorkspacePackage[];
+    readonly packagePaths: ReadonlySet<string>;
+    readonly allDependencyNames: ReadonlySet<string>;
+    readonly allPackageJsonPaths: readonly string[];
+}
+
+/**
+ * String Interning Utilities
+ *
+ * String interning stores a single copy of each unique string value
+ * and reuses that reference, reducing memory usage for frequently
+ * repeated strings.
+ */
+/**
+ * A string interner that stores canonical string references.
+ *
+ * When the same string value is encountered multiple times, the interner
+ * returns the same reference, enabling reference equality comparisons
+ * and reducing memory usage.
+ *
+ * @example
+ * const interner = new StringInterner();
+ * const a = interner.intern("hello");
+ * const b = interner.intern("hello");
+ * console.log(a === b); // true (same reference)
+ */
+declare class StringInterner {
+    private readonly table;
+    /**
+     * Intern a string, returning a canonical reference.
+     *
+     * If the string has been seen before, returns the existing reference.
+     * Otherwise, stores and returns the input string.
+     *
+     * @param s - The string to intern
+     * @returns The canonical interned string
+     */
+    intern(s: string): string;
+    /**
+     * Check if a string has been interned.
+     *
+     * @param s - The string to check
+     * @returns True if the string is already in the intern table
+     */
+    has(s: string): boolean;
+    /**
+     * Get the interned version of a string if it exists.
+     *
+     * @param s - The string to look up
+     * @returns The interned string or undefined
+     */
+    get(s: string): string | undefined;
+    /**
+     * Clear all interned strings.
+     */
+    clear(): void;
+    /**
+     * Get the number of interned strings.
+     *
+     * @returns The number of strings in the intern table
+     */
+    get size(): number;
+    /**
+     * Pre-intern a set of strings.
+     *
+     * @param strings - Array of strings to intern
+     */
+    internAll(strings: readonly string[]): void;
+    /**
+     * Pre-intern strings from an object's values.
+     *
+     * @param obj - Object whose string values should be interned
+     */
+    internFromObject(obj: Record<string, string>): void;
+}
 
 type MessageId = string;
 type Message = string;
@@ -159,6 +320,12 @@ declare class TypeResolver {
     private typeCache;
     private solidSymbolCache;
     readonly logger: Logger;
+    /**
+     * Create a resolver backed by a TypeScript type checker.
+     *
+     * @param checker - Type checker used for all type queries
+     * @param logger - Optional logger for debug output
+     */
     constructor(checker: ts.TypeChecker, logger?: Logger);
     private isSymbolFromSolid;
     private isSolidSymbol;
@@ -1426,6 +1593,9 @@ interface SolidSyntaxTree {
         readonly name: string;
     }>;
     readonly componentFunctions: readonly FunctionEntity[];
+    /** Maps sub-component function scope ID → compound base's children-forwarding JSX element ID.
+     * Built from Object.assign compound component patterns during syntax tree construction. */
+    readonly compoundComponentParents: ReadonlyMap<number, number>;
     readonly functionsWithReactiveCaptures: readonly FunctionEntity[];
     readonly reactiveVariables: readonly VariableEntity$1[];
     readonly propsVariables: readonly VariableEntity$1[];
@@ -1539,6 +1709,7 @@ interface SolidBuildContext {
         name: string;
     }>;
     componentFunctions: FunctionEntity[];
+    compoundComponentParents: ReadonlyMap<number, number>;
     functionsWithReactiveCaptures: FunctionEntity[];
     reactiveVariables: VariableEntity$1[];
     propsVariables: VariableEntity$1[];
@@ -1595,13 +1766,6 @@ interface SolidBuildContext {
     findExpressionAtOffset(offset: number): ts.Node | null;
 }
 
-/**
- * Solid analysis entry point.
- *
- * Builds a SolidSyntaxTree from a SolidInput by running all analysis phases
- * against a mutable SolidBuildContext, then freezing the result.
- */
-
 /**
  * Build a SolidSyntaxTree from input.
  *

package/dist/index.d.ts

@@ -1,7 +1,168 @@
 import ts from 'typescript';
-import { RuleOverrides, Logger, StringInterner, WorkspaceLayout } from '@drskillissue/ganko-shared';
+import { R as RuleOverrides } from './rules-manifest-BvNUyXdr.js';
+export { a as RULES, b as RULES_BY_CATEGORY, c as RuleEntry, g as getRule } from './rules-manifest-BvNUyXdr.js';
 import { Declaration, AtRule, Root, Rule } from 'postcss';
-export { RULES, RULES_BY_CATEGORY, RuleEntry, getRule } from './rules-manifest.js';
+
+/**
+ * Resolved project root — a nominal wrapper that cannot be constructed
+ * from a raw string without going through a factory function.
+ *
+ * The `path` field is the canonical (realpath-resolved, absolute) directory.
+ * Use `.path` wherever a string is needed. The wrapper exists so that
+ * "project root" is a distinct type from "arbitrary string" in every
+ * function signature — you cannot accidentally pass a file path or URI.
+ */
+declare class ProjectRoot {
+    readonly path: string;
+    /** @param canonical - Canonical absolute path */
+    private constructor();
+    /** String coercion returns the canonical path. */
+    toString(): string;
+    /** JSON serialization returns the canonical path. */
+    toJSON(): string;
+    /** @internal Factory — only used by the module-level factory functions below. */
+    static _create(canonical: string): ProjectRoot;
+}
+
+/** Canonical list of log level names, most verbose to least verbose. */
+declare const LOG_LEVELS: readonly ["trace", "debug", "info", "warning", "error", "critical", "off"];
+/** String log level name — used for configuration, parsing, and display. */
+type LogLevel = (typeof LOG_LEVELS)[number];
+/**
+ * Numeric log level constants for hot-path level checks.
+ *
+ * Lower numbers are more verbose. Use with `isLevelEnabled`:
+ *
+ * ```ts
+ * if (log.isLevelEnabled(Level.Debug)) log.debug(`rebuilt ${count} graphs`);
+ * ```
+ */
+declare const Level: {
+    readonly Trace: 0;
+    readonly Debug: 1;
+    readonly Info: 2;
+    readonly Warning: 3;
+    readonly Error: 4;
+    readonly Critical: 5;
+    readonly Off: 6;
+};
+/** Numeric log level value (0–6). */
+type LevelValue = (typeof Level)[keyof typeof Level];
+/**
+ * Logger — shared logging interface for all packages.
+ *
+ * Levels match VS Code's LogLevel enum: Trace, Debug, Info, Warning, Error, Critical, Off.
+ *
+ * Backends are environment-specific (LSP connection, CLI stderr, noop for tests).
+ * The interface lives here so ganko and @drskillissue/ganko-shared consumers can log
+ * without depending on ganko.
+ *
+ * Use `isLevelEnabled` to guard expensive log argument computation:
+ *
+ * ```ts
+ * if (log.isLevelEnabled(Level.Debug)) log.debug(`rebuilt ${count} graphs in ${elapsed}ms`);
+ * ```
+ *
+ * This checks against the actual log level threshold — a single integer
+ * comparison with no lookup table. Template literals and function calls
+ * inside the guard are never evaluated when the level is disabled.
+ */
+interface Logger {
+    /** The active log level threshold. Messages below this level are suppressed. */
+    readonly level: LogLevel;
+    /** Check whether a specific level would produce output at the current threshold. */
+    isLevelEnabled(level: LevelValue): boolean;
+    trace(message: string): void;
+    debug(message: string): void;
+    info(message: string): void;
+    warning(message: string): void;
+    error(message: string, err?: Error): void;
+    critical(message: string, err?: Error): void;
+}
+
+interface WorkspacePackage {
+    readonly path: string;
+    readonly name: string | null;
+    readonly dependencies: ReadonlySet<string>;
+    readonly packageJsonPath: string;
+}
+interface WorkspaceLayout {
+    readonly root: ProjectRoot;
+    readonly packages: readonly WorkspacePackage[];
+    readonly packagePaths: ReadonlySet<string>;
+    readonly allDependencyNames: ReadonlySet<string>;
+    readonly allPackageJsonPaths: readonly string[];
+}
+
+/**
+ * String Interning Utilities
+ *
+ * String interning stores a single copy of each unique string value
+ * and reuses that reference, reducing memory usage for frequently
+ * repeated strings.
+ */
+/**
+ * A string interner that stores canonical string references.
+ *
+ * When the same string value is encountered multiple times, the interner
+ * returns the same reference, enabling reference equality comparisons
+ * and reducing memory usage.
+ *
+ * @example
+ * const interner = new StringInterner();
+ * const a = interner.intern("hello");
+ * const b = interner.intern("hello");
+ * console.log(a === b); // true (same reference)
+ */
+declare class StringInterner {
+    private readonly table;
+    /**
+     * Intern a string, returning a canonical reference.
+     *
+     * If the string has been seen before, returns the existing reference.
+     * Otherwise, stores and returns the input string.
+     *
+     * @param s - The string to intern
+     * @returns The canonical interned string
+     */
+    intern(s: string): string;
+    /**
+     * Check if a string has been interned.
+     *
+     * @param s - The string to check
+     * @returns True if the string is already in the intern table
+     */
+    has(s: string): boolean;
+    /**
+     * Get the interned version of a string if it exists.
+     *
+     * @param s - The string to look up
+     * @returns The interned string or undefined
+     */
+    get(s: string): string | undefined;
+    /**
+     * Clear all interned strings.
+     */
+    clear(): void;
+    /**
+     * Get the number of interned strings.
+     *
+     * @returns The number of strings in the intern table
+     */
+    get size(): number;
+    /**
+     * Pre-intern a set of strings.
+     *
+     * @param strings - Array of strings to intern
+     */
+    internAll(strings: readonly string[]): void;
+    /**
+     * Pre-intern strings from an object's values.
+     *
+     * @param obj - Object whose string values should be interned
+     */
+    internFromObject(obj: Record<string, string>): void;
+}
 
 type MessageId = string;
 type Message = string;
@@ -159,6 +320,12 @@ declare class TypeResolver {
     private typeCache;
     private solidSymbolCache;
     readonly logger: Logger;
+    /**
+     * Create a resolver backed by a TypeScript type checker.
+     *
+     * @param checker - Type checker used for all type queries
+     * @param logger - Optional logger for debug output
+     */
     constructor(checker: ts.TypeChecker, logger?: Logger);
     private isSymbolFromSolid;
     private isSolidSymbol;
@@ -1426,6 +1593,9 @@ interface SolidSyntaxTree {
         readonly name: string;
     }>;
     readonly componentFunctions: readonly FunctionEntity[];
+    /** Maps sub-component function scope ID → compound base's children-forwarding JSX element ID.
+     * Built from Object.assign compound component patterns during syntax tree construction. */
+    readonly compoundComponentParents: ReadonlyMap<number, number>;
     readonly functionsWithReactiveCaptures: readonly FunctionEntity[];
     readonly reactiveVariables: readonly VariableEntity$1[];
     readonly propsVariables: readonly VariableEntity$1[];
@@ -1539,6 +1709,7 @@ interface SolidBuildContext {
         name: string;
     }>;
     componentFunctions: FunctionEntity[];
+    compoundComponentParents: ReadonlyMap<number, number>;
     functionsWithReactiveCaptures: FunctionEntity[];
     reactiveVariables: VariableEntity$1[];
     propsVariables: VariableEntity$1[];
@@ -1595,13 +1766,6 @@ interface SolidBuildContext {
     findExpressionAtOffset(offset: number): ts.Node | null;
 }
 
-/**
- * Solid analysis entry point.
- *
- * Builds a SolidSyntaxTree from a SolidInput by running all analysis phases
- * against a mutable SolidBuildContext, then freezing the result.
- */
-
 /**
  * Build a SolidSyntaxTree from input.
  *