@fuzdev/fuz_ui 0.202.0 → 0.203.1

package/dist/contextmenu_state.svelte.js

@@ -1,10 +1,11 @@
 import { onDestroy } from 'svelte';
 import { is_promise } from '@fuzdev/fuz_util/async.js';
-import { BROWSER } from 'esm-env';
+import { BROWSER, DEV } from 'esm-env';
 import { EMPTY_OBJECT } from '@fuzdev/fuz_util/object.js';
 import { Dimensions } from './dimensions.svelte.js';
 import { create_context } from './context_helpers.js';
 import { url_to_root_relative } from './library_helpers.js';
+import { icon_copy } from './icons.js';
 export const contextmenu_context = create_context();
 export const contextmenu_submenu_context = create_context();
 export const contextmenu_dimensions_context = create_context(() => new Dimensions());
@@ -23,25 +24,70 @@ export class EntryState {
         this.disabled = disabled;
     }
 }
-export class SubmenuState {
+/**
+ * Shared `items` state for `SubmenuState` and `RootMenuState`.
+ *
+ * The source of truth is a plain non-reactive array because items register and
+ * unregister from component lifecycles that can interleave within a single batch -
+ * effect teardowns can observe stale signal values mid-batch, so read-copy-write
+ * against the reactive array can lose concurrent registrations (e.g. reopening the
+ * menu while it's open). Every mutation publishes an immutable snapshot, preserving
+ * the reassignment (not mutation) contract for readers.
+ */
+export class ContextmenuItemsState {
+    #items_source = [];
+    #items = $state.raw([]);
+    get items() {
+        return this.#items;
+    }
+    set items(value) {
+        // copy for the published snapshot too, so callers mutating
+        // their own array can't mutate it in readers' hands
+        this.#items_source = [...value];
+        this.#items = [...value];
+    }
+    /**
+     * Appends `item`, publishing a new immutable `items`.
+     */
+    add_item(item) {
+        this.#items_source.push(item);
+        this.#items = [...this.#items_source];
+    }
+    /**
+     * Removes `item` if present, publishing a new immutable `items`.
+     * Safe to call from effect teardown - it reads only the non-reactive source array.
+     */
+    remove_item(item) {
+        const index = this.#items_source.indexOf(item);
+        if (index === -1)
+            return;
+        this.#items_source.splice(index, 1);
+        this.#items = [...this.#items_source];
+    }
+}
+export class SubmenuState extends ContextmenuItemsState {
     is_menu = true;
     menu;
     depth;
     selected = $state.raw(false);
-    items = $state.raw([]);
     constructor(menu, depth) {
+        super();
         this.menu = menu;
         this.depth = depth;
     }
 }
-export class RootMenuState {
+export class RootMenuState extends ContextmenuItemsState {
     is_menu = true;
     menu = null;
     depth = 1;
-    items = $state.raw([]);
 }
+/** Extracts a string `message` property from a thrown value or failed result, if present. */
+const to_error_message = (value) => {
+    const message = value?.message;
+    return typeof message === 'string' ? message : undefined;
+};
 /**
- * Creates a contextmenu store.
+ * Manages contextmenu state.
  * See usage with `ContextmenuRoot.svelte` and `Contextmenu.svelte`.
  *
  * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/contextmenu_event}
@@ -59,10 +105,15 @@ export class ContextmenuState {
     y = $state.raw(0);
     params = $state.raw([]);
     error = $state.raw();
-    // These arrays use immutable updates (reassignment, not mutation).
-    // If you need reactivity, use `$contextmenu` in a reactive statement to react to all changes, and
-    // then access the immutable `contextmenu.root_menu` and `contextmenu.selections`.
-    // See `ContextmenuEntry.svelte` and `ContextmenuSubmenu.svelte` for reactive usage examples.
+    /**
+     * The element the menu was opened from, while opened, else `undefined`.
+     * Resolves the popover host when the menu opens inside a modal `<dialog>` -
+     * see `contextmenu_resolve_popover_host`. Deliberately not reactive -
+     * read it in event handlers and attachments, not in templates.
+     */
+    target = undefined;
+    // These arrays use immutable updates (reassignment, not mutation) - readers can depend
+    // on snapshot identity, and `ContextmenuItemsState` documents the publication contract.
     root_menu = new RootMenuState();
     selections = $state.raw([]);
     can_collapse = $derived(this.selections.length > 1);
@@ -70,11 +121,11 @@ export class ContextmenuState {
         const selected = this.selections.at(-1);
         return !!selected?.is_menu && selected.items.length > 0;
     });
-    can_select_next = $derived.by(() => {
-        const menu = this.selections.at(-1)?.menu ?? this.root_menu;
-        return menu.items.length > 1;
-    });
-    can_select_previous = $derived.by(() => {
+    /**
+     * Whether `select_next` and `select_previous` can move the selection -
+     * the selected menu has more than one item.
+     */
+    can_select_sibling = $derived.by(() => {
         const menu = this.selections.at(-1)?.menu ?? this.root_menu;
         return menu.items.length > 1;
     });
@@ -82,6 +133,10 @@ export class ContextmenuState {
         const selected = this.selections.at(-1);
         if (!selected)
             return false;
+        // the selected item can unregister out from under the selection
+        // (e.g. its component unmounted) - its action must not run
+        if (!selected.menu.items.includes(selected))
+            return false;
         if (selected.is_menu)
             return selected.items.length > 0;
         return !selected.disabled();
@@ -91,18 +146,34 @@ export class ContextmenuState {
         this.has_custom_layout = !!layout;
         this.layout = layout ?? new Dimensions();
     }
-    open(params, x, y) {
-        this.selections = [];
+    open(params, x, y, target) {
+        this.#clear_selections();
         this.opened = true;
+        this.error = undefined;
         this.x = x;
         this.y = y;
         this.params = params;
+        this.target = target;
     }
     close() {
         if (!this.opened)
             return;
         this.reset_items(this.root_menu.items);
+        this.#clear_selections();
         this.opened = false;
+        this.target = undefined;
+    }
+    /**
+     * Deselects every selected item and empties `selections`. Items can outlive
+     * a selection (e.g. surviving a reopen-while-open), so clearing the array
+     * without deselecting would leave ghost highlights.
+     */
+    #clear_selections() {
+        if (!this.selections.length)
+            return;
+        for (const s of this.selections)
+            s.selected = false;
+        this.selections = [];
     }
     reset_items(items) {
         for (const item of items) {
@@ -116,84 +187,96 @@ export class ContextmenuState {
             }
         }
     }
-    activate(item) {
-        if (item.is_menu) {
-            this.expand_selected();
-        }
-        else {
-            if (item.disabled())
-                return false;
-            let returned;
-            try {
-                returned = item.run()();
-            }
-            catch (error) {
-                const message = typeof error?.message === 'string' ? error.message : undefined;
-                item.error_message = message ?? 'unknown error';
-                this.error = message;
-            }
-            if (is_promise(returned)) {
-                item.pending = true;
-                item.error_message = null;
-                const promise = (item.promise = returned
-                    .then((result) => {
-                    if (promise !== item.promise)
-                        return;
-                    if (typeof result?.ok === 'boolean') {
-                        if (result.ok) {
-                            if (result.close !== false) {
-                                this.close();
-                            }
-                        }
-                        else {
-                            const message = typeof result.message === 'string' ? result.message : undefined;
-                            item.error_message = message ?? 'unknown error';
-                            this.error = message;
-                        }
-                    }
-                    else {
-                        // void or undefined - default behavior is to close
-                        this.close();
-                    }
-                    return result;
-                }, (err) => {
-                    if (promise !== item.promise)
-                        return;
-                    const message = typeof err?.message === 'string' ? err.message : undefined;
-                    item.error_message = message ?? 'unknown error';
-                    this.error = message;
-                })
-                    .finally(() => {
-                    if (promise !== item.promise)
-                        return;
-                    item.pending = false;
-                    item.promise = null;
-                }));
-                return item.promise; // async path
-            }
-            // synchronous path
-            if (typeof returned?.ok === 'boolean') {
-                if (returned.ok) {
-                    if (returned.close !== false) {
-                        this.close();
-                    }
-                }
-                else {
-                    const message = typeof returned.message === 'string' ? returned.message : undefined;
-                    item.error_message = message ?? 'unknown error';
-                    this.error = message;
+    /**
+     * Sets the error state for a failed activation.
+     * `error_message` falls back to `'unknown error'` so the entry always displays something,
+     * while `error` keeps the raw message so external consumers can detect its absence.
+     */
+    #handle_error(item, message) {
+        item.error_message = message ?? 'unknown error';
+        this.error = message;
+    }
+    /**
+     * Applies an activation result, returning `false` when it failed.
+     */
+    #handle_result(item, result) {
+        if (typeof result?.ok === 'boolean') {
+            if (result.ok) {
+                if (result.close !== false) {
+                    this.close();
                 }
             }
             else {
-                // void or undefined - default behavior is to close
-                this.close();
+                this.#handle_error(item, to_error_message(result));
+                return false;
             }
         }
+        else {
+            // void or undefined - default behavior is to close
+            this.close();
+        }
         return true;
     }
+    /**
+     * Activates `item` - expanding submenus, running entries.
+     *
+     * @returns for async runs, the activation promise; for sync runs, `false` when the
+     * activation didn't run (disabled) or failed (a throw or `{ok: false}`), else `true`
+     */
+    activate(item) {
+        if (item.is_menu) {
+            // select before expanding - `expand_selected` operates on the selection
+            // tail, and callers aren't required to have selected (hovered) `item` first
+            this.select(item);
+            this.expand_selected();
+            return true;
+        }
+        if (item.disabled())
+            return false;
+        let returned;
+        try {
+            returned = item.run()();
+        }
+        catch (error) {
+            // keep the menu open so the entry displays the error, matching the async failure path
+            this.#handle_error(item, to_error_message(error));
+            return false;
+        }
+        if (is_promise(returned)) {
+            item.pending = true;
+            item.error_message = null;
+            const promise = (item.promise = returned
+                .then((result) => {
+                if (promise !== item.promise)
+                    return;
+                this.#handle_result(item, result);
+                return result;
+            }, (err) => {
+                if (promise !== item.promise)
+                    return;
+                this.#handle_error(item, to_error_message(err));
+            })
+                .finally(() => {
+                if (promise !== item.promise)
+                    return;
+                item.pending = false;
+                item.promise = null;
+            }));
+            return item.promise; // async path
+        }
+        // synchronous path
+        return this.#handle_result(item, returned);
+    }
+    /**
+     * Activates the selected item, or if none is selected, selects the first.
+     * Returns `false` without activating when the selected item has unregistered
+     * out from under the selection (e.g. its component unmounted).
+     */
     activate_selected() {
         const selected = this.selections.at(-1);
         if (selected) {
+            if (!selected.menu.items.includes(selected))
+                return false;
             return this.activate(selected);
         }
         this.select_first();
@@ -203,7 +286,7 @@ export class ContextmenuState {
     // Could be improved but it's fine because we're using mutation and the N is very small,
     // and it allows us to have a single code path for the various selection methods.
     /**
-     * Activates the selected entry, or if none, selects the first.
+     * Selects `item` and its ancestor menus, deselecting everything else.
      */
     // TODO implement focus management per APG: call .focus() on the selected item's DOM element (requires storing element refs in EntryState/SubmenuState)
     select(item) {
@@ -243,6 +326,11 @@ export class ContextmenuState {
         }
         const item = this.selections.at(-1);
         const index = item.menu.items.indexOf(item);
+        if (index === -1) {
+            // the selected item unregistered out from under the selection - restart
+            this.select_first();
+            return;
+        }
         this.select(item.menu.items[index === item.menu.items.length - 1 ? 0 : index + 1]);
     }
     select_previous() {
@@ -252,6 +340,11 @@ export class ContextmenuState {
         }
         const item = this.selections.at(-1);
         const index = item.menu.items.indexOf(item);
+        if (index === -1) {
+            // the selected item unregistered out from under the selection - restart
+            this.select_last();
+            return;
+        }
         this.select(item.menu.items[index === 0 ? item.menu.items.length - 1 : index - 1]);
     }
     select_first() {
@@ -273,10 +366,9 @@ export class ContextmenuState {
     add_entry(run, disabled = () => false) {
         const menu = contextmenu_submenu_context.get_maybe() ?? this.root_menu;
         const entry = new EntryState(menu, run, disabled);
-        menu.items = [...menu.items, entry];
-        // TODO messy, runs more than needed
+        menu.add_item(entry);
         onDestroy(() => {
-            menu.items = [];
+            menu.remove_item(entry);
         });
         return entry;
     }
@@ -286,38 +378,33 @@ export class ContextmenuState {
     add_submenu() {
         const menu = contextmenu_submenu_context.get_maybe() ?? this.root_menu;
         const submenu = new SubmenuState(menu, menu.depth + 1);
-        menu.items = [...menu.items, submenu];
+        menu.add_item(submenu);
         contextmenu_submenu_context.set(submenu);
-        // TODO messy, runs more than needed
         onDestroy(() => {
-            menu.items = [];
+            menu.remove_item(submenu);
         });
         return submenu;
     }
 }
+// The dataset attribute is only a crawl marker for `contextmenu_query_params` -
+// the params themselves live in `contextmenu_params_by_element`, keyed by element.
 // The dataset key must not have capital letters or dashes or it'll differ between JS and DOM:
 // https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/dataset
 const CONTEXTMENU_DATASET_KEY = 'contextmenu';
 const CONTEXTMENU_DOM_QUERY = `a,[data-${CONTEXTMENU_DATASET_KEY}]`;
-const contextmenu_cache = new Map();
-let cache_key_counter = 0;
+const contextmenu_params_by_element = new WeakMap();
 /**
  * Creates an attachment that sets up contextmenu behavior on an element.
  * @param params - contextmenu parameters or nullish to disable
  */
 export const contextmenu_attachment = (params) => (el) => {
-    // TODO could clean up the dataset attr, maybe use a weakmap?
     if (params == null)
         return;
-    // Only create key once per element, reuse on updates
-    let key = el.dataset[CONTEXTMENU_DATASET_KEY];
-    if (!key) {
-        key = cache_key_counter++ + '';
-        el.dataset[CONTEXTMENU_DATASET_KEY] = key;
-    }
-    contextmenu_cache.set(key, params);
+    el.dataset[CONTEXTMENU_DATASET_KEY] = '';
+    contextmenu_params_by_element.set(el, params);
     return () => {
-        contextmenu_cache.delete(key);
+        contextmenu_params_by_element.delete(el);
+        delete el.dataset[CONTEXTMENU_DATASET_KEY]; // eslint-disable-line @typescript-eslint/no-dynamic-delete
     };
 };
 const CONTEXTMENU_OPEN_VIBRATE_DURATION = 17;
@@ -325,9 +412,9 @@ const CONTEXTMENU_OPEN_VIBRATE_DURATION = 17;
  * Opens the contextmenu, if appropriate,
  * querying the menu items from the DOM starting at the event target.
  * @param target - the leaf element from which to open the contextmenu
- * @param x - the page X coordinate at which to open the contextmenu, typically the mouse `pageX`
- * @param y - the page Y coordinate at which to open the contextmenu, typically the mouse `pageY`
- * @param contextmenu - the contextmenu store
+ * @param x - the client (viewport) X coordinate at which to open the contextmenu, typically the mouse `clientX` - the menu positions with `fixed`
+ * @param y - the client (viewport) Y coordinate at which to open the contextmenu, typically the mouse `clientY` - the menu positions with `fixed`
+ * @param contextmenu - the contextmenu state
  * @param options - optional configuration for filtering entries and haptic feedback
  * @returns a boolean indicating if the menu was opened or not
  */
@@ -340,7 +427,7 @@ export const contextmenu_open = (target, x, y, contextmenu, options) => {
     // No-op if empty
     if (!params?.length)
         return false;
-    contextmenu.open(params, x, y);
+    contextmenu.open(params, x, y, target);
     // `navigator.vibrate()` works with `ContextmenuRoot` but gets blocked by some browsers
     // when used with `ContextmenuRootForSafariCompatibility` because its longpress
     // workaround triggers from a timeout rather than a direct user interaction.
@@ -353,20 +440,17 @@ const contextmenu_query_params = (target) => {
     let params = null;
     // crawl DOM for contextmenu entries
     let el = target;
-    let cache_key, cached;
     while ((el = el?.closest(CONTEXTMENU_DOM_QUERY))) {
-        if ((cache_key = el.dataset[CONTEXTMENU_DATASET_KEY])) {
-            params ??= [];
-            cached = contextmenu_cache.get(cache_key);
-            if (cached === undefined) {
-                continue;
-            }
+        // Params may be missing when the element matched as a bare `<a>`, or when a
+        // stale marker was left behind - treat the element as having no registered entries.
+        const registered = contextmenu_params_by_element.get(el);
+        if (registered !== undefined) {
             // preserve bubbling order
-            if (Array.isArray(cached)) {
-                (params ??= []).push(...cached);
+            if (Array.isArray(registered)) {
+                (params ??= []).push(...registered);
             }
             else {
-                (params ??= []).push(cached);
+                (params ??= []).push(registered);
             }
         }
         if (el.tagName === 'A') {
@@ -386,7 +470,7 @@ const contextmenu_query_params = (target) => {
                 snippet: 'text',
                 props: {
                     content: 'copy text',
-                    icon: '📋',
+                    icon: icon_copy,
                     run: async () => {
                         await navigator.clipboard.writeText(text);
                     },
@@ -400,11 +484,14 @@ const contextmenu_query_params = (target) => {
 const non_scoped_roots = new Set();
 /**
  * Registers a contextmenu root and warns if multiple non-scoped roots are detected.
- * Only active in development mode. Automatically handles cleanup on unmount.
+ * Only active in development mode - `DEV` is a build-time constant, so production
+ * bundles eliminate the check. Automatically handles cleanup on unmount.
  *
  * @param get_scoped - getter function that returns the current scoped value
  */
 export const contextmenu_check_global_root = (get_scoped) => {
+    if (!DEV)
+        return;
     $effect(() => {
         const id = Symbol('contextmenu_root');
         if (!get_scoped()) {

package/dist/declaration.svelte.d.ts

@@ -296,6 +296,7 @@ export declare class Declaration {
     /**
      * 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: string[] | undefined;
     /**

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,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"}
+{"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;;;;OAIG;IACH,kBAAkB,uBAAoD;IAEtE;;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

@@ -102,8 +102,9 @@ export class Declaration {
     /**
      * 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(field(this.declaration_json, 'alsoExportedFrom'));
+    also_exported_from = $derived(this.declaration_json.alsoExportedFrom);
     /**
      * Mutation documentation from `@mutates` tags, mapping parameter names to descriptions.
      */

package/dist/icons.d.ts

@@ -130,6 +130,12 @@ export declare const icon_pause: {
         d: string;
     }[];
 };
+export declare const icon_stop: {
+    label: string;
+    paths: {
+        d: string;
+    }[];
+};
 export declare const icon_checkmark: {
     label: string;
     paths: {
@@ -412,19 +418,25 @@ export declare const icon_session: {
         d: string;
     }[];
 };
-export declare const icon_action_type_local_call: {
+export declare const icon_action_local_call: {
+    label: string;
+    paths: {
+        d: string;
+    }[];
+};
+export declare const icon_action_remote_notification: {
     label: string;
     paths: {
         d: string;
     }[];
 };
-export declare const icon_action_type_remote_notification: {
+export declare const icon_action_request_response: {
     label: string;
     paths: {
         d: string;
     }[];
 };
-export declare const icon_action_type_request_response: {
+export declare const icon_link: {
     label: string;
     paths: {
         d: string;

package/dist/icons.d.ts.map

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

package/dist/icons.js

@@ -155,6 +155,12 @@ export const icon_pause = {
         },
     ],
 };
+export const icon_stop = {
+    label: 'stop',
+    paths: [
+        { d: 'M30 23H70A7 7 0 0 1 77 30V70A7 7 0 0 1 70 77H30A7 7 0 0 1 23 70V30A7 7 0 0 1 30 23Z' },
+    ],
+};
 // --- Validation ---
 export const icon_checkmark = {
     label: 'checkmark',
@@ -507,7 +513,7 @@ export const icon_session = {
     ],
 };
 // --- Action Types ---
-export const icon_action_type_local_call = {
+export const icon_action_local_call = {
     label: 'local call, lightning bolt to target',
     paths: [
         {
@@ -518,7 +524,7 @@ export const icon_action_type_local_call = {
         },
     ],
 };
-export const icon_action_type_remote_notification = {
+export const icon_action_remote_notification = {
     label: 'remote notification, lightning bolt with signal',
     paths: [
         {
@@ -528,7 +534,7 @@ export const icon_action_type_remote_notification = {
         { d: 'M78 27a27 27 0 0 1 0 46 24 24 0 0 0 0-46z' },
     ],
 };
-export const icon_action_type_request_response = {
+export const icon_action_request_response = {
     label: 'request response, opposing lightning bolts',
     paths: [
         {
@@ -537,6 +543,14 @@ export const icon_action_type_request_response = {
     ],
 };
 // --- Links ---
+export const icon_link = {
+    label: 'link, diagonal chain',
+    paths: [
+        {
+            d: 'M34 53A20 20 0 1 1 53 34L44 33.6A11 11 0 1 0 33.6 44ZM66 47A20 20 0 1 1 47 66L56 66.4A11 11 0 1 0 66.4 56ZM34.4 41.5L58.5 65.6L65.6 58.5L41.5 34.4Z',
+        },
+    ],
+};
 export const icon_external_link = {
     label: 'external link, arrow out of box',
     paths: [