@fuzdev/fuz_ui 0.199.0 → 0.201.0

package/dist/DialogContent.svelte.d.ts

@@ -0,0 +1,69 @@
+import type { Snippet } from 'svelte';
+import type { HTMLAttributes } from 'svelte/elements';
+import { type DialogContext, type DialogCloseButtonAttrs } from './dialog.js';
+type $$ComponentProps = Omit<HTMLAttributes<HTMLDivElement>, 'children'> & {
+    /**
+     * The content surface's padding, set as an inline style. Defaults to
+     * `var(--space_xl)` for a comfortable gutter between the card edge and its
+     * content. Set to `''` or `'0'` for no padding (e.g. a flush image or a
+     * surface that manages its own spacing).
+     * @default 'var(--space_xl)'
+     */
+    padding?: string;
+    /**
+     * Whether to apply the fuz_css `.pane` card class to the content surface --
+     * its opaque background, shadow, and rounded corners. `true` (the default) is
+     * the standard dialog card; `false` gives a chromeless surface. Either way the
+     * surface registers with `Dialog`, so click-outside-to-close keeps working.
+     * @default true
+     */
+    pane?: boolean;
+    /**
+     * The gutter around the `.pane` card -- its outer margin, and so the area
+     * outside the card where a press dismisses the dialog. Set to `''` or `'0'` to remove.
+     * @default 'var(--space_xl3)'
+     */
+    gutter?: string;
+    /**
+     * The card's max width. The card shrinks to its content and is capped here,
+     * so narrow content stays narrow while wide content doesn't sprawl. Set to
+     * `''` for no cap (pure shrink-to-content).
+     * @default 'var(--distance_md)'
+     */
+    max_width?: string;
+    /**
+     * The close button floating just outside the content surface's top-right
+     * corner. `true` (the default) renders an absolutely-positioned `.sm.plain.icon_button`
+     * that closes the dialog; `false` removes it. It renders after
+     * `children`, so a content control (or an `autofocus` element) takes initial
+     * focus on open rather than the close button.
+     *
+     * Pass a `Snippet` to render your own. It receives `attrs`
+     * (`DialogCloseButtonAttrs`) carrying the default's placement, styling, a11y,
+     * and `onclick` (closes the dialog), plus the `DialogContext` (e.g. `{close}`).
+     * Spread `attrs` onto a `<button>` to inherit the corner anchoring and override
+     * only what differs (e.g. the glyph), or drop it to place the button freely. The
+     * surface is a containing block (`position: relative`), so an absolutely-positioned
+     * custom button anchors to it.
+     * @default true
+     */
+    close_button?: boolean | Snippet<[attrs: DialogCloseButtonAttrs, dialog: DialogContext]>;
+    /**
+     * Rendered inside the content surface. Receives the `DialogContext` (e.g.
+     * `{close}`) so content can close the dialog without reaching into `Dialog`'s
+     * `children` snippet.
+     *
+     * The default `close_button` renders as the surface's last child (so a content
+     * control or `autofocus` element wins initial focus over it). Because it's a
+     * real child, it throws off universal child-spacing selectors: your content's
+     * last element is no longer `:last-child` (so `> :not(:last-child)` matches it
+     * and `> :last-child` skips it), and `> * + *` matches the button itself. Either
+     * scope spacing to your own elements or a class, or wrap your content in a single
+     * element so its child selectors no longer see the button.
+     */
+    children: Snippet<[dialog: DialogContext]>;
+};
+declare const DialogContent: import("svelte").Component<$$ComponentProps, {}, "">;
+type DialogContent = ReturnType<typeof DialogContent>;
+export default DialogContent;
+//# sourceMappingURL=DialogContent.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DialogContent.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/DialogContent.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAC,cAAc,EAAqB,MAAM,iBAAiB,CAAC;AAExE,OAAO,EAAiB,KAAK,aAAa,EAAE,KAAK,sBAAsB,EAAC,MAAM,aAAa,CAAC;AAE3F,KAAK,gBAAgB,GAAI,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC,GAAG;IAC3E;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,KAAK,EAAE,sBAAsB,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IACzF;;;;;;;;;;;;OAYG;IACH,QAAQ,EAAE,OAAO,CAAC,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;CAC3C,CAAC;AAoEH,QAAA,MAAM,aAAa,sDAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}

