@aceshooting/lyra-ui 2.1.0 → 2.3.0

package/dist/components/word-cloud/word-cloud.class.js

@@ -0,0 +1,307 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { html, nothing, svg } from 'lit';
+import { property, query, state } from 'lit/decorators.js';
+import { LyraElement } from '../../internal/lyra-element.js';
+import { srOnly } from '../../internal/a11y.js';
+import { layoutWordCloud, MAX_WORDS } from './word-cloud-layout.js';
+import { styles } from './word-cloud.styles.js';
+const DEFAULT_MIN_FONT_SIZE = 12;
+const DEFAULT_MAX_FONT_SIZE = 48;
+const PALETTE_SIZE = 8;
+const FALLBACK_PALETTE = ['#0969da', '#1a7f37', '#9a6700', '#cf222e', '#8250df', '#bf3989', '#0a7d91', '#57606a'];
+/** Must match `[part='word']`'s `font-weight` in word-cloud.styles.ts -- canvas
+ *  measures at `normal` weight by default, which is narrower than the actually
+ *  rendered bold glyphs, so the spiral layout's collision boxes would end up
+ *  too small versus what's actually painted if this ever drifts out of sync. */
+const WORD_FONT_WEIGHT = 600;
+const NAV_KEYS = new Set(['ArrowRight', 'ArrowDown', 'ArrowLeft', 'ArrowUp', 'Home', 'End']);
+/** Padding, in px, between a focused word's glyph box and its drawn focus ring. */
+const FOCUS_RING_PAD = 2;
+let scratchCtx;
+/** A detached canvas used solely to measure rendered text width for layout. */
+function getScratchCtx() {
+    if (scratchCtx === undefined) {
+        scratchCtx = document.createElement('canvas').getContext('2d');
+    }
+    return scratchCtx;
+}
+const warnedSkipCounts = new Set();
+function warnSkippedWords(count) {
+    if (warnedSkipCounts.has(count))
+        return;
+    warnedSkipCounts.add(count);
+    console.warn(`<lyra-word-cloud> could not place ${count} word(s) (blank text, over the ${MAX_WORDS}-word cap, or ` +
+        'the layout search was exhausted) -- they were dropped, not rendered.');
+}
+/**
+ * `<lyra-word-cloud>` — a zero-dependency SVG word/tag cloud. First-party
+ * invention (no Web Awesome equivalent). Each word's rendered size is scaled
+ * from its `weight` and placed via an outward Archimedean-spiral search (the
+ * standard word-cloud heuristic: heaviest words placed first, each one
+ * spiraling out from the center until it clears every word already placed).
+ *
+ * Unlike sibling `lyra-sparkline`/`lyra-heatmap` (one `role="img"` glyph
+ * standing in for an aggregate value), the individual words here are the
+ * meaningful interactive content — but with up to `MAX_WORDS` of them, making
+ * every single one its own tab stop would be a poor keyboard experience.
+ * Instead, like `lyra-heatmap`'s cells, the whole `[part="svg"]` is one tab
+ * stop with roving arrow-key focus (Home/End jump to the first/last word,
+ * Enter/Space activates the focused one), a drawn `[part="focus-ring"]`, and
+ * a visually-hidden `aria-live="polite"` status announcement. The SVG focus
+ * target carries the group role and accessible name so the semantics follow
+ * the element a keyboard user actually focuses.
+ *
+ * @customElement lyra-word-cloud
+ * @event lyra-word-click - Fired on click, or Enter/Space on the focused word.
+ * `detail: { text, weight, group }`.
+ * @csspart base - The word-cloud wrapper.
+ * @csspart svg - The word-cloud SVG.
+ * @csspart word - A rendered word.
+ * @csspart focus-ring - The keyboard focus ring.
+ * @csspart live-region - The visually hidden announcement region.
+ * @csspart empty - The empty-state message.
+ */
+export class LyraWordCloud extends LyraElement {
+    constructor() {
+        super(...arguments);
+        /** The words to lay out. Re-laid-out whenever this (or a sizing property) changes. */
+        this.words = [];
+        /** Font size, in px, for the lowest-weight word. */
+        this.minFontSize = DEFAULT_MIN_FONT_SIZE;
+        /** Font size, in px, for the highest-weight word. */
+        this.maxFontSize = DEFAULT_MAX_FONT_SIZE;
+        /** `sqrt` compresses the weight->font-size mapping so one heavy word doesn't dwarf the rest. */
+        this.scale = 'linear';
+        /** `mixed` lets some words render rotated 90° for denser packing. */
+        this.orientations = 'horizontal';
+        this.cachedLayout = { placed: [], skipped: [], width: 0, height: 0 };
+        /** Roving-focus cursor -- an index into `navOrder()`, not into `cachedLayout.placed`. */
+        this.focusedIndex = null;
+        /** Text of the visually-hidden `aria-live="polite"` status announcement. */
+        this.liveText = '';
+        /**
+         * Whether `role`/`aria-label` were present on the host *before* this
+         * element's own code ever wrote to them -- snapshotted once, in the very
+         * first `willUpdate()` (guarded by `hasUpdated`, which Lit only flips to
+         * `true` after that first update commits). Re-checking `hasAttribute()` on
+         * every update instead would self-poison: once this element writes its own
+         * default `aria-label` on the first render, `hasAttribute('aria-label')` is
+         * permanently `true` afterwards, which would wrongly look like an
+         * author-supplied value and freeze the label instead of refreshing it as
+         * `words` changes on later updates.
+         */
+        this.authorSuppliedRole = false;
+        this.authorSuppliedAriaLabel = false;
+        this.measureText = (text, fontSize) => {
+            const ctx = getScratchCtx();
+            if (!ctx)
+                return text.length * fontSize * 0.6;
+            ctx.font = `${WORD_FONT_WEIGHT} ${fontSize}px ${this.fontFamily()}`;
+            return ctx.measureText(text).width;
+        };
+        this.onWordClick = (word) => {
+            const order = this.navOrder();
+            const idx = order.findIndex((w) => w.originalIndex === word.originalIndex);
+            this.focusedIndex = idx === -1 ? null : idx;
+            if (idx !== -1)
+                this.announce(order[idx]);
+            this.svgEl?.focus();
+            this.activate(word);
+        };
+        this.onKeyDown = (e) => {
+            const order = this.navOrder();
+            if (order.length === 0)
+                return;
+            if (e.key === 'Enter' || e.key === ' ') {
+                e.preventDefault();
+                if (this.focusedIndex !== null)
+                    this.activate(order[this.focusedIndex]);
+                return;
+            }
+            if (!NAV_KEYS.has(e.key))
+                return;
+            e.preventDefault();
+            if (this.focusedIndex === null) {
+                this.focusedIndex = 0;
+                this.announce(order[0]);
+                return;
+            }
+            let next = this.focusedIndex;
+            if (e.key === 'ArrowRight' || e.key === 'ArrowDown')
+                next = Math.min(order.length - 1, this.focusedIndex + 1);
+            else if (e.key === 'ArrowLeft' || e.key === 'ArrowUp')
+                next = Math.max(0, this.focusedIndex - 1);
+            else if (e.key === 'Home')
+                next = 0;
+            else if (e.key === 'End')
+                next = order.length - 1;
+            this.focusedIndex = next;
+            this.announce(order[next]);
+        };
+    }
+    static { this.styles = [LyraElement.styles, styles, srOnly]; }
+    fontFamily() {
+        return getComputedStyle(this).getPropertyValue('--lyra-font').trim() || 'sans-serif';
+    }
+    paletteColors() {
+        if (this.palette?.length)
+            return this.palette;
+        const cs = getComputedStyle(this);
+        const colors = [];
+        for (let i = 0; i < PALETTE_SIZE; i++) {
+            colors.push(cs.getPropertyValue(`--lyra-word-cloud-color-${i + 1}`).trim() || FALLBACK_PALETTE[i]);
+        }
+        return colors;
+    }
+    /** Stable keyboard tab order -- the order words were declared in `words`,
+     *  independent of the weight-sorted placement order. */
+    navOrder() {
+        return [...this.cachedLayout.placed].sort((a, b) => a.originalIndex - b.originalIndex);
+    }
+    willUpdate(changed) {
+        if (changed.has('words') ||
+            changed.has('minFontSize') ||
+            changed.has('maxFontSize') ||
+            changed.has('scale') ||
+            changed.has('orientations')) {
+            this.relayout();
+        }
+        if (!this.hasUpdated) {
+            this.authorSuppliedRole = this.hasAttribute('role');
+            this.authorSuppliedAriaLabel = this.hasAttribute('aria-label');
+        }
+        // Only default role/aria-label when the author hasn't already supplied
+        // one -- unconditionally overwriting them on every update (including
+        // ones triggered purely by a `words` re-layout) would silently clobber a
+        // host's own accessible name/role on the very next data refresh.
+        if (!this.authorSuppliedRole)
+            this.setAttribute('role', 'group');
+        if (!this.authorSuppliedAriaLabel) {
+            this.setAttribute('aria-label', this.localize('wordCloud', undefined, {
+                count: this.cachedLayout.placed.length,
+                word: this.cachedLayout.placed.length === 1 ? 'word' : 'words',
+            }));
+        }
+    }
+    relayout() {
+        this.cachedLayout = layoutWordCloud(this.words, {
+            minFontSize: this.minFontSize,
+            maxFontSize: this.maxFontSize,
+            scale: this.scale,
+            orientations: this.orientations,
+            measureText: this.measureText,
+        });
+        if (this.cachedLayout.skipped.length > 0)
+            warnSkippedWords(this.cachedLayout.skipped.length);
+        // The previous focus cursor may no longer address a real word once the
+        // data changes out from under it.
+        this.focusedIndex = null;
+        this.liveText = '';
+    }
+    /** Forces a relayout so the font-family theme token (`--lyra-font`) is
+     *  re-read from computed style — mirrors `lyra-chart`'s `refreshTheme()`.
+     *  No global theme-broadcast event exists in lyra-ui to subscribe to
+     *  automatically; call this from a consumer's own theme-toggle handler. */
+    refreshTheme() {
+        this.relayout();
+        this.requestUpdate();
+    }
+    activate(word) {
+        this.emit('lyra-word-click', { text: word.text, weight: word.weight, group: word.group });
+    }
+    announce(word) {
+        this.liveText = `${word.text}, ${word.weight}`;
+    }
+    /** Axis-aligned focus-ring rect for `w`, already accounting for its rotation. */
+    focusRingRect(w) {
+        const boxW = w.rotated ? w.height : w.width;
+        const boxH = w.rotated ? w.width : w.height;
+        return {
+            x: w.x - boxW / 2 - FOCUS_RING_PAD,
+            y: w.y - boxH / 2 - FOCUS_RING_PAD,
+            width: boxW + 2 * FOCUS_RING_PAD,
+            height: boxH + 2 * FOCUS_RING_PAD,
+        };
+    }
+    render() {
+        const layout = this.cachedLayout;
+        if (layout.placed.length === 0) {
+            return html `<div part="base"><div part="empty">${this.localize('noData')}</div></div>`;
+        }
+        const colors = this.paletteColors();
+        const groupColor = new Map();
+        const colorFor = (word) => {
+            if (word.color)
+                return word.color;
+            if (word.group) {
+                if (!groupColor.has(word.group))
+                    groupColor.set(word.group, colors[groupColor.size % colors.length]);
+                return groupColor.get(word.group);
+            }
+            return colors[word.originalIndex % colors.length];
+        };
+        const order = this.navOrder();
+        const focused = this.focusedIndex !== null ? order[this.focusedIndex] : undefined;
+        const ring = focused ? this.focusRingRect(focused) : undefined;
+        return html `
+      <div part="base">
+        <svg
+          part="svg"
+          role="group"
+          aria-label=${this.getAttribute('aria-label') ?? nothing}
+          aria-describedby="live-region"
+          tabindex="0"
+          viewBox="0 0 ${layout.width} ${layout.height}"
+          @keydown=${this.onKeyDown}
+        >
+          ${layout.placed.map((w) => svg `<text
+              part="word"
+              x=${w.x}
+              y=${w.y}
+              font-size=${w.fontSize}
+              fill=${colorFor(w)}
+              transform=${w.rotated ? `rotate(-90, ${w.x}, ${w.y})` : nothing}
+              @click=${() => this.onWordClick(w)}
+            >${w.text}</text>`)}
+          ${ring
+            ? svg `<rect part="focus-ring" x=${ring.x} y=${ring.y} width=${ring.width} height=${ring.height}></rect>`
+            : ''}
+        </svg>
+        <div id="live-region" part="live-region" class="sr-only" role="status" aria-live="polite">${this.liveText}</div>
+      </div>
+    `;
+    }
+}
+__decorate([
+    property({ attribute: false })
+], LyraWordCloud.prototype, "words", void 0);
+__decorate([
+    property({ attribute: 'min-font-size', type: Number })
+], LyraWordCloud.prototype, "minFontSize", void 0);
+__decorate([
+    property({ attribute: 'max-font-size', type: Number })
+], LyraWordCloud.prototype, "maxFontSize", void 0);
+__decorate([
+    property()
+], LyraWordCloud.prototype, "scale", void 0);
+__decorate([
+    property()
+], LyraWordCloud.prototype, "orientations", void 0);
+__decorate([
+    property({ attribute: false })
+], LyraWordCloud.prototype, "palette", void 0);
+__decorate([
+    query('[part="svg"]')
+], LyraWordCloud.prototype, "svgEl", void 0);
+__decorate([
+    state()
+], LyraWordCloud.prototype, "focusedIndex", void 0);
+__decorate([
+    state()
+], LyraWordCloud.prototype, "liveText", void 0);
+//# sourceMappingURL=word-cloud.class.js.map

