sveld 0.27.0 → 0.29.0

package/lib/ComponentParser.d.ts

@@ -262,6 +262,8 @@ export interface ParsedComponent {
 export default class ComponentParser {
     /** Parser configuration options (e.g., verbose logging) */
     private options?;
+    /** Whether the component uses legacy or runes syntax according to compiler metadata */
+    private syntaxMode;
     /** Raw source code of the Svelte component being parsed */
     private source?;
     /** Compiled Svelte code containing extracted variables and AST */
@@ -300,11 +302,46 @@ export default class ComponentParser {
     private readonly contexts;
     /** Cache for variable type and description information to avoid redundant lookups */
     private variableInfoCache;
+    /** Maps local binding names back to their public prop names */
+    private readonly propLocalToPublicName;
+    /** Tracks `$props()` bindings that are used as spread/rest props */
+    private readonly restPropLocals;
+    /** Tracks prop locals that are used as snippet/render props */
+    private readonly snippetPropLocals;
+    /** Component-level lexical scope shared by instance script and template */
+    private readonly componentScope;
+    /** Precomputed lexical scopes for nested AST nodes */
+    private scopeDeclarations;
+    /** Active lexical scopes while walking the component AST */
+    private readonly activeScopes;
     /** Cached array of source code lines split by newline for efficient line-based operations */
     private sourceLinesCache?;
     constructor(options?: ComponentParserOptions);
     private static mapToArray;
     private static assignValue;
+    private resolvePublicPropName;
+    private trackPropLocalName;
+    private getPropByLocalOrPublic;
+    private getPropTypeByLocalOrPublic;
+    private declareScopeBinding;
+    private resolveIdentifierToReactiveProp;
+    private collectPatternIdentifiers;
+    private markReactivePropsFromMutationTarget;
+    private isScopeOwner;
+    private isFunctionScopeOwner;
+    private getOrCreateScope;
+    private declareVariableDeclaration;
+    private declareFunctionLikeScopeBindings;
+    private collectDirectBlockDeclarations;
+    private extractRunesScopeBindings;
+    private collectComponentScopeDeclarations;
+    private collectNestedScopeDeclarations;
+    private buildScopeDeclarations;
+    private createRestPropsFromParent;
+    private maybeSetRestProps;
+    private isCallExpressionNamed;
+    private getPropertyName;
+    private logUnsupportedRunesPattern;
     private static formatComment;
     /**
      * Extracts and categorizes JSDoc tags from a parsed comment.
@@ -351,6 +388,8 @@ export default class ComponentParser {
      * ```
      */
     private static findJSDocComment;
+    private findAdjacentJSDocComment;
+    private processNodeJSDoc;
     /**
      * Processes JSDoc comments from leadingComments and extracts structured information.
      *
@@ -446,12 +485,16 @@ export default class ComponentParser {
      */
     private processInitializer;
     /**
-     * Collects reactive variables from the compiled Svelte component.
-     *
-     * Reactive variables are those that are both reassigned and writable,
-     * indicating they can change and trigger reactivity in Svelte.
+     * Unwraps `$bindable(...)` calls so defaults are documented as their underlying values.
+     */
+    private unwrapBindableInitializer;
+    /**
+     * Extracts component props from top-level `$props()` declarations in runes components.
      */
-    private collectReactiveVars;
+    private parseRunesPropsDeclaration;
+    private inferSlotPropValueFromExpression;
+    private buildSlotPropsFromObjectExpression;
+    private extractRenderTagInfo;
     /**
      * Adds or merges a component prop to the props map.
      *
@@ -601,7 +644,7 @@ export default class ComponentParser {
      * Parses custom types, events, slots, and other JSDoc annotations from component comments.
      *
      * Scans the entire source for JSDoc comment blocks and extracts structured information
-     * about events, typedefs, slots, extends, restProps, and generics. Handles complex
+     * about events, typedefs, callbacks, slots, extends, restProps, and generics. Handles complex
      * description extraction logic that supports both inline descriptions and preceding
      * line descriptions.
      *