package/dist/ProjectLinks.svelte

@@ -35,8 +35,8 @@
 		{name: 'fuz_css', url: 'https://css.fuz.dev/', logo: logo_fuz_css, description: 'CSS framework and design system', glyph: '🌿', color_class: 'color_b_50'},
 		{name: 'fuz_ui', url: 'https://ui.fuz.dev/', logo: logo_fuz_ui, description: 'Svelte UI library', glyph: '🧶', color_class: 'color_c_50'},
 		{name: 'fuz_template', url: 'https://template.fuz.dev/', logo: logo_fuz_template, description: 'a static web app and Node library template with TypeScript, Svelte, SvelteKit, Vite, esbuild, Fuz, and Gro', glyph: '❄', color_class: 'color_h_50'},
-		{name: 'fuz_code', url: 'https://code.fuz.dev/', logo: logo_fuz_code, description: 'syntax styling utilities and components for TypeScript, Svelte, SvelteKit', glyph: '🎨', color_class: 'color_g_50'},
 		{name: 'fuz_blog', url: 'https://blog.fuz.dev/', logo: logo_fuz_blog, description: 'blog software from scratch with SvelteKit', glyph: '🖊️', color_class: 'color_e_50'},
+		{name: 'fuz_code', url: 'https://code.fuz.dev/', logo: logo_fuz_code, description: 'syntax styling utilities and components for TypeScript, Svelte, SvelteKit', glyph: '🎨', color_class: 'color_g_50'},
 		{name: 'fuz_mastodon', url: 'https://mastodon.fuz.dev/', logo: logo_fuz_mastodon, description: 'Mastodon components and helpers for Svelte, SvelteKit, and Fuz', glyph: '🦣', color_class: 'color_d_50'},
 		{name: 'fuz_gitops', url: 'https://gitops.fuz.dev/', logo: logo_fuz_gitops, description: 'a tool for managing many repos', glyph: '🪄', color_class: 'color_a_50'},
 		{name: 'fuz_docs', url: 'https://docs.fuz.dev/', logo: logo_fuz_docs, description: 'AI-generated documentation and skills for the Fuz stack', glyph: '📜', color_class: 'color_i_50'},

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

@@ -1 +1 @@
-{"version":3,"file":"api_search.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/api_search.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAE/C,MAAM,WAAW,sBAAsB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IACxB,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACR,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACnB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;KACxB,CAAC;IACF,YAAY,EAAE;QACb,GAAG,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QACxB,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;KAC7B,CAAC;CACF;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,OAAO,KAAG,cA8CpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gCAAgC,GAC5C,cAAc,KAAK,CAAC,WAAW,CAAC,KAC9B,sBAyCF,CAAC"}
+{"version":3,"file":"api_search.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/api_search.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAE/C,MAAM,WAAW,sBAAsB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IACxB,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACR,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACnB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;KACxB,CAAC;IACF,YAAY,EAAE;QACb,GAAG,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QACxB,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;KAC7B,CAAC;CACF;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,OAAO,KAAG,cA+CpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gCAAgC,GAC5C,cAAc,KAAK,CAAC,WAAW,CAAC,KAC9B,sBA0CF,CAAC"}

package/dist/api_search.svelte.js

