@fuzdev/fuz_ui 0.206.6 → 0.206.8

package/dist/declaration.svelte.js

@@ -1,4 +1,5 @@
 import { generateImport, getDisplayName } from 'svelte-docinfo/declaration-helpers.js';
+import { EMPTY_ARRAY } from '@fuzdev/fuz_util/array.ts';
 import { url_github_file } from '@fuzdev/fuz_util/package_helpers.ts';
 // The `virtual:svelte-docinfo` module is serialized with svelte-docinfo's
 // `compactReplacer`, which strips empty default arrays — so the runtime data
@@ -13,9 +14,11 @@ const field = (decl, key) => decl[key];
  * Rich runtime representation of an exported declaration.
  *
  * Wraps svelte-docinfo's `DeclarationJson` discriminated union (on `kind`)
- * with Svelte 5 reactive derivations and computed URLs.
- * Kind-specific fields are accessed via the `field()` helper since
- * not all fields exist on all variants.
+ * with computed properties and URLs. Kind-specific fields are accessed via
+ * the `field()` helper since not all fields exist on all variants.
+ *
+ * Computed properties are plain getters rather than `$derived` — see
+ * `Library` for why.
  *
  * @see {@link https://github.com/ryanatkn/svelte-docinfo svelte-docinfo} for the analysis library
  * @see `DeclarationDetail.svelte` for the rendering component
@@ -23,105 +26,182 @@ const field = (decl, key) => decl[key];
 export class Declaration {
     module = $state.raw();
     declaration_json = $state.raw();
-    library = $derived(this.module.library);
+    get library() {
+        return this.module.library;
+    }
     /**
      * Module path where this declaration is defined.
      */
-    module_path = $derived(this.module.path);
-    name = $derived(this.declaration_json.name);
-    kind = $derived(this.declaration_json.kind);
+    get module_path() {
+        return this.module.path;
+    }
+    get name() {
+        return this.declaration_json.name;
+    }
+    get kind() {
+        return this.declaration_json.kind;
+    }
     /**
      * GitHub source URL with line number.
      */
-    url_github = $derived(this.library.repo_url && this.declaration_json.sourceLine
-        ? url_github_file(this.library.repo_url, `src/lib/${this.module_path}`, this.declaration_json.sourceLine)
-        : undefined);
+    get url_github() {
+        return this.library.repo_url && this.declaration_json.sourceLine
+            ? url_github_file(this.library.repo_url, `src/lib/${this.module_path}`, this.declaration_json.sourceLine)
+            : undefined;
+    }
     /**
      * API documentation URL.
      */
-    url_api = $derived(`/docs/api${this.library.url_prefix}/${this.module_path}#${this.name}`);
+    get url_api() {
+        return `/docs/api${this.library.url_prefix}/${this.module_path}#${this.name}`;
+    }
+    #import_statement;
     /**
      * Generated TypeScript import statement.
      */
-    import_statement = $derived(
-    // `generateImport` reads only `name`/`kind`/path, none of the defaulted
-    // arrays, so asserting the parsed shape here is sound.
-    generateImport(this.declaration_json, this.module_path, this.library.pkg_json.name));
+    get import_statement() {
+        // `generateImport` reads only `name`/`kind`/path, none of the defaulted
+        // arrays, so asserting the parsed shape here is sound.
+        return (this.#import_statement ??= generateImport(this.declaration_json, this.module_path, this.library.pkg_json.name));
+    }
     /**
      * Public documentation link (if homepage_url is available).
      */
-    url_api_full = $derived(this.library.homepage_url
-        ? `${this.library.homepage_url.replace(/\/$/, '')}/docs/api/${this.module_path}#${this.name}`
-        : undefined);
+    get url_api_full() {
+        return this.library.homepage_url
+            ? `${this.library.homepage_url.replace(/\/$/, '')}/docs/api/${this.module_path}#${this.name}`
+            : undefined;
+    }
+    #display_name;
     /**
      * Display name with generic parameters.
      */
-    // `getDisplayName` reads `genericParams` unguarded, so feed it the defaulted
-    // value rather than the raw (possibly-absent) input field.
-    display_name = $derived(getDisplayName({
-        ...this.declaration_json,
-        genericParams: this.declaration_json.genericParams ?? [],
-    }));
-    type_signature = $derived(this.declaration_json.typeSignature);
-    doc_comment = $derived(this.declaration_json.docComment);
-    deprecated_message = $derived(this.declaration_json.deprecatedMessage);
-    parameters = $derived(field(this.declaration_json, 'parameters'));
-    props = $derived(field(this.declaration_json, 'props'));
-    return_type = $derived(field(this.declaration_json, 'returnType'));
-    return_description = $derived(field(this.declaration_json, 'returnDescription'));
-    generic_params = $derived(this.declaration_json.genericParams ?? []);
-    extends_type = $derived(field(this.declaration_json, 'extends'));
-    implements_types = $derived(field(this.declaration_json, 'implements'));
-    throws = $derived(this.declaration_json.throws ?? []);
-    since = $derived(this.declaration_json.since);
-    examples = $derived(this.declaration_json.examples ?? []);
-    see_also = $derived(this.declaration_json.seeAlso ?? []);
+    get display_name() {
+        // `getDisplayName` reads `genericParams` unguarded, so feed it the defaulted
+        // value rather than the raw (possibly-absent) input field.
+        return (this.#display_name ??= getDisplayName({
+            ...this.declaration_json,
+            genericParams: this.declaration_json.genericParams ?? []
+        }));
+    }
+    get type_signature() {
+        return this.declaration_json.typeSignature;
+    }
+    get doc_comment() {
+        return this.declaration_json.docComment;
+    }
+    get deprecated_message() {
+        return this.declaration_json.deprecatedMessage;
+    }
+    get parameters() {
+        return field(this.declaration_json, 'parameters');
+    }
+    get props() {
+        return field(this.declaration_json, 'props');
+    }
+    get return_type() {
+        return field(this.declaration_json, 'returnType');
+    }
+    get return_description() {
+        return field(this.declaration_json, 'returnDescription');
+    }
+    get generic_params() {
+        return this.declaration_json.genericParams ?? EMPTY_ARRAY;
+    }
+    get extends_type() {
+        return field(this.declaration_json, 'extends');
+    }
+    get implements_types() {
+        return field(this.declaration_json, 'implements');
+    }
+    get throws() {
+        return this.declaration_json.throws ?? EMPTY_ARRAY;
+    }
+    get since() {
+        return this.declaration_json.since;
+    }
+    get examples() {
+        return this.declaration_json.examples ?? EMPTY_ARRAY;
+    }
+    get see_also() {
+        return this.declaration_json.seeAlso ?? EMPTY_ARRAY;
+    }
     /**
      * Nested members for classes, interfaces, types, and enums.
      */
-    members = $derived(field(this.declaration_json, 'members'));
+    get members() {
+        return field(this.declaration_json, 'members');
+    }
     /**
      * Intersection types whose properties are external (filtered out of props/members).
      * Present on `component` and `type` kinds.
      */
-    intersects = $derived(field(this.declaration_json, 'intersects'));
+    get intersects() {
+        return field(this.declaration_json, 'intersects');
+    }
     /**
      * Whether a component accepts children via props or template usage.
      * Present on `component` kind only.
      */
-    accepts_children = $derived(field(this.declaration_json, 'acceptsChildren'));
+    get accepts_children() {
+        return field(this.declaration_json, 'acceptsChildren');
+    }
     /**
      * Function overload signatures when multiple public overloads exist.
      * Present on `function` and `snippet` kinds, and on function/constructor members.
      */
-    overloads = $derived(field(this.declaration_json, 'overloads'));
+    get overloads() {
+        return field(this.declaration_json, 'overloads');
+    }
     /**
      * Re-export alias info when this declaration is a renamed re-export.
      */
-    alias_of = $derived(this.declaration_json.aliasOf);
+    get alias_of() {
+        return this.declaration_json.aliasOf;
+    }
     /**
      * Other modules that also export this declaration (re-export paths
      * relative to src/lib). Absent when only exported from its defining module.
      * The back-link of those modules' `Module.re_exports` edges.
      */
-    also_exported_from = $derived(this.declaration_json.alsoExportedFrom);
+    get also_exported_from() {
+        return this.declaration_json.alsoExportedFrom;
+    }
     /**
      * Mutation documentation from `@mutates` tags, mapping parameter names to descriptions.
      */
-    mutates = $derived(this.declaration_json.mutates);
+    get mutates() {
+        return this.declaration_json.mutates;
+    }
     /**
      * Svelte reactivity flavor (`$state`, `$state.raw`, `$derived`, `$derived.by`)
      * when this variable is initialized with a value-producing rune.
      * Present on `variable` kind only.
      */
-    reactivity = $derived(field(this.declaration_json, 'reactivity'));
-    has_examples = $derived(this.examples.length > 0);
+    get reactivity() {
+        return field(this.declaration_json, 'reactivity');
+    }
+    get has_examples() {
+        return this.examples.length > 0;
+    }
     // presence, not truthiness — a bare `@deprecated` (no message text) arrives as `''`
-    is_deprecated = $derived(this.deprecated_message !== undefined);
-    has_documentation = $derived(!!this.doc_comment);
-    has_parameters = $derived(!!(this.parameters && this.parameters.length > 0));
-    has_props = $derived(!!(this.props && this.props.length > 0));
-    has_generics = $derived(this.generic_params.length > 0);
+    get is_deprecated() {
+        return this.deprecated_message !== undefined;
+    }
+    get has_documentation() {
+        return !!this.doc_comment;
+    }
+    get has_parameters() {
+        const { parameters } = this;
+        return !!(parameters && parameters.length > 0);
+    }
+    get has_props() {
+        const { props } = this;
+        return !!(props && props.length > 0);
+    }
+    get has_generics() {
+        return this.generic_params.length > 0;
+    }
     constructor(module, declaration_json) {
         this.module = module;
         this.declaration_json = declaration_json;

package/dist/declaration_contextmenu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"declaration_contextmenu.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/declaration_contextmenu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,+BAA+B,CAAC;AAIrE,eAAO,MAAM,8BAA8B,GAC1C,aAAa,WAAW,KACtB,KAAK,CAAC,iBAAiB,CAczB,CAAC"}
+{"version":3,"file":"declaration_contextmenu.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/declaration_contextmenu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAIvE,eAAO,MAAM,8BAA8B,GAC1C,aAAa,WAAW,KACtB,KAAK,CAAC,iBAAiB,CAczB,CAAC"}

package/dist/declaration_contextmenu.js

@@ -6,8 +6,8 @@ export const create_declaration_contextmenu = (declaration) => {
         entries.push({
             snippet: 'link',
             props: {
-                href: declaration.url_github,
-            },
+                href: declaration.url_github
+            }
         });
     }
     return entries;

