sveld 0.34.0 → 0.35.0

package/lib/ast-guards.d.ts

@@ -1,4 +1,4 @@
-import type { ArrowFunctionExpression, CallExpression, FunctionDeclaration, FunctionExpression, Identifier, Literal, MemberExpression, ObjectExpression, VariableDeclaration } from "estree";
+import type { ArrowFunctionExpression, CallExpression, FunctionDeclaration, FunctionExpression, Identifier, Literal, MemberExpression, NewExpression, ObjectExpression, VariableDeclaration } from "estree";
 export declare function isObject(value: unknown): value is Record<string, unknown>;
 export declare function isVariableDeclaration(node: unknown): node is VariableDeclaration;
 export declare function isLiteral(node: unknown): node is Literal;
@@ -7,6 +7,8 @@ export declare function isMemberExpression(node: unknown): node is MemberExpress
 export declare function isObjectExpression(node: unknown): node is ObjectExpression;
 export declare function isCallExpression(node: unknown): node is CallExpression;
 export declare function isCallExpressionNamed(node: unknown, calleeName: string): node is CallExpression;
+export declare function isNewExpression(node: unknown): node is NewExpression;
+export declare function isNewExpressionNamed(node: unknown, calleeName: string): node is NewExpression;
 export declare function isFunctionDeclaration(node: unknown): node is FunctionDeclaration;
 export declare function isFunctionExpression(node: unknown): node is FunctionExpression;
 export declare function isArrowFunctionExpression(node: unknown): node is ArrowFunctionExpression;

package/lib/bundle.d.ts

@@ -48,8 +48,9 @@ export interface GenerateBundleOptions {
     documentExports?: boolean;
     /**
      * Cache parsed component output to disk. Unchanged files skip re-parsing on
-     * later runs. `true` uses `node_modules/.cache/sveld/parse-cache.json`; a
-     * string sets a custom path. Off by default.
+     * later runs. On by default, writing to
+     * `node_modules/.cache/sveld/parse-cache.json`; a string sets a custom path.
+     * Pass `false` to disable.
      */
     cache?: boolean | string;
     /**
@@ -71,7 +72,19 @@ export interface ProcessComponentOptions {
     onParseError?: (error: ComponentParseError) => void;
     /** When set, reuse a component's previous parse if its content hash is unchanged. */
     cache?: ParseCache;
+    /** Resolved file path -> sha256, computed once up front so it isn't re-hashed per pass. */
+    hashes?: Map<string, string>;
+    /**
+     * In-run memo of freshly parsed components, keyed by resolved file path and
+     * shared across the exported and all-components passes so a component that
+     * appears in both is only parsed once. Only fresh parses are stored here
+     * (never disk-cache hits), and an entry is cleared wherever the disk cache
+     * is invalidated so the `@extends` dependency-invalidation flow still forces
+     * a re-parse.
+     */
+    memo?: Map<string, ParsedComponent>;
 }
+export declare function stripTopLevelStyleBlock(source: string): string;
 /**
  * Discovered component sources for an entry point, before parsing.
  *

package/lib/check.d.ts

@@ -1,4 +1,5 @@
 import type { ComponentDocs } from "./bundle";
+import type { SveldRuntimeOptions } from "./load-config";
 import type { EntryExports } from "./parse-entry-exports";
 import { type ComponentApiDocument } from "./writer/document-model";
 export type SemverBump = "major" | "minor" | "patch" | "none";
@@ -26,6 +27,11 @@ export interface RunCheckOptions {
     /** Entry-barrel exports when `documentExports` is on. */
     entryExports?: EntryExports;
 }
+/**
+ * Resolves the snapshot path for `check`: an explicit string wins, otherwise
+ * it falls back to the `json` writer's `outFile`, or `COMPONENT_API.json`.
+ */
+export declare function resolveCheckSnapshotFile(options: Pick<SveldRuntimeOptions, "check" | "jsonOptions">): string;
 /**
  * Diffs the current component set against a committed `COMPONENT_API.json`
  * snapshot and assigns a semver bump to each change. Returns

package/lib/cli.d.ts

@@ -1,20 +1,22 @@
-import { type PluginSveldOptions } from "./plugin";
-/** CLI options layered on top of the shared plugin options. */
-interface CliOptions extends PluginSveldOptions {
-    /** Set exit code 1 when diagnostics are present. */
-    strict?: boolean;
-    /**
-     * Diff the parsed component API against a committed snapshot (default:
-     * the `json` writer's `outFile`, or `COMPONENT_API.json`) and assign a
-     * semver bump to each change. Exits `1` on a breaking change. Pass a
-     * string for a custom snapshot path.
-     */
-    check?: boolean | string;
-}
-export declare function parseCliOptions(argv: string[]): CliOptions;
+import { type SveldRuntimeOptions } from "./load-config";
+/** CLI options: identical surface to the shared runtime options. */
+type CliOptions = SveldRuntimeOptions;
+/** Discriminated result of parsing the full argument list. */
+export type CliParseResult = {
+    kind: "options";
+    options: CliOptions;
+} | {
+    kind: "help";
+} | {
+    kind: "version";
+} | {
+    kind: "unknown";
+    arg: string;
+};
+export declare function parseCliOptions(argv: string[]): CliParseResult;
 /**
- * CLI entry point: parse flags, load any config file, run Rollup, generate
- * docs, write outputs.
+ * CLI entry point: parse flags, load any config file, generate docs, write
+ * outputs.
  *
  * @example
  * ```ts

package/lib/diagnostics.d.ts

@@ -1,3 +1,4 @@
+import type { SourceRange } from "./ComponentParser";
 /**
  * Why sveld could not pin a type during parsing.
  *
@@ -5,8 +6,9 @@
  * - `context-any-type`: `setContext` value inferred as `any`.
  * - `event-no-source`: `@event` with no dispatch, forward, or callback prop.
  * - `example-compile-error`: an `@example` block failed to type-check (opt-in, `checkExamples`).
+ * - `syntax-skipped`: `$props()`/`{@render}` syntax the parser can't model; omitted from output.
  */
-export type SveldDiagnosticKind = "prop-unknown-type" | "context-any-type" | "event-no-source" | "example-compile-error";
+export type SveldDiagnosticKind = "prop-unknown-type" | "context-any-type" | "event-no-source" | "example-compile-error" | "syntax-skipped";
 /**
  * One place sveld had to guess a type instead of inferring it.
  */
@@ -18,6 +20,8 @@ export interface SveldDiagnostic {
     name: string;
     /** What went wrong and what type sveld used. */
     message: string;
+    /** Where in the component source this diagnostic points, when the parser holds a stable position. */
+    source?: SourceRange;
 }
 /**
  * Drop duplicates (same component, kind, and name). Each file is parsed twice

package/lib/example-check.d.ts

@@ -1,4 +1,4 @@
-import type { ParsedComponent } from "./ComponentParser";
+import type { ParsedComponent, SourceRange } from "./ComponentParser";
 /**
  * One `@example` block worth type-checking, reduced to what `resolve-types.ts`
  * needs: a declaration for the documented symbol and the example body itself.
@@ -12,6 +12,8 @@ export interface ExampleCheckSource {
     type: string;
     /** The `@example` body, stripped of any surrounding code fence. */
     code: string;
+    /** Source range of the documented symbol (prop/export/slot/event), when available. */
+    source?: SourceRange;
 }
 /**
  * Collects every `@example` block sveld can type-check for a parsed component: