@fuzdev/fuz_util 0.50.1 → 0.51.0

package/dist/path.d.ts

@@ -29,12 +29,18 @@ export type FileFilter = (path: string) => boolean;
  */
 export declare const to_file_path: (path_or_url: string | URL) => string;
 /**
- * @example parse_path_parts('./foo/bar/baz.ts') => ['foo', 'foo/bar', 'foo/bar/baz.ts']
+ * @example
+ * ```ts
+ * parse_path_parts('./foo/bar/baz.ts') // => ['foo', 'foo/bar', 'foo/bar/baz.ts']
+ * ```
  */
 export declare const parse_path_parts: (path: string) => Array<string>;
 /**
  * Gets the individual parts of a path, ignoring dots and separators.
- * @example parse_path_segments('/foo/bar/baz.ts') => ['foo', 'bar', 'baz.ts']
+ * @example
+ * ```ts
+ * parse_path_segments('/foo/bar/baz.ts') // => ['foo', 'bar', 'baz.ts']
+ * ```
  */
 export declare const parse_path_segments: (path: string) => Array<string>;
 /**

package/dist/path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/path.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,QAAQ;IAC7C,IAAI,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,KAAK,OAAO,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,aAAa,MAAM,GAAG,GAAG,KAAG,MACgC,CAAC;AAE1F;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,KAAK,CAAC,MAAM,CAU3D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,KAAG,KAAK,CAAC,MAAM,CACH,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,SAAS,GAClB;IACA,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACZ,GACD;IACA,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACZ,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,KAAG,KAAK,CAAC,SAAS,CAgBnE,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,GAC/B,UAAU,MAAM,GAAG,SAAS,EAC5B,SAAS,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,KAC7B,OAKF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,EAAE,gCAA6B,KAAG,MAYpE,CAAC"}
+{"version":3,"file":"path.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/path.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,QAAQ;IAC7C,IAAI,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,KAAK,OAAO,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,aAAa,MAAM,GAAG,GAAG,KAAG,MACgC,CAAC;AAE1F;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,KAAK,CAAC,MAAM,CAU3D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,KAAG,KAAK,CAAC,MAAM,CACH,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,SAAS,GAClB;IACA,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACZ,GACD;IACA,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACZ,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,KAAG,KAAK,CAAC,SAAS,CAgBnE,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,GAC/B,UAAU,MAAM,GAAG,SAAS,EAC5B,SAAS,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,KAC7B,OAKF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,EAAE,gCAA6B,KAAG,MAYpE,CAAC"}

package/dist/path.js

@@ -3,7 +3,10 @@
  */
 export const to_file_path = (path_or_url) => typeof path_or_url === 'string' ? path_or_url : decodeURIComponent(path_or_url.pathname);
 /**
- * @example parse_path_parts('./foo/bar/baz.ts') => ['foo', 'foo/bar', 'foo/bar/baz.ts']
+ * @example
+ * ```ts
+ * parse_path_parts('./foo/bar/baz.ts') // => ['foo', 'foo/bar', 'foo/bar/baz.ts']
+ * ```
  */
 export const parse_path_parts = (path) => {
     const segments = parse_path_segments(path);
@@ -18,7 +21,10 @@ export const parse_path_parts = (path) => {
 };
 /**
  * Gets the individual parts of a path, ignoring dots and separators.
- * @example parse_path_segments('/foo/bar/baz.ts') => ['foo', 'bar', 'baz.ts']
+ * @example
+ * ```ts
+ * parse_path_segments('/foo/bar/baz.ts') // => ['foo', 'bar', 'baz.ts']
+ * ```
  */
 export const parse_path_segments = (path) => path.split('/').filter((s) => s && s !== '.' && s !== '..');
 /**

package/dist/process.d.ts

@@ -289,7 +289,10 @@ export declare const spawn_detached: (command: string, args?: ReadonlyArray<stri
 /**
  * Formats a child process for display.
  *
- * @example `pid(1234) <- node server.js`
+ * @example
+ * ```ts
+ * `pid(1234) <- node server.js`
+ * ```
  */
 export declare const print_child_process: (child: ChildProcess) => string;
 /**

package/dist/process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/process.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"process.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/process.ts"],"names":[],"mappings":"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"}

package/dist/process.js

@@ -401,7 +401,10 @@ export const spawn_detached = (command, args = [], options) => {
 /**
  * Formats a child process for display.
  *
- * @example `pid(1234) <- node server.js`
+ * @example
+ * ```ts
+ * `pid(1234) <- node server.js`
+ * ```
  */
 export const print_child_process = (child) => `${st('gray', 'pid(')}${child.pid ?? 'none'}${st('gray', ')')} ← ${st('green', child.spawnargs.join(' '))}`;
 /**

package/dist/source_json.d.ts

@@ -15,8 +15,8 @@ import { z } from 'zod';
  */
 export declare const DeclarationKind: z.ZodEnum<{
     function: "function";
-    type: "type";
     json: "json";
+    type: "type";
     variable: "variable";
     class: "class";
     constructor: "constructor";
@@ -67,6 +67,19 @@ export declare const ComponentPropInfo: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     default_value: z.ZodOptional<z.ZodString>;
     bindable: z.ZodOptional<z.ZodBoolean>;
+    /** Code examples from `@example` tags. */
+    examples: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    /** Deprecation message from `@deprecated` tag. */
+    deprecated_message: z.ZodOptional<z.ZodString>;
+    /** Related items from `@see` tags, in raw TSDoc format. */
+    see_also: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    /** Exceptions from `@throws` tags. */
+    throws: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodOptional<z.ZodString>;
+        description: z.ZodString;
+    }, z.core.$loose>>>;
+    /** Version introduced, from `@since` tag. */
+    since: z.ZodOptional<z.ZodString>;
 }, z.core.$loose>;
 export type ComponentPropInfo = z.infer<typeof ComponentPropInfo>;
 /**
@@ -79,8 +92,8 @@ export declare const DeclarationJson: z.ZodObject<{
     name: z.ZodString;
     kind: z.ZodEnum<{
         function: "function";
-        type: "type";
         json: "json";
+        type: "type";
         variable: "variable";
         class: "class";
         constructor: "constructor";
@@ -129,6 +142,8 @@ export declare const DeclarationJson: z.ZodObject<{
     }, z.core.$loose>>>;
     /** Version introduced, from `@since` tag. */
     since: z.ZodOptional<z.ZodString>;
