svelte-docinfo 0.7.0 → 0.8.0

package/dist/types.d.ts

@@ -122,8 +122,9 @@ export declare const GenericParamJson: z.ZodObject<{
 export type GenericParamJson = z.infer<typeof GenericParamJson>;
 /**
  * Structured type information — the machine-readable counterpart to the flat
- * type strings (`ParameterJson.type`, `ComponentPropJson.type`, and the
- * `typeSignature` fields that carry a `typeInfo` sibling).
+ * type strings (`ParameterJson.type`, `ComponentPropJson.type`, the
+ * `typeSignature` fields that carry a `typeInfo` sibling, and `returnType`
+ * beside `returnTypeInfo`).
  *
  * **Absence contract**: the field holding a `TypeJson` is absent when the flat
  * string is the whole story — the type is terminal at the root (an intrinsic,
@@ -182,12 +183,19 @@ export type GenericParamJson = z.infer<typeof GenericParamJson>;
  * still resolves, but a structural walk can't distinguish from a printed
  * signature).
  *
- * **Normalization**: mirrors the flat strings — the optional-widening
- * `undefined` member is dropped from a root union (`optional: true` carries
- * it, and an optional tuple element strips the same widening from its type),
- * and a `true | false` literal pair collapses to the `boolean` intrinsic
- * (the checker expands `boolean` inside unions). A union reduced to one member
- * by either rule becomes that member directly, never a 1-member union.
+ * **Normalization**: the optional-widening `undefined` member is dropped from a
+ * root union like the flat string drops it (`optional: true` carries it) — but
+ * the flat string strips at the top level only, while the tree strips at every
+ * `optional`-flagged position it expands, so `Snippet<[a: string, b?: number]>`
+ * prints `b?: number | undefined` while the tuple element reports `number` with
+ * `optional: true`. Treat `typeSignature` as the checker's canonical rendering
+ * and the structured fields as normalized. At property sites the strip applies
+ * only when the checker widened: under `exactOptionalPropertyTypes` an
+ * author-written `undefined` on an optional property is kept (parameters and
+ * tuple elements always strip). Separately, a `true | false` literal pair
+ * collapses to the `boolean` intrinsic (the checker expands `boolean` inside
+ * unions). A union reduced to one member by either rule becomes that member
+ * directly, never a 1-member union.
  *
  * Terminal `text` fields are printed with `NoTruncation` up to a 1000-char
  * budget, past which the checker's own elided rendering is used — so `text` is
@@ -199,14 +207,15 @@ export type GenericParamJson = z.infer<typeof GenericParamJson>;
  * (`z.infer<typeof S>`, valibot's `InferOutput`) carries no alias symbol, so
  * the checker expands its whole structure at every use.
  *
- * **Written-name recovery**: where a written annotation exists (return types —
- * per overload included — parameters, variables, type-alias declarations and
- * their properties, index signatures, getter-backed accessors, component
- * props, snippet parameters), each bare
- * type reference in it is resolved by checker type identity, and a type the
- * checker has no name for — the alias-dropped shapes above — emits
+ * **Written-name recovery**: at each annotated position, each bare type
+ * reference is resolved by checker type identity, and a type the checker has
+ * no name for — the alias-dropped shapes above — emits
  * `{kind: 'reference', name}` instead of expanding, alias-lost unions and
- * intersections included. The name resolves through import aliases to the
+ * intersections included. The annotated positions: return types (per overload
+ * too), parameters, variables, type-alias declarations, properties of type
+ * aliases, interfaces, and classes, index signatures, accessors (the getter's
+ * return, else a setter-only accessor's parameter), component props, and
+ * snippet parameters. The name resolves through import aliases to the
  * importable one (`import {Original as Renamed}` recovers `Original`); a name
  * the checker has is never overridden; `typeof` queries, import types, inline
  * type literals, and argument-carrying references (`z.infer<typeof S>` itself,
@@ -215,7 +224,8 @@ export type GenericParamJson = z.infer<typeof GenericParamJson>;
  * the root, relaxing the absence contract the way alias roots do: a
  * checker-named bare reference defers to a flat sibling printing the same
  * name, while a recovered one stands against the anonymous expansion, so the
- * name exists only in the tree.
+ * name exists only in the tree. Both recovery channels still fire at the depth
+ * cap, so a capped alias-lost type emits its reference instead of elided text.
  *
  * **Registry recovery**: behind the written channel, unannotated positions
  * recover through the analyzed set's alias registry — any exported,
@@ -224,9 +234,10 @@ export type GenericParamJson = z.infer<typeof GenericParamJson>;
  * `module`, the declaring module's `ModuleJson.path` — provenance for
  * collision-exact linking, and always an emitted module (gated modules never
  * register), so a consumer lookup by `(module, name)` can't dangle. `module`
- * is registry-only, deliberately: a written-channel recovery names whatever
- * the author wrote at the site (which may not be the registry's winner), and
- * checker-named references never carry it — consumers must handle absence.
+ * appears only on registry-recovered references: written-channel recoveries
+ * name whatever the author wrote (which may not be the registry's winner), and
+ * checker-named references and alias-carrying `union`/`intersection` nodes
+ * carry no provenance. Consumers must handle absence.
  *
  * **Member order and nested aliases**: union members follow the flat string's
  * printed order — `null`/`undefined` sink last, and the checker's `origin`
@@ -340,7 +351,8 @@ export interface TupleElementJson {
     name?: string;
     /**
      * The element's type. An optional element's type has the widening
-     * `undefined` stripped so `optional` carries it alone; a rest element's is
+     * `undefined` stripped so `optional` carries it alone (the enclosing flat
+     * string keeps it — see the normalization policy); a rest element's is
      * the array it collects (`...rest: boolean[]` carries an `array` node over
      * `boolean`, matching the written form), while a variadic spread of an
      * unresolved type (`...T`) carries the spread type itself.
@@ -360,9 +372,16 @@ export declare const TupleElementJson: z.ZodType<TupleElementJson, TupleElementJ
  * Function parameters form a tuple with positional semantics:
  * calling order matters (`fn(a, b)` vs `fn(b, a)`),
  * may include rest parameters and destructuring patterns.
+ *
+ * Carries no doc fields beyond `description`, unlike `ComponentPropJson`: a
+ * parameter's docs come from one `@param` line, while a prop has a JSDoc block
+ * of its own.
  */
 export declare const ParameterJson: z.ZodObject<{
-    /** Parameter name (e.g., `options`, `...args`). */
+    /**
+     * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+     * never the name.
+     */
     name: z.ZodString;
     /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
     type: z.ZodString;
@@ -374,7 +393,11 @@ export declare const ParameterJson: z.ZodObject<{
     rest: z.ZodDefault<z.ZodBoolean>;
     /** Description from `@param` tag. */
     description: z.ZodOptional<z.ZodString>;
-    /** Default value expression from the source (e.g., `'hello'`, `42`). */
+    /**
+     * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+     * `() => 10`) — quotes included, no normalization; consumers render it as
+     * highlighted TS.
+     */
     defaultValue: z.ZodOptional<z.ZodString>;
     /**
      * Descriptions for properties of a named object parameter, from dotted
@@ -422,7 +445,11 @@ export declare const ComponentPropJson: z.ZodObject<{
     optional: z.ZodDefault<z.ZodBoolean>;
     /** Description from JSDoc on the prop's type declaration. */
     description: z.ZodOptional<z.ZodString>;
-    /** Default value expression from destructuring or `@default` tag. */
+    /**
+     * The destructuring default's source text, else the `@default` tag text —
+     * verbatim author text either way (`"'primary'"`, `() => 10`), quotes
+     * included, no normalization; consumers render it as highlighted TS.
+     */
     defaultValue: z.ZodOptional<z.ZodString>;
     /** Whether the prop uses the `$bindable()` rune, enabling two-way binding. */
     bindable: z.ZodDefault<z.ZodBoolean>;
@@ -436,7 +463,10 @@ export declare const ComponentPropJson: z.ZodObject<{
      * meaningful signal, not an empty list.
      */
     parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        /** Parameter name (e.g., `options`, `...args`). */
+        /**
+         * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+         * never the name.
+         */
         name: z.ZodString;
         /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
         type: z.ZodString;
@@ -448,7 +478,11 @@ export declare const ComponentPropJson: z.ZodObject<{
         rest: z.ZodDefault<z.ZodBoolean>;
         /** Description from `@param` tag. */
         description: z.ZodOptional<z.ZodString>;
-        /** Default value expression from the source (e.g., `'hello'`, `42`). */
+        /**
+         * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+         * `() => 10`) — quotes included, no normalization; consumers render it as
+         * highlighted TS.
+         */
         defaultValue: z.ZodOptional<z.ZodString>;
         /**
          * Descriptions for properties of a named object parameter, from dotted
@@ -481,7 +515,10 @@ export declare const OverloadJson: z.ZodObject<{
     typeSignature: z.ZodString;
     /** Parameters for this overload. */
     parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        /** Parameter name (e.g., `options`, `...args`). */
+        /**
+         * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+         * never the name.
+         */
         name: z.ZodString;
         /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
         type: z.ZodString;
@@ -493,7 +530,11 @@ export declare const OverloadJson: z.ZodObject<{
         rest: z.ZodDefault<z.ZodBoolean>;
         /** Description from `@param` tag. */
         description: z.ZodOptional<z.ZodString>;
-        /** Default value expression from the source (e.g., `'hello'`, `42`). */
+        /**
+         * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+         * `() => 10`) — quotes included, no normalization; consumers render it as
+         * highlighted TS.
+         */
         defaultValue: z.ZodOptional<z.ZodString>;
         /**
          * Descriptions for properties of a named object parameter, from dotted
@@ -539,8 +580,7 @@ export type OverloadJsonInput = z.input<typeof OverloadJson>;
  * and properties/accessors (`'variable'`). Interface/type properties use the same kinds
  * for property signatures, method signatures, index signatures, and call/construct signatures.
  *
- * Top-level-only kinds (`'class'`, `'interface'`, `'type'`, `'enum'`, `'component'`) never
- * appear as members — nesting is exactly one level deep.
+ * Every other `DeclarationKind` is top-level only; nesting is exactly one level deep.
  */
 export declare const MemberKind: z.ZodEnum<{
     function: "function";
@@ -553,9 +593,8 @@ export type MemberKind = z.infer<typeof MemberKind>;
  * Has `parameters`, `returnType`, `returnDescription`, `overloads`.
  *
  * `optional` reflects a `?` token on the declaration (e.g., `foo?(): void`
- * on an interface or type literal). Always `false` for index/call/construct
- * signatures and for class methods (TypeScript disallows optional methods on
- * classes).
+ * on an interface or type literal, or `m?(): void {}` on a class). Always
+ * `false` for index/call/construct signatures.
  *
  * `name` is the user-chosen method/property identifier, except for call
  * signatures on interfaces and type aliases where it is the literal sentinel
@@ -573,15 +612,19 @@ export declare const FunctionMemberJson: z.ZodObject<{
     /**
      * Default value documented via `@default` — for a callable member,
      * typically the behavior used when the callback is omitted. Always
-     * tag-authored (structural containers have no initializers). Members only:
-     * top-level function declarations and overloads never carry one.
+     * tag-authored (structural containers have no initializers), verbatim with
+     * no normalization. Members only: top-level function declarations and
+     * overloads never carry one.
      */
     defaultValue: z.ZodOptional<z.ZodString>;
     returnType: z.ZodOptional<z.ZodString>;
     returnTypeInfo: z.ZodOptional<z.ZodType<TypeJson, TypeJson, z.core.$ZodTypeInternals<TypeJson, TypeJson>>>;
     returnDescription: z.ZodOptional<z.ZodString>;
     parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        /** Parameter name (e.g., `options`, `...args`). */
+        /**
+         * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+         * never the name.
+         */
         name: z.ZodString;
         /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
         type: z.ZodString;
@@ -593,7 +636,11 @@ export declare const FunctionMemberJson: z.ZodObject<{
         rest: z.ZodDefault<z.ZodBoolean>;
         /** Description from `@param` tag. */
         description: z.ZodOptional<z.ZodString>;
-        /** Default value expression from the source (e.g., `'hello'`, `42`). */
+        /**
+         * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+         * `() => 10`) — quotes included, no normalization; consumers render it as
+         * highlighted TS.
+         */
         defaultValue: z.ZodOptional<z.ZodString>;
         /**
          * Descriptions for properties of a named object parameter, from dotted
@@ -617,7 +664,10 @@ export declare const FunctionMemberJson: z.ZodObject<{
         typeSignature: z.ZodString;
         /** Parameters for this overload. */
         parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** Parameter name (e.g., `options`, `...args`). */
+            /**
+             * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+             * never the name.
+             */
             name: z.ZodString;
             /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
             type: z.ZodString;
@@ -629,7 +679,11 @@ export declare const FunctionMemberJson: z.ZodObject<{
             rest: z.ZodDefault<z.ZodBoolean>;
             /** Description from `@param` tag. */
             description: z.ZodOptional<z.ZodString>;
-            /** Default value expression from the source (e.g., `'hello'`, `42`). */
+            /**
+             * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+             * `() => 10`) — quotes included, no normalization; consumers render it as
+             * highlighted TS.
+             */
             defaultValue: z.ZodOptional<z.ZodString>;
             /**
              * Descriptions for properties of a named object parameter, from dotted
@@ -718,7 +772,11 @@ export declare const VariableMemberJson: z.ZodObject<{
         $derived: "$derived";
         "$derived.by": "$derived.by";
     }>>;
-    /** Default value documented via `@default`. Authoritative initializer (when human-readable) is in `typeSignature`. */
+    /**
+     * Default value documented via `@default`, verbatim tag text with no
+     * normalization. Initializers aren't captured — a class field's
+     * `typeSignature` is its checker type, not its initializer.
+     */
     defaultValue: z.ZodOptional<z.ZodString>;
     /**
      * Structured type; absent when `typeSignature` is the whole story (see
@@ -779,7 +837,10 @@ export declare const ConstructorMemberJson: z.ZodObject<{
     kind: z.ZodLiteral<"constructor">;
     name: z.ZodUnion<readonly [z.ZodLiteral<"constructor">, z.ZodLiteral<"(construct)">]>;
     parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        /** Parameter name (e.g., `options`, `...args`). */
+        /**
+         * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+         * never the name.
+         */
         name: z.ZodString;
         /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
         type: z.ZodString;
@@ -791,7 +852,11 @@ export declare const ConstructorMemberJson: z.ZodObject<{
         rest: z.ZodDefault<z.ZodBoolean>;
         /** Description from `@param` tag. */
         description: z.ZodOptional<z.ZodString>;
-        /** Default value expression from the source (e.g., `'hello'`, `42`). */
+        /**
+         * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+         * `() => 10`) — quotes included, no normalization; consumers render it as
+         * highlighted TS.
+         */
         defaultValue: z.ZodOptional<z.ZodString>;
         /**
          * Descriptions for properties of a named object parameter, from dotted
@@ -815,7 +880,10 @@ export declare const ConstructorMemberJson: z.ZodObject<{
         typeSignature: z.ZodString;
         /** Parameters for this overload. */
         parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** Parameter name (e.g., `options`, `...args`). */
+            /**
+             * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+             * never the name.
+             */
             name: z.ZodString;
             /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
             type: z.ZodString;
@@ -827,7 +895,11 @@ export declare const ConstructorMemberJson: z.ZodObject<{
             rest: z.ZodDefault<z.ZodBoolean>;
             /** Description from `@param` tag. */
             description: z.ZodOptional<z.ZodString>;
-            /** Default value expression from the source (e.g., `'hello'`, `42`). */
+            /**
+             * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+             * `() => 10`) — quotes included, no normalization; consumers render it as
+             * highlighted TS.
+             */
             defaultValue: z.ZodOptional<z.ZodString>;
             /**
              * Descriptions for properties of a named object parameter, from dotted
@@ -923,7 +995,10 @@ export declare const FunctionDeclarationJson: z.ZodObject<{
     returnTypeInfo: z.ZodOptional<z.ZodType<TypeJson, TypeJson, z.core.$ZodTypeInternals<TypeJson, TypeJson>>>;
     returnDescription: z.ZodOptional<z.ZodString>;
     parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        /** Parameter name (e.g., `options`, `...args`). */
+        /**
+         * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+         * never the name.
+         */
         name: z.ZodString;
         /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
         type: z.ZodString;
@@ -935,7 +1010,11 @@ export declare const FunctionDeclarationJson: z.ZodObject<{
         rest: z.ZodDefault<z.ZodBoolean>;
         /** Description from `@param` tag. */
         description: z.ZodOptional<z.ZodString>;
-        /** Default value expression from the source (e.g., `'hello'`, `42`). */
+        /**
+         * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+         * `() => 10`) — quotes included, no normalization; consumers render it as
+         * highlighted TS.
+         */
         defaultValue: z.ZodOptional<z.ZodString>;
         /**
          * Descriptions for properties of a named object parameter, from dotted
@@ -959,7 +1038,10 @@ export declare const FunctionDeclarationJson: z.ZodObject<{
         typeSignature: z.ZodString;
         /** Parameters for this overload. */
         parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** Parameter name (e.g., `options`, `...args`). */
+            /**
+             * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+             * never the name.
+             */
             name: z.ZodString;
             /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
             type: z.ZodString;
@@ -971,7 +1053,11 @@ export declare const FunctionDeclarationJson: z.ZodObject<{
             rest: z.ZodDefault<z.ZodBoolean>;
             /** Description from `@param` tag. */
             description: z.ZodOptional<z.ZodString>;
-            /** Default value expression from the source (e.g., `'hello'`, `42`). */
+            /**
+             * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+             * `() => 10`) — quotes included, no normalization; consumers render it as
+             * highlighted TS.
+             */
             defaultValue: z.ZodOptional<z.ZodString>;
             /**
              * Descriptions for properties of a named object parameter, from dotted
@@ -1081,13 +1167,17 @@ export declare const ClassDeclarationJson: z.ZodObject<{
      *
      * Entry normalization (rename resolution, type-parameter substitution,
      * text-dedupe, source order) matches `TypeDeclarationJson.externalTypes`.
+     * A direct external base makes this textually equal to `extends`;
+     * consumers dedupe at render time.
      */
     externalTypes: z.ZodDefault<z.ZodArray<z.ZodString>>;
     /** Implemented interfaces. */
     implements: z.ZodDefault<z.ZodArray<z.ZodString>>;
     /**
      * Class members: methods, properties, constructors, getters/setters — own
-     * members only, inherited members excluded whatever their origin.
+     * members only, inherited members excluded whatever their origin. Source
+     * order, except accessors (getter/setter pairs merged by name), which follow
+     * every other member.
      */
     members: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"function">;
@@ -1101,15 +1191,19 @@ export declare const ClassDeclarationJson: z.ZodObject<{
         /**
          * Default value documented via `@default` — for a callable member,
          * typically the behavior used when the callback is omitted. Always
-         * tag-authored (structural containers have no initializers). Members only:
-         * top-level function declarations and overloads never carry one.
+         * tag-authored (structural containers have no initializers), verbatim with
+         * no normalization. Members only: top-level function declarations and
+         * overloads never carry one.
          */
         defaultValue: z.ZodOptional<z.ZodString>;
         returnType: z.ZodOptional<z.ZodString>;
         returnTypeInfo: z.ZodOptional<z.ZodType<TypeJson, TypeJson, z.core.$ZodTypeInternals<TypeJson, TypeJson>>>;
         returnDescription: z.ZodOptional<z.ZodString>;
         parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** Parameter name (e.g., `options`, `...args`). */
+            /**
+             * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+             * never the name.
+             */
             name: z.ZodString;
             /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
             type: z.ZodString;
@@ -1121,7 +1215,11 @@ export declare const ClassDeclarationJson: z.ZodObject<{
             rest: z.ZodDefault<z.ZodBoolean>;
             /** Description from `@param` tag. */
             description: z.ZodOptional<z.ZodString>;
-            /** Default value expression from the source (e.g., `'hello'`, `42`). */
+            /**
+             * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+             * `() => 10`) — quotes included, no normalization; consumers render it as
+             * highlighted TS.
+             */
             defaultValue: z.ZodOptional<z.ZodString>;
             /**
              * Descriptions for properties of a named object parameter, from dotted
@@ -1145,7 +1243,10 @@ export declare const ClassDeclarationJson: z.ZodObject<{
             typeSignature: z.ZodString;
             /** Parameters for this overload. */
             parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                /** Parameter name (e.g., `options`, `...args`). */
+                /**
+                 * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                 * never the name.
+                 */
                 name: z.ZodString;
                 /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                 type: z.ZodString;
@@ -1157,7 +1258,11 @@ export declare const ClassDeclarationJson: z.ZodObject<{
                 rest: z.ZodDefault<z.ZodBoolean>;
                 /** Description from `@param` tag. */
                 description: z.ZodOptional<z.ZodString>;
-                /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                /**
+                 * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                 * `() => 10`) — quotes included, no normalization; consumers render it as
+                 * highlighted TS.
+                 */
                 defaultValue: z.ZodOptional<z.ZodString>;
                 /**
                  * Descriptions for properties of a named object parameter, from dotted
@@ -1236,7 +1341,11 @@ export declare const ClassDeclarationJson: z.ZodObject<{
             $derived: "$derived";
             "$derived.by": "$derived.by";
         }>>;
-        /** Default value documented via `@default`. Authoritative initializer (when human-readable) is in `typeSignature`. */
+        /**
+         * Default value documented via `@default`, verbatim tag text with no
+         * normalization. Initializers aren't captured — a class field's
+         * `typeSignature` is its checker type, not its initializer.
+         */
         defaultValue: z.ZodOptional<z.ZodString>;
         /**
          * Structured type; absent when `typeSignature` is the whole story (see
@@ -1282,7 +1391,10 @@ export declare const ClassDeclarationJson: z.ZodObject<{
         kind: z.ZodLiteral<"constructor">;
         name: z.ZodUnion<readonly [z.ZodLiteral<"constructor">, z.ZodLiteral<"(construct)">]>;
         parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** Parameter name (e.g., `options`, `...args`). */
+            /**
+             * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+             * never the name.
+             */
             name: z.ZodString;
             /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
             type: z.ZodString;
@@ -1294,7 +1406,11 @@ export declare const ClassDeclarationJson: z.ZodObject<{
             rest: z.ZodDefault<z.ZodBoolean>;
             /** Description from `@param` tag. */
             description: z.ZodOptional<z.ZodString>;
-            /** Default value expression from the source (e.g., `'hello'`, `42`). */
+            /**
+             * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+             * `() => 10`) — quotes included, no normalization; consumers render it as
+             * highlighted TS.
+             */
             defaultValue: z.ZodOptional<z.ZodString>;
             /**
              * Descriptions for properties of a named object parameter, from dotted
@@ -1318,7 +1434,10 @@ export declare const ClassDeclarationJson: z.ZodObject<{
             typeSignature: z.ZodString;
             /** Parameters for this overload. */
             parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                /** Parameter name (e.g., `options`, `...args`). */
+                /**
+                 * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                 * never the name.
+                 */
                 name: z.ZodString;
                 /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                 type: z.ZodString;
@@ -1330,7 +1449,11 @@ export declare const ClassDeclarationJson: z.ZodObject<{
                 rest: z.ZodDefault<z.ZodBoolean>;
                 /** Description from `@param` tag. */
                 description: z.ZodOptional<z.ZodString>;
-                /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                /**
+                 * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                 * `() => 10`) — quotes included, no normalization; consumers render it as
+                 * highlighted TS.
+                 */
                 defaultValue: z.ZodOptional<z.ZodString>;
                 /**
                  * Descriptions for properties of a named object parameter, from dotted
@@ -1477,13 +1600,16 @@ export declare const InterfaceDeclarationJson: z.ZodObject<{
      *
      * Entry normalization (rename resolution, type-parameter substitution,
      * text-dedupe, source order) matches `TypeDeclarationJson.externalTypes`.
+     * Direct-heritage cases make this textually equal to `extends`; consumers
+     * dedupe at render time.
      */
     externalTypes: z.ZodDefault<z.ZodArray<z.ZodString>>;
     /**
      * Interface members: property signatures, method signatures, index
      * signatures, call/construct signatures — own members only, inherited
      * members excluded whatever their origin (call/construct signatures
-     * included: a base interface's `(call)` is not enumerated here).
+     * included: a base interface's `(call)` is not enumerated here). Source
+     * order, except call/construct signatures, which come last.
      */
     members: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"function">;
@@ -1497,15 +1623,19 @@ export declare const InterfaceDeclarationJson: z.ZodObject<{
         /**
          * Default value documented via `@default` — for a callable member,
          * typically the behavior used when the callback is omitted. Always
-         * tag-authored (structural containers have no initializers). Members only:
-         * top-level function declarations and overloads never carry one.
+         * tag-authored (structural containers have no initializers), verbatim with
+         * no normalization. Members only: top-level function declarations and
+         * overloads never carry one.
          */
         defaultValue: z.ZodOptional<z.ZodString>;
         returnType: z.ZodOptional<z.ZodString>;
         returnTypeInfo: z.ZodOptional<z.ZodType<TypeJson, TypeJson, z.core.$ZodTypeInternals<TypeJson, TypeJson>>>;
         returnDescription: z.ZodOptional<z.ZodString>;
         parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** Parameter name (e.g., `options`, `...args`). */
+            /**
+             * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+             * never the name.
+             */
             name: z.ZodString;
             /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
             type: z.ZodString;
@@ -1517,7 +1647,11 @@ export declare const InterfaceDeclarationJson: z.ZodObject<{
             rest: z.ZodDefault<z.ZodBoolean>;
             /** Description from `@param` tag. */
             description: z.ZodOptional<z.ZodString>;
-            /** Default value expression from the source (e.g., `'hello'`, `42`). */
+            /**
+             * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+             * `() => 10`) — quotes included, no normalization; consumers render it as
+             * highlighted TS.
+             */
             defaultValue: z.ZodOptional<z.ZodString>;
             /**
              * Descriptions for properties of a named object parameter, from dotted
@@ -1541,7 +1675,10 @@ export declare const InterfaceDeclarationJson: z.ZodObject<{
             typeSignature: z.ZodString;
             /** Parameters for this overload. */
             parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                /** Parameter name (e.g., `options`, `...args`). */
+                /**
+                 * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                 * never the name.
+                 */
                 name: z.ZodString;
                 /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                 type: z.ZodString;
@@ -1553,7 +1690,11 @@ export declare const InterfaceDeclarationJson: z.ZodObject<{
                 rest: z.ZodDefault<z.ZodBoolean>;
                 /** Description from `@param` tag. */
                 description: z.ZodOptional<z.ZodString>;
-                /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                /**
+                 * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                 * `() => 10`) — quotes included, no normalization; consumers render it as
+                 * highlighted TS.
+                 */
                 defaultValue: z.ZodOptional<z.ZodString>;
                 /**
                  * Descriptions for properties of a named object parameter, from dotted
@@ -1632,7 +1773,11 @@ export declare const InterfaceDeclarationJson: z.ZodObject<{
             $derived: "$derived";
             "$derived.by": "$derived.by";
         }>>;
-        /** Default value documented via `@default`. Authoritative initializer (when human-readable) is in `typeSignature`. */
+        /**
+         * Default value documented via `@default`, verbatim tag text with no
+         * normalization. Initializers aren't captured — a class field's
+         * `typeSignature` is its checker type, not its initializer.
+         */
         defaultValue: z.ZodOptional<z.ZodString>;
         /**
          * Structured type; absent when `typeSignature` is the whole story (see
@@ -1678,7 +1823,10 @@ export declare const InterfaceDeclarationJson: z.ZodObject<{
         kind: z.ZodLiteral<"constructor">;
         name: z.ZodUnion<readonly [z.ZodLiteral<"constructor">, z.ZodLiteral<"(construct)">]>;
         parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** Parameter name (e.g., `options`, `...args`). */
+            /**
+             * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+             * never the name.
+             */
             name: z.ZodString;
             /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
             type: z.ZodString;
@@ -1690,7 +1838,11 @@ export declare const InterfaceDeclarationJson: z.ZodObject<{
             rest: z.ZodDefault<z.ZodBoolean>;
             /** Description from `@param` tag. */
             description: z.ZodOptional<z.ZodString>;
-            /** Default value expression from the source (e.g., `'hello'`, `42`). */
+            /**
+             * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+             * `() => 10`) — quotes included, no normalization; consumers render it as
+             * highlighted TS.
+             */
             defaultValue: z.ZodOptional<z.ZodString>;
             /**
              * Descriptions for properties of a named object parameter, from dotted
@@ -1714,7 +1866,10 @@ export declare const InterfaceDeclarationJson: z.ZodObject<{
             typeSignature: z.ZodString;
             /** Parameters for this overload. */
             parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                /** Parameter name (e.g., `options`, `...args`). */
+                /**
+                 * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                 * never the name.
+                 */
                 name: z.ZodString;
                 /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                 type: z.ZodString;
@@ -1726,7 +1881,11 @@ export declare const InterfaceDeclarationJson: z.ZodObject<{
                 rest: z.ZodDefault<z.ZodBoolean>;
                 /** Description from `@param` tag. */
                 description: z.ZodOptional<z.ZodString>;
-                /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                /**
+                 * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                 * `() => 10`) — quotes included, no normalization; consumers render it as
+                 * highlighted TS.
+                 */
                 defaultValue: z.ZodOptional<z.ZodString>;
                 /**
                  * Descriptions for properties of a named object parameter, from dotted
@@ -1900,8 +2059,8 @@ export declare const TypeDeclarationJson: z.ZodObject<{
      */
     typeInfo: z.ZodOptional<z.ZodType<TypeJson, TypeJson, z.core.$ZodTypeInternals<TypeJson, TypeJson>>>;
     /**
-     * Type members: property signatures, method signatures, index signatures,
-     * call/construct signatures.
+     * Type members: properties (property and method signatures) first, then
+     * index signatures (string, number), then call and construct signatures.
      */
     members: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"function">;
@@ -1915,15 +2074,19 @@ export declare const TypeDeclarationJson: z.ZodObject<{
         /**
          * Default value documented via `@default` — for a callable member,
          * typically the behavior used when the callback is omitted. Always
-         * tag-authored (structural containers have no initializers). Members only:
-         * top-level function declarations and overloads never carry one.
+         * tag-authored (structural containers have no initializers), verbatim with
+         * no normalization. Members only: top-level function declarations and
+         * overloads never carry one.
          */
         defaultValue: z.ZodOptional<z.ZodString>;
         returnType: z.ZodOptional<z.ZodString>;
         returnTypeInfo: z.ZodOptional<z.ZodType<TypeJson, TypeJson, z.core.$ZodTypeInternals<TypeJson, TypeJson>>>;
         returnDescription: z.ZodOptional<z.ZodString>;
         parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** Parameter name (e.g., `options`, `...args`). */
+            /**
+             * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+             * never the name.
+             */
             name: z.ZodString;
             /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
             type: z.ZodString;
@@ -1935,7 +2098,11 @@ export declare const TypeDeclarationJson: z.ZodObject<{
             rest: z.ZodDefault<z.ZodBoolean>;
             /** Description from `@param` tag. */
             description: z.ZodOptional<z.ZodString>;
-            /** Default value expression from the source (e.g., `'hello'`, `42`). */
+            /**
+             * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+             * `() => 10`) — quotes included, no normalization; consumers render it as
+             * highlighted TS.
+             */
             defaultValue: z.ZodOptional<z.ZodString>;
             /**
              * Descriptions for properties of a named object parameter, from dotted
@@ -1959,7 +2126,10 @@ export declare const TypeDeclarationJson: z.ZodObject<{
             typeSignature: z.ZodString;
             /** Parameters for this overload. */
             parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                /** Parameter name (e.g., `options`, `...args`). */
+                /**
+                 * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                 * never the name.
+                 */
                 name: z.ZodString;
                 /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                 type: z.ZodString;
@@ -1971,7 +2141,11 @@ export declare const TypeDeclarationJson: z.ZodObject<{
                 rest: z.ZodDefault<z.ZodBoolean>;
                 /** Description from `@param` tag. */
                 description: z.ZodOptional<z.ZodString>;
-                /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                /**
+                 * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                 * `() => 10`) — quotes included, no normalization; consumers render it as
+                 * highlighted TS.
+                 */
                 defaultValue: z.ZodOptional<z.ZodString>;
                 /**
                  * Descriptions for properties of a named object parameter, from dotted
@@ -2050,7 +2224,11 @@ export declare const TypeDeclarationJson: z.ZodObject<{
             $derived: "$derived";
             "$derived.by": "$derived.by";
         }>>;
-        /** Default value documented via `@default`. Authoritative initializer (when human-readable) is in `typeSignature`. */
+        /**
+         * Default value documented via `@default`, verbatim tag text with no
+         * normalization. Initializers aren't captured — a class field's
+         * `typeSignature` is its checker type, not its initializer.
+         */
         defaultValue: z.ZodOptional<z.ZodString>;
         /**
          * Structured type; absent when `typeSignature` is the whole story (see
@@ -2096,7 +2274,10 @@ export declare const TypeDeclarationJson: z.ZodObject<{
         kind: z.ZodLiteral<"constructor">;
         name: z.ZodUnion<readonly [z.ZodLiteral<"constructor">, z.ZodLiteral<"(construct)">]>;
         parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** Parameter name (e.g., `options`, `...args`). */
+            /**
+             * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+             * never the name.
+             */
             name: z.ZodString;
             /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
             type: z.ZodString;
@@ -2108,7 +2289,11 @@ export declare const TypeDeclarationJson: z.ZodObject<{
             rest: z.ZodDefault<z.ZodBoolean>;
             /** Description from `@param` tag. */
             description: z.ZodOptional<z.ZodString>;
-            /** Default value expression from the source (e.g., `'hello'`, `42`). */
+            /**
+             * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+             * `() => 10`) — quotes included, no normalization; consumers render it as
+             * highlighted TS.
+             */
             defaultValue: z.ZodOptional<z.ZodString>;
             /**
              * Descriptions for properties of a named object parameter, from dotted
@@ -2132,7 +2317,10 @@ export declare const TypeDeclarationJson: z.ZodObject<{
             typeSignature: z.ZodString;
             /** Parameters for this overload. */
             parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                /** Parameter name (e.g., `options`, `...args`). */
+                /**
+                 * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                 * never the name.
+                 */
                 name: z.ZodString;
                 /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                 type: z.ZodString;
@@ -2144,7 +2332,11 @@ export declare const TypeDeclarationJson: z.ZodObject<{
                 rest: z.ZodDefault<z.ZodBoolean>;
                 /** Description from `@param` tag. */
                 description: z.ZodOptional<z.ZodString>;
-                /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                /**
+                 * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                 * `() => 10`) — quotes included, no normalization; consumers render it as
+                 * highlighted TS.
+                 */
                 defaultValue: z.ZodOptional<z.ZodString>;
                 /**
                  * Descriptions for properties of a named object parameter, from dotted
@@ -2282,7 +2474,12 @@ export declare const VariableDeclarationJson: z.ZodObject<{
         $derived: "$derived";
         "$derived.by": "$derived.by";
     }>>;
-    /** Default value documented via `@default`. Useful when the AST initializer is opaque (a call expression, computed value) and the author wants to document the conceptual default. */
+    /**
+     * Default value documented via `@default`, verbatim tag text with no
+     * normalization. Useful when the AST initializer is opaque (a call
+     * expression, computed value) and the author wants to document the
+     * conceptual default.
+     */
     defaultValue: z.ZodOptional<z.ZodString>;
     /** Structured type; absent when `typeSignature` is the whole story (see `TypeJson`). */
     typeInfo: z.ZodOptional<z.ZodType<TypeJson, TypeJson, z.core.$ZodTypeInternals<TypeJson, TypeJson>>>;
@@ -2347,15 +2544,19 @@ export declare const EnumDeclarationJson: z.ZodObject<{
         /**
          * Default value documented via `@default` — for a callable member,
          * typically the behavior used when the callback is omitted. Always
-         * tag-authored (structural containers have no initializers). Members only:
-         * top-level function declarations and overloads never carry one.
+         * tag-authored (structural containers have no initializers), verbatim with
+         * no normalization. Members only: top-level function declarations and
+         * overloads never carry one.
          */
         defaultValue: z.ZodOptional<z.ZodString>;
         returnType: z.ZodOptional<z.ZodString>;
         returnTypeInfo: z.ZodOptional<z.ZodType<TypeJson, TypeJson, z.core.$ZodTypeInternals<TypeJson, TypeJson>>>;
         returnDescription: z.ZodOptional<z.ZodString>;
         parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** Parameter name (e.g., `options`, `...args`). */
+            /**
+             * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+             * never the name.
+             */
             name: z.ZodString;
             /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
             type: z.ZodString;
@@ -2367,7 +2568,11 @@ export declare const EnumDeclarationJson: z.ZodObject<{
             rest: z.ZodDefault<z.ZodBoolean>;
             /** Description from `@param` tag. */
             description: z.ZodOptional<z.ZodString>;
-            /** Default value expression from the source (e.g., `'hello'`, `42`). */
+            /**
+             * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+             * `() => 10`) — quotes included, no normalization; consumers render it as
+             * highlighted TS.
+             */
             defaultValue: z.ZodOptional<z.ZodString>;
             /**
              * Descriptions for properties of a named object parameter, from dotted
@@ -2391,7 +2596,10 @@ export declare const EnumDeclarationJson: z.ZodObject<{
             typeSignature: z.ZodString;
             /** Parameters for this overload. */
             parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                /** Parameter name (e.g., `options`, `...args`). */
+                /**
+                 * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                 * never the name.
+                 */
                 name: z.ZodString;
                 /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                 type: z.ZodString;
@@ -2403,7 +2611,11 @@ export declare const EnumDeclarationJson: z.ZodObject<{
                 rest: z.ZodDefault<z.ZodBoolean>;
                 /** Description from `@param` tag. */
                 description: z.ZodOptional<z.ZodString>;
-                /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                /**
+                 * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                 * `() => 10`) — quotes included, no normalization; consumers render it as
+                 * highlighted TS.
+                 */
                 defaultValue: z.ZodOptional<z.ZodString>;
                 /**
                  * Descriptions for properties of a named object parameter, from dotted
@@ -2482,7 +2694,11 @@ export declare const EnumDeclarationJson: z.ZodObject<{
             $derived: "$derived";
             "$derived.by": "$derived.by";
         }>>;
-        /** Default value documented via `@default`. Authoritative initializer (when human-readable) is in `typeSignature`. */
+        /**
+         * Default value documented via `@default`, verbatim tag text with no
+         * normalization. Initializers aren't captured — a class field's
+         * `typeSignature` is its checker type, not its initializer.
+         */
         defaultValue: z.ZodOptional<z.ZodString>;
         /**
          * Structured type; absent when `typeSignature` is the whole story (see
@@ -2528,7 +2744,10 @@ export declare const EnumDeclarationJson: z.ZodObject<{
         kind: z.ZodLiteral<"constructor">;
         name: z.ZodUnion<readonly [z.ZodLiteral<"constructor">, z.ZodLiteral<"(construct)">]>;
         parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** Parameter name (e.g., `options`, `...args`). */
+            /**
+             * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+             * never the name.
+             */
             name: z.ZodString;
             /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
             type: z.ZodString;
@@ -2540,7 +2759,11 @@ export declare const EnumDeclarationJson: z.ZodObject<{
             rest: z.ZodDefault<z.ZodBoolean>;
             /** Description from `@param` tag. */
             description: z.ZodOptional<z.ZodString>;
-            /** Default value expression from the source (e.g., `'hello'`, `42`). */
+            /**
+             * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+             * `() => 10`) — quotes included, no normalization; consumers render it as
+             * highlighted TS.
+             */
             defaultValue: z.ZodOptional<z.ZodString>;
             /**
              * Descriptions for properties of a named object parameter, from dotted
@@ -2564,7 +2787,10 @@ export declare const EnumDeclarationJson: z.ZodObject<{
             typeSignature: z.ZodString;
             /** Parameters for this overload. */
             parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                /** Parameter name (e.g., `options`, `...args`). */
+                /**
+                 * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                 * never the name.
+                 */
                 name: z.ZodString;
                 /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                 type: z.ZodString;
@@ -2576,7 +2802,11 @@ export declare const EnumDeclarationJson: z.ZodObject<{
                 rest: z.ZodDefault<z.ZodBoolean>;
                 /** Description from `@param` tag. */
                 description: z.ZodOptional<z.ZodString>;
-                /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                /**
+                 * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                 * `() => 10`) — quotes included, no normalization; consumers render it as
+                 * highlighted TS.
+                 */
                 defaultValue: z.ZodOptional<z.ZodString>;
                 /**
                  * Descriptions for properties of a named object parameter, from dotted
@@ -2718,7 +2948,9 @@ export declare const ComponentDeclarationJson: z.ZodObject<{
      *   interface itself. Field shapes mirror TS syntax.
      */
     externalTypes: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    /** Svelte component props. */
+    /**
+     * Svelte component props, in source order.
+     */
     props: z.ZodDefault<z.ZodArray<z.ZodObject<{
         examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
         deprecatedMessage: z.ZodOptional<z.ZodString>;
@@ -2738,7 +2970,11 @@ export declare const ComponentDeclarationJson: z.ZodObject<{
         optional: z.ZodDefault<z.ZodBoolean>;
         /** Description from JSDoc on the prop's type declaration. */
         description: z.ZodOptional<z.ZodString>;
-        /** Default value expression from destructuring or `@default` tag. */
+        /**
+         * The destructuring default's source text, else the `@default` tag text —
+         * verbatim author text either way (`"'primary'"`, `() => 10`), quotes
+         * included, no normalization; consumers render it as highlighted TS.
+         */
         defaultValue: z.ZodOptional<z.ZodString>;
         /** Whether the prop uses the `$bindable()` rune, enabling two-way binding. */
         bindable: z.ZodDefault<z.ZodBoolean>;
@@ -2752,7 +2988,10 @@ export declare const ComponentDeclarationJson: z.ZodObject<{
          * meaningful signal, not an empty list.
          */
         parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            /** Parameter name (e.g., `options`, `...args`). */
+            /**
+             * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+             * never the name.
+             */
             name: z.ZodString;
             /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
             type: z.ZodString;
@@ -2764,7 +3003,11 @@ export declare const ComponentDeclarationJson: z.ZodObject<{
             rest: z.ZodDefault<z.ZodBoolean>;
             /** Description from `@param` tag. */
             description: z.ZodOptional<z.ZodString>;
-            /** Default value expression from the source (e.g., `'hello'`, `42`). */
+            /**
+             * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+             * `() => 10`) — quotes included, no normalization; consumers render it as
+             * highlighted TS.
+             */
             defaultValue: z.ZodOptional<z.ZodString>;
             /**
              * Descriptions for properties of a named object parameter, from dotted
@@ -2840,7 +3083,10 @@ export declare const SnippetDeclarationJson: z.ZodObject<{
     kind: z.ZodLiteral<"snippet">;
     /** Snippet parameters. */
     parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        /** Parameter name (e.g., `options`, `...args`). */
+        /**
+         * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+         * never the name.
+         */
         name: z.ZodString;
         /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
         type: z.ZodString;
@@ -2852,7 +3098,11 @@ export declare const SnippetDeclarationJson: z.ZodObject<{
         rest: z.ZodDefault<z.ZodBoolean>;
         /** Description from `@param` tag. */
         description: z.ZodOptional<z.ZodString>;
-        /** Default value expression from the source (e.g., `'hello'`, `42`). */
+        /**
+         * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+         * `() => 10`) — quotes included, no normalization; consumers render it as
+         * highlighted TS.
+         */
         defaultValue: z.ZodOptional<z.ZodString>;
         /**
          * Descriptions for properties of a named object parameter, from dotted
@@ -3036,7 +3286,8 @@ export declare const ReExportJson: z.ZodObject<{
     /**
      * Whether the statement (`export type {A} from ...`) or specifier
      * (`export {type A} from ...`) is type-only — the name is erased at
-     * runtime and importable only via `import type`.
+     * runtime and importable only via `import type`. A type-only *rename*
+     * carries no such marker (see `aliasOf`).
      */
     typeOnly: z.ZodDefault<z.ZodBoolean>;
     /**
@@ -3049,9 +3300,11 @@ export declare const ReExportJson: z.ZodObject<{
 export type ReExportJson = z.infer<typeof ReExportJson>;
 export type ReExportJsonInput = z.input<typeof ReExportJson>;
 /**
- * A re-export whose immediate target is outside the analyzed source set —
+ * A re-export whose immediate target is an external package —
  * `export {x} from 'pkg'`, `export {x as y} from 'pkg'`, or
- * `export * as ns from 'pkg'`.
+ * `export * as ns from 'pkg'`. External is per `createIsExternalPath`; a
+ * project-local target excluded from output (the `internal/` convention) is
+ * not external, and its re-exports synthesize alias declarations instead.
  *
  * `specifier` is the module specifier as written (usually a package name);
  * there is no canonical declaration to resolve, so these entries are flat
@@ -3060,8 +3313,9 @@ export type ReExportJsonInput = z.input<typeof ReExportJson>;
  * Only statements that *directly* reference the external specifier are
  * captured. Forms that stay silent: `import {x} from 'pkg'; export {x};`
  * (import-then-export), re-export chains that reach a package through
- * another source module (that module owns the entry), and specifiers the
- * checker can't resolve. Statement-level `@nodocs` suppresses the entry.
+ * another source module (that module owns the entry) or through a
+ * project-local gated module, and specifiers the checker can't resolve.
+ * Statement-level `@nodocs` suppresses the entry.
  */
 export declare const ExternalReExportJson: z.ZodObject<{
     /** Public exported name from this module. */
@@ -3084,7 +3338,8 @@ export type ExternalReExportJsonInput = z.input<typeof ExternalReExportJson>;
 /**
  * Metadata for a source module — the top-level container in the data model.
  *
- * `analyze` and `analyzeFromFiles` return `Array<ModuleJson>` sorted alphabetically by `path`.
+ * `analyze`, `analyzeFromFiles`, and `AnalysisSession.query` return `AnalyzeResultJson`,
+ * whose `modules` is sorted by `path` (`compareStrings`).
  * Each module contains its exported `declarations`, dependency graph, and optional `moduleComment`.
  */
 export declare const ModuleJson: z.ZodObject<{
@@ -3103,7 +3358,10 @@ export declare const ModuleJson: z.ZodObject<{
         returnTypeInfo: z.ZodOptional<z.ZodType<TypeJson, TypeJson, z.core.$ZodTypeInternals<TypeJson, TypeJson>>>;
         returnDescription: z.ZodOptional<z.ZodString>;
         parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** Parameter name (e.g., `options`, `...args`). */
+            /**
+             * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+             * never the name.
+             */
             name: z.ZodString;
             /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
             type: z.ZodString;
@@ -3115,7 +3373,11 @@ export declare const ModuleJson: z.ZodObject<{
             rest: z.ZodDefault<z.ZodBoolean>;
             /** Description from `@param` tag. */
             description: z.ZodOptional<z.ZodString>;
-            /** Default value expression from the source (e.g., `'hello'`, `42`). */
+            /**
+             * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+             * `() => 10`) — quotes included, no normalization; consumers render it as
+             * highlighted TS.
+             */
             defaultValue: z.ZodOptional<z.ZodString>;
             /**
              * Descriptions for properties of a named object parameter, from dotted
@@ -3139,7 +3401,10 @@ export declare const ModuleJson: z.ZodObject<{
             typeSignature: z.ZodString;
             /** Parameters for this overload. */
             parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                /** Parameter name (e.g., `options`, `...args`). */
+                /**
+                 * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                 * never the name.
+                 */
                 name: z.ZodString;
                 /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                 type: z.ZodString;
@@ -3151,7 +3416,11 @@ export declare const ModuleJson: z.ZodObject<{
                 rest: z.ZodDefault<z.ZodBoolean>;
                 /** Description from `@param` tag. */
                 description: z.ZodOptional<z.ZodString>;
-                /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                /**
+                 * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                 * `() => 10`) — quotes included, no normalization; consumers render it as
+                 * highlighted TS.
+                 */
                 defaultValue: z.ZodOptional<z.ZodString>;
                 /**
                  * Descriptions for properties of a named object parameter, from dotted
@@ -3258,13 +3527,17 @@ export declare const ModuleJson: z.ZodObject<{
          *
          * Entry normalization (rename resolution, type-parameter substitution,
          * text-dedupe, source order) matches `TypeDeclarationJson.externalTypes`.
+         * A direct external base makes this textually equal to `extends`;
+         * consumers dedupe at render time.
          */
         externalTypes: z.ZodDefault<z.ZodArray<z.ZodString>>;
         /** Implemented interfaces. */
         implements: z.ZodDefault<z.ZodArray<z.ZodString>>;
         /**
          * Class members: methods, properties, constructors, getters/setters — own
-         * members only, inherited members excluded whatever their origin.
+         * members only, inherited members excluded whatever their origin. Source
+         * order, except accessors (getter/setter pairs merged by name), which follow
+         * every other member.
          */
         members: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"function">;
@@ -3278,15 +3551,19 @@ export declare const ModuleJson: z.ZodObject<{
             /**
              * Default value documented via `@default` — for a callable member,
              * typically the behavior used when the callback is omitted. Always
-             * tag-authored (structural containers have no initializers). Members only:
-             * top-level function declarations and overloads never carry one.
+             * tag-authored (structural containers have no initializers), verbatim with
+             * no normalization. Members only: top-level function declarations and
+             * overloads never carry one.
              */
             defaultValue: z.ZodOptional<z.ZodString>;
             returnType: z.ZodOptional<z.ZodString>;
             returnTypeInfo: z.ZodOptional<z.ZodType<TypeJson, TypeJson, z.core.$ZodTypeInternals<TypeJson, TypeJson>>>;
             returnDescription: z.ZodOptional<z.ZodString>;
             parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                /** Parameter name (e.g., `options`, `...args`). */
+                /**
+                 * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                 * never the name.
+                 */
                 name: z.ZodString;
                 /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                 type: z.ZodString;
@@ -3298,7 +3575,11 @@ export declare const ModuleJson: z.ZodObject<{
                 rest: z.ZodDefault<z.ZodBoolean>;
                 /** Description from `@param` tag. */
                 description: z.ZodOptional<z.ZodString>;
-                /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                /**
+                 * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                 * `() => 10`) — quotes included, no normalization; consumers render it as
+                 * highlighted TS.
+                 */
                 defaultValue: z.ZodOptional<z.ZodString>;
                 /**
                  * Descriptions for properties of a named object parameter, from dotted
@@ -3322,7 +3603,10 @@ export declare const ModuleJson: z.ZodObject<{
                 typeSignature: z.ZodString;
                 /** Parameters for this overload. */
                 parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                    /** Parameter name (e.g., `options`, `...args`). */
+                    /**
+                     * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                     * never the name.
+                     */
                     name: z.ZodString;
                     /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                     type: z.ZodString;
@@ -3334,7 +3618,11 @@ export declare const ModuleJson: z.ZodObject<{
                     rest: z.ZodDefault<z.ZodBoolean>;
                     /** Description from `@param` tag. */
                     description: z.ZodOptional<z.ZodString>;
-                    /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                    /**
+                     * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                     * `() => 10`) — quotes included, no normalization; consumers render it as
+                     * highlighted TS.
+                     */
                     defaultValue: z.ZodOptional<z.ZodString>;
                     /**
                      * Descriptions for properties of a named object parameter, from dotted
@@ -3413,7 +3701,11 @@ export declare const ModuleJson: z.ZodObject<{
                 $derived: "$derived";
                 "$derived.by": "$derived.by";
             }>>;
-            /** Default value documented via `@default`. Authoritative initializer (when human-readable) is in `typeSignature`. */
+            /**
+             * Default value documented via `@default`, verbatim tag text with no
+             * normalization. Initializers aren't captured — a class field's
+             * `typeSignature` is its checker type, not its initializer.
+             */
             defaultValue: z.ZodOptional<z.ZodString>;
             /**
              * Structured type; absent when `typeSignature` is the whole story (see
@@ -3459,7 +3751,10 @@ export declare const ModuleJson: z.ZodObject<{
             kind: z.ZodLiteral<"constructor">;
             name: z.ZodUnion<readonly [z.ZodLiteral<"constructor">, z.ZodLiteral<"(construct)">]>;
             parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                /** Parameter name (e.g., `options`, `...args`). */
+                /**
+                 * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                 * never the name.
+                 */
                 name: z.ZodString;
                 /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                 type: z.ZodString;
@@ -3471,7 +3766,11 @@ export declare const ModuleJson: z.ZodObject<{
                 rest: z.ZodDefault<z.ZodBoolean>;
                 /** Description from `@param` tag. */
                 description: z.ZodOptional<z.ZodString>;
-                /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                /**
+                 * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                 * `() => 10`) — quotes included, no normalization; consumers render it as
+                 * highlighted TS.
+                 */
                 defaultValue: z.ZodOptional<z.ZodString>;
                 /**
                  * Descriptions for properties of a named object parameter, from dotted
@@ -3495,7 +3794,10 @@ export declare const ModuleJson: z.ZodObject<{
                 typeSignature: z.ZodString;
                 /** Parameters for this overload. */
                 parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                    /** Parameter name (e.g., `options`, `...args`). */
+                    /**
+                     * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                     * never the name.
+                     */
                     name: z.ZodString;
                     /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                     type: z.ZodString;
@@ -3507,7 +3809,11 @@ export declare const ModuleJson: z.ZodObject<{
                     rest: z.ZodDefault<z.ZodBoolean>;
                     /** Description from `@param` tag. */
                     description: z.ZodOptional<z.ZodString>;
-                    /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                    /**
+                     * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                     * `() => 10`) — quotes included, no normalization; consumers render it as
+                     * highlighted TS.
+                     */
                     defaultValue: z.ZodOptional<z.ZodString>;
                     /**
                      * Descriptions for properties of a named object parameter, from dotted
@@ -3651,13 +3957,16 @@ export declare const ModuleJson: z.ZodObject<{
          *
          * Entry normalization (rename resolution, type-parameter substitution,
          * text-dedupe, source order) matches `TypeDeclarationJson.externalTypes`.
+         * Direct-heritage cases make this textually equal to `extends`; consumers
+         * dedupe at render time.
          */
         externalTypes: z.ZodDefault<z.ZodArray<z.ZodString>>;
         /**
          * Interface members: property signatures, method signatures, index
          * signatures, call/construct signatures — own members only, inherited
          * members excluded whatever their origin (call/construct signatures
-         * included: a base interface's `(call)` is not enumerated here).
+         * included: a base interface's `(call)` is not enumerated here). Source
+         * order, except call/construct signatures, which come last.
          */
         members: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"function">;
@@ -3671,15 +3980,19 @@ export declare const ModuleJson: z.ZodObject<{
             /**
              * Default value documented via `@default` — for a callable member,
              * typically the behavior used when the callback is omitted. Always
-             * tag-authored (structural containers have no initializers). Members only:
-             * top-level function declarations and overloads never carry one.
+             * tag-authored (structural containers have no initializers), verbatim with
+             * no normalization. Members only: top-level function declarations and
+             * overloads never carry one.
              */
             defaultValue: z.ZodOptional<z.ZodString>;
             returnType: z.ZodOptional<z.ZodString>;
             returnTypeInfo: z.ZodOptional<z.ZodType<TypeJson, TypeJson, z.core.$ZodTypeInternals<TypeJson, TypeJson>>>;
             returnDescription: z.ZodOptional<z.ZodString>;
             parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                /** Parameter name (e.g., `options`, `...args`). */
+                /**
+                 * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                 * never the name.
+                 */
                 name: z.ZodString;
                 /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                 type: z.ZodString;
@@ -3691,7 +4004,11 @@ export declare const ModuleJson: z.ZodObject<{
                 rest: z.ZodDefault<z.ZodBoolean>;
                 /** Description from `@param` tag. */
                 description: z.ZodOptional<z.ZodString>;
-                /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                /**
+                 * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                 * `() => 10`) — quotes included, no normalization; consumers render it as
+                 * highlighted TS.
+                 */
                 defaultValue: z.ZodOptional<z.ZodString>;
                 /**
                  * Descriptions for properties of a named object parameter, from dotted
@@ -3715,7 +4032,10 @@ export declare const ModuleJson: z.ZodObject<{
                 typeSignature: z.ZodString;
                 /** Parameters for this overload. */
                 parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                    /** Parameter name (e.g., `options`, `...args`). */
+                    /**
+                     * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                     * never the name.
+                     */
                     name: z.ZodString;
                     /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                     type: z.ZodString;
@@ -3727,7 +4047,11 @@ export declare const ModuleJson: z.ZodObject<{
                     rest: z.ZodDefault<z.ZodBoolean>;
                     /** Description from `@param` tag. */
                     description: z.ZodOptional<z.ZodString>;
-                    /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                    /**
+                     * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                     * `() => 10`) — quotes included, no normalization; consumers render it as
+                     * highlighted TS.
+                     */
                     defaultValue: z.ZodOptional<z.ZodString>;
                     /**
                      * Descriptions for properties of a named object parameter, from dotted
@@ -3806,7 +4130,11 @@ export declare const ModuleJson: z.ZodObject<{
                 $derived: "$derived";
                 "$derived.by": "$derived.by";
             }>>;
-            /** Default value documented via `@default`. Authoritative initializer (when human-readable) is in `typeSignature`. */
+            /**
+             * Default value documented via `@default`, verbatim tag text with no
+             * normalization. Initializers aren't captured — a class field's
+             * `typeSignature` is its checker type, not its initializer.
+             */
             defaultValue: z.ZodOptional<z.ZodString>;
             /**
              * Structured type; absent when `typeSignature` is the whole story (see
@@ -3852,7 +4180,10 @@ export declare const ModuleJson: z.ZodObject<{
             kind: z.ZodLiteral<"constructor">;
             name: z.ZodUnion<readonly [z.ZodLiteral<"constructor">, z.ZodLiteral<"(construct)">]>;
             parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                /** Parameter name (e.g., `options`, `...args`). */
+                /**
+                 * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                 * never the name.
+                 */
                 name: z.ZodString;
                 /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                 type: z.ZodString;
@@ -3864,7 +4195,11 @@ export declare const ModuleJson: z.ZodObject<{
                 rest: z.ZodDefault<z.ZodBoolean>;
                 /** Description from `@param` tag. */
                 description: z.ZodOptional<z.ZodString>;
-                /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                /**
+                 * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                 * `() => 10`) — quotes included, no normalization; consumers render it as
+                 * highlighted TS.
+                 */
                 defaultValue: z.ZodOptional<z.ZodString>;
                 /**
                  * Descriptions for properties of a named object parameter, from dotted
@@ -3888,7 +4223,10 @@ export declare const ModuleJson: z.ZodObject<{
                 typeSignature: z.ZodString;
                 /** Parameters for this overload. */
                 parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                    /** Parameter name (e.g., `options`, `...args`). */
+                    /**
+                     * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                     * never the name.
+                     */
                     name: z.ZodString;
                     /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                     type: z.ZodString;
@@ -3900,7 +4238,11 @@ export declare const ModuleJson: z.ZodObject<{
                     rest: z.ZodDefault<z.ZodBoolean>;
                     /** Description from `@param` tag. */
                     description: z.ZodOptional<z.ZodString>;
-                    /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                    /**
+                     * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                     * `() => 10`) — quotes included, no normalization; consumers render it as
+                     * highlighted TS.
+                     */
                     defaultValue: z.ZodOptional<z.ZodString>;
                     /**
                      * Descriptions for properties of a named object parameter, from dotted
@@ -4071,8 +4413,8 @@ export declare const ModuleJson: z.ZodObject<{
          */
         typeInfo: z.ZodOptional<z.ZodType<TypeJson, TypeJson, z.core.$ZodTypeInternals<TypeJson, TypeJson>>>;
         /**
-         * Type members: property signatures, method signatures, index signatures,
-         * call/construct signatures.
+         * Type members: properties (property and method signatures) first, then
+         * index signatures (string, number), then call and construct signatures.
          */
         members: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"function">;
@@ -4086,15 +4428,19 @@ export declare const ModuleJson: z.ZodObject<{
             /**
              * Default value documented via `@default` — for a callable member,
              * typically the behavior used when the callback is omitted. Always
-             * tag-authored (structural containers have no initializers). Members only:
-             * top-level function declarations and overloads never carry one.
+             * tag-authored (structural containers have no initializers), verbatim with
+             * no normalization. Members only: top-level function declarations and
+             * overloads never carry one.
              */
             defaultValue: z.ZodOptional<z.ZodString>;
             returnType: z.ZodOptional<z.ZodString>;
             returnTypeInfo: z.ZodOptional<z.ZodType<TypeJson, TypeJson, z.core.$ZodTypeInternals<TypeJson, TypeJson>>>;
             returnDescription: z.ZodOptional<z.ZodString>;
             parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                /** Parameter name (e.g., `options`, `...args`). */
+                /**
+                 * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                 * never the name.
+                 */
                 name: z.ZodString;
                 /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                 type: z.ZodString;
@@ -4106,7 +4452,11 @@ export declare const ModuleJson: z.ZodObject<{
                 rest: z.ZodDefault<z.ZodBoolean>;
                 /** Description from `@param` tag. */
                 description: z.ZodOptional<z.ZodString>;
-                /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                /**
+                 * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                 * `() => 10`) — quotes included, no normalization; consumers render it as
+                 * highlighted TS.
+                 */
                 defaultValue: z.ZodOptional<z.ZodString>;
                 /**
                  * Descriptions for properties of a named object parameter, from dotted
@@ -4130,7 +4480,10 @@ export declare const ModuleJson: z.ZodObject<{
                 typeSignature: z.ZodString;
                 /** Parameters for this overload. */
                 parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                    /** Parameter name (e.g., `options`, `...args`). */
+                    /**
+                     * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                     * never the name.
+                     */
                     name: z.ZodString;
                     /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                     type: z.ZodString;
@@ -4142,7 +4495,11 @@ export declare const ModuleJson: z.ZodObject<{
                     rest: z.ZodDefault<z.ZodBoolean>;
                     /** Description from `@param` tag. */
                     description: z.ZodOptional<z.ZodString>;
-                    /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                    /**
+                     * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                     * `() => 10`) — quotes included, no normalization; consumers render it as
+                     * highlighted TS.
+                     */
                     defaultValue: z.ZodOptional<z.ZodString>;
                     /**
                      * Descriptions for properties of a named object parameter, from dotted
@@ -4221,7 +4578,11 @@ export declare const ModuleJson: z.ZodObject<{
                 $derived: "$derived";
                 "$derived.by": "$derived.by";
             }>>;
-            /** Default value documented via `@default`. Authoritative initializer (when human-readable) is in `typeSignature`. */
+            /**
+             * Default value documented via `@default`, verbatim tag text with no
+             * normalization. Initializers aren't captured — a class field's
+             * `typeSignature` is its checker type, not its initializer.
+             */
             defaultValue: z.ZodOptional<z.ZodString>;
             /**
              * Structured type; absent when `typeSignature` is the whole story (see
@@ -4267,7 +4628,10 @@ export declare const ModuleJson: z.ZodObject<{
             kind: z.ZodLiteral<"constructor">;
             name: z.ZodUnion<readonly [z.ZodLiteral<"constructor">, z.ZodLiteral<"(construct)">]>;
             parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                /** Parameter name (e.g., `options`, `...args`). */
+                /**
+                 * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                 * never the name.
+                 */
                 name: z.ZodString;
                 /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                 type: z.ZodString;
@@ -4279,7 +4643,11 @@ export declare const ModuleJson: z.ZodObject<{
                 rest: z.ZodDefault<z.ZodBoolean>;
                 /** Description from `@param` tag. */
                 description: z.ZodOptional<z.ZodString>;
-                /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                /**
+                 * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                 * `() => 10`) — quotes included, no normalization; consumers render it as
+                 * highlighted TS.
+                 */
                 defaultValue: z.ZodOptional<z.ZodString>;
                 /**
                  * Descriptions for properties of a named object parameter, from dotted
@@ -4303,7 +4671,10 @@ export declare const ModuleJson: z.ZodObject<{
                 typeSignature: z.ZodString;
                 /** Parameters for this overload. */
                 parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                    /** Parameter name (e.g., `options`, `...args`). */
+                    /**
+                     * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                     * never the name.
+                     */
                     name: z.ZodString;
                     /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                     type: z.ZodString;
@@ -4315,7 +4686,11 @@ export declare const ModuleJson: z.ZodObject<{
                     rest: z.ZodDefault<z.ZodBoolean>;
                     /** Description from `@param` tag. */
                     description: z.ZodOptional<z.ZodString>;
-                    /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                    /**
+                     * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                     * `() => 10`) — quotes included, no normalization; consumers render it as
+                     * highlighted TS.
+                     */
                     defaultValue: z.ZodOptional<z.ZodString>;
                     /**
                      * Descriptions for properties of a named object parameter, from dotted
@@ -4447,7 +4822,12 @@ export declare const ModuleJson: z.ZodObject<{
             $derived: "$derived";
             "$derived.by": "$derived.by";
         }>>;
-        /** Default value documented via `@default`. Useful when the AST initializer is opaque (a call expression, computed value) and the author wants to document the conceptual default. */
+        /**
+         * Default value documented via `@default`, verbatim tag text with no
+         * normalization. Useful when the AST initializer is opaque (a call
+         * expression, computed value) and the author wants to document the
+         * conceptual default.
+         */
         defaultValue: z.ZodOptional<z.ZodString>;
         /** Structured type; absent when `typeSignature` is the whole story (see `TypeJson`). */
         typeInfo: z.ZodOptional<z.ZodType<TypeJson, TypeJson, z.core.$ZodTypeInternals<TypeJson, TypeJson>>>;
@@ -4509,15 +4889,19 @@ export declare const ModuleJson: z.ZodObject<{
             /**
              * Default value documented via `@default` — for a callable member,
              * typically the behavior used when the callback is omitted. Always
-             * tag-authored (structural containers have no initializers). Members only:
-             * top-level function declarations and overloads never carry one.
+             * tag-authored (structural containers have no initializers), verbatim with
+             * no normalization. Members only: top-level function declarations and
+             * overloads never carry one.
              */
             defaultValue: z.ZodOptional<z.ZodString>;
             returnType: z.ZodOptional<z.ZodString>;
             returnTypeInfo: z.ZodOptional<z.ZodType<TypeJson, TypeJson, z.core.$ZodTypeInternals<TypeJson, TypeJson>>>;
             returnDescription: z.ZodOptional<z.ZodString>;
             parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                /** Parameter name (e.g., `options`, `...args`). */
+                /**
+                 * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                 * never the name.
+                 */
                 name: z.ZodString;
                 /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                 type: z.ZodString;
@@ -4529,7 +4913,11 @@ export declare const ModuleJson: z.ZodObject<{
                 rest: z.ZodDefault<z.ZodBoolean>;
                 /** Description from `@param` tag. */
                 description: z.ZodOptional<z.ZodString>;
-                /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                /**
+                 * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                 * `() => 10`) — quotes included, no normalization; consumers render it as
+                 * highlighted TS.
+                 */
                 defaultValue: z.ZodOptional<z.ZodString>;
                 /**
                  * Descriptions for properties of a named object parameter, from dotted
@@ -4553,7 +4941,10 @@ export declare const ModuleJson: z.ZodObject<{
                 typeSignature: z.ZodString;
                 /** Parameters for this overload. */
                 parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                    /** Parameter name (e.g., `options`, `...args`). */
+                    /**
+                     * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                     * never the name.
+                     */
                     name: z.ZodString;
                     /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                     type: z.ZodString;
@@ -4565,7 +4956,11 @@ export declare const ModuleJson: z.ZodObject<{
                     rest: z.ZodDefault<z.ZodBoolean>;
                     /** Description from `@param` tag. */
                     description: z.ZodOptional<z.ZodString>;
-                    /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                    /**
+                     * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                     * `() => 10`) — quotes included, no normalization; consumers render it as
+                     * highlighted TS.
+                     */
                     defaultValue: z.ZodOptional<z.ZodString>;
                     /**
                      * Descriptions for properties of a named object parameter, from dotted
@@ -4644,7 +5039,11 @@ export declare const ModuleJson: z.ZodObject<{
                 $derived: "$derived";
                 "$derived.by": "$derived.by";
             }>>;
-            /** Default value documented via `@default`. Authoritative initializer (when human-readable) is in `typeSignature`. */
+            /**
+             * Default value documented via `@default`, verbatim tag text with no
+             * normalization. Initializers aren't captured — a class field's
+             * `typeSignature` is its checker type, not its initializer.
+             */
             defaultValue: z.ZodOptional<z.ZodString>;
             /**
              * Structured type; absent when `typeSignature` is the whole story (see
@@ -4690,7 +5089,10 @@ export declare const ModuleJson: z.ZodObject<{
             kind: z.ZodLiteral<"constructor">;
             name: z.ZodUnion<readonly [z.ZodLiteral<"constructor">, z.ZodLiteral<"(construct)">]>;
             parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                /** Parameter name (e.g., `options`, `...args`). */
+                /**
+                 * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                 * never the name.
+                 */
                 name: z.ZodString;
                 /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                 type: z.ZodString;
@@ -4702,7 +5104,11 @@ export declare const ModuleJson: z.ZodObject<{
                 rest: z.ZodDefault<z.ZodBoolean>;
                 /** Description from `@param` tag. */
                 description: z.ZodOptional<z.ZodString>;
-                /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                /**
+                 * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                 * `() => 10`) — quotes included, no normalization; consumers render it as
+                 * highlighted TS.
+                 */
                 defaultValue: z.ZodOptional<z.ZodString>;
                 /**
                  * Descriptions for properties of a named object parameter, from dotted
@@ -4726,7 +5132,10 @@ export declare const ModuleJson: z.ZodObject<{
                 typeSignature: z.ZodString;
                 /** Parameters for this overload. */
                 parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                    /** Parameter name (e.g., `options`, `...args`). */
+                    /**
+                     * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                     * never the name.
+                     */
                     name: z.ZodString;
                     /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                     type: z.ZodString;
@@ -4738,7 +5147,11 @@ export declare const ModuleJson: z.ZodObject<{
                     rest: z.ZodDefault<z.ZodBoolean>;
                     /** Description from `@param` tag. */
                     description: z.ZodOptional<z.ZodString>;
-                    /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                    /**
+                     * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                     * `() => 10`) — quotes included, no normalization; consumers render it as
+                     * highlighted TS.
+                     */
                     defaultValue: z.ZodOptional<z.ZodString>;
                     /**
                      * Descriptions for properties of a named object parameter, from dotted
@@ -4877,7 +5290,9 @@ export declare const ModuleJson: z.ZodObject<{
          *   interface itself. Field shapes mirror TS syntax.
          */
         externalTypes: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        /** Svelte component props. */
+        /**
+         * Svelte component props, in source order.
+         */
         props: z.ZodDefault<z.ZodArray<z.ZodObject<{
             examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
             deprecatedMessage: z.ZodOptional<z.ZodString>;
@@ -4897,7 +5312,11 @@ export declare const ModuleJson: z.ZodObject<{
             optional: z.ZodDefault<z.ZodBoolean>;
             /** Description from JSDoc on the prop's type declaration. */
             description: z.ZodOptional<z.ZodString>;
-            /** Default value expression from destructuring or `@default` tag. */
+            /**
+             * The destructuring default's source text, else the `@default` tag text —
+             * verbatim author text either way (`"'primary'"`, `() => 10`), quotes
+             * included, no normalization; consumers render it as highlighted TS.
+             */
             defaultValue: z.ZodOptional<z.ZodString>;
             /** Whether the prop uses the `$bindable()` rune, enabling two-way binding. */
             bindable: z.ZodDefault<z.ZodBoolean>;
@@ -4911,7 +5330,10 @@ export declare const ModuleJson: z.ZodObject<{
              * meaningful signal, not an empty list.
              */
             parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                /** Parameter name (e.g., `options`, `...args`). */
+                /**
+                 * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+                 * never the name.
+                 */
                 name: z.ZodString;
                 /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
                 type: z.ZodString;
@@ -4923,7 +5345,11 @@ export declare const ModuleJson: z.ZodObject<{
                 rest: z.ZodDefault<z.ZodBoolean>;
                 /** Description from `@param` tag. */
                 description: z.ZodOptional<z.ZodString>;
-                /** Default value expression from the source (e.g., `'hello'`, `42`). */
+                /**
+                 * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+                 * `() => 10`) — quotes included, no normalization; consumers render it as
+                 * highlighted TS.
+                 */
                 defaultValue: z.ZodOptional<z.ZodString>;
                 /**
                  * Descriptions for properties of a named object parameter, from dotted
@@ -4996,7 +5422,10 @@ export declare const ModuleJson: z.ZodObject<{
         kind: z.ZodLiteral<"snippet">;
         /** Snippet parameters. */
         parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** Parameter name (e.g., `options`, `...args`). */
+            /**
+             * Parameter name (e.g., `options`, `args`); rest-ness is carried by `rest`,
+             * never the name.
+             */
             name: z.ZodString;
             /** Resolved TypeScript type string (e.g., `string`, `Record<string, unknown>`). */
             type: z.ZodString;
@@ -5008,7 +5437,11 @@ export declare const ModuleJson: z.ZodObject<{
             rest: z.ZodDefault<z.ZodBoolean>;
             /** Description from `@param` tag. */
             description: z.ZodOptional<z.ZodString>;
-            /** Default value expression from the source (e.g., `'hello'`, `42`). */
+            /**
+             * The initializer's source text, verbatim (e.g., `"'hello'"`, `42`,
+             * `() => 10`) — quotes included, no normalization; consumers render it as
+             * highlighted TS.
+             */
             defaultValue: z.ZodOptional<z.ZodString>;
             /**
              * Descriptions for properties of a named object parameter, from dotted
@@ -5127,7 +5560,9 @@ export declare const ModuleJson: z.ZodObject<{
     /**
      * Modules fully re-exported via `export * from './module'`.
      * Paths are relative to `sourceRoot`. Statement-level `@nodocs`
-     * suppresses the entry, like the other re-export encodings.
+     * suppresses the entry, like the other re-export encodings. `export type *
+     * from` is recorded like a value star — per-statement type-only-ness isn't
+     * captured.
      */
     starExports: z.ZodDefault<z.ZodArray<z.ZodString>>;
     /**
@@ -5145,7 +5580,8 @@ export declare const ModuleJson: z.ZodObject<{
         /**
          * Whether the statement (`export type {A} from ...`) or specifier
          * (`export {type A} from ...`) is type-only — the name is erased at
-         * runtime and importable only via `import type`.
+         * runtime and importable only via `import type`. A type-only *rename*
+         * carries no such marker (see `aliasOf`).
          */
         typeOnly: z.ZodDefault<z.ZodBoolean>;
         /**
@@ -5189,8 +5625,8 @@ export declare const ModuleJson: z.ZodObject<{
      * Currently only set for Svelte files where svelte2tsx threw at ingest
      * (the `transform_failed` diagnostic carries the error). Placeholder
      * modules have `declarations: []` and serve as a structural slot so the
-     * `modules` array reflects the full owned set; consumers render them as
-     * "broken" entries.
+     * `modules` array reflects the full emitted (source-gated) set; consumers
+     * render them as "broken" entries.
      */
     partial: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strict>;