@fusion.dev/helix-headless 0.208.0 → 0.209.0

package/dist/carousel/root/carousel-root.js

@@ -1,5 +1,5 @@
 import { __decorate } from "tslib";
-import { ChildrenController, capturePointer, customElement, formatWords, HelixActivateEvent, HelixElement, HelixSelectEvent, hostAria, inlineStep, isRtl, MIRROR_RULE, motionPaused, numberConverter, onMotionChange, reducedMotion, requestChange, SCROLLER_RULE, timeConverter, words, } from '@fusion.dev/helix-core';
+import { assignSlot, ChildrenController, capturePointer, customElement, formatWords, HelixActivateEvent, HelixElement, HelixSelectEvent, hostAria, inlineStep, isRtl, MIRROR_RULE, motionPaused, numberConverter, onMotionChange, reducedMotion, requestChange, SCROLLER_RULE, timeConverter, words, } from '@fusion.dev/helix-core';
 import { caretLeft, caretRight, play, stop } from '@fusion.dev/helix-icons';
 import { html, nothing } from 'lit';
 import { property, state } from 'lit/decorators.js';
@@ -464,16 +464,20 @@ let HelixHeadlessCarousel = class HelixHeadlessCarousel extends HelixElement {
             return;
         }
         for (const name of ICON_SLOTS) {
-            this.renderRoot
-                ?.querySelector?.(`slot[name="${name}"]`)
-                ?.assign?.(...this.iconsFor(name));
+            const slot = this.renderRoot?.querySelector?.(`slot[name="${name}"]`);
+            if (slot) {
+                assignSlot(slot, ...this.iconsFor(name));
+            }
         }
         const panes = this.renderRoot?.querySelectorAll?.('[part="slide"] slot');
         if (!panes) {
             return;
         }
         this.slides.forEach((slide, index) => {
-            panes[index]?.assign?.(slide);
+            const pane = panes[index];
+            if (pane) {
+                assignSlot(pane, slide);
+            }
         });
     }
     runEnd() {

package/dist/chat/root/chat-root.js

@@ -1,6 +1,6 @@
 var HelixHeadlessChat_1;
 import { __decorate } from "tslib";
-import { ChildrenController, customElement, deepActiveElement, drawIcon, focusableElements, formatWords, HelixBeforePinEvent, HelixElement, HelixHistoryEvent, HelixPinEvent, hostAria, MixinCollection, numberConverter, onUnlessFalse, reportRuntime, requestChange, SCROLLER_RULE, UpgradeController, VIRTUAL_RULE, VirtualizeController, whenHydrated, words, wordsConverter, } from '@fusion.dev/helix-core';
+import { assignSlot, ChildrenController, customElement, deepActiveElement, drawIcon, focusableElements, formatWords, HelixBeforePinEvent, HelixElement, HelixHistoryEvent, HelixPinEvent, hostAria, MixinCollection, numberConverter, onUnlessFalse, reportRuntime, requestChange, SCROLLER_RULE, UpgradeController, VIRTUAL_RULE, VirtualizeController, whenHydrated, words, wordsConverter, } from '@fusion.dev/helix-core';
 import { arrowDown } from '@fusion.dev/helix-icons';
 import { nothing } from 'lit';
 import { property, state } from 'lit/decorators.js';
@@ -291,9 +291,12 @@ let HelixHeadlessChat = class HelixHeadlessChat extends MixinCollection(HelixEle
             }
             return;
         }