+    /** Mutation documentation from `@mutates` tags (non-standard), mapping parameter names to descriptions. */
+    mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     /** Extended classes/interfaces. */
     extends: z.ZodOptional<z.ZodArray<z.ZodString>>;
     /** Implemented interfaces. */
@@ -145,6 +160,19 @@ export declare const DeclarationJson: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         default_value: z.ZodOptional<z.ZodString>;
         bindable: z.ZodOptional<z.ZodBoolean>;
+        /** Code examples from `@example` tags. */
+        examples: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        /** Deprecation message from `@deprecated` tag. */
+        deprecated_message: z.ZodOptional<z.ZodString>;
+        /** Related items from `@see` tags, in raw TSDoc format. */
+        see_also: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        /** Exceptions from `@throws` tags. */
+        throws: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodOptional<z.ZodString>;
+            description: z.ZodString;
+        }, z.core.$loose>>>;
+        /** Version introduced, from `@since` tag. */
+        since: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>>;
     /**
      * Module paths (relative to src/lib) that re-export this declaration.
@@ -157,6 +185,16 @@ export declare const DeclarationJson: z.ZodObject<{
     alias_of: z.ZodOptional<z.ZodObject<{
         module: z.ZodString;
         name: z.ZodString;
+        kind: z.ZodEnum<{
+            function: "function";
+            json: "json";
+            type: "type";
+            variable: "variable";
+            class: "class";
+            constructor: "constructor";
+            component: "component";
+            css: "css";
+        }>;
     }, z.core.$strip>>;
 }, z.core.$loose>;
 export type DeclarationJson = z.infer<typeof DeclarationJson>;
@@ -171,8 +209,8 @@ export declare const ModuleJson: z.ZodObject<{
         name: z.ZodString;
         kind: z.ZodEnum<{
             function: "function";
-            type: "type";
             json: "json";
+            type: "type";
             variable: "variable";
             class: "class";
             constructor: "constructor";
@@ -221,6 +259,8 @@ export declare const ModuleJson: z.ZodObject<{
         }, z.core.$loose>>>;
         /** Version introduced, from `@since` tag. */
         since: z.ZodOptional<z.ZodString>;
