jssm 5.162.7 → 5.162.9

package/dist/wc/viz.define.js

@@ -9,11 +9,9 @@ export { FslViz } from './viz.js';
 /**
  * Returns true when `tag_name` is exactly `fsl-<suffix>` or `jssm-<suffix>`
  * (case-insensitive).
- *
  * @param tag_name - The element tag name to test (e.g. `"FSL-VIZ"`, `"jssm-viz"`).
  * @param suffix   - The suffix to match after the prefix (e.g. `"viz"`).
  * @returns `true` when `tag_name` is `fsl-<suffix>` or `jssm-<suffix>`.
- *
  * @example
  * wc_suffix_matches('FSL-VIZ', 'viz');   // true
  * wc_suffix_matches('jssm-viz', 'viz');  // true
@@ -27,18 +25,15 @@ export { FslViz } from './viz.js';
  * callers pass the canonical class and a thin subclass for the synonym.
  * The function is idempotent: if either tag is already registered it skips
  * that `define` call rather than throwing.
- *
  * @param canonical_tag  - The primary tag name (e.g. `"fsl-instance"`).
  * @param synonym_tag    - The alias tag name (e.g. `"jssm-instance"`).
  * @param CanonicalClass - Constructor to register under `canonical_tag`.
  * @param SynonymClass   - Constructor to register under `synonym_tag`
  *                         (must be a distinct class from `CanonicalClass`).
- *
  * @example
  * class FslInstance extends HTMLElement {}
  * class JssmInstance extends FslInstance {}
  * define_with_synonym('fsl-instance', 'jssm-instance', FslInstance, JssmInstance);
- *
  * @see closest_wc
  */
 function define_with_synonym(canonical_tag, synonym_tag, CanonicalClass, SynonymClass) {
@@ -50,7 +45,6 @@ function define_with_synonym(canonical_tag, synonym_tag, CanonicalClass, Synonym
 
 /**
  * Thin subclass so `<jssm-viz>` registers under a distinct constructor.
- *
  * @deprecated The `jssm-*` tag and the `JssmViz` class alias are deprecated
  * since v5 in favor of the canonical `<fsl-viz>` / {@link FslViz}, for
  * fsl.tools brand alignment. They remain functional but are slated for

package/dist/wc/viz.js

@@ -11,11 +11,9 @@ import { machine_to_svg_string, fsl_to_svg_string } from 'jssm/viz';
 /**
  * Returns true when `tag_name` is exactly `fsl-<suffix>` or `jssm-<suffix>`
  * (case-insensitive).
- *
  * @param tag_name - The element tag name to test (e.g. `"FSL-VIZ"`, `"jssm-viz"`).
  * @param suffix   - The suffix to match after the prefix (e.g. `"viz"`).
  * @returns `true` when `tag_name` is `fsl-<suffix>` or `jssm-<suffix>`.
- *
  * @example
  * wc_suffix_matches('FSL-VIZ', 'viz');   // true
  * wc_suffix_matches('jssm-viz', 'viz');  // true
@@ -25,15 +23,12 @@ import { machine_to_svg_string, fsl_to_svg_string } from 'jssm/viz';
 /**
  * Returns the nearest ancestor of `el` (or `el` itself) whose tag is
  * `fsl-<suffix>` or `jssm-<suffix>`, or `null` if none exists.
- *
  * @param el     - The element to start the search from.
  * @param suffix - The suffix to match (e.g. `"instance"`).
  * @returns The closest matching ancestor element, or `null`.
- *
  * @example
  * // <fsl-instance><div id="k"></div></fsl-instance>
  * closest_wc(document.getElementById('k'), 'instance'); // <fsl-instance>
- *
  * @see wc_suffix_matches
  */
 function closest_wc(el, suffix) {
@@ -50,10 +45,8 @@ function closest_wc(el, suffix) {
  *
  * Each edge's label text is hoisted out of its edge group to the very top.
  * Markup that isn't graphviz output (no `g.graph`) is returned untouched.
- *
  * @param svg - SVG markup from the viz pipeline (`machine_to_svg_string`, etc.).
  * @returns The reordered SVG markup; identical input for non-graphviz SVG.
- *
  * @example
  * // <g class="graph"><polygon/>…<g class="node"/><g class="edge"><path/><text/></g></g>
  * // becomes: <g class="graph"><polygon/><g class="edge"><path/></g><g class="node"/><text/></g>
@@ -70,23 +63,23 @@ function reorder_svg_layers(svg) {
     // Hoist every edge's label out of its group so it lands on the top layer.
     const labels = [];
     for (const edge of edges) {
-        for (const text of [...edge.querySelectorAll(':scope > text')]) {
+        for (const text of edge.querySelectorAll(':scope > text')) {
             labels.push(text);
         }
     }
     // appendChild moves a node to the end (top of the stack), so appending in
     // back-to-front order yields: background, edges, nodes, labels.
     if (background !== null) {
-        graph.appendChild(background);
+        graph.append(background);
     }
     for (const edge of edges) {
-        graph.appendChild(edge);
+        graph.append(edge);
     }
     for (const node of nodes) {
-        graph.appendChild(node);
+        graph.append(node);
     }
     for (const label of labels) {
-        graph.appendChild(label);
+        graph.append(label);
     }
     return new XMLSerializer().serializeToString(doc);
 }
@@ -112,7 +105,6 @@ var __decorate = (undefined && undefined.__decorate) || function (decorators, ta
  * normalize_viz_error('bare string failure');
  * // => { message: 'bare string failure', location: undefined }
  * ```
- *
  * @param e The thrown value to normalize.
  * @returns A `{ message, location }` object suitable for use as the
  * `detail` of a `viz-error` `CustomEvent`.
@@ -123,9 +115,11 @@ function normalize_viz_error(e) {
         const raw_message = rec.message;
         const message = (typeof raw_message === 'string' && raw_message.length > 0)
             ? raw_message
+            // eslint-disable-next-line @typescript-eslint/no-base-to-string -- intentional last-resort coercion: Error/JssmError throws stringify meaningfully, and '[object Object]' is the accepted fallback for exotic message-less objects
             : String(e);
         return { message, location: rec.location };
     }
+    // eslint-disable-next-line @typescript-eslint/no-base-to-string -- unreachable for objects: the typeof-object branch above returns, so `e` is a primitive (or function) here and String() is meaningful
     return { message: String(e), location: undefined };
 }
 /**
@@ -141,7 +135,6 @@ function normalize_viz_error(e) {
  *      bind to the parent's machine and re-render on every `transition`
  *      event.  The element's own `fsl` attribute is ignored in this mode;
  *      supplying it emits a `console.warn` for developer feedback.
- *
  * @element fsl-viz
  * @cssproperty [--jssm-viz-min-height=100px] - Minimum height of the rendered SVG container.
  * @fires {CustomEvent<{ message: string; location?: unknown }>} viz-error - Fires when the FSL source fails to parse or render.
@@ -179,7 +172,6 @@ class FslViz extends LitElement {
      * `engine` change — but only in standalone mode.  In nested mode the
      * `fsl` attribute is ignored; renders are driven by the parent machine's
      * transition events instead.
-     *
      * @param changed - Map of changed reactive properties supplied by Lit.
      */
     willUpdate(changed) {
@@ -188,12 +180,12 @@ class FslViz extends LitElement {
             // parent's transition events.  `engine` changes still re-render
             // because they apply to whichever source is in use.
             if (changed.has('engine')) {
-                this._rerenderFromHostMachine();
+                void this._rerenderFromHostMachine();
             }
             return;
         }
         if (changed.has('fsl') || changed.has('engine')) {
-            this._renderSvg();
+            void this._renderSvg();
         }
     }
     /**
@@ -216,7 +208,6 @@ class FslViz extends LitElement {
         // attribute is almost certainly a bug.  Warn but proceed — the parent
         // owns the machine.
         if (typeof this.fsl === 'string' && this.fsl.trim().length > 0) {
-            // eslint-disable-next-line no-console
             console.warn('<fsl-viz>: `fsl` ignored when nested inside <fsl-instance>; parent owns the machine');
         }
         this._parent_host = host;
@@ -232,14 +223,14 @@ class FslViz extends LitElement {
             }
             let sub;
             try {
-                sub = host.machine.on('transition', () => { this._rerenderFromHostMachine(); });
+                sub = host.machine.on('transition', () => { void this._rerenderFromHostMachine(); });
             }
-            catch (e) {
+            catch (error) {
                 // The parent existed but its machine wasn't ready / threw.  Emit
                 // a viz-error so the consumer learns about it instead of silently
                 // showing nothing.
                 this.dispatchEvent(new CustomEvent('viz-error', {
-                    detail: normalize_viz_error(e),
+                    detail: normalize_viz_error(error),
                     bubbles: true,
                     composed: true,
                 }));
@@ -250,13 +241,14 @@ class FslViz extends LitElement {
             // rebuild): the old subscription is on a dead machine object.
             const on_rebuild = () => {
                 sub();
-                sub = host.machine.on('transition', () => { this._rerenderFromHostMachine(); });
+                sub = host.machine.on('transition', () => { void this._rerenderFromHostMachine(); });
                 this._parent_sub = sub;
-                this._rerenderFromHostMachine();
+                void this._rerenderFromHostMachine();
             };
             host.addEventListener('fsl-machine-rebuilt', on_rebuild);
             this._host_unbind = () => { host.removeEventListener('fsl-machine-rebuilt', on_rebuild); };
-            this._rerenderFromHostMachine();
+            void this._rerenderFromHostMachine();
+            return;
         });
     }
     /**
@@ -282,7 +274,6 @@ class FslViz extends LitElement {
      * {@link machine_to_svg_string} pipeline and commits the result to
      * `_svg`.  On failure emits a `viz-error` `CustomEvent` and clears the
      * SVG.
-     *
      * @returns A promise that resolves once the render attempt has finished.
      */
     async _rerenderFromHostMachine() {
@@ -298,10 +289,10 @@ class FslViz extends LitElement {
                 this._svg = reorder_svg_layers(result);
             }
         }
-        catch (e) {
+        catch (error) {
             this._svg = '';
             this.dispatchEvent(new CustomEvent('viz-error', {
-                detail: normalize_viz_error(e),
+                detail: normalize_viz_error(error),
                 bubbles: true,
                 composed: true,
             }));
@@ -312,7 +303,6 @@ class FslViz extends LitElement {
      * `fsl_to_svg_string` pipeline. Updates `_svg` on success; emits a
      * `viz-error` `CustomEvent` on failure. Guards against stale results
      * when `fsl` changes mid-flight.
-     *
      * @returns A promise that resolves once the render attempt has finished.
      */
     async _renderSvg() {
@@ -328,10 +318,10 @@ class FslViz extends LitElement {
                 this._svg = reorder_svg_layers(result);
             }
         }
-        catch (e) {
+        catch (error) {
             this._svg = '';
             this.dispatchEvent(new CustomEvent('viz-error', {
-                detail: normalize_viz_error(e),
+                detail: normalize_viz_error(error),
                 bubbles: true,
                 composed: true,
             }));
@@ -345,7 +335,6 @@ class FslViz extends LitElement {
      * sanitized SVG. `unsafeHTML` is required because Lit's template-literal
      * interpolation otherwise escapes the markup as text. The directive name
      * makes the trust boundary explicit at the call site.
-     *
      * @returns A Lit `TemplateResult` wrapping the SVG in a `.container` div.
      */
     render() {
@@ -366,7 +355,6 @@ class FslViz extends LitElement {
      * viz.highlightTrace(['a', 'b']);
      * viz.clearHighlights();   // back to the default rendering
      * ```
-     *
      * @see highlightTrace
      */
     clearHighlights() {
@@ -378,7 +366,7 @@ class FslViz extends LitElement {
             return;
         }
         // Remove the inline styles that override the SVG presentation attributes.
-        const elements = container.querySelectorAll('.node, .edge, .node *, .edge *');
+        const elements = container.querySelectorAll(':scope .node, :scope .edge, :scope .node *, :scope .edge *');
         elements.forEach(el => {
             el.style.removeProperty('fill');
             el.style.removeProperty('stroke');
@@ -399,13 +387,11 @@ class FslViz extends LitElement {
      * // Highlight a -> b -> c in green, without dimming the rest:
      * viz.highlightTrace(['a', 'b', 'c'], { color: '#2e7d32', fadeOthers: false });
      * ```
-     *
      * @param trace   Ordered state names describing the path (e.g.
      *                `['A', 'B', 'C']`). Consecutive pairs select the edges
      *                `A->B` and `B->C`. An empty array is a no-op.
      * @param options Highlight styling; see {@link HighlightOptions}. Defaults
      *                to crimson with off-trace fading enabled.
-     *
      * @see clearHighlights
      * @see HighlightOptions
      */
@@ -419,7 +405,7 @@ class FslViz extends LitElement {
         }
         this.clearHighlights();
         const color = options.color || '#b71c1c'; // default: a distinct crimson
-        const fadeOthers = options.fadeOthers !== false; // default: true
+        const fadeOthers = options.fadeOthers !== false; // default: true — undefined must fade
         const targetNodes = new Set();
         const targetEdges = new Set();
         for (let i = 0; i < trace.length; i++) {

package/dist/wc/widgets.define.js

@@ -9,11 +9,9 @@ export * from './widgets.js';
 /**
  * Returns true when `tag_name` is exactly `fsl-<suffix>` or `jssm-<suffix>`
  * (case-insensitive).
- *
  * @param tag_name - The element tag name to test (e.g. `"FSL-VIZ"`, `"jssm-viz"`).
  * @param suffix   - The suffix to match after the prefix (e.g. `"viz"`).
  * @returns `true` when `tag_name` is `fsl-<suffix>` or `jssm-<suffix>`.
- *
  * @example
  * wc_suffix_matches('FSL-VIZ', 'viz');   // true
  * wc_suffix_matches('jssm-viz', 'viz');  // true
@@ -33,14 +31,11 @@ export * from './widgets.js';
  * dual-named components.
  *
  * Idempotent: skips the `define` call when the tag is already registered.
- *
  * @param canonical_tag - The `fsl-*` tag name (e.g. `"fsl-info-panel"`).
  * @param CanonicalClass - Constructor to register under `canonical_tag`.
- *
  * @example
  * class FslInfoPanel extends HTMLElement {}
  * define_canonical('fsl-info-panel', FslInfoPanel);
- *
  * @see define_with_synonym
  */
 function define_canonical(canonical_tag, CanonicalClass) {