package/dist/components/word-cloud/word-cloud.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"word-cloud.class.js","sourceRoot":"","sources":["../../../src/components/word-cloud/word-cloud.class.ts"],"names":[],"mappings":"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"}

package/dist/components/word-cloud/word-cloud.d.ts

@@ -1,91 +1,2 @@
-import { type PropertyValues, type TemplateResult } from 'lit';
-import { LyraElement } from '../../internal/lyra-element.js';
-import { type WordCloudWord } from './word-cloud-layout.js';
-export type { WordCloudWord };
-/**
- * `<lyra-word-cloud>` — a zero-dependency SVG word/tag cloud. First-party
- * invention (no Web Awesome equivalent). Each word's rendered size is scaled
- * from its `weight` and placed via an outward Archimedean-spiral search (the
- * standard word-cloud heuristic: heaviest words placed first, each one
- * spiraling out from the center until it clears every word already placed).
- *
- * Unlike sibling `lyra-sparkline`/`lyra-heatmap` (one `role="img"` glyph
- * standing in for an aggregate value), the individual words here are the
- * meaningful interactive content — but with up to `MAX_WORDS` of them, making
- * every single one its own tab stop would be a poor keyboard experience.
- * Instead, like `lyra-heatmap`'s cells, the whole `[part="svg"]` is one tab
- * stop with roving arrow-key focus (Home/End jump to the first/last word,
- * Enter/Space activates the focused one), a drawn `[part="focus-ring"]`, and
- * a visually-hidden `aria-live="polite"` status announcement. The SVG focus
- * target carries the group role and accessible name so the semantics follow
- * the element a keyboard user actually focuses.
- *
- * @customElement lyra-word-cloud
- * @event lyra-word-click - Fired on click, or Enter/Space on the focused word.
- * `detail: { text, weight, group }`.
- * @csspart base - The word-cloud wrapper.
- * @csspart svg - The word-cloud SVG.
- * @csspart word - A rendered word.
- * @csspart focus-ring - The keyboard focus ring.
- * @csspart live-region - The visually hidden announcement region.
- * @csspart empty - The empty-state message.
- */
-export declare class LyraWordCloud extends LyraElement {
-    static styles: import("lit").CSSResultGroup[];
-    /** The words to lay out. Re-laid-out whenever this (or a sizing property) changes. */
-    words: WordCloudWord[];
-    /** Font size, in px, for the lowest-weight word. */
-    minFontSize: number;
-    /** Font size, in px, for the highest-weight word. */
-    maxFontSize: number;
-    /** `sqrt` compresses the weight->font-size mapping so one heavy word doesn't dwarf the rest. */
-    scale: 'linear' | 'sqrt';
-    /** `mixed` lets some words render rotated 90° for denser packing. */
-    orientations: 'horizontal' | 'mixed';
-    /** Custom categorical palette, cycled by word index (or by `group`, see `words`). Defaults to the `--lyra-word-cloud-color-*` tokens. */
-    palette?: string[];
-    private svgEl?;
-    private cachedLayout;
-    /** Roving-focus cursor -- an index into `navOrder()`, not into `cachedLayout.placed`. */
-    private focusedIndex;
-    /** Text of the visually-hidden `aria-live="polite"` status announcement. */
-    private liveText;
-    /**
-     * Whether `role`/`aria-label` were present on the host *before* this
-     * element's own code ever wrote to them -- snapshotted once, in the very
-     * first `willUpdate()` (guarded by `hasUpdated`, which Lit only flips to
-     * `true` after that first update commits). Re-checking `hasAttribute()` on
-     * every update instead would self-poison: once this element writes its own
-     * default `aria-label` on the first render, `hasAttribute('aria-label')` is
-     * permanently `true` afterwards, which would wrongly look like an
-     * author-supplied value and freeze the label instead of refreshing it as
-     * `words` changes on later updates.
-     */
-    private authorSuppliedRole;
-    private authorSuppliedAriaLabel;
-    private measureText;
-    private fontFamily;
-    private paletteColors;
-    /** Stable keyboard tab order -- the order words were declared in `words`,
-     *  independent of the weight-sorted placement order. */
-    private navOrder;
-    protected willUpdate(changed: PropertyValues): void;
-    private relayout;
-    /** Forces a relayout so the font-family theme token (`--lyra-font`) is
-     *  re-read from computed style — mirrors `lyra-chart`'s `refreshTheme()`.
-     *  No global theme-broadcast event exists in lyra-ui to subscribe to
-     *  automatically; call this from a consumer's own theme-toggle handler. */
-    refreshTheme(): void;
-    private activate;
-    private announce;
-    private onWordClick;
-    private onKeyDown;
-    /** Axis-aligned focus-ring rect for `w`, already accounting for its rotation. */
-    private focusRingRect;
-    render(): TemplateResult;
-}
-declare global {
-    interface HTMLElementTagNameMap {
-        'lyra-word-cloud': LyraWordCloud;
-    }
-}
+export * from './word-cloud.class.js';
+//# sourceMappingURL=word-cloud.d.ts.map

package/dist/components/word-cloud/word-cloud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"word-cloud.d.ts","sourceRoot":"","sources":["../../../src/components/word-cloud/word-cloud.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}