+        /** Mutation documentation from `@mutates` tags (non-standard), mapping parameter names to descriptions. */
+        mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         /** Extended classes/interfaces. */
         extends: z.ZodOptional<z.ZodArray<z.ZodString>>;
         /** Implemented interfaces. */
@@ -237,6 +277,19 @@ export declare const ModuleJson: z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
             default_value: z.ZodOptional<z.ZodString>;
             bindable: z.ZodOptional<z.ZodBoolean>;
+            /** Code examples from `@example` tags. */
+            examples: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            /** Deprecation message from `@deprecated` tag. */
+            deprecated_message: z.ZodOptional<z.ZodString>;
+            /** Related items from `@see` tags, in raw TSDoc format. */
+            see_also: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            /** Exceptions from `@throws` tags. */
+            throws: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                type: z.ZodOptional<z.ZodString>;
+                description: z.ZodString;
+            }, z.core.$loose>>>;
+            /** Version introduced, from `@since` tag. */
+            since: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>>>;
         /**
          * Module paths (relative to src/lib) that re-export this declaration.
@@ -249,6 +302,16 @@ export declare const ModuleJson: z.ZodObject<{
         alias_of: z.ZodOptional<z.ZodObject<{
             module: z.ZodString;
             name: z.ZodString;
+            kind: z.ZodEnum<{
+                function: "function";
+                json: "json";
+                type: "type";
+                variable: "variable";
+                class: "class";
+                constructor: "constructor";
+                component: "component";
+                css: "css";
+            }>;
         }, z.core.$strip>>;
     }, z.core.$loose>>>;
     /** File-level JSDoc comment. */
