@fuzdev/fuz_util 0.50.1 → 0.52.0

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.52.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.1",
+    "@fuzdev/fuz_css": "^0.52.0",
+    "@fuzdev/fuz_ui": "^0.184.0",
+    "@fuzdev/gro": "^0.194.0",
+    "@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": [