sveld 0.30.3 → 0.32.0

package/lib/{ComponentParser.d.ts → src/ComponentParser.d.ts}

@@ -1,3 +1,13 @@
+export interface SourcePosition {
+    /** 1-based source line number */
+    line: number;
+    /** 0-based source column number */
+    column: number;
+}
+export interface SourceRange {
+    start: SourcePosition;
+    end: SourcePosition;
+}
 export interface ParsedComponentTypeScriptMetadata {
     canonicalPropsType?: string;
     canonicalPropNames: string[];
@@ -8,6 +18,15 @@ export declare const PARSED_COMPONENT_TYPE_SCRIPT_METADATA: unique symbol;
 export declare function getParsedComponentTypeScriptMetadata(component: {
     [PARSED_COMPONENT_TYPE_SCRIPT_METADATA]?: ParsedComponentTypeScriptMetadata;
 }): ParsedComponentTypeScriptMetadata | undefined;
+type SyntaxMode = "legacy" | "runes";
+type ScriptLanguage = "js" | "ts";
+type ComponentPropTypeSource = "typescript" | "jsdoc" | "default" | "inferred" | "unknown";
+type ComponentPropDefaultValueKind = "literal" | "array" | "object" | "expression" | "function" | "unknown";
+interface ComponentPropDefaultValue {
+    raw: string;
+    kind: ComponentPropDefaultValueKind;
+    value?: unknown;
+}
 /**
  * Diagnostic information for component parsing.
  *
@@ -27,6 +46,7 @@ interface ComponentParserOptions {
     /** Enable verbose logging for debugging parsing issues */
     verbose?: boolean;
 }
+type ComponentPropBinding = "readonly" | "writable";
 /**
  * Parameter information for function props.
  *
@@ -58,8 +78,14 @@ interface ComponentProp {
     constant: boolean;
     /** The TypeScript type of the prop (e.g., "string", "number | string") */
     type?: string;
+    /** Conservative provenance for the prop type */
+    typeSource?: ComponentPropTypeSource;
+    /** Local variable name, emitted when it differs from the public prop name */
+    localName?: string;
     /** The default value as a string representation of the source code */
     value?: string;
+    /** Structured default value metadata for docs UIs */
+    defaultValue?: ComponentPropDefaultValue;
     /** Description extracted from JSDoc comments */
     description?: string;
     /** Function parameters (for function props) extracted from `@param` tags */
@@ -74,6 +100,12 @@ interface ComponentProp {
     isRequired: boolean;
     /** Whether this prop is reactive (can change and trigger reactivity) */
     reactive: boolean;
+    /** Explicit author-documented binding direction from `@bindable` JSDoc */
+    binding?: ComponentPropBinding;
+    /** True when the prop is explicitly declared with Svelte 5 `$bindable()` */
+    bindable?: true;
+    /** Source range for the prop declaration, when available */
+    source?: SourceRange;
 }
 /**
  * Component slot definition.
@@ -100,6 +132,8 @@ interface ComponentSlot {
         name: string;
         body: string;
     }>;
+    /** Source range for the slot/snippet declaration or documentation tag, when available */
+    source?: SourceRange;
 }
 /**
  * Event that is forwarded from a child component or element.
@@ -118,6 +152,8 @@ interface ForwardedEvent {
     description?: string;
     /** The detail type if explicitly specified in `@event` tag */
     detail?: string;
+    /** Source range for the forwarded event declaration or documentation tag, when available */
+    source?: SourceRange;
 }
 /**
  * Event that is dispatched by the component.
@@ -134,6 +170,8 @@ interface DispatchedEvent {
     detail?: string;
     /** Description extracted from JSDoc `@event` tags */
     description?: string;