-        log.assign(...(this.fed ? [] : this.messages));
+        assignSlot(log, ...(this.fed ? [] : this.messages));
         for (const name of REGIONS) {
-            root?.querySelector?.(`slot[name="${name}"]`)?.assign?.(...this.given(name));
+            const slot = root?.querySelector?.(`slot[name="${name}"]`);
+            if (slot) {
+                assignSlot(slot, ...this.given(name));
+            }
         }
     }
     given(name) {

package/dist/data-table/root/data-table-root.js

@@ -1,6 +1,6 @@
 var HelixHeadlessDataTable_1;
 import { __decorate } from "tslib";
-import { anchorAt, arranged, auditChildren, auditServed, commaList, countLabel, customElement, cycle, deepActiveElement, deepContains, everyState, format, formatWords, gridMove, HelixActivateEvent, HelixElement, HelixExpandEvent, HelixFilterEvent, HelixFilteredEvent, HelixLoadMoreEvent, HelixNavigateEvent, HelixReorderEvent, HelixReorderedEvent, HelixSelectEvent, HelixSelectedEvent, HelixSortEvent, HelixSortedEvent, handedLocale, hostAria, inlineStep, inRowOrder, MIRROR_RULE, MixinCollection, markRegion, numberConverter, onAndroid, ordered, pageRows, parse, placeKey, ReorderController, rangeAdd, reportRuntime, requestChange, requestReorder, SCROLLER_RULE, scrollingAncestor, scrollRoom, selectsAll, Typeahead, toggleEvery, treeArrow, typesCharacter, VIRTUAL_RULE, VirtualizeController, valueAt, whenHydrated, window_, words, wordsLocale, writtenList, } from '@fusion.dev/helix-core';
+import { anchorAt, arranged, assignSlot, auditChildren, auditServed, commaList, countLabel, customElement, cycle, deepActiveElement, deepContains, everyState, format, formatWords, gridMove, HelixActivateEvent, HelixElement, HelixExpandEvent, HelixFilterEvent, HelixFilteredEvent, HelixLoadMoreEvent, HelixNavigateEvent, HelixReorderEvent, HelixReorderedEvent, HelixSelectEvent, HelixSelectedEvent, HelixSortEvent, HelixSortedEvent, handedLocale, hostAria, inlineStep, inRowOrder, MIRROR_RULE, MixinCollection, markRegion, numberConverter, onAndroid, ordered, pageRows, parse, placeKey, ReorderController, rangeAdd, reportRuntime, requestChange, requestReorder, SCROLLER_RULE, scrollingAncestor, scrollRoom, selectsAll, Typeahead, toggleEvery, treeArrow, typesCharacter, VIRTUAL_RULE, VirtualizeController, valueAt, whenHydrated, window_, words, wordsLocale, writtenList, } from '@fusion.dev/helix-core';
 import { caretDown, caretRight, dotsSixVertical } from '@fusion.dev/helix-icons';
 import { nothing } from 'lit';
 import { property, state } from 'lit/decorators.js';
@@ -924,10 +924,11 @@ let HelixHeadlessDataTable = class HelixHeadlessDataTable extends MixinCollectio
             return;
         }
         const columns = this.orderedColumns;
-        head.assign(...columns);
-        root
-            .querySelector('[part="table"] > slot:not([name])')
-            ?.assign(...(this.serving ? this.servedRows : []));
+        assignSlot(head, ...columns);
+        const served = root.querySelector('[part="table"] > slot:not([name])');
+        if (served) {
+            assignSlot(served, ...(this.serving ? this.servedRows : []));
+        }
         const rest = [...this.children].filter((child) => !columns.includes(child));
         for (const [name, wanted] of [
             ['toolbar', true],
@@ -937,8 +938,8 @@ let HelixHeadlessDataTable = class HelixHeadlessDataTable extends MixinCollectio
             ['loading', true],
         ]) {
             const slot = root.querySelector(`slot[name="${name}"]`);
-            if (slot?.assign && wanted) {
-                slot.assign(...rest.filter((child) => child.getAttribute('slot') === name));
+            if (slot && wanted) {
+                assignSlot(slot, ...rest.filter((child) => child.getAttribute('slot') === name));
             }
         }
     }

package/dist/element-events.generated.js