@@ -278,8 +341,8 @@ export declare const SourceJson: z.ZodObject<{
             name: z.ZodString;
             kind: z.ZodEnum<{
                 function: "function";
-                type: "type";
                 json: "json";
+                type: "type";
                 variable: "variable";
                 class: "class";
                 constructor: "constructor";
@@ -328,6 +391,8 @@ export declare const SourceJson: z.ZodObject<{
             }, z.core.$loose>>>;
             /** Version introduced, from `@since` tag. */
             since: z.ZodOptional<z.ZodString>;
+            /** Mutation documentation from `@mutates` tags (non-standard), mapping parameter names to descriptions. */
+            mutates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             /** Extended classes/interfaces. */
             extends: z.ZodOptional<z.ZodArray<z.ZodString>>;
             /** Implemented interfaces. */
@@ -344,6 +409,19 @@ export declare const SourceJson: z.ZodObject<{
                 description: z.ZodOptional<z.ZodString>;
                 default_value: z.ZodOptional<z.ZodString>;
                 bindable: z.ZodOptional<z.ZodBoolean>;
+                /** Code examples from `@example` tags. */
+                examples: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                /** Deprecation message from `@deprecated` tag. */
+                deprecated_message: z.ZodOptional<z.ZodString>;
+                /** Related items from `@see` tags, in raw TSDoc format. */
+                see_also: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                /** Exceptions from `@throws` tags. */
+                throws: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    type: z.ZodOptional<z.ZodString>;
+                    description: z.ZodString;
+                }, z.core.$loose>>>;
+                /** Version introduced, from `@since` tag. */
+                since: z.ZodOptional<z.ZodString>;
             }, z.core.$loose>>>;
             /**
              * Module paths (relative to src/lib) that re-export this declaration.
@@ -356,6 +434,16 @@ export declare const SourceJson: z.ZodObject<{
             alias_of: z.ZodOptional<z.ZodObject<{
                 module: z.ZodString;
                 name: z.ZodString;
+                kind: z.ZodEnum<{
+                    function: "function";
+                    json: "json";
+                    type: "type";
+                    variable: "variable";
+                    class: "class";
+                    constructor: "constructor";
+                    component: "component";
+                    css: "css";
+                }>;
             }, z.core.$strip>>;
         }, z.core.$loose>>>;
         /** File-level JSDoc comment. */
@@ -374,14 +462,26 @@ export declare const SourceJson: z.ZodObject<{
 export type SourceJson = z.infer<typeof SourceJson>;
 /**
  * Format declaration name with generic parameters for display.
- * @example declaration_get_display_name({name: 'Map', kind: 'type', generic_params: [{name: 'K'}, {name: 'V'}]})
+ *
+ * @deprecated Use `getDisplayName` from `@fuzdev/svelte-docinfo/types.js` instead.
+ *
+ * @example
+ * ```ts
+ * declaration_get_display_name({name: 'Map', kind: 'type', generic_params: [{name: 'K'}, {name: 'V'}]})
  * // => 'Map<K, V>'
+ * ```
  */
 export declare const declaration_get_display_name: (declaration: DeclarationJson) => string;
 /**
  * Generate TypeScript import statement for a declaration.
- * @example declaration_generate_import({name: 'Foo', kind: 'type'}, 'foo.ts', '@pkg/lib')
+ *
+ * @deprecated Use `generateImport` from `@fuzdev/svelte-docinfo/types.js` instead.
+ *
+ * @example
+ * ```ts
+ * declaration_generate_import({name: 'Foo', kind: 'type'}, 'foo.ts', '@pkg/lib')
  * // => "import type {Foo} from '@pkg/lib/foo.js';"
+ * ```
  */
 export declare const declaration_generate_import: (declaration: DeclarationJson, module_path: string, library_name: string) => string;
 //# sourceMappingURL=source_json.d.ts.map

package/dist/source_json.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source_json.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/source_json.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"source_json.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/source_json.ts"],"names":[],"mappings":"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"}

package/dist/source_json.js

@@ -64,6 +64,16 @@ export const ComponentPropInfo = z.looseObject({
     description: z.string().optional(),
     default_value: z.string().optional(),
     bindable: z.boolean().optional(),
+    /** Code examples from `@example` tags. */
+    examples: z.array(z.string()).optional(),
+    /** Deprecation message from `@deprecated` tag. */
+    deprecated_message: z.string().optional(),
+    /** Related items from `@see` tags, in raw TSDoc format. */
+    see_also: z.array(z.string()).optional(),
+    /** Exceptions from `@throws` tags. */
+    throws: z.array(z.looseObject({ type: z.string().optional(), description: z.string() })).optional(),
+    /** Version introduced, from `@since` tag. */
+    since: z.string().optional(),
 });
 /**
  * Metadata for an exported declaration (function, type, class, component, etc.).
@@ -100,6 +110,8 @@ export const DeclarationJson = z.looseObject({
     throws: z.array(z.looseObject({ type: z.string().optional(), description: z.string() })).optional(),
     /** Version introduced, from `@since` tag. */
     since: z.string().optional(),
+    /** Mutation documentation from `@mutates` tags (non-standard), mapping parameter names to descriptions. */
+    mutates: z.record(z.string(), z.string()).optional(),
     /** Extended classes/interfaces. */
     extends: z.array(z.string()).optional(),
     /** Implemented interfaces. */
@@ -126,6 +138,7 @@ export const DeclarationJson = z.looseObject({
         .object({
         module: z.string(),
         name: z.string(),
+        kind: DeclarationKind,
     })
         .optional(),
 });