package/dist/docs_helpers.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs_helpers.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/docs_helpers.svelte.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,SAAS,EAAE,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAKvD,eAAO,MAAM,kBAAkB;;;;CAA8B,CAAC;AAE9D;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,MAY1C,CAAC;AAEF,eAAO,MAAM,iBAAiB,UAAU,CAAC;AACzC,eAAO,MAAM,SAAS,QAAmB,CAAC;AAC1C,eAAO,MAAM,aAAa,QAAqB,CAAC;AAEhD,eAAO,MAAM,iBAAiB,GAC7B,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,kBAA6B,KAC3B;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;CAK5E,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,WAAW,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,qBAAa,SAAS;;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC,CAAmB;IAgBlE,UAAU,iBA4BP;IAEH,QAAQ,CAAC,kBAAkB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAmB;gBAErD,SAAS,SAAoB;IAIzC,GAAG,CACF,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,WAAW,EACjB,KAAK,SAAI,EACT,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GAClB,MAAM;IAkBT,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxB;;;OAGG;IACH,mBAAmB,IAAI,MAAM;CAG7B"}
+{"version":3,"file":"docs_helpers.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/docs_helpers.svelte.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAKzD,eAAO,MAAM,kBAAkB;;;;CAA8B,CAAC;AAE9D;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,MAY1C,CAAC;AAEF,eAAO,MAAM,iBAAiB,UAAU,CAAC;AACzC,eAAO,MAAM,SAAS,QAAmB,CAAC;AAC1C,eAAO,MAAM,aAAa,QAAqB,CAAC;AAEhD,eAAO,MAAM,iBAAiB,GAC7B,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,kBAA6B,KAC3B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;CAK7E,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,WAAW,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,qBAAa,SAAS;;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC,CAAmB;IAgBlE,UAAU,iBA4BP;IAEH,QAAQ,CAAC,kBAAkB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAmB;gBAErD,SAAS,SAAoB;IAIzC,GAAG,CACF,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,WAAW,EACjB,KAAK,SAAI,EACT,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GAClB,MAAM;IAkBT,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxB;;;OAGG;IACH,mBAAmB,IAAI,MAAM;CAG7B"}