+    /** Source range for the dispatched event call or documentation tag, when available */
+    source?: SourceRange;
 }
 type ComponentEvent = ForwardedEvent | DispatchedEvent;
 /**
@@ -256,6 +294,12 @@ interface ComponentContext {
  * ```
  */
 export interface ParsedComponent {
+    /** Source range for the component source that was parsed */
+    source?: SourceRange;
+    /** Whether the component uses legacy or runes syntax according to compiler metadata */
+    syntaxMode: SyntaxMode;
+    /** Language used by the instance or module script when it can be determined */
+    scriptLanguage?: ScriptLanguage;
     /** Component props that can be passed to the component */
     props: ComponentProp[];
     /** Exports from `<script context="module">` block */
@@ -274,6 +318,8 @@ export interface ParsedComponent {
     extends?: Extends;
     /** Component-level description from `@component` HTML comment */
     componentComment?: string;
+    /** Source range for the `@component` HTML comment, when available */
+    componentCommentSource?: SourceRange;
     /** Contexts created with `setContext` in the component */
     contexts?: ComponentContext[];
     /** Internal writer-only TypeScript metadata. Not serialized to JSON. */
@@ -284,6 +330,8 @@ export default class ComponentParser {
     private options?;
     /** Whether the component uses legacy or runes syntax according to compiler metadata */
     private syntaxMode;
+    /** Language used by the component's instance or module script, when supported */
+    private scriptLanguage?;
     /** Raw source code of the Svelte component being parsed */
     private source?;
     /** Compiled Svelte code containing extracted variables and AST */
@@ -296,6 +344,8 @@ export default class ComponentParser {
     private extends?;
     /** Component-level description extracted from `@component` HTML comment */
     private componentComment?;
+    /** Source range for the `@component` HTML comment, when available */
+    private componentCommentSource?;
     /** Set of reactive variable names found in the component */
     private readonly reactive_vars;
     /** Set of all variable declarations found in the component script */
@@ -348,8 +398,12 @@ export default class ComponentParser {
     private readonly activeScopes;
     /** Cached array of source code lines split by newline for efficient line-based operations */
     private sourceLinesCache?;
+    /** Cached 0-based source offsets for the start of each line */
+    private sourceLineStartOffsetsCache?;
     constructor(options?: ComponentParserOptions);
     private static mapToArray;
+    private static getStaticAttributeValue;
+    private static resolveScriptLanguage;
     private static assignValue;
     private resolvePublicPropName;
     private trackPropLocalName;
@@ -361,6 +415,11 @@ export default class ComponentParser {
     private getTypeReferenceName;
     private getTypeDependencyName;
     private getTypeAnnotationText;
+    private getSourceLineStartOffsets;
+    private sourcePositionFromOffset;
+    private sourceRangeFromOffsets;
+    private sourceRangeFromNode;
+    private sourceRangeFromCommentTag;
     private collectReferencedTypeDependencies;
     private buildTypeImportStatements;
     private buildTypeScriptMetadata;
@@ -384,6 +443,7 @@ export default class ComponentParser {
     private isCallExpressionNamed;
     private getPropertyName;
     private logUnsupportedRunesPattern;
+    private logParserWarning;
     private static formatComment;
     /**
      * Extracts and categorizes JSDoc tags from a parsed comment.
@@ -498,6 +558,10 @@ export default class ComponentParser {
      * @returns The source code substring, or undefined if source is not available
      */
     private sourceAtPos;
+    private sourceForExpression;
+    private jsonSafeValueFromExpression;
+    private classifyDefaultValue;
+    private resolveTypeSource;
     /**
      * Processes an initializer expression to extract its value, type, and function status.
      *

package/lib/{writer → src/writer}/markdown-format-utils.d.ts

@@ -1,7 +1,7 @@
 export declare const BACKTICK_REGEX: RegExp;
 export declare const WHITESPACE_REGEX: RegExp;
 export declare const MD_TYPE_UNDEFINED = "--";
-export declare const PROP_TABLE_HEADER = "| Prop name | Required | Kind | Reactive | Type | Default value | Description |\n| :- | :- | :- | :- |\n";
+export declare const PROP_TABLE_HEADER = "| Prop name | Required | Kind | Reactive | Binding | Type | Default value | Description |\n| :- | :- | :- | :- | :- | :- | :- | :- |\n";
 export declare const SLOT_TABLE_HEADER = "| Slot name | Default | Props | Fallback |\n| :- | :- | :- | :- |\n";
 export declare const EVENT_TABLE_HEADER = "| Event name | Type | Detail | Description |\n| :- | :- | :- | :- |\n";
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sveld",
-  "version": "0.30.3",
+  "version": "0.32.0",
   "license": "Apache-2.0",
   "description": "Generate TypeScript definitions and component documentation for your Svelte components.",
   "type": "module",