@@ -158,8 +171,14 @@ export const SourceJson = z.looseObject({
 });
 /**
  * Format declaration name with generic parameters for display.
- * @example declaration_get_display_name({name: 'Map', kind: 'type', generic_params: [{name: 'K'}, {name: 'V'}]})
+ *
+ * @deprecated Use `getDisplayName` from `@fuzdev/svelte-docinfo/types.js` instead.
+ *
+ * @example
+ * ```ts
+ * declaration_get_display_name({name: 'Map', kind: 'type', generic_params: [{name: 'K'}, {name: 'V'}]})
  * // => 'Map<K, V>'
+ * ```
  */
 export const declaration_get_display_name = (declaration) => {
     if (!declaration.generic_params?.length)
@@ -176,8 +195,14 @@ export const declaration_get_display_name = (declaration) => {
 };
 /**
  * Generate TypeScript import statement for a declaration.
- * @example declaration_generate_import({name: 'Foo', kind: 'type'}, 'foo.ts', '@pkg/lib')
+ *
+ * @deprecated Use `generateImport` from `@fuzdev/svelte-docinfo/types.js` instead.
+ *
+ * @example
+ * ```ts
+ * declaration_generate_import({name: 'Foo', kind: 'type'}, 'foo.ts', '@pkg/lib')
  * // => "import type {Foo} from '@pkg/lib/foo.js';"
+ * ```
  */
 export const declaration_generate_import = (declaration, module_path, library_name) => {
     const js_path = module_path.replace(/\.ts$/, '.js');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_util",
-  "version": "0.50.1",
+  "version": "0.51.0",
   "description": "utility belt for JS",
   "glyph": "🦕",
   "logo": "logo.svg",
@@ -69,11 +69,12 @@
   },
   "devDependencies": {
     "@changesets/changelog-git": "^0.2.1",
-    "@fuzdev/fuz_code": "^0.41.0",
-    "@fuzdev/fuz_css": "^0.47.0",
-    "@fuzdev/fuz_ui": "^0.181.1",
+    "@fuzdev/fuz_code": "^0.45.0",
+    "@fuzdev/fuz_css": "^0.50.0",
+    "@fuzdev/fuz_ui": "^0.183.1",
+    "@fuzdev/gro": "^0.192.1",
+    "@jridgewell/trace-mapping": "^0.3.31",
     "@ryanatkn/eslint-config": "^0.9.0",
-    "@ryanatkn/gro": "^0.190.0",
     "@sveltejs/adapter-static": "^3.0.10",
     "@sveltejs/kit": "^2.50.1",
     "@sveltejs/package": "^2.5.7",
@@ -86,15 +87,18 @@
     "eslint-plugin-svelte": "^3.14.0",
     "esm-env": "^1.2.2",
     "fast-deep-equal": "^3.1.3",
+    "magic-string": "^0.30.21",
     "prettier": "^3.7.4",
     "prettier-plugin-svelte": "^3.4.1",
     "svelte": "^5.49.1",
     "svelte-check": "^4.3.6",
+    "svelte2tsx": "^0.7.47",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.48.1",
     "vitest": "^4.0.15",
-    "zod": "^4.1.13"
+    "zimmerframe": "^1.1.4",
+    "zod": "^4.3.6"
   },
   "prettier": {
     "plugins": [

package/src/lib/path.ts

@@ -37,7 +37,10 @@ export const to_file_path = (path_or_url: string | URL): string =>
 	typeof path_or_url === 'string' ? path_or_url : decodeURIComponent(path_or_url.pathname);
 
 /**
- * @example parse_path_parts('./foo/bar/baz.ts') => ['foo', 'foo/bar', 'foo/bar/baz.ts']
+ * @example
+ * ```ts
+ * parse_path_parts('./foo/bar/baz.ts') // => ['foo', 'foo/bar', 'foo/bar/baz.ts']
+ * ```
  */
 export const parse_path_parts = (path: string): Array<string> => {
 	const segments = parse_path_segments(path);
@@ -53,7 +56,10 @@ export const parse_path_parts = (path: string): Array<string> => {
 
 /**
  * Gets the individual parts of a path, ignoring dots and separators.
- * @example parse_path_segments('/foo/bar/baz.ts') => ['foo', 'bar', 'baz.ts']
+ * @example
+ * ```ts
+ * parse_path_segments('/foo/bar/baz.ts') // => ['foo', 'bar', 'baz.ts']
+ * ```
  */
 export const parse_path_segments = (path: string): Array<string> =>
 	path.split('/').filter((s) => s && s !== '.' && s !== '..');

package/src/lib/process.ts

@@ -616,7 +616,10 @@ export const spawn_detached = (
 /**
  * Formats a child process for display.
  *
- * @example `pid(1234) <- node server.js`
+ * @example
+ * ```ts
+ * `pid(1234) <- node server.js`
+ * ```
  */
 export const print_child_process = (child: ChildProcess): string =>
 	`${st('gray', 'pid(')}${child.pid ?? 'none'}${st('gray', ')')} ← ${st('green', child.spawnargs.join(' '))}`;

package/src/lib/source_json.ts

@@ -72,6 +72,16 @@ export const ComponentPropInfo = z.looseObject({
 	description: z.string().optional(),
 	default_value: z.string().optional(),
 	bindable: z.boolean().optional(),
+	/** Code examples from `@example` tags. */
+	examples: z.array(z.string()).optional(),
+	/** Deprecation message from `@deprecated` tag. */
+	deprecated_message: z.string().optional(),
+	/** Related items from `@see` tags, in raw TSDoc format. */
+	see_also: z.array(z.string()).optional(),
+	/** Exceptions from `@throws` tags. */
+	throws: z.array(z.looseObject({type: z.string().optional(), description: z.string()})).optional(),
+	/** Version introduced, from `@since` tag. */
+	since: z.string().optional(),
 });
 export type ComponentPropInfo = z.infer<typeof ComponentPropInfo>;
 
@@ -110,6 +120,8 @@ export const DeclarationJson = z.looseObject({
 	throws: z.array(z.looseObject({type: z.string().optional(), description: z.string()})).optional(),
 	/** Version introduced, from `@since` tag. */
 	since: z.string().optional(),
+	/** Mutation documentation from `@mutates` tags (non-standard), mapping parameter names to descriptions. */
+	mutates: z.record(z.string(), z.string()).optional(),
 	/** Extended classes/interfaces. */
 	extends: z.array(z.string()).optional(),
 	/** Implemented interfaces. */
@@ -136,6 +148,7 @@ export const DeclarationJson = z.looseObject({
 		.object({
 			module: z.string(),
 			name: z.string(),
+			kind: DeclarationKind,
 		})
 		.optional(),
 });
@@ -174,8 +187,14 @@ export type SourceJson = z.infer<typeof SourceJson>;
 
 /**
  * Format declaration name with generic parameters for display.
- * @example declaration_get_display_name({name: 'Map', kind: 'type', generic_params: [{name: 'K'}, {name: 'V'}]})
+ *
+ * @deprecated Use `getDisplayName` from `@fuzdev/svelte-docinfo/types.js` instead.
+ *
+ * @example
+ * ```ts
+ * declaration_get_display_name({name: 'Map', kind: 'type', generic_params: [{name: 'K'}, {name: 'V'}]})
  * // => 'Map<K, V>'
+ * ```
  */
 export const declaration_get_display_name = (declaration: DeclarationJson): string => {
 	if (!declaration.generic_params?.length) return declaration.name;
@@ -190,8 +209,14 @@ export const declaration_get_display_name = (declaration: DeclarationJson): stri
 
 /**
  * Generate TypeScript import statement for a declaration.
- * @example declaration_generate_import({name: 'Foo', kind: 'type'}, 'foo.ts', '@pkg/lib')
+ *
+ * @deprecated Use `generateImport` from `@fuzdev/svelte-docinfo/types.js` instead.
+ *
+ * @example
+ * ```ts
+ * declaration_generate_import({name: 'Foo', kind: 'type'}, 'foo.ts', '@pkg/lib')
  * // => "import type {Foo} from '@pkg/lib/foo.js';"
+ * ```
  */
 export const declaration_generate_import = (
 	declaration: DeclarationJson,