@@ -19,7 +19,8 @@ export const create_api_search = (library) => {
     const all_declarations = $derived(library.declarations);
     const filtered_declarations = $derived.by(() => {
         const items = query.trim() ? library.search_declarations(query) : all_declarations;
-        return items.sort((a, b) => a.name.localeCompare(b.name));
+        // spread before sort — `items` may be the shared source array
+        return [...items].sort((a, b) => a.name.localeCompare(b.name));
     });
     return {
         get query() {
@@ -54,8 +55,9 @@ export const create_module_declaration_search = (declarations) => {
     const all = $derived(declarations);
     const filtered = $derived.by(() => {
         const trimmed_query = query.trim();
+        // spread before sort — `all` is the shared source array
         if (!trimmed_query)
-            return all.sort((a, b) => a.name.localeCompare(b.name));
+            return [...all].sort((a, b) => a.name.localeCompare(b.name));
         const terms = trimmed_query.toLowerCase().split(/\s+/);
         const items = all.filter((d) => {
             const name_lower = d.name.toLowerCase();

package/dist/declaration.svelte.d.ts

@@ -293,10 +293,21 @@ export declare class Declaration {
         module: string;
         name: string;
     } | undefined;
+    /**
+     * Other modules that also export this declaration (re-export paths
+     * relative to src/lib). Absent when only exported from its defining module.
+     */
+    also_exported_from: string[] | undefined;
     /**
      * Mutation documentation from `@mutates` tags, mapping parameter names to descriptions.
      */
     mutates: Record<string, string> | undefined;
+    /**
+     * 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: "$state" | "$state.raw" | "$derived" | "$derived.by" | undefined;
     has_examples: boolean;
     is_deprecated: boolean;
     has_documentation: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"declaration.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/declaration.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,oBAAoB,EAKpB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAc/C;;;;;;;;;;GAUG;AACH,qBAAa,WAAW;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAiB;IACxC,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,CAAiB;IAEhE,OAAO,wCAAiC;IAExC;;OAEG;IACH,WAAW,SAA8B;IAEzC,IAAI,SAAwC;IAC5C,IAAI,4GAAwC;IAE5C;;OAEG;IACH,UAAU,qBAQR;IAEF;;OAEG;IACH,OAAO,SAAoF;IAE3F;;OAEG;IACH,gBAAgB,SAQd;IAEF;;OAEG;IACH,YAAY,qBAIV;IAEF;;OAEG;IAGH,YAAY,SAKV;IAEF,cAAc,qBAAiD;IAC/D,WAAW,qBAA8C;IACzD,kBAAkB,qBAAqD;IACvE,UAAU;;;;;;;;oBAAmF;IAC7F,KAAK;;;;;;;;;;;;;;;;;;;;;;;;oBAAkF;IACvF,WAAW,qBAAgE;IAC3E,kBAAkB,qBAAuE;IACzF,cAAc;;;;QAAuD;IACrE,YAAY,gCAA6E;IACzF,gBAAgB,uBAAuE;IACvF,MAAM;;;QAAgD;IACtD,KAAK,qBAAyC;IAC9C,QAAQ,WAAkD;IAC1D,QAAQ,WAAiD;IACzD;;OAEG;IACH,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAA6E;IAEpF;;;OAGG;IACH,UAAU,uBAAuE;IAEjF;;;OAGG;IACH,gBAAgB,sBAAsE;IAEtF;;;OAGG;IACH,SAAS;;;;;;;;;;;;;;;;;;;oBAAiF;IAE1F;;OAEG;IACH,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA2C;IAEnD;;OAEG;IACH,OAAO,qCAA2C;IAElD,YAAY,UAAsC;IAClD,aAAa,UAAuC;IACpD,iBAAiB,UAAgC;IACjD,cAAc,UAA+D;IAC7E,SAAS,UAAqD;IAC9D,YAAY,UAA4C;gBAE5C,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,oBAAoB;CAIlE"}
+{"version":3,"file":"declaration.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/declaration.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,oBAAoB,EAMpB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAc/C;;;;;;;;;;GAUG;AACH,qBAAa,WAAW;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAiB;IACxC,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,CAAiB;IAEhE,OAAO,wCAAiC;IAExC;;OAEG;IACH,WAAW,SAA8B;IAEzC,IAAI,SAAwC;IAC5C,IAAI,4GAAwC;IAE5C;;OAEG;IACH,UAAU,qBAQR;IAEF;;OAEG;IACH,OAAO,SAAoF;IAE3F;;OAEG;IACH,gBAAgB,SAQd;IAEF;;OAEG;IACH,YAAY,qBAIV;IAEF;;OAEG;IAGH,YAAY,SAKV;IAEF,cAAc,qBAAiD;IAC/D,WAAW,qBAA8C;IACzD,kBAAkB,qBAAqD;IACvE,UAAU;;;;;;;;oBAAmF;IAC7F,KAAK;;;;;;;;;;;;;;;;;;;;;;;;oBAAkF;IACvF,WAAW,qBAAgE;IAC3E,kBAAkB,qBAAuE;IACzF,cAAc;;;;QAAuD;IACrE,YAAY,gCAA6E;IACzF,gBAAgB,uBAAuE;IACvF,MAAM;;;QAAgD;IACtD,KAAK,qBAAyC;IAC9C,QAAQ,WAAkD;IAC1D,QAAQ,WAAiD;IACzD;;OAEG;IACH,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAA6E;IAEpF;;;OAGG;IACH,UAAU,uBAAuE;IAEjF;;;OAGG;IACH,gBAAgB,sBAAsE;IAEtF;;;OAGG;IACH,SAAS;;;;;;;;;;;;;;;;;;;oBAAiF;IAE1F;;OAEG;IACH,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA2C;IAEnD;;;OAGG;IACH,kBAAkB,uBAA6E;IAE/F;;OAEG;IACH,OAAO,qCAA2C;IAElD;;;;OAIG;IACH,UAAU,mEAAoE;IAE9E,YAAY,UAAsC;IAElD,aAAa,UAAmD;IAChE,iBAAiB,UAAgC;IACjD,cAAc,UAA+D;IAC7E,SAAS,UAAqD;IAC9D,YAAY,UAA4C;gBAE5C,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,oBAAoB;CAIlE"}

package/dist/declaration.svelte.js

@@ -99,12 +99,24 @@ export class Declaration {
      * Re-export alias info when this declaration is a renamed re-export.
      */
     alias_of = $derived(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.
+     */
+    also_exported_from = $derived(field(this.declaration_json, 'alsoExportedFrom'));
     /**
      * Mutation documentation from `@mutates` tags, mapping parameter names to descriptions.
      */
     mutates = $derived(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);
-    is_deprecated = $derived(!!this.deprecated_message);
+    // 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));

package/dist/dialog.d.ts

@@ -1,24 +1,38 @@
-import type { ComponentProps, Component } from 'svelte';
-import type Dialog from './Dialog.svelte';
+export type DialogAlign = 'center' | 'top';
+export declare const dialog_aligns: Array<DialogAlign>;
 /**
- * This helper function is needed to construct `DialogParams` with type safety.
- * It uses TypeScript's inferred generics for functions,
- * which do not work for plain objects as of v5.0.4.
- * * `ContextmenuParams` uses a similar strategy.
+ * Set by `Dialog`, read by `DialogContent`. Lets the content surface close the
+ * dialog without the consumer threading `close` through the `children` snippet.
  */
-export declare const to_dialog_params: <T extends Component<any>>(Component: T, props: ComponentProps<T>, dialog_props?: Partial<ComponentProps<typeof Dialog>>) => DialogParams<T>;
+export interface DialogContext {
+    /**
+     * Closes the dialog. When passed an event it's swallowed (default-prevented
+     * and propagation-stopped) before closing.
+     */
+    close: (e?: Event) => void;
+    /**
+     * Registers a content-surface element so a press inside it isn't treated as an
+     * outside-dismiss. The surface is known by node identity, independent of any
+     * class. Use as an attachment on the surface: `{@attach register_surface}`.
+     * Returns a cleanup that unregisters on unmount.
+     */
+    register_surface: (element: Element) => () => void;
+}
+export declare const dialog_context: {
+    get: (error_message?: string) => DialogContext;
+    get_maybe: () => DialogContext | undefined;
+    set: (value: DialogContext) => DialogContext;
+};
 /**
- * This pattern is based on:
- * https://github.com/ivanhofer/sveltekit-typescript-showcase/blob/main/src/01-props/09-svelte-component/Component.svelte
- * The main limitation is that the generic cannot be inferred automatically,
- * so we use `to_dialog_params` to construct instances in most cases.
- * Definining `DialogParams` with no concrete `T` lacks typechecking for `props`.
+ * The `attrs` a custom `DialogContent` `close_button` snippet receives.
+ * Spread onto a `<button>` to inherit the corner-anchored close button.
  */
-export interface DialogParams<T extends Component<any> = Component<any>> {
-    Component: T;
-    props: ComponentProps<T>;
-    dialog_props?: Partial<ComponentProps<typeof Dialog>> | undefined;
+export interface DialogCloseButtonAttrs {
+    type: 'button';
+    class: string;
+    style: string;
+    onclick: DialogContext['close'];
+    title: string;
+    'aria-label': string;
 }
-export type DialogLayout = 'centered' | 'page';
-export declare const dialog_layouts: Array<DialogLayout>;
 //# sourceMappingURL=dialog.d.ts.map

package/dist/dialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dialog.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/dialog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,cAAc,EAAE,SAAS,EAAC,MAAM,QAAQ,CAAC;AAEtD,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,SAAS,CAAC,GAAG,CAAC,EACxD,WAAW,CAAC,EACZ,OAAO,cAAc,CAAC,CAAC,CAAC,EACxB,eAAe,OAAO,CAAC,cAAc,CAAC,OAAO,MAAM,CAAC,CAAC,KACnD,YAAY,CAAC,CAAC,CAIf,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC;IACtE,SAAS,EAAE,CAAC,CAAC;IACb,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,OAAO,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;CAClE;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC;AAC/C,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,YAAY,CAAwB,CAAC"}
+{"version":3,"file":"dialog.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/dialog.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,KAAK,CAAC;AAC3C,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,WAAW,CAAqB,CAAC;AAEnE;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B;;;OAGG;IACH,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IAC3B;;;;;OAKG;IACH,gBAAgB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;CACnD;AAED,eAAO,MAAM,cAAc;;;;CAAkC,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACtC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACrB"}

package/dist/dialog.js

@@ -1,12 +1,3 @@
-/**
- * This helper function is needed to construct `DialogParams` with type safety.
- * It uses TypeScript's inferred generics for functions,
- * which do not work for plain objects as of v5.0.4.
- * * `ContextmenuParams` uses a similar strategy.
- */
-export const to_dialog_params = (Component, props, dialog_props) => ({
-    Component,
-    props,
-    dialog_props,
-});
-export const dialog_layouts = ['centered', 'page'];
+import { create_context } from './context_helpers.js';
+export const dialog_aligns = ['center', 'top'];
+export const dialog_context = create_context();

package/dist/module.svelte.d.ts

@@ -59,6 +59,8 @@ export declare class Module {
      * Modules that import this (paths relative to src/lib).
      */
     dependents: string[];
+    has_dependencies: boolean;
+    has_dependents: 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;gBAE7C,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,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"}

package/dist/module.svelte.js

@@ -68,6 +68,8 @@ export class Module {
      * Modules that import this (paths relative to src/lib).
      */
     dependents = $derived(this.module_json.dependents ?? []);
+    has_dependencies = $derived(this.dependencies.length > 0);
+    has_dependents = $derived(this.dependents.length > 0);
     constructor(library, module_json) {
         this.library = library;
         this.module_json = module_json;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_ui",
-  "version": "0.199.0",
+  "version": "0.201.0",
   "description": "Svelte UI library",
   "tagline": "friendly user zystem",
   "glyph": "🧶",
@@ -82,10 +82,10 @@
   "devDependencies": {
     "@changesets/changelog-git": "^0.2.1",
     "@fuzdev/blake3_wasm": "^0.1.1",
-    "@fuzdev/fuz_code": "^0.45.1",
-    "@fuzdev/fuz_css": "^0.61.1",
+    "@fuzdev/fuz_code": "^0.46.0",
+    "@fuzdev/fuz_css": "^0.62.0",
     "@fuzdev/fuz_util": "^0.65.1",
-    "@fuzdev/gro": "^0.203.0",
+    "@fuzdev/gro": "^0.204.0",
     "@jridgewell/trace-mapping": "^0.3.31",
     "@ryanatkn/eslint-config": "^0.12.1",
     "@sveltejs/acorn-typescript": "^1.0.9",
@@ -99,13 +99,13 @@
     "eslint": "^9.39.4",
     "eslint-plugin-svelte": "^3.19.0",
     "esm-env": "^1.2.2",
-    "jsdom": "^27.2.0",
+    "jsdom": "^29.1.1",
     "magic-string": "^0.30.21",
     "prettier": "^3.7.4",
     "prettier-plugin-svelte": "^3.5.1",
     "svelte": "^5.56.0",
     "svelte-check": "^4.4.8",
-    "svelte-docinfo": "^0.4.0",
+    "svelte-docinfo": "^0.4.1",
     "svelte2tsx": "^0.7.55",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",

package/src/lib/api_search.svelte.ts

@@ -42,7 +42,8 @@ export const create_api_search = (library: Library): ApiSearchState => {
 	const all_declarations = $derived(library.declarations);
 	const filtered_declarations = $derived.by(() => {
 		const items = query.trim() ? library.search_declarations(query) : all_declarations;
-		return items.sort((a, b) => a.name.localeCompare(b.name));
+		// spread before sort — `items` may be the shared source array
+		return [...items].sort((a, b) => a.name.localeCompare(b.name));
 	});
 
 	return {
@@ -83,7 +84,8 @@ export const create_module_declaration_search = (
 
 	const filtered = $derived.by(() => {
 		const trimmed_query = query.trim();
-		if (!trimmed_query) return all.sort((a, b) => a.name.localeCompare(b.name));
+		// spread before sort — `all` is the shared source array
+		if (!trimmed_query) return [...all].sort((a, b) => a.name.localeCompare(b.name));
 
 		const terms = trimmed_query.toLowerCase().split(/\s+/);
 

package/src/lib/declaration.svelte.ts

@@ -5,6 +5,7 @@ import type {
 	ParameterJsonInput,
 	ComponentPropJsonInput,
 	OverloadJsonInput,
+	Reactivity,
 } from 'svelte-docinfo/types.js';
 import {generateImport, getDisplayName} from 'svelte-docinfo/declaration-helpers.js';
 
@@ -141,13 +142,27 @@ export class Declaration {
 	 */
 	alias_of = $derived(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.
+	 */
+	also_exported_from = $derived(field<Array<string>>(this.declaration_json, 'alsoExportedFrom'));
+
 	/**
 	 * Mutation documentation from `@mutates` tags, mapping parameter names to descriptions.
 	 */
 	mutates = $derived(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<Reactivity>(this.declaration_json, 'reactivity'));
+
 	has_examples = $derived(this.examples.length > 0);
-	is_deprecated = $derived(!!this.deprecated_message);
+	// 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));

package/src/lib/dialog.ts

@@ -1,35 +1,38 @@
-import type {ComponentProps, Component} from 'svelte';
+import {create_context} from './context_helpers.js';
 
-import type Dialog from './Dialog.svelte';
+export type DialogAlign = 'center' | 'top';
+export const dialog_aligns: Array<DialogAlign> = ['center', 'top'];
 
 /**
- * This helper function is needed to construct `DialogParams` with type safety.
- * It uses TypeScript's inferred generics for functions,
- * which do not work for plain objects as of v5.0.4.
- * * `ContextmenuParams` uses a similar strategy.
+ * Set by `Dialog`, read by `DialogContent`. Lets the content surface close the
+ * dialog without the consumer threading `close` through the `children` snippet.
  */
-export const to_dialog_params = <T extends Component<any>>(
-	Component: T,
-	props: ComponentProps<T>,
-	dialog_props?: Partial<ComponentProps<typeof Dialog>>,
-): DialogParams<T> => ({
-	Component,
-	props,
-	dialog_props,
-});
+export interface DialogContext {
+	/**
+	 * Closes the dialog. When passed an event it's swallowed (default-prevented
+	 * and propagation-stopped) before closing.
+	 */
+	close: (e?: Event) => void;
+	/**
+	 * Registers a content-surface element so a press inside it isn't treated as an
+	 * outside-dismiss. The surface is known by node identity, independent of any
+	 * class. Use as an attachment on the surface: `{@attach register_surface}`.
+	 * Returns a cleanup that unregisters on unmount.
+	 */
+	register_surface: (element: Element) => () => void;
+}
+
+export const dialog_context = create_context<DialogContext>();
 
 /**
- * This pattern is based on:
- * https://github.com/ivanhofer/sveltekit-typescript-showcase/blob/main/src/01-props/09-svelte-component/Component.svelte
- * The main limitation is that the generic cannot be inferred automatically,
- * so we use `to_dialog_params` to construct instances in most cases.
- * Definining `DialogParams` with no concrete `T` lacks typechecking for `props`.
+ * The `attrs` a custom `DialogContent` `close_button` snippet receives.
+ * Spread onto a `<button>` to inherit the corner-anchored close button.
  */
-export interface DialogParams<T extends Component<any> = Component<any>> {
-	Component: T;
-	props: ComponentProps<T>;
-	dialog_props?: Partial<ComponentProps<typeof Dialog>> | undefined;
+export interface DialogCloseButtonAttrs {
+	type: 'button';
+	class: string;
+	style: string;
+	onclick: DialogContext['close'];
+	title: string;
+	'aria-label': string;
 }
-
-export type DialogLayout = 'centered' | 'page';
-export const dialog_layouts: Array<DialogLayout> = ['centered', 'page'];

package/src/lib/module.svelte.ts

@@ -90,6 +90,10 @@ export class Module {
 	 */
 	dependents = $derived(this.module_json.dependents ?? []);
 
+	has_dependencies: boolean = $derived(this.dependencies.length > 0);
+
+	has_dependents: boolean = $derived(this.dependents.length > 0);
+
 	constructor(library: Library, module_json: ModuleJsonInput) {
 		this.library = library;
 		this.module_json = module_json;

package/dist/Dialogs.svelte

@@ -1,28 +0,0 @@
-<script lang="ts">
-	import type {Snippet} from 'svelte';
-
-	import type {DialogParams} from './dialog.js';
-	import Dialog from './Dialog.svelte';
-
-	// TODO this is experimental
-
-	const {
-		dialogs,
-		onclose,
-		children,
-	}: {
-		dialogs: Array<DialogParams>;
-		onclose?: () => void;
-		children?: Snippet<[dialog: DialogParams]>;
-	} = $props();
-</script>
-
-{#each dialogs as dialog, index (dialog)}<Dialog
-		{onclose}
-		{...dialog.dialog_props}
-		{index}
-		active={index === dialogs.length - 1}
-		>{#if children}{@render children(dialog)}{:else}<dialog.Component
-				{...dialog.props}
-			/>{/if}</Dialog
-	>{/each}

package/dist/Dialogs.svelte.d.ts

@@ -1,11 +0,0 @@
-import type { Snippet } from 'svelte';
-import type { DialogParams } from './dialog.js';
-type $$ComponentProps = {
-    dialogs: Array<DialogParams>;
-    onclose?: () => void;
-    children?: Snippet<[dialog: DialogParams]>;
-};
-declare const Dialogs: import("svelte").Component<$$ComponentProps, {}, "">;
-type Dialogs = ReturnType<typeof Dialogs>;
-export default Dialogs;
-//# sourceMappingURL=Dialogs.svelte.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Dialogs.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Dialogs.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AAEpC,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,aAAa,CAAC;AAG7C,KAAK,gBAAgB,GAAI;IACxB,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;CAC3C,CAAC;AAoBH,QAAA,MAAM,OAAO,sDAAwC,CAAC;AACtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAC1C,eAAe,OAAO,CAAC"}