svelte-docinfo 0.1.0

package/dist/analyze-core.d.ts

@@ -0,0 +1,1386 @@
+/**
+ * Pure two-phase analysis orchestrator.
+ *
+ * Extracted from `analyze.ts` to break what would otherwise be a circular
+ * import: `session.ts → analyze.ts (for the orchestrator) → session.ts (for
+ * the wrappers)`. With the orchestrator here, both `session.ts` and
+ * `analyze.ts` import downward into this module without depending on each
+ * other.
+ *
+ * Public surface:
+ *
+ * - `analyzeCore` — runs phase 1 module dispatch + phase 2 re-export merge,
+ *   returns `AnalyzeResultJson`. Caller supplies pre-prepared inputs (program,
+ *   svelte virtuals, transform-failed IDs).
+ * - `analyzeModule` — the per-module dispatcher (TS / Svelte / CSS / JSON).
+ *   `@internal`; exposed for tests and power users via the subpath.
+ * - `AnalyzeResultJson` / `OnDuplicates` / `OnDuplicatesCallback` — shared types
+ *   surfaced through the main barrel directly from this module.
+ * - `throwOnDuplicates` — convenience callback paired with `OnDuplicates`.
+ * - `normalizeDiagnosticPaths` — boundary helper for build-tool integrations
+ *   that bypass the session and collect their own diagnostics.
+ *
+ * @internal — module split is implementation detail; consumers go through
+ * `analyze.ts` / `session.ts` for the stable surface.
+ *
+ * @module
+ */
+import ts from 'typescript';
+import { z } from 'zod';
+import { ModuleJson } from './types.js';
+import type { ReExportInfo } from './declaration-build.js';
+import { Diagnostic } from './diagnostics.js';
+import type { AnalysisLog } from './log.js';
+import { type SvelteVirtualFile } from './svelte.js';
+import { type SourceFileInfo } from './source.js';
+import { type ModuleSourceOptions } from './source-config.js';
+import { type DuplicateDeclaration } from './postprocess.js';
+/**
+ * Custom callback for handling duplicate declaration names.
+ *
+ * Use the `'throw'` or `'warn'` shortcuts on `onDuplicates` for the common
+ * cases. Pass a function to fully control reporting.
+ *
+ * @param duplicates - map of declaration names to their `DuplicateDeclaration` occurrences across modules
+ * @param log - logger for reporting (only `error` method required)
+ */
+export type OnDuplicatesCallback = (duplicates: Map<string, Array<DuplicateDeclaration>>, log: Pick<AnalysisLog, 'error'>) => void;
+/**
+ * Behavior selector for duplicate declaration names across modules.
+ *
+ * - `'throw'` — throw an `Error` listing every duplicate (strict flat-namespace enforcement)
+ * - `'warn'` — log to `log.error` and continue
+ * - `OnDuplicatesCallback` — custom handler
+ *
+ * Omitted entirely: no dispatch runs, but a `duplicate_declaration` diagnostic
+ * is still emitted into the diagnostics array for every collision (the diagnostic
+ * is the data; this option is the action).
+ *
+ * **`'throw'` trade-off**: the throw fires after diagnostics are emitted but
+ * before the result is returned, so `'throw'` callers never reach the
+ * diagnostics array. Callers that want fail-fast *and* diagnostic access
+ * should omit `onDuplicates` and inspect themselves:
+ *
+ * ```ts
+ * const result = await analyze({...});
+ * if (hasErrors(result.diagnostics)) throw new Error('analysis errors');
+ * ```
+ *
+ * Or use an `OnDuplicatesCallback` and stash the data before throwing.
+ */
+export type OnDuplicates = 'throw' | 'warn' | OnDuplicatesCallback;
+/**
+ * Convenience `OnDuplicatesCallback` that throws on any duplicate.
+ *
+ * @throws Error listing every duplicate name and module location
+ */
+export declare const throwOnDuplicates: OnDuplicatesCallback;
+/**
+ * Result of `analyze`, `analyzeFromFiles`, and `AnalysisSession.query`.
+ *
+ * Modules sorted alphabetically by `path`. Diagnostics are query-time
+ * (analysis-pass) diagnostics only when produced by `session.query`; one-shot
+ * wrappers concatenate ingest + query diagnostics into this same array.
+ *
+ * ## Schema-validated round-trip
+ *
+ * The envelope is a Zod schema (`AnalyzeResultJson`) — both fields default to
+ * `[]`, so `JSON.stringify(result, compactReplacer)` strips empty arrays on
+ * the wire and `AnalyzeResultJson.parse(JSON.parse(json))` restores them.
+ * Consumers programmatically ingesting analysis JSON should parse through the
+ * schema to get defaults restored; raw-JSON consumers (e.g., `jq`) treat
+ * missing keys as null-equivalent (`jq '.diagnostics | length'` returns `0`
+ * on `{}`) and don't need the parse step.
+ *
+ * Construction sites (one-shot wrappers, `session.query`) hand back hand-built
+ * objects without re-running `.parse()` — the inner `modules` and
+ * `diagnostics` arrays are already Zod-validated upstream, and the envelope
+ * schema is the type contract, not a validation gate.
+ */
+export declare const AnalyzeResultJson: z.ZodObject<{
+    modules: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        declarations: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"function">;
+            returnType: z.ZodOptional<z.ZodString>;
+            returnDescription: z.ZodOptional<z.ZodString>;
+            parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                type: z.ZodString;
+                optional: z.ZodDefault<z.ZodBoolean>;
+                rest: z.ZodDefault<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+                defaultValue: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            overloads: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                typeSignature: z.ZodString;
+                parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    type: z.ZodString;
+                    optional: z.ZodDefault<z.ZodBoolean>;
+                    rest: z.ZodDefault<z.ZodBoolean>;
+                    description: z.ZodOptional<z.ZodString>;
+                    defaultValue: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                returnType: z.ZodOptional<z.ZodString>;
+                genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    constraint: z.ZodOptional<z.ZodString>;
+                    defaultType: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                docComment: z.ZodOptional<z.ZodString>;
+                returnDescription: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            alsoExportedFrom: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            aliasOf: z.ZodOptional<z.ZodObject<{
+                module: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strict>>;
+            mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            partial: z.ZodDefault<z.ZodBoolean>;
+            examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            deprecatedMessage: z.ZodOptional<z.ZodString>;
+            seeAlso: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            throws: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                type: z.ZodOptional<z.ZodString>;
+                description: z.ZodString;
+            }, z.core.$strict>>>;
+            since: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            docComment: z.ZodOptional<z.ZodString>;
+            typeSignature: z.ZodOptional<z.ZodString>;
+            modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                public: "public";
+                protected: "protected";
+                readonly: "readonly";
+                static: "static";
+                abstract: "abstract";
+                getter: "getter";
+                setter: "setter";
+            }>>>;
+            sourceLine: z.ZodOptional<z.ZodNumber>;
+            genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                constraint: z.ZodOptional<z.ZodString>;
+                defaultType: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"class">;
+            extends: z.ZodOptional<z.ZodString>;
+            implements: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            members: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"function">;
+                name: z.ZodString;
+                optional: z.ZodDefault<z.ZodBoolean>;
+                returnType: z.ZodOptional<z.ZodString>;
+                returnDescription: z.ZodOptional<z.ZodString>;
+                parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    type: z.ZodString;
+                    optional: z.ZodDefault<z.ZodBoolean>;
+                    rest: z.ZodDefault<z.ZodBoolean>;
+                    description: z.ZodOptional<z.ZodString>;
+                    defaultValue: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                overloads: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    typeSignature: z.ZodString;
+                    parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        type: z.ZodString;
+                        optional: z.ZodDefault<z.ZodBoolean>;
+                        rest: z.ZodDefault<z.ZodBoolean>;
+                        description: z.ZodOptional<z.ZodString>;
+                        defaultValue: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>>;
+                    returnType: z.ZodOptional<z.ZodString>;
+                    genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        constraint: z.ZodOptional<z.ZodString>;
+                        defaultType: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>>;
+                    docComment: z.ZodOptional<z.ZodString>;
+                    returnDescription: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                partial: z.ZodDefault<z.ZodBoolean>;
+                examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                deprecatedMessage: z.ZodOptional<z.ZodString>;
+                seeAlso: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                throws: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    type: z.ZodOptional<z.ZodString>;
+                    description: z.ZodString;
+                }, z.core.$strict>>>;
+                since: z.ZodOptional<z.ZodString>;
+                docComment: z.ZodOptional<z.ZodString>;
+                typeSignature: z.ZodOptional<z.ZodString>;
+                modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    public: "public";
+                    protected: "protected";
+                    readonly: "readonly";
+                    static: "static";
+                    abstract: "abstract";
+                    getter: "getter";
+                    setter: "setter";
+                }>>>;
+                sourceLine: z.ZodOptional<z.ZodNumber>;
+                genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    constraint: z.ZodOptional<z.ZodString>;
+                    defaultType: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"variable">;
+                optional: z.ZodDefault<z.ZodBoolean>;
+                reactivity: z.ZodOptional<z.ZodEnum<{
+                    $state: "$state";
+                    "$state.raw": "$state.raw";
+                    $derived: "$derived";
+                    "$derived.by": "$derived.by";
+                }>>;
+                defaultValue: z.ZodOptional<z.ZodString>;
+                mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                partial: z.ZodDefault<z.ZodBoolean>;
+                examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                deprecatedMessage: z.ZodOptional<z.ZodString>;
+                seeAlso: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                throws: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    type: z.ZodOptional<z.ZodString>;
+                    description: z.ZodString;
+                }, z.core.$strict>>>;
+                since: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+                docComment: z.ZodOptional<z.ZodString>;
+                typeSignature: z.ZodOptional<z.ZodString>;
+                modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    public: "public";
+                    protected: "protected";
+                    readonly: "readonly";
+                    static: "static";
+                    abstract: "abstract";
+                    getter: "getter";
+                    setter: "setter";
+                }>>>;
+                sourceLine: z.ZodOptional<z.ZodNumber>;
+                genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    constraint: z.ZodOptional<z.ZodString>;
+                    defaultType: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"constructor">;
+                name: z.ZodUnion<readonly [z.ZodLiteral<"constructor">, z.ZodLiteral<"(construct)">]>;
+                parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    type: z.ZodString;
+                    optional: z.ZodDefault<z.ZodBoolean>;
+                    rest: z.ZodDefault<z.ZodBoolean>;
+                    description: z.ZodOptional<z.ZodString>;
+                    defaultValue: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                overloads: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    typeSignature: z.ZodString;
+                    parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        type: z.ZodString;
+                        optional: z.ZodDefault<z.ZodBoolean>;
+                        rest: z.ZodDefault<z.ZodBoolean>;
+                        description: z.ZodOptional<z.ZodString>;
+                        defaultValue: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>>;
+                    returnType: z.ZodOptional<z.ZodString>;
+                    genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        constraint: z.ZodOptional<z.ZodString>;
+                        defaultType: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>>;
+                    docComment: z.ZodOptional<z.ZodString>;
+                    returnDescription: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                partial: z.ZodDefault<z.ZodBoolean>;
+                examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                deprecatedMessage: z.ZodOptional<z.ZodString>;
+                seeAlso: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                throws: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    type: z.ZodOptional<z.ZodString>;
+                    description: z.ZodString;
+                }, z.core.$strict>>>;
+                since: z.ZodOptional<z.ZodString>;
+                docComment: z.ZodOptional<z.ZodString>;
+                typeSignature: z.ZodOptional<z.ZodString>;
+                modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    public: "public";
+                    protected: "protected";
+                    readonly: "readonly";
+                    static: "static";
+                    abstract: "abstract";
+                    getter: "getter";
+                    setter: "setter";
+                }>>>;
+                sourceLine: z.ZodOptional<z.ZodNumber>;
+                genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    constraint: z.ZodOptional<z.ZodString>;
+                    defaultType: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>], "kind">>>;
+            alsoExportedFrom: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            aliasOf: z.ZodOptional<z.ZodObject<{
+                module: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strict>>;
+            mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            partial: z.ZodDefault<z.ZodBoolean>;
+            examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            deprecatedMessage: z.ZodOptional<z.ZodString>;
+            seeAlso: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            throws: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                type: z.ZodOptional<z.ZodString>;
+                description: z.ZodString;
+            }, z.core.$strict>>>;
+            since: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            docComment: z.ZodOptional<z.ZodString>;
+            typeSignature: z.ZodOptional<z.ZodString>;
+            modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                public: "public";
+                protected: "protected";
+                readonly: "readonly";
+                static: "static";
+                abstract: "abstract";
+                getter: "getter";
+                setter: "setter";
+            }>>>;
+            sourceLine: z.ZodOptional<z.ZodNumber>;
+            genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                constraint: z.ZodOptional<z.ZodString>;
+                defaultType: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"interface">;
+            extends: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            members: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"function">;
+                name: z.ZodString;
+                optional: z.ZodDefault<z.ZodBoolean>;
+                returnType: z.ZodOptional<z.ZodString>;
+                returnDescription: z.ZodOptional<z.ZodString>;
+                parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    type: z.ZodString;
+                    optional: z.ZodDefault<z.ZodBoolean>;
+                    rest: z.ZodDefault<z.ZodBoolean>;
+                    description: z.ZodOptional<z.ZodString>;
+                    defaultValue: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                overloads: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    typeSignature: z.ZodString;
+                    parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        type: z.ZodString;
+                        optional: z.ZodDefault<z.ZodBoolean>;
+                        rest: z.ZodDefault<z.ZodBoolean>;
+                        description: z.ZodOptional<z.ZodString>;
+                        defaultValue: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>>;
+                    returnType: z.ZodOptional<z.ZodString>;
+                    genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        constraint: z.ZodOptional<z.ZodString>;
+                        defaultType: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>>;
+                    docComment: z.ZodOptional<z.ZodString>;
+                    returnDescription: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                partial: z.ZodDefault<z.ZodBoolean>;
+                examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                deprecatedMessage: z.ZodOptional<z.ZodString>;
+                seeAlso: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                throws: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    type: z.ZodOptional<z.ZodString>;
+                    description: z.ZodString;
+                }, z.core.$strict>>>;
+                since: z.ZodOptional<z.ZodString>;
+                docComment: z.ZodOptional<z.ZodString>;
+                typeSignature: z.ZodOptional<z.ZodString>;
+                modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    public: "public";
+                    protected: "protected";
+                    readonly: "readonly";
+                    static: "static";
+                    abstract: "abstract";
+                    getter: "getter";
+                    setter: "setter";
+                }>>>;
+                sourceLine: z.ZodOptional<z.ZodNumber>;
+                genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    constraint: z.ZodOptional<z.ZodString>;
+                    defaultType: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"variable">;
+                optional: z.ZodDefault<z.ZodBoolean>;
+                reactivity: z.ZodOptional<z.ZodEnum<{
+                    $state: "$state";
+                    "$state.raw": "$state.raw";
+                    $derived: "$derived";
+                    "$derived.by": "$derived.by";
+                }>>;
+                defaultValue: z.ZodOptional<z.ZodString>;
+                mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                partial: z.ZodDefault<z.ZodBoolean>;
+                examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                deprecatedMessage: z.ZodOptional<z.ZodString>;
+                seeAlso: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                throws: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    type: z.ZodOptional<z.ZodString>;
+                    description: z.ZodString;
+                }, z.core.$strict>>>;
+                since: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+                docComment: z.ZodOptional<z.ZodString>;
+                typeSignature: z.ZodOptional<z.ZodString>;
+                modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    public: "public";
+                    protected: "protected";
+                    readonly: "readonly";
+                    static: "static";
+                    abstract: "abstract";
+                    getter: "getter";
+                    setter: "setter";
+                }>>>;
+                sourceLine: z.ZodOptional<z.ZodNumber>;
+                genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    constraint: z.ZodOptional<z.ZodString>;
+                    defaultType: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"constructor">;
+                name: z.ZodUnion<readonly [z.ZodLiteral<"constructor">, z.ZodLiteral<"(construct)">]>;
+                parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    type: z.ZodString;
+                    optional: z.ZodDefault<z.ZodBoolean>;
+                    rest: z.ZodDefault<z.ZodBoolean>;
+                    description: z.ZodOptional<z.ZodString>;
+                    defaultValue: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                overloads: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    typeSignature: z.ZodString;
+                    parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        type: z.ZodString;
+                        optional: z.ZodDefault<z.ZodBoolean>;
+                        rest: z.ZodDefault<z.ZodBoolean>;
+                        description: z.ZodOptional<z.ZodString>;
+                        defaultValue: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>>;
+                    returnType: z.ZodOptional<z.ZodString>;
+                    genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        constraint: z.ZodOptional<z.ZodString>;
+                        defaultType: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>>;
+                    docComment: z.ZodOptional<z.ZodString>;
+                    returnDescription: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                partial: z.ZodDefault<z.ZodBoolean>;
+                examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                deprecatedMessage: z.ZodOptional<z.ZodString>;
+                seeAlso: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                throws: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    type: z.ZodOptional<z.ZodString>;
+                    description: z.ZodString;
+                }, z.core.$strict>>>;
+                since: z.ZodOptional<z.ZodString>;
+                docComment: z.ZodOptional<z.ZodString>;
+                typeSignature: z.ZodOptional<z.ZodString>;
+                modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    public: "public";
+                    protected: "protected";
+                    readonly: "readonly";
+                    static: "static";
+                    abstract: "abstract";
+                    getter: "getter";
+                    setter: "setter";
+                }>>>;
+                sourceLine: z.ZodOptional<z.ZodNumber>;
+                genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    constraint: z.ZodOptional<z.ZodString>;
+                    defaultType: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>], "kind">>>;
+            alsoExportedFrom: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            aliasOf: z.ZodOptional<z.ZodObject<{
+                module: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strict>>;
+            mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            partial: z.ZodDefault<z.ZodBoolean>;
+            examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            deprecatedMessage: z.ZodOptional<z.ZodString>;
+            seeAlso: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            throws: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                type: z.ZodOptional<z.ZodString>;
+                description: z.ZodString;
+            }, z.core.$strict>>>;
+            since: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            docComment: z.ZodOptional<z.ZodString>;
+            typeSignature: z.ZodOptional<z.ZodString>;
+            modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                public: "public";
+                protected: "protected";
+                readonly: "readonly";
+                static: "static";
+                abstract: "abstract";
+                getter: "getter";
+                setter: "setter";
+            }>>>;
+            sourceLine: z.ZodOptional<z.ZodNumber>;
+            genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                constraint: z.ZodOptional<z.ZodString>;
+                defaultType: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"type">;
+            intersects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            members: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"function">;
+                name: z.ZodString;
+                optional: z.ZodDefault<z.ZodBoolean>;
+                returnType: z.ZodOptional<z.ZodString>;
+                returnDescription: z.ZodOptional<z.ZodString>;
+                parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    type: z.ZodString;
+                    optional: z.ZodDefault<z.ZodBoolean>;
+                    rest: z.ZodDefault<z.ZodBoolean>;
+                    description: z.ZodOptional<z.ZodString>;
+                    defaultValue: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                overloads: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    typeSignature: z.ZodString;
+                    parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        type: z.ZodString;
+                        optional: z.ZodDefault<z.ZodBoolean>;
+                        rest: z.ZodDefault<z.ZodBoolean>;
+                        description: z.ZodOptional<z.ZodString>;
+                        defaultValue: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>>;
+                    returnType: z.ZodOptional<z.ZodString>;
+                    genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        constraint: z.ZodOptional<z.ZodString>;
+                        defaultType: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>>;
+                    docComment: z.ZodOptional<z.ZodString>;
+                    returnDescription: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                partial: z.ZodDefault<z.ZodBoolean>;
+                examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                deprecatedMessage: z.ZodOptional<z.ZodString>;
+                seeAlso: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                throws: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    type: z.ZodOptional<z.ZodString>;
+                    description: z.ZodString;
+                }, z.core.$strict>>>;
+                since: z.ZodOptional<z.ZodString>;
+                docComment: z.ZodOptional<z.ZodString>;
+                typeSignature: z.ZodOptional<z.ZodString>;
+                modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    public: "public";
+                    protected: "protected";
+                    readonly: "readonly";
+                    static: "static";
+                    abstract: "abstract";
+                    getter: "getter";
+                    setter: "setter";
+                }>>>;
+                sourceLine: z.ZodOptional<z.ZodNumber>;
+                genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    constraint: z.ZodOptional<z.ZodString>;
+                    defaultType: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"variable">;
+                optional: z.ZodDefault<z.ZodBoolean>;
+                reactivity: z.ZodOptional<z.ZodEnum<{
+                    $state: "$state";
+                    "$state.raw": "$state.raw";
+                    $derived: "$derived";
+                    "$derived.by": "$derived.by";
+                }>>;
+                defaultValue: z.ZodOptional<z.ZodString>;
+                mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                partial: z.ZodDefault<z.ZodBoolean>;
+                examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                deprecatedMessage: z.ZodOptional<z.ZodString>;
+                seeAlso: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                throws: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    type: z.ZodOptional<z.ZodString>;
+                    description: z.ZodString;
+                }, z.core.$strict>>>;
+                since: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+                docComment: z.ZodOptional<z.ZodString>;
+                typeSignature: z.ZodOptional<z.ZodString>;
+                modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    public: "public";
+                    protected: "protected";
+                    readonly: "readonly";
+                    static: "static";
+                    abstract: "abstract";
+                    getter: "getter";
+                    setter: "setter";
+                }>>>;
+                sourceLine: z.ZodOptional<z.ZodNumber>;
+                genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    constraint: z.ZodOptional<z.ZodString>;
+                    defaultType: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"constructor">;
+                name: z.ZodUnion<readonly [z.ZodLiteral<"constructor">, z.ZodLiteral<"(construct)">]>;
+                parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    type: z.ZodString;
+                    optional: z.ZodDefault<z.ZodBoolean>;
+                    rest: z.ZodDefault<z.ZodBoolean>;
+                    description: z.ZodOptional<z.ZodString>;
+                    defaultValue: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                overloads: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    typeSignature: z.ZodString;
+                    parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        type: z.ZodString;
+                        optional: z.ZodDefault<z.ZodBoolean>;
+                        rest: z.ZodDefault<z.ZodBoolean>;
+                        description: z.ZodOptional<z.ZodString>;
+                        defaultValue: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>>;
+                    returnType: z.ZodOptional<z.ZodString>;
+                    genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        constraint: z.ZodOptional<z.ZodString>;
+                        defaultType: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>>;
+                    docComment: z.ZodOptional<z.ZodString>;
+                    returnDescription: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                partial: z.ZodDefault<z.ZodBoolean>;
+                examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                deprecatedMessage: z.ZodOptional<z.ZodString>;
+                seeAlso: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                throws: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    type: z.ZodOptional<z.ZodString>;
+                    description: z.ZodString;
+                }, z.core.$strict>>>;
+                since: z.ZodOptional<z.ZodString>;
+                docComment: z.ZodOptional<z.ZodString>;
+                typeSignature: z.ZodOptional<z.ZodString>;
+                modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    public: "public";
+                    protected: "protected";
+                    readonly: "readonly";
+                    static: "static";
+                    abstract: "abstract";
+                    getter: "getter";
+                    setter: "setter";
+                }>>>;
+                sourceLine: z.ZodOptional<z.ZodNumber>;
+                genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    constraint: z.ZodOptional<z.ZodString>;
+                    defaultType: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>], "kind">>>;
+            alsoExportedFrom: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            aliasOf: z.ZodOptional<z.ZodObject<{
+                module: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strict>>;
+            mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            partial: z.ZodDefault<z.ZodBoolean>;
+            examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            deprecatedMessage: z.ZodOptional<z.ZodString>;
+            seeAlso: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            throws: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                type: z.ZodOptional<z.ZodString>;
+                description: z.ZodString;
+            }, z.core.$strict>>>;
+            since: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            docComment: z.ZodOptional<z.ZodString>;
+            typeSignature: z.ZodOptional<z.ZodString>;
+            modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                public: "public";
+                protected: "protected";
+                readonly: "readonly";
+                static: "static";
+                abstract: "abstract";
+                getter: "getter";
+                setter: "setter";
+            }>>>;
+            sourceLine: z.ZodOptional<z.ZodNumber>;
+            genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                constraint: z.ZodOptional<z.ZodString>;
+                defaultType: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"variable">;
+            reactivity: z.ZodOptional<z.ZodEnum<{
+                $state: "$state";
+                "$state.raw": "$state.raw";
+                $derived: "$derived";
+                "$derived.by": "$derived.by";
+            }>>;
+            defaultValue: z.ZodOptional<z.ZodString>;
+            alsoExportedFrom: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            aliasOf: z.ZodOptional<z.ZodObject<{
+                module: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strict>>;
+            mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            partial: z.ZodDefault<z.ZodBoolean>;
+            examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            deprecatedMessage: z.ZodOptional<z.ZodString>;
+            seeAlso: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            throws: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                type: z.ZodOptional<z.ZodString>;
+                description: z.ZodString;
+            }, z.core.$strict>>>;
+            since: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            docComment: z.ZodOptional<z.ZodString>;
+            typeSignature: z.ZodOptional<z.ZodString>;
+            modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                public: "public";
+                protected: "protected";
+                readonly: "readonly";
+                static: "static";
+                abstract: "abstract";
+                getter: "getter";
+                setter: "setter";
+            }>>>;
+            sourceLine: z.ZodOptional<z.ZodNumber>;
+            genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                constraint: z.ZodOptional<z.ZodString>;
+                defaultType: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"enum">;
+            members: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"function">;
+                name: z.ZodString;
+                optional: z.ZodDefault<z.ZodBoolean>;
+                returnType: z.ZodOptional<z.ZodString>;
+                returnDescription: z.ZodOptional<z.ZodString>;
+                parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    type: z.ZodString;
+                    optional: z.ZodDefault<z.ZodBoolean>;
+                    rest: z.ZodDefault<z.ZodBoolean>;
+                    description: z.ZodOptional<z.ZodString>;
+                    defaultValue: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                overloads: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    typeSignature: z.ZodString;
+                    parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        type: z.ZodString;
+                        optional: z.ZodDefault<z.ZodBoolean>;
+                        rest: z.ZodDefault<z.ZodBoolean>;
+                        description: z.ZodOptional<z.ZodString>;
+                        defaultValue: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>>;
+                    returnType: z.ZodOptional<z.ZodString>;
+                    genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        constraint: z.ZodOptional<z.ZodString>;
+                        defaultType: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>>;
+                    docComment: z.ZodOptional<z.ZodString>;
+                    returnDescription: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                partial: z.ZodDefault<z.ZodBoolean>;
+                examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                deprecatedMessage: z.ZodOptional<z.ZodString>;
+                seeAlso: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                throws: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    type: z.ZodOptional<z.ZodString>;
+                    description: z.ZodString;
+                }, z.core.$strict>>>;
+                since: z.ZodOptional<z.ZodString>;
+                docComment: z.ZodOptional<z.ZodString>;
+                typeSignature: z.ZodOptional<z.ZodString>;
+                modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    public: "public";
+                    protected: "protected";
+                    readonly: "readonly";
+                    static: "static";
+                    abstract: "abstract";
+                    getter: "getter";
+                    setter: "setter";
+                }>>>;
+                sourceLine: z.ZodOptional<z.ZodNumber>;
+                genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    constraint: z.ZodOptional<z.ZodString>;
+                    defaultType: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"variable">;
+                optional: z.ZodDefault<z.ZodBoolean>;
+                reactivity: z.ZodOptional<z.ZodEnum<{
+                    $state: "$state";
+                    "$state.raw": "$state.raw";
+                    $derived: "$derived";
+                    "$derived.by": "$derived.by";
+                }>>;
+                defaultValue: z.ZodOptional<z.ZodString>;
+                mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                partial: z.ZodDefault<z.ZodBoolean>;
+                examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                deprecatedMessage: z.ZodOptional<z.ZodString>;
+                seeAlso: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                throws: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    type: z.ZodOptional<z.ZodString>;
+                    description: z.ZodString;
+                }, z.core.$strict>>>;
+                since: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+                docComment: z.ZodOptional<z.ZodString>;
+                typeSignature: z.ZodOptional<z.ZodString>;
+                modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    public: "public";
+                    protected: "protected";
+                    readonly: "readonly";
+                    static: "static";
+                    abstract: "abstract";
+                    getter: "getter";
+                    setter: "setter";
+                }>>>;
+                sourceLine: z.ZodOptional<z.ZodNumber>;
+                genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    constraint: z.ZodOptional<z.ZodString>;
+                    defaultType: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"constructor">;
+                name: z.ZodUnion<readonly [z.ZodLiteral<"constructor">, z.ZodLiteral<"(construct)">]>;
+                parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    type: z.ZodString;
+                    optional: z.ZodDefault<z.ZodBoolean>;
+                    rest: z.ZodDefault<z.ZodBoolean>;
+                    description: z.ZodOptional<z.ZodString>;
+                    defaultValue: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                overloads: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    typeSignature: z.ZodString;
+                    parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        type: z.ZodString;
+                        optional: z.ZodDefault<z.ZodBoolean>;
+                        rest: z.ZodDefault<z.ZodBoolean>;
+                        description: z.ZodOptional<z.ZodString>;
+                        defaultValue: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>>;
+                    returnType: z.ZodOptional<z.ZodString>;
+                    genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        constraint: z.ZodOptional<z.ZodString>;
+                        defaultType: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>>;
+                    docComment: z.ZodOptional<z.ZodString>;
+                    returnDescription: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                partial: z.ZodDefault<z.ZodBoolean>;
+                examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                deprecatedMessage: z.ZodOptional<z.ZodString>;
+                seeAlso: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                throws: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    type: z.ZodOptional<z.ZodString>;
+                    description: z.ZodString;
+                }, z.core.$strict>>>;
+                since: z.ZodOptional<z.ZodString>;
+                docComment: z.ZodOptional<z.ZodString>;
+                typeSignature: z.ZodOptional<z.ZodString>;
+                modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    public: "public";
+                    protected: "protected";
+                    readonly: "readonly";
+                    static: "static";
+                    abstract: "abstract";
+                    getter: "getter";
+                    setter: "setter";
+                }>>>;
+                sourceLine: z.ZodOptional<z.ZodNumber>;
+                genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    constraint: z.ZodOptional<z.ZodString>;
+                    defaultType: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>], "kind">>>;
+            alsoExportedFrom: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            aliasOf: z.ZodOptional<z.ZodObject<{
+                module: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strict>>;
+            mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            partial: z.ZodDefault<z.ZodBoolean>;
+            examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            deprecatedMessage: z.ZodOptional<z.ZodString>;
+            seeAlso: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            throws: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                type: z.ZodOptional<z.ZodString>;
+                description: z.ZodString;
+            }, z.core.$strict>>>;
+            since: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            docComment: z.ZodOptional<z.ZodString>;
+            typeSignature: z.ZodOptional<z.ZodString>;
+            modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                public: "public";
+                protected: "protected";
+                readonly: "readonly";
+                static: "static";
+                abstract: "abstract";
+                getter: "getter";
+                setter: "setter";
+            }>>>;
+            sourceLine: z.ZodOptional<z.ZodNumber>;
+            genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                constraint: z.ZodOptional<z.ZodString>;
+                defaultType: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"component">;
+            intersects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            props: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                deprecatedMessage: z.ZodOptional<z.ZodString>;
+                seeAlso: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                throws: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    type: z.ZodOptional<z.ZodString>;
+                    description: z.ZodString;
+                }, z.core.$strict>>>;
+                since: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+                type: z.ZodString;
+                optional: z.ZodDefault<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+                defaultValue: z.ZodOptional<z.ZodString>;
+                bindable: z.ZodDefault<z.ZodBoolean>;
+                parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    type: z.ZodString;
+                    optional: z.ZodDefault<z.ZodBoolean>;
+                    rest: z.ZodDefault<z.ZodBoolean>;
+                    description: z.ZodOptional<z.ZodString>;
+                    defaultValue: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>>>;
+            acceptsChildren: z.ZodDefault<z.ZodBoolean>;
+            lang: z.ZodOptional<z.ZodEnum<{
+                js: "js";
+            }>>;
+            alsoExportedFrom: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            aliasOf: z.ZodOptional<z.ZodObject<{
+                module: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strict>>;
+            mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            partial: z.ZodDefault<z.ZodBoolean>;
+            examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            deprecatedMessage: z.ZodOptional<z.ZodString>;
+            seeAlso: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            throws: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                type: z.ZodOptional<z.ZodString>;
+                description: z.ZodString;
+            }, z.core.$strict>>>;
+            since: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            docComment: z.ZodOptional<z.ZodString>;
+            typeSignature: z.ZodOptional<z.ZodString>;
+            modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                public: "public";
+                protected: "protected";
+                readonly: "readonly";
+                static: "static";
+                abstract: "abstract";
+                getter: "getter";
+                setter: "setter";
+            }>>>;
+            sourceLine: z.ZodOptional<z.ZodNumber>;
+            genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                constraint: z.ZodOptional<z.ZodString>;
+                defaultType: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"snippet">;
+            parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                type: z.ZodString;
+                optional: z.ZodDefault<z.ZodBoolean>;
+                rest: z.ZodDefault<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+                defaultValue: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            alsoExportedFrom: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            aliasOf: z.ZodOptional<z.ZodObject<{
+                module: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strict>>;
+            mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            partial: z.ZodDefault<z.ZodBoolean>;
+            examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            deprecatedMessage: z.ZodOptional<z.ZodString>;
+            seeAlso: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            throws: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                type: z.ZodOptional<z.ZodString>;
+                description: z.ZodString;
+            }, z.core.$strict>>>;
+            since: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            docComment: z.ZodOptional<z.ZodString>;
+            typeSignature: z.ZodOptional<z.ZodString>;
+            modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                public: "public";
+                protected: "protected";
+                readonly: "readonly";
+                static: "static";
+                abstract: "abstract";
+                getter: "getter";
+                setter: "setter";
+            }>>>;
+            sourceLine: z.ZodOptional<z.ZodNumber>;
+            genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                constraint: z.ZodOptional<z.ZodString>;
+                defaultType: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"namespace">;
+            module: z.ZodString;
+            alsoExportedFrom: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            aliasOf: z.ZodOptional<z.ZodObject<{
+                module: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strict>>;
+            mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            partial: z.ZodDefault<z.ZodBoolean>;
+            examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            deprecatedMessage: z.ZodOptional<z.ZodString>;
+            seeAlso: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            throws: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                type: z.ZodOptional<z.ZodString>;
+                description: z.ZodString;
+            }, z.core.$strict>>>;
+            since: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            docComment: z.ZodOptional<z.ZodString>;
+            typeSignature: z.ZodOptional<z.ZodString>;
+            modifiers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                public: "public";
+                protected: "protected";
+                readonly: "readonly";
+                static: "static";
+                abstract: "abstract";
+                getter: "getter";
+                setter: "setter";
+            }>>>;
+            sourceLine: z.ZodOptional<z.ZodNumber>;
+            genericParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                constraint: z.ZodOptional<z.ZodString>;
+                defaultType: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>], "kind">>>;
+        moduleComment: z.ZodOptional<z.ZodString>;
+        dependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        dependents: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        starExports: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        partial: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    diagnostics: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        symbolName: z.ZodString;
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        column: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        kind: z.ZodLiteral<"type_extraction_failed">;
+    }, z.core.$strict>, z.ZodObject<{
+        functionName: z.ZodString;
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        column: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        kind: z.ZodLiteral<"signature_analysis_failed">;
+    }, z.core.$strict>, z.ZodObject<{
+        className: z.ZodString;
+        memberName: z.ZodString;
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        column: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        kind: z.ZodLiteral<"class_member_failed">;
+    }, z.core.$strict>, z.ZodObject<{
+        componentName: z.ZodString;
+        propName: z.ZodString;
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        column: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        kind: z.ZodLiteral<"svelte_prop_failed">;
+    }, z.core.$strict>, z.ZodObject<{
+        reason: z.ZodEnum<{
+            not_in_program: "not_in_program";
+            no_analyzer: "no_analyzer";
+            requires_program: "requires_program";
+        }>;
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        column: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        kind: z.ZodLiteral<"module_skipped">;
+    }, z.core.$strict>, z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        column: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        kind: z.ZodLiteral<"module_unreadable">;
+    }, z.core.$strict>, z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        column: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        kind: z.ZodLiteral<"import_parse_failed">;
+    }, z.core.$strict>, z.ZodObject<{
+        commentType: z.ZodEnum<{
+            module_comment: "module_comment";
+            doc_comment: "doc_comment";
+        }>;
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        column: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        kind: z.ZodLiteral<"duplicate_comment">;
+    }, z.core.$strict>, z.ZodObject<{
+        tagName: z.ZodEnum<{
+            default: "default";
+            throws: "throws";
+            since: "since";
+            mutates: "mutates";
+            deprecated: "deprecated";
+            example: "example";
+            see: "see";
+            nodocs: "nodocs";
+        }>;
+        functionName: z.ZodString;
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        column: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        kind: z.ZodLiteral<"misplaced_tag">;
+    }, z.core.$strict>, z.ZodObject<{
+        paramName: z.ZodString;
+        functionName: z.ZodString;
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        column: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        kind: z.ZodLiteral<"unknown_param">;
+    }, z.core.$strict>, z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        column: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        kind: z.ZodLiteral<"source_map_failed">;
+    }, z.core.$strict>, z.ZodObject<{
+        declarationName: z.ZodString;
+        modules: z.ZodArray<z.ZodString>;
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        column: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        kind: z.ZodLiteral<"duplicate_declaration">;
+    }, z.core.$strict>, z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        column: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        kind: z.ZodLiteral<"transform_failed">;
+    }, z.core.$strict>, z.ZodObject<{
+        specifier: z.ZodString;
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        column: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        kind: z.ZodLiteral<"resolver_failed">;
+    }, z.core.$strict>], "kind">>>;
+}, z.core.$strict>;
+export type AnalyzeResultJson = z.infer<typeof AnalyzeResultJson>;
+/**
+ * Result of analyzing a single module.
+ *
+ * `alsoExportedFrom` on declarations is always empty from this path —
+ * cross-module re-export resolution requires all modules.
+ */
+export interface ModuleAnalyzeResult {
+    module: ModuleJson;
+    reExports: Array<ReExportInfo>;
+}
+/**
+ * Analyze a single non-Svelte source file and extract module metadata.
+ *
+ * @internal Single-module dispatcher used internally by the two-phase
+ * orchestrator. Importable from `svelte-docinfo/analyze-core.js` for tests
+ * and power users — not part of the stable barrel API and not guaranteed
+ * across minor versions.
+ *
+ * Dispatches on file type:
+ * - TypeScript/JS → `analyzeTypescriptModule`
+ * - CSS/JSON → minimal module (no declarations, dependency tracking only)
+ * - Svelte → `module_skipped: requires_program` (callers using session API
+ *   should not reach this path; the session pre-handles Svelte)
+ *
+ * Returns `undefined` when the file is skipped; the diagnostic is added to
+ * `diagnostics` so the caller can keep iterating.
+ */
+export declare const analyzeModule: (sourceFile: SourceFileInfo & {
+    dependents?: ReadonlyArray<string>;
+}, program: ts.Program, options: ModuleSourceOptions, diagnostics: Array<Diagnostic>, log?: AnalysisLog) => ModuleAnalyzeResult | undefined;
+/**
+ * Inputs to `analyzeCore`. The caller (one-shot wrapper or session.query)
+ * is responsible for normalizing `sourceOptions`, obtaining the program,
+ * and pre-transforming Svelte files into `svelteVirtualFiles`.
+ *
+ * `transformFailedIds` carries the IDs of `.svelte` files whose svelte2tsx
+ * transform threw at ingest. The dispatch synthesizes a placeholder
+ * `ModuleJson` (`partial: true`, empty declarations) for each so consumers
+ * see the file's existence in `modules` even though analysis couldn't run.
+ * Identifying these via a sibling Set keeps `svelteVirtualFiles` a clean
+ * "files we can analyze" map; the failure side-channel doesn't pollute it.
+ */
+export interface AnalyzeCoreInputs {
+    sourceFiles: ReadonlyArray<SourceFileInfo>;
+    sourceOptions: ModuleSourceOptions;
+    program: ts.Program;
+    svelteVirtualFiles: ReadonlyMap<string, SvelteVirtualFile>;
+    /** Svelte file IDs whose svelte2tsx transform failed at ingest. */
+    transformFailedIds?: ReadonlySet<string>;
+    onDuplicates?: OnDuplicates;
+    log?: AnalysisLog;
+}
+/**
+ * Run the two-phase analysis loop on pre-prepared inputs.
+ *
+ * @internal Shared two-phase orchestrator used internally by `session.query`
+ * and the one-shot wrappers. Importable from `svelte-docinfo/analyze-core.js`
+ * for tests and power users — not part of the stable barrel API and not
+ * guaranteed across minor versions.
+ *
+ * Phase 1: per-file dispatch (TS / Svelte / CSS / JSON / placeholder for
+ * transform-failed Svelte). Phase 2: re-export merge, component-alias fill,
+ * sort, duplicate detection. Diagnostic paths are normalized to
+ * project-root-relative form before return.
+ *
+ * Dependents are read from `sourceFile.dependents` (caller-supplied via
+ * `extractDependencies`); `analyzeCore` does not compute them. `session.query`
+ * runs `computeDependents` on the owned set before invoking this.
+ */
+export declare const analyzeCore: (inputs: AnalyzeCoreInputs) => AnalyzeResultJson;
+/**
+ * Normalize `Diagnostic.file` to project-root-relative form, in place.
+ *
+ * Producers inside the analysis pipeline can write absolute paths or virtual
+ * paths (svelte2tsx output like `Foo.svelte.__svelte2tsx__.ts`). This pass
+ * collapses both to the public contract: a path relative to `projectRoot`
+ * with no leading slash and no `./` prefix.
+ *
+ * Exposed for build-tool integrations that bypass the session and collect
+ * their own discovery/dep diagnostics — they need the same normalization to
+ * match the public contract.
+ *
+ * @mutates diagnostics — rewrites each diagnostic's `file` field
+ */
+export declare const normalizeDiagnosticPaths: (diagnostics: Array<Diagnostic>, projectRoot: string) => void;
+//# sourceMappingURL=analyze-core.d.ts.map