sveld 0.28.0 → 0.29.1

package/lib/ComponentParser.d.ts

@@ -80,7 +80,7 @@ interface ComponentSlot {
     fallback?: string;
     /** TypeScript type definition for slot props (e.g., "{ title: string }") */
     slot_props?: string;
-    /** Description extracted from JSDoc `@slot` tags */
+    /** Description extracted from JSDoc `@slot` or `@snippet` tags */
     description?: string;
 }
 /**
@@ -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,17 +302,55 @@ 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;
+    /** Per-declarator type metadata extracted from modern AST `$props()` annotations */
+    private readonly runesPropTypeMetadataByDeclaratorStart;
+    /** 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 getRunesPropTypeMetadata;
+    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.
      *
      * Separates tags into type, param, returns, and additional categories while
-     * excluding tags that are handled separately (extends, restProps, slot, event, typedef).
+     * excluding tags that are handled separately (extends, restProps, slot/snippet, event, typedef).
      *
      * @param parsed - The parsed comment result from comment-parser
      * @returns An object containing categorized tags and the comment description
@@ -351,6 +391,9 @@ export default class ComponentParser {
      * ```
      */
     private static findJSDocComment;
+    private findAdjacentJSDocComment;
+    private processNodeJSDoc;
+    private processLeadingCommentsJSDoc;
     /**
      * Processes JSDoc comments from leadingComments and extracts structured information.
      *
@@ -384,6 +427,7 @@ export default class ComponentParser {
      * ```
      */
     private processJSDocComment;
+    private buildRunesPropTypeMetadata;
     /**
      * Checks if a MemberExpression represents a well-known numeric constant.
      *
@@ -446,12 +490,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.
      *
@@ -597,6 +645,7 @@ export default class ComponentParser {
      * ```
      */
     private addDispatchedEvent;
+    private normalizeRunesCallbackProps;
     /**
      * Parses custom types, events, slots, and other JSDoc annotations from component comments.
      *