@@ -339,6 +339,15 @@ registerElementEvents({
     'helix-headless-tabs': ['helix-activate', 'helix-before-activate', 'helix-select'],
     'helix-headless-tag': ['helix-dismiss'],
     'helix-headless-tag-group': ['change', 'helix-before-change', 'helix-dismiss'],
+    'helix-headless-terminal': [
+        'helix-copy',
+        'helix-terminal-bell',
+        'helix-terminal-input',
+        'helix-terminal-link',
+        'helix-terminal-resize',
+        'helix-terminal-restart',
+        'helix-terminal-title',
+    ],
     'helix-headless-textarea': ['change', 'helix-before-change', 'helix-clear', 'input'],
     'helix-headless-time-input': [
         'change',

package/dist/index.d.ts

@@ -103,6 +103,7 @@ export * from './switch/index.js';
 export * from './table/index.js';
 export * from './tabs/index.js';
 export * from './tag/index.js';
+export * from './terminal/index.js';
 export * from './textarea/index.js';
 export * from './time-input/index.js';
 export * from './time-picker/index.js';

package/dist/index.js

@@ -94,6 +94,7 @@ export * from './switch/index.js';
 export * from './table/index.js';
 export * from './tabs/index.js';
 export * from './tag/index.js';
+export * from './terminal/index.js';
 export * from './textarea/index.js';
 export * from './time-input/index.js';
 export * from './time-picker/index.js';

package/dist/outline/root/outline-root.js

@@ -1,5 +1,5 @@
 import { __decorate } from "tslib";
-import { customElement, elementById, HelixActivateEvent, HelixElement, IndicatorController, numberConverter, plainClick, reflectElements, scrollingAncestor, scrollWithin, words, } from '@fusion.dev/helix-core';
+import { assignSlot, customElement, elementById, HelixActivateEvent, HelixElement, IndicatorController, numberConverter, plainClick, reflectElements, scrollingAncestor, scrollWithin, words, } from '@fusion.dev/helix-core';
 import { html, nothing } from 'lit';
 import { property } from 'lit/decorators.js';
 import { levelOf, nest } from '../levels.js';
@@ -296,22 +296,27 @@ let HelixHeadlessOutline = class HelixHeadlessOutline extends HelixElement {
         }
         const root = this.renderRoot;
         const heading = root?.querySelector?.('slot[name="heading"]');
-        heading?.assign?.(...this.knownChildren.filter((child) => child.slot === 'heading'));
-        root
-            ?.querySelector?.('slot[name="indicator"]')
-            ?.assign?.(...this.knownChildren.filter((child) => child.slot === 'indicator'));
+        if (heading) {
+            assignSlot(heading, ...this.knownChildren.filter((child) => child.slot === 'heading'));
+        }
+        const indicator = root?.querySelector?.('slot[name="indicator"]');
+        if (indicator) {
+            assignSlot(indicator, ...this.knownChildren.filter((child) => child.slot === 'indicator'));
+        }
         const run = this.run;
         if (run) {
             for (const slot of root?.querySelectorAll?.('slot[data-link]') ?? []) {
                 const link = run[Number(slot.dataset.link)];
                 if (link) {
-                    slot.assign(link);
+                    assignSlot(slot, link);
                 }
             }
             return;
         }
         const plain = root?.querySelector?.('nav > slot:not([role])');
-        plain?.assign?.(...[...this.childNodes].filter((node) => node instanceof Element ? !OWN_SLOTS.has(node.slot) : node instanceof Text));
+        if (plain) {
+            assignSlot(plain, ...[...this.childNodes].filter((node) => node instanceof Element ? !OWN_SLOTS.has(node.slot) : node instanceof Text));
+        }
     }
     updated(changed) {
         super.updated(changed);

package/dist/terminal/index.d.ts

@@ -0,0 +1,3 @@
+export type { TerminalShortcut } from './keys.js';
+export type { TerminalColorName, TerminalFindOptions, TerminalLook, TerminalRenderer, TerminalSettings, TerminalSink, } from './root/terminal-root.js';
+export { HelixHeadlessTerminal } from './root/terminal-root.js';

package/dist/terminal/index.js

@@ -0,0 +1 @@
+export { HelixHeadlessTerminal } from './root/terminal-root.js';

package/dist/terminal/keys.d.ts

@@ -0,0 +1,14 @@
+import { type ChordPress } from '@fusion.dev/helix-core';
+/** What a terminal frame does with a key press before the program sees it. */
+export type TerminalShortcut = 'copy' | 'find' | 'tab-focus';
+/** The chord for a shortcut on this keyboard, or `undefined` where the frame takes none. */
+export declare const chordOf: (shortcut: TerminalShortcut, apple: boolean) => string | undefined;
+/** Which shortcut a press is, or `null` for a press the program should have. */
+export declare const shortcutOf: (press: ChordPress, apple: boolean) => TerminalShortcut | null;
+/**
+ * A chord as a reader says it, such as "Control+Shift+M": the key names
+ * `aria-keyshortcuts` uses, which a screen reader reads aloud whole.
+ */
+export declare const spokenChord: (shortcut: TerminalShortcut, apple: boolean) => string;
+/** Whether a press is a bare Tab or Shift+Tab, which moves focus while Tab is set to. */
+export declare const isTab: (press: ChordPress) => boolean;

package/dist/terminal/keys.js

@@ -0,0 +1,20 @@
+import { ariaChord, matchesChord } from '@fusion.dev/helix-core';
+const CHORDS = {
+    apple: { copy: undefined, find: 'cmd+f', 'tab-focus': 'ctrl+shift+m' },
+    other: { copy: 'ctrl+shift+c', find: 'ctrl+shift+f', 'tab-focus': 'ctrl+m' },
+};
+export const chordOf = (shortcut, apple) => CHORDS[apple ? 'apple' : 'other'][shortcut];
+export const shortcutOf = (press, apple) => {
+    for (const shortcut of ['copy', 'find', 'tab-focus']) {
+        const chord = chordOf(shortcut, apple);
+        if (chord !== undefined && matchesChord(press, chord, apple)) {
+            return shortcut;
+        }
+    }
+    return null;
+};
+export const spokenChord = (shortcut, apple) => {
+    const chord = chordOf(shortcut, apple);
+    return chord === undefined ? '' : ariaChord(chord, apple).replace('Meta', 'Command');
+};
+export const isTab = (press) => press.key === 'Tab' && !press.altKey && !press.ctrlKey && !press.metaKey;