@fuzdev/fuz_ui 0.201.0 → 0.203.0

package/dist/logos.js

@@ -66,7 +66,7 @@ export const logo_fuz_css = {
     label: 'a fuzzy tuft of green moss',
     fill: '#3db33d',
     paths: logo_fuz.paths,
-    attrs: { style: 'transform: scaleX(-1) rotate(180deg)' },
+    style: 'transform: scaleX(-1) rotate(180deg)',
 };
 export const logo_fuz_ui = {
     label: 'a friendly red spider facing you',

package/dist/module.svelte.d.ts

@@ -1,4 +1,4 @@
-import type { ModuleJsonInput } from 'svelte-docinfo/types.js';
+import type { ModuleJsonInput, ReExportJsonInput, ExternalReExportJsonInput } from 'svelte-docinfo/types.js';
 import { Declaration } from './declaration.svelte.js';
 import type { Library } from './library.svelte.js';
 /**
@@ -49,6 +49,10 @@ export declare class Module {
      * GitHub source URL.
      */
     url_github: string | undefined;
+    /**
+     * Whether the module has renderable declarations (after the default-export
+     * filter in `declarations`).
+     */
     has_declarations: boolean;
     has_module_comment: boolean;
     /**
@@ -61,6 +65,63 @@ export declare class Module {
     dependents: string[];
     has_dependencies: boolean;
     has_dependents: boolean;
+    /**
+     * Same-name re-export edges in this module's source (`ModuleJson.reExports`)
+     * — the forward view of declarations' `alsoExportedFrom`, sorted by name
+     * then module. Renamed re-exports appear as declarations with `aliasOf`
+     * instead, and star exports in `star_exports`.
+     */
+    re_exports: {
+        name: string;
+        module: string;
+        typeOnly?: boolean | undefined;
+        sourceLine?: number | undefined;
+    }[];
+    has_re_exports: boolean;
+    /**
+     * Modules fully re-exported via `export * from './module'`
+     * (`ModuleJson.starExports`), in source order. Star-projected symbols are
+     * not materialized as declarations or `re_exports` edges — this is their
+     * sole encoding.
+     */
+    star_exports: string[];
+    has_star_exports: boolean;
+    /**
+     * Re-export edges grouped by canonical module path, groups sorted by path.
+     * Entries within each group keep their name-sorted serialized order.
+     */
+    re_exports_by_module: Map<string, Array<ReExportJsonInput>>;
+    /**
+     * Re-exports whose immediate target is an external package
+     * (`ModuleJson.externalReExports`) — `export {x} from 'pkg'` and
+     * `export * as ns from 'pkg'` forms, sorted by name then specifier.
+     */
+    external_re_exports: {
+        name: string;
+        specifier: string;
+        originalName?: string | undefined;
+        typeOnly?: boolean | undefined;
+        sourceLine?: number | undefined;
+    }[];
+    has_external_re_exports: boolean;
+    /**
+     * External re-exports grouped by package specifier, groups sorted by
+     * specifier. Entries within each group keep their name-sorted serialized
+     * order.
+     */
+    external_re_exports_by_specifier: Map<string, Array<ExternalReExportJsonInput>>;
+    /**
+     * External packages fully re-exported via `export * from 'pkg'`
+     * (`ModuleJson.externalStarExports`), in source order. The projected
+     * names are unknown — the package isn't analyzed.
+     */
+    external_star_exports: string[];
+    has_external_star_exports: boolean;
+    /**
+     * Whether the module re-exports anything in any form — same-name edges,
+     * star exports, or the external variants of both.
+     */
+    has_any_re_exports: boolean;
     constructor(library: Library, module_json: ModuleJsonInput);
     /**
      * Look up a declaration by name within this module.

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

@@ -1 +1 @@
-{"version":3,"file":"module.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/module.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAGjD;;;;;;;;GAQG;AACH,qBAAa,MAAM;IAClB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAiB;IAK1C,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAiB;IAEtD;;;;;;;;;;OAUG;IACH,IAAI,SAAmC;IAEvC;;OAEG;IACH,WAAW,SAA8B;IAEzC,cAAc,qBAA4C;IAE1D;;OAEG;IACH,YAAY,gBAIV;IAEF;;OAEG;IACH,OAAO,SAAgE;IAEvE;;;;;OAKG;IACH,YAAY,qBAIV;IAEF;;OAEG;IACH,UAAU,qBAIR;IAEF,gBAAgB,EAAE,OAAO,CAA8D;IAEvF,kBAAkB,EAAE,OAAO,CAAmC;IAE9D;;OAEG;IACH,YAAY,WAAiD;IAE7D;;OAEG;IACH,UAAU,WAA+C;IAEzD,gBAAgB,EAAE,OAAO,CAA0C;IAEnE,cAAc,EAAE,OAAO,CAAwC;gBAEnD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe;IAK1D;;OAEG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;CAG9D"}
+{"version":3,"file":"module.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/module.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,eAAe,EACf,iBAAiB,EACjB,yBAAyB,EACzB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAwBjD;;;;;;;;GAQG;AACH,qBAAa,MAAM;IAClB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAiB;IAK1C,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAiB;IAEtD;;;;;;;;;;OAUG;IACH,IAAI,SAAmC;IAEvC;;OAEG;IACH,WAAW,SAA8B;IAEzC,cAAc,qBAA4C;IAE1D;;OAEG;IACH,YAAY,gBAIV;IAEF;;OAEG;IACH,OAAO,SAAgE;IAEvE;;;;;OAKG;IACH,YAAY,qBAIV;IAEF;;OAEG;IACH,UAAU,qBAIR;IAEF;;;OAGG;IACH,gBAAgB,EAAE,OAAO,CAA0C;IAEnE,kBAAkB,EAAE,OAAO,CAAmC;IAE9D;;OAEG;IACH,YAAY,WAAiD;IAE7D;;OAEG;IACH,UAAU,WAA+C;IAEzD,gBAAgB,EAAE,OAAO,CAA0C;IAEnE,cAAc,EAAE,OAAO,CAAwC;IAE/D;;;;;OAKG;IACH,UAAU;;;;;QAA8C;IAExD,cAAc,EAAE,OAAO,CAAwC;IAE/D;;;;;OAKG;IACH,YAAY,WAAgD;IAE5D,gBAAgB,EAAE,OAAO,CAA0C;IAEnE;;;OAGG;IACH,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAEzD;IAEF;;;;OAIG;IACH,mBAAmB;;;;;;QAAsD;IAEzE,uBAAuB,EAAE,OAAO,CAAiD;IAEjF;;;;OAIG;IACH,gCAAgC,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAE7E;IAEF;;;;OAIG;IACH,qBAAqB,WAAwD;IAE7E,yBAAyB,EAAE,OAAO,CAAmD;IAErF;;;OAGG;IACH,kBAAkB,EAAE,OAAO,CAKzB;gBAEU,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe;IAK1D;;OAEG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;CAG9D"}

package/dist/module.svelte.js

@@ -1,5 +1,22 @@
 import { Declaration } from './declaration.svelte.js';
 import { url_github_file } from '@fuzdev/fuz_util/package_helpers.js';
+/**
+ * Groups entries by a string key, with groups sorted by key. Entries within
+ * each group keep their input order.
+ */
+const group_sorted = (entries, get_key) => {
+    const by_key = new Map();
+    for (const entry of entries) {
+        const key = get_key(entry);
+        let group = by_key.get(key);
+        if (!group) {
+            group = [];
+            by_key.set(key, group);
+        }
+        group.push(entry);
+    }
+    return new Map([...by_key].sort(([a], [b]) => a.localeCompare(b)));
+};
 /**
  * Rich runtime representation of a module with computed properties.
  *
@@ -58,7 +75,11 @@ export class Module {
     url_github = $derived(this.library.repo_url
         ? url_github_file(this.library.repo_url, `src/lib/${this.path}`)
         : undefined);
-    has_declarations = $derived((this.module_json.declarations?.length ?? 0) > 0);
+    /**
+     * Whether the module has renderable declarations (after the default-export
+     * filter in `declarations`).
+     */
+    has_declarations = $derived(this.declarations.length > 0);
     has_module_comment = $derived(!!this.module_comment);
     /**
      * Modules this imports (paths relative to src/lib).
@@ -70,6 +91,55 @@ export class Module {
     dependents = $derived(this.module_json.dependents ?? []);
     has_dependencies = $derived(this.dependencies.length > 0);
     has_dependents = $derived(this.dependents.length > 0);
+    /**
+     * Same-name re-export edges in this module's source (`ModuleJson.reExports`)
+     * — the forward view of declarations' `alsoExportedFrom`, sorted by name
+     * then module. Renamed re-exports appear as declarations with `aliasOf`
+     * instead, and star exports in `star_exports`.
+     */
+    re_exports = $derived(this.module_json.reExports ?? []);
+    has_re_exports = $derived(this.re_exports.length > 0);
+    /**
+     * Modules fully re-exported via `export * from './module'`
+     * (`ModuleJson.starExports`), in source order. Star-projected symbols are
+     * not materialized as declarations or `re_exports` edges — this is their
+     * sole encoding.
+     */
+    star_exports = $derived(this.module_json.starExports ?? []);
+    has_star_exports = $derived(this.star_exports.length > 0);
+    /**
+     * Re-export edges grouped by canonical module path, groups sorted by path.
+     * Entries within each group keep their name-sorted serialized order.
+     */
+    re_exports_by_module = $derived(group_sorted(this.re_exports, (entry) => entry.module));
+    /**
+     * Re-exports whose immediate target is an external package
+     * (`ModuleJson.externalReExports`) — `export {x} from 'pkg'` and
+     * `export * as ns from 'pkg'` forms, sorted by name then specifier.
+     */
+    external_re_exports = $derived(this.module_json.externalReExports ?? []);
+    has_external_re_exports = $derived(this.external_re_exports.length > 0);
+    /**
+     * External re-exports grouped by package specifier, groups sorted by
+     * specifier. Entries within each group keep their name-sorted serialized
+     * order.
+     */
+    external_re_exports_by_specifier = $derived(group_sorted(this.external_re_exports, (entry) => entry.specifier));
+    /**
+     * External packages fully re-exported via `export * from 'pkg'`
+     * (`ModuleJson.externalStarExports`), in source order. The projected
+     * names are unknown — the package isn't analyzed.
+     */
+    external_star_exports = $derived(this.module_json.externalStarExports ?? []);
+    has_external_star_exports = $derived(this.external_star_exports.length > 0);
+    /**
+     * Whether the module re-exports anything in any form — same-name edges,
+     * star exports, or the external variants of both.
+     */
+    has_any_re_exports = $derived(this.has_re_exports ||
+        this.has_star_exports ||
+        this.has_external_re_exports ||
+        this.has_external_star_exports);
     constructor(library, module_json) {
         this.library = library;
         this.module_json = module_json;

package/dist/svg.d.ts

@@ -1,25 +1,84 @@
 import type { SvelteHTMLElements } from 'svelte/elements';
+/**
+ * A structured icon definition rendered by `Svg.svelte`. Rendering is purely
+ * structural - typed fields, never raw markup - so untrusted data cannot
+ * introduce script execution or navigation. See `Svg.svelte` for the full
+ * security notes, including the residual `style` `url(...)` caveat.
+ */
 export interface SvgData {
     /**
-     * Raw svg markup string that's inserted unsafely as a child of the `svg` element.
-     * This is an escape hatch for non-`path` markup -
-     * generally, you should instead use the `paths` property to avoid security/CSP implications.
-     */
-    raw?: string | null;
-    /**
-     * List of svg `path` attribute objects. The `d` attribute is required.
+     * List of svg `path` attribute objects, spread onto each `path` element. The
+     * `d` attribute is required; a per-path `fill` overrides the resolved `fill`.
      */
     paths?: Array<{
         d: string;
     } & SvelteHTMLElements['path']> | null;
-    attrs?: SvelteHTMLElements['svg'] | null;
+    /**
+     * Inline `style` applied to the root `svg` element, merged with any `style`
+     * passed as a component prop. Travels with the icon definition - per-instance
+     * svg attributes belong on the `Svg` component itself.
+     */
+    style?: string | null;
+    /**
+     * Default `fill` for every `path`, falling back to `var(--text_color, #000)`.
+     * Overridden by the component's `fill` prop, and per-path by a path's own `fill`.
+     */
     fill?: string | null;
-    width?: string | null;
-    height?: string | null;
+    /**
+     * Accessible name, applied as `aria-label`. Overridden by the component's `label` prop.
+     */
     label?: string | null;
     /**
      * Defaults to `"0 0 100 100"`.
      */
     viewBox?: string | null;
+    /**
+     * Gradient definitions rendered into the svg's `<defs>` block. This is the
+     * structured replacement for raw markup - reference a gradient from a
+     * path/shape `fill` or `stroke` with `url(#id)`. Most svgs need only `paths`.
+     */
+    gradients?: Array<SvgGradient> | null;
+}
+/**
+ * A gradient definition rendered into the svg's `<defs>` block. Reference it
+ * from a path/shape `fill` or `stroke` with `url(#id)`.
+ */
+export interface SvgGradient {
+    /**
+     * Whether to render a `linearGradient` or `radialGradient` element.
+     */
+    type: 'linear' | 'radial';
+    /**
+     * The `id` referenced by a `fill`/`stroke` like `url(#id)`. Inline svgs share
+     * the document's id namespace, so pick a value unique to the icon - icons
+     * with colliding ids all resolve to whichever element renders first.
+     */
+    id: string;
+    /**
+     * The gradient's color stops.
+     */
+    stops: Array<SvgGradientStop>;
+    /**
+     * Additional attributes on the gradient element, e.g. `gradientUnits`,
+     * `gradientTransform`, `cx`/`cy`/`r` (radial), or `x1`/`y1`/`x2`/`y2` (linear).
+     */
+    attrs?: (SvelteHTMLElements['radialGradient'] & SvelteHTMLElements['linearGradient']) | null;
+}
+/**
+ * A single color stop of an `SvgGradient`.
+ */
+export interface SvgGradientStop {
+    /**
+     * The stop's position along the gradient, e.g. `0.5` or `"50%"`.
+     */
+    offset: string | number;
+    /**
+     * The stop's color, applied as the `stop-color` attribute.
+     */
+    color: string;
+    /**
+     * The stop's opacity, applied as the `stop-opacity` attribute.
+     */
+    opacity?: string | number | null;
 }
 //# sourceMappingURL=svg.d.ts.map

package/dist/svg.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"svg.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/svg.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAExD,MAAM,WAAW,OAAO;IACvB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,EAAE,kBAAkB,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB"}
+{"version":3,"file":"svg.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/svg.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAExD;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACvB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/D;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC3B;;OAEG;IACH,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;IAC9B;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,GAAG,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,GAAG,IAAI,CAAC;CAC7F;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B;;OAEG;IACH,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACjC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_ui",
-  "version": "0.201.0",
+  "version": "0.203.0",
   "description": "Svelte UI library",
   "tagline": "friendly user zystem",
   "glyph": "🧶",
@@ -105,7 +105,7 @@
     "prettier-plugin-svelte": "^3.5.1",
     "svelte": "^5.56.0",
     "svelte-check": "^4.4.8",
-    "svelte-docinfo": "^0.4.1",
+    "svelte-docinfo": "^0.5.1",
     "svelte2tsx": "^0.7.55",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",