@knowark/componarkjs 1.14.0 → 1.14.1

package/lib/components/splitview/components/splitview.master.js

@@ -1,6 +1,9 @@
 import { Component } from "#base/index.js"
 
 const tag = 'ark-splitview-master'
+/**
+ * Master pane controller for split-view layout.
+ */
 export class SplitViewMaster extends Component {
   constructor () {
     super()
@@ -9,25 +12,31 @@ export class SplitViewMaster extends Component {
     this.masterEvent = this.masterEvent
   }
 
+  /** @param {object} context
+   *  @returns {this} */
   init (context = {}) {
     this.binding = 'splitview-master-listen'
     return super.init(context)
   }
 
+  /** @returns {string[]} */
   reflectedProperties () {
     return ['masterEvent']
   }
 
+  /** @returns {void} */
   connectedCallback () {
     this._syncMasterEventListener()
     super.connectedCallback()
   }
 
+  /** @returns {void} */
   disconnectedCallback () {
     this._removeMasterEventListener()
     super.disconnectedCallback()
   }
 
+  /** @returns {void} */
   _syncMasterEventListener () {
     const masterEvent = (this.masterEvent || '').trim()
     if (!masterEvent || masterEvent === this._boundMasterEvent) return
@@ -37,6 +46,7 @@ export class SplitViewMaster extends Component {
     this._boundMasterEvent = masterEvent
   }
 
+  /** @returns {void} */
   _removeMasterEventListener () {
     if (!this._boundMasterEvent) return
     this.removeEventListener(this._boundMasterEvent, this._onMasterEvent)

package/lib/components/splitview/index.js

@@ -1,3 +1,4 @@
+/** Master-detail split view components. */
 export { SplitViewDetail } from './components/splitview.detail.js'
 export { SplitViewMaster } from './components/splitview.master.js'
 export { SplitView } from './components/splitview.js'

package/lib/components/translate/components/translate.js

@@ -1,13 +1,24 @@
 import { Component } from "#base/index.js"
 
 const tag = 'ark-translate'
+ /**
+ * Translation component.
+ * @typedef {{key:string, namespace:string}} TranslatedKey
+ * @typedef {Record<string, Record<string, Record<string, string>>>} DictionaryStore
+ * @typedef {{language?:string, root?:string}} TransliterateOptions
+ */
 export class Translate extends Component {
+  /** @type {DictionaryStore} */
+  dictionary
+  /** @param {object} context
+   * @returns {this} */
   init (context = {}) {
     this.languages = this.languages
     this.global = context.global || window
     this.endpoint = context.endpoint || this.endpoint || '/locales'
     this.namespace = context.namespace || this.namespace || 'default'
     this.root = context.root || this.root || 'body'
+    /** @type {DictionaryStore} */
     this.dictionary = context.dictionary || {}
 
     const dictionary = (
@@ -15,7 +26,7 @@ export class Translate extends Component {
     if (dictionary) {
       const content = dictionary.content.textContent
       try {
-        this.dictionary = JSON.parse(content)
+        this.dictionary = /** @type {DictionaryStore} */ (JSON.parse(content))
       } catch (error) {
         this.emit('error', error)
       }
@@ -24,10 +35,12 @@ export class Translate extends Component {
     return super.init(context)
   }
 
+  /** @returns {string[]} */
   reflectedProperties () {
     return ['languages', 'endpoint', 'namespace', 'root']
   }
 
+  /** @returns {this} */
   render () {
     const languages = this.languages.split(',').filter(
       item => Boolean(item) && item.trim())
@@ -46,12 +59,17 @@ export class Translate extends Component {
     return super.render()
   }
 
+  /** @param {Event} event
+   * @returns {Promise<void>} */
   async onLanguageChanged (event) {
     event.stopPropagation()
-    const language = event.target.value
+    const target = /** @type {HTMLSelectElement|null} */ (event.target)
+    const language = target?.value
     await this.transliterate({ language })
   }
 
+  /** @param {TransliterateOptions} options
+   * @returns {Promise<void>} */
   async transliterate (options = {}) {
     const language = options.language || 'es'
     const root = this.global.document.querySelector(
@@ -67,12 +85,15 @@ export class Translate extends Component {
           language, namespace
         )
       )
-      const dictionary = dictionaries[namespace]
+      const dictionary = /** @type {Record<string, string>} */ (
+        dictionaries[namespace])
 
       node.textContent = dictionary[key] || node.textContent
     }
   }
 
+  /** @param {string} value
+   * @returns {TranslatedKey} */
   parseKey (value) {
     let key = value
     let namespace = this.namespace
@@ -86,26 +107,36 @@ export class Translate extends Component {
     return { key, namespace }
   }
 
+  /** @param {string} language
+   * @param {string} namespace
+   * @returns {Promise<Record<string,string>>} */
   async resolveDictionary (language, namespace) {
-    let dictionary = ((this.dictionary[language] ||
-        {})[namespace] || null)
+    /** @type {DictionaryStore} */
+    const translations = this.dictionary
+    /** @type {Record<string, string>|null} */
+    let dictionary = /** @type {Record<string, string>|null} */ (
+      /** @type {unknown} */ (translations[language]?.[namespace]) || null)
 
     if (dictionary !== null) return dictionary
 
-    if (!this.global.fetch) return {}
+    if (!this.global.fetch) return /** @type {Record<string, string>} */ ({})
 
     const url = `${this.endpoint}/${language}/${namespace}.json`
     try {
       const response = await this.global.fetch(url)
-      if (response.ok === false) return {}
-      dictionary = await response.json()
+      if (response.ok === false) return /** @type {Record<string, string>} */ ({})
+      dictionary = /** @type {Record<string, string>} */ (
+        await response.json())
     } catch (error) {
       this.emit('error', error)
-      return {}
+      return /** @type {Record<string, string>} */ ({})
     }
 
-    this.dictionary[language] || (this.dictionary[language] = {})
-    this.dictionary[language][namespace] = dictionary
+    const cache = /** @type {Record<string, Record<string, Record<string, string>>>} */ (
+      /** @type {unknown} */ (translations))
+    cache[language] = cache[language] || {}
+    cache[language][namespace] = /** @type {Record<string, string>} */ (
+      /** @type {unknown} */ (dictionary || {}))
 
     return dictionary
   }

package/lib/components/translate/components/translate.test.js

@@ -182,6 +182,27 @@ it('translates the page content on language changes', async () => {
   assert.deepStrictEqual(givenOptions, { language: 'en' })
 })
 
+it('passes an undefined language when language change event has no target', async () => {
+  setup()
+  const translateContainer = document.createElement('div')
+  translateContainer.innerHTML = '<ark-translate></ark-translate>'
+  container.appendChild(translateContainer)
+  const translate = /** @type Translate **/ (
+    translateContainer.querySelector('ark-translate'))
+  let givenOptions = null
+
+  translate.transliterate = async (options) => {
+    givenOptions = options
+  }
+
+  await translate.onLanguageChanged({
+    stopPropagation: () => {},
+    target: null
+  })
+
+  assert.deepStrictEqual(givenOptions, { language: undefined })
+})
+
 it('fetches its translation files from the server', async () => {
   setup();
   const root = document.createElement('div')
@@ -581,4 +602,151 @@ it('renders the translate component with an empty dictionary', async () => {
     </p>
   `
   assert.deepStrictEqual(root, expectedRoot)
-})
+})
+
+it('does not render language options for an empty language list', () => {
+  setup()
+  container.innerHTML = '<ark-translate languages=""></ark-translate>'
+  const translate = container.querySelector('ark-translate')
+
+  translate.init()
+
+  const select = translate.querySelector('select')
+  assert.equal(select, null)
+})
+
+it('does nothing when the configured transliterate root does not exist', async () => {
+  setup()
+  const root = document.createElement('div')
+  root.innerHTML = /* html */`
+  <span data-i18n="hello">Hello</span>
+  `
+  root.id = 'translations'
+  container.appendChild(root)
+  const translateContainer = document.createElement('div')
+  translateContainer.innerHTML = '<ark-translate></ark-translate>'
+  container.appendChild(translateContainer)
+  const translate = /** @type Translate **/ (
+    translateContainer.querySelector('ark-translate'))
+
+  let called = false
+  translate.resolveDictionary = async () => {
+    called = true
+    return {}
+  }
+
+  await translate.transliterate({ root: '#missing-root' })
+
+  assert.equal(called, false)
+})
+
+it('returns an empty dictionary when no fetch API is available', async () => {
+  setup()
+  const translateContainer = document.createElement('div')
+  translateContainer.innerHTML = '<ark-translate></ark-translate>'
+  container.appendChild(translateContainer)
+  const translate = /** @type Translate **/ (
+    translateContainer.querySelector('ark-translate'))
+
+  translate.init({ global: { document } })
+
+  const dictionary = await translate.resolveDictionary('es', 'default')
+  assert.deepStrictEqual(dictionary, {})
+})
+
+it('keeps original text when translation endpoint returns a non-ok response', async () => {
+  setup()
+  const root = document.createElement('div')
+  root.innerHTML = /* html */`
+  <span data-i18n="hello">Hello</span>
+  `
+  root.id = 'translate-root'
+  container.appendChild(root)
+  const translateContainer = document.createElement('div')
+  translateContainer.innerHTML = '<ark-translate languages="es"></ark-translate>'
+  container.appendChild(translateContainer)
+  const translate = /** @type Translate **/ (
+    translateContainer.querySelector('ark-translate'))
+  let requestedUrl = null
+
+  translate.init({
+    root: '#translate-root',
+    global: {
+      document,
+      fetch: async (url) => {
+        requestedUrl = url
+        return { ok: false }
+      }
+    }
+  })
+
+  await translate.transliterate({ language: 'es' })
+
+  assert.equal(requestedUrl, '/locales/es/default.json')
+  assert.equal(root.querySelector('[data-i18n="hello"]').textContent, 'Hello')
+})
+
+it('stores an empty dictionary cache entry when fetch returns null JSON', async () => {
+  setup()
+  const translateContainer = document.createElement('div')
+  translateContainer.innerHTML = '<ark-translate></ark-translate>'
+  container.appendChild(translateContainer)
+  const translate = /** @type Translate **/ (
+    translateContainer.querySelector('ark-translate'))
+
+  translate.init({
+    global: {
+      document,
+      fetch: async () => ({
+        ok: true,
+        json: async () => null
+      })
+    }
+  })
+
+  const dictionary = await translate.resolveDictionary('es', 'default')
+
+  assert.equal(dictionary, null)
+  assert.deepStrictEqual(translate.dictionary.es.default, {})
+})
+
+it('reuses cached dictionaries for repeated transliterations', async () => {
+  setup()
+  const root = document.createElement('div')
+  root.innerHTML = /* html */`
+  <span data-i18n="hello">Hello</span>
+  <span data-i18n="world">World</span>
+  `
+  root.id = 'translate-root'
+  container.appendChild(root)
+  const translateContainer = document.createElement('div')
+  translateContainer.innerHTML = '<ark-translate></ark-translate>'
+  container.appendChild(translateContainer)
+  const translate = /** @type Translate **/ (
+    translateContainer.querySelector('ark-translate'))
+
+  let fetchCalls = 0
+  translate.init({
+    root: '#translate-root',
+    global: {
+      document,
+      fetch: async () => {
+        fetchCalls += 1
+        return {
+          ok: true,
+          json: async () => ({
+            hello: 'Hola',
+            world: 'Mundo'
+          })
+        }
+      }
+    }
+  })
+
+  await translate.transliterate({ language: 'es' })
+  await translate.transliterate({ language: 'es' })
+
+  assert.equal(fetchCalls, 1)
+  assert.equal(root.querySelector('[data-i18n="hello"]').textContent, 'Hola')
+  assert.equal(root.querySelector('[data-i18n="world"]').textContent, 'Mundo')
+})

package/lib/components/translate/index.js

@@ -1 +1,2 @@
+/** Translation component. */
 export { Translate } from './components/translate.js'

package/lib/index.js

@@ -1,2 +1,5 @@
+/**
+ * @module componark
+ */
 export * from './base/index.js'
 export * from './components/index.js'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowark/componarkjs",
-  "version": "1.14.0",
+  "version": "1.14.1",
   "author": "Knowark",
   "description": "Knowark's Web Components Library",
   "license": "ISC",
@@ -9,6 +9,7 @@
   "types": "types/index.d.ts",
   "scripts": {
     "test": "NODE_OPTIONS='--no-warnings' node --test --experimental-test-coverage --test-coverage-include='lib/**/*.js' --test-coverage-exclude='**/*.test.js' --import ./scripts/node-test-setup.js",
+    "types": "tsc -p tsconfig.json --emitDeclarationOnly false --noEmit --checkJs false",
     "dev": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' webpack serve --mode development --env development",
     "prod": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' webpack --mode production --env production"
   },

package/tsconfig.json

@@ -5,7 +5,7 @@
     "module": "nodenext",
     "moduleResolution": "nodenext",
     "allowJs": true,
-    "checkJs": true,
+    "checkJs": false,
     "baseUrl": "lib",
     "declaration": true,
     "emitDeclarationOnly": true,

package/types/base/component/component.d.ts

@@ -1,11 +1,22 @@
+/**
+ * Base composable UI component.
+ * @extends {globalThis.HTMLElement}
+ */
 export class Component extends HTMLElement {
     /**
-     * @param {string} tag
+     * Register a custom element and optional CSS for the same tag.
+     * @param {string} tagName
      * @param {CustomElementConstructor} element
-     * @param {string} styles **/
-    static define(tag: string, element: CustomElementConstructor, styles?: string): void;
+     * @param {string} [styles]
+     * @returns {void}
+     */
+    static define(tagName: string, element: CustomElementConstructor, styles?: string): void;
     binding: string;
     local: {};
+    _isConnected: boolean;
+    _cleanupCallbacks: any[];
+    _needsBinding: boolean;
+    global: typeof globalThis;
     /**
      * @param {object} styleMap
      * @return {string} **/
@@ -16,18 +27,24 @@ export class Component extends HTMLElement {
     init(context?: object): Component;
     /** @return {string[]} */
     reflectedProperties(): string[];
-    get slots(): {
-        [x: string]: HTMLElement[];
-    };
+    get slots(): Record<string, HTMLElement[]>;
     /** @param {string} content */
     set content(content: string);
     /** @return {string} */
     get content(): string;
+    /** @returns {void} */
     connectedCallback(): void;
+    /** @returns {void} */
+    disconnectedCallback(): void;
+    /**
+     * @param {Function} callback
+     * @return {Function} */
+    registerCleanup(callback: Function): Function;
     /** @return {Component} */
     render(): Component;
-    /** @param {object} context */
-    load(context?: object): Promise<void>;
+    /** @param {object} context
+     * @returns {void | Promise<void>} */
+    load(context?: object): void | Promise<void>;
     /**
      * @param {string} selectors
      * @return {Component} */
@@ -44,5 +61,23 @@ export class Component extends HTMLElement {
      * @param {string} resource
      * @return {any} */
     resolve(resource: string): any;
+    /**
+     * @param {any} detail
+     * @param {string} phase
+     * @return {Error} */
+    _enhanceError(detail: any, phase: string): Error;
+    /** @returns {void} */
+    _cleanup(): void;
+    /**
+     * Creates an event object for dispatch.
+     * @param {string} type
+     * @param {any} detail
+     * @param {{ bubbles?: boolean, cancelable?: boolean }} [options]
+     * @returns {CustomEvent}
+     */
+    _createEvent(type: string, detail: any, options?: {
+        bubbles?: boolean;
+        cancelable?: boolean;
+    }): CustomEvent;
 }
 //# sourceMappingURL=component.d.ts.map

package/types/base/component/component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../../lib/base/component/component.js"],"names":[],"mappings":"AAIA;IAQE;;;iCAG6B;IAC7B,mBAHW,MAAM,WACN,wBAAwB,WACxB,MAAM,QAGhB;IAXC,gBAAuB;IACvB,UAAe;IAYjB;;2BAEuB;IACvB,qBAFW,MAAM,GACL,MAAM,CAGjB;IAED;;6BAEyB;IACzB,eAFW,MAAM,GACL,SAAS,CAGpB;IAED,yBAAyB;IACzB,uBADa,MAAM,EAAE,CAGpB;IAED;;MAEC;IAED,8BAA8B;IAC9B,6BAEC;IAED,uBAAuB;IACvB,sBAEC;IAED,0BASC;IAED,0BAA0B;IAC1B,UADa,SAAS,CAKrB;IAED,8BAA8B;IAC9B,eADY,MAAM,iBACU;IAE5B;;6BAEyB;IACzB,kBAFW,MAAM,GACL,SAAS,CAGpB;IAED;;yCAEqC;IACrC,qBAFW,MAAM,GACL,UAAU,CAAC,SAAS,CAAC,CAKhC;IAED;;6BAEyB;IACzB,WAFW,MAAM,UACN,GAAG,QASb;IAED;;uBAEmB;IACnB,kBAFW,MAAM,GACL,GAAG,CASd;CACF"}
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../../lib/base/component/component.js"],"names":[],"mappings":"AAIA;;;GAGG;AACH;IAYE;;;;;;OAMG;IACH,uBALW,MAAM,WACN,wBAAwB,WACxB,MAAM,GACJ,IAAI,CAIhB;IAlBC,gBAAuB;IACvB,UAAe;IACf,sBAAyB;IACzB,yBAA2B;IAC3B,uBAAyB;IACzB,0BAAwB;IAe1B;;2BAEuB;IACvB,qBAFW,MAAM,GACL,MAAM,CAGjB;IAED;;6BAEyB;IACzB,eAFW,MAAM,GACL,SAAS,CAGpB;IAED,yBAAyB;IACzB,uBADa,MAAM,EAAE,CAGpB;IAED,2CAEC;IAED,8BAA8B;IAC9B,6BAGC;IAED,uBAAuB;IACvB,sBAEC;IAED,sBAAsB;IACtB,qBADc,IAAI,CAqBjB;IAED,sBAAsB;IACtB,wBADc,IAAI,CAIjB;IAED;;4BAEwB;IACxB,8CASC;IAED,0BAA0B;IAC1B,UADa,SAAS,CAQrB;IAED;yCACqC;IACrC,eAFY,MAAM,GACL,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CACX;IAEtB;;6BAEyB;IACzB,kBAFW,MAAM,GACL,SAAS,CAGpB;IAED;;yCAEqC;IACrC,qBAFW,MAAM,GACL,UAAU,CAAC,SAAS,CAAC,CAKhC;IAED;;6BAEyB;IACzB,WAFW,MAAM,UACN,GAAG,QAMb;IAED;;uBAEmB;IACnB,kBAFW,MAAM,GACL,GAAG,CAQd;IAED;;;yBAGqB;IACrB,sBAHW,GAAG,SACH,MAAM,GACL,KAAK,CAYhB;IAED,sBAAsB;IACtB,YADc,IAAI,CAYjB;IAED;;;;;;OAMG;IACH,mBALW,MAAM,UACN,GAAG,YACH;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GACzC,WAAW,CAkBvB;CACF"}

package/types/base/component/index.d.ts

@@ -1,8 +1,6 @@
 export { Component } from "./component.js";
-export const css: (template: {
-    raw: readonly string[] | ArrayLike<string>;
-}, ...substitutions: any[]) => string;
-export const html: (template: {
-    raw: readonly string[] | ArrayLike<string>;
-}, ...substitutions: any[]) => string;
+/** @type {typeof String.raw} */
+export const css: typeof String.raw;
+/** @type {typeof String.raw} */
+export const html: typeof String.raw;
 //# sourceMappingURL=index.d.ts.map

package/types/base/component/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/base/component/index.js"],"names":[],"mappings":";AACA;;sCAA6B;AAC7B;;sCAA8B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/base/component/index.js"],"names":[],"mappings":";AAEA,gCAAgC;AAChC,kBADW,OAAO,MAAM,CAAC,GAAG,CACC;AAC7B,gCAAgC;AAChC,mBADW,OAAO,MAAM,CAAC,GAAG,CACE"}

package/types/base/styles/index.d.ts

@@ -1,3 +1,4 @@
-export default styles;
-import styles from './styles.js';
+export default stylesText;
+/** @type {string} */
+declare const stylesText: string;
 //# sourceMappingURL=index.d.ts.map

package/types/base/styles/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/base/styles/index.js"],"names":[],"mappings":";mBAAmB,aAAa"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/base/styles/index.js"],"names":[],"mappings":";AAEA,qBAAqB;AACrB,0BADW,MAAM,CACQ"}

package/types/base/utils/define.d.ts

@@ -1,5 +1,6 @@
 /** @param {string} tag
  * @param {CustomElementConstructor} element
- * @param {string} styles **/
-export function define(tag: string, element: CustomElementConstructor, styles?: string): CSSStyleSheet[];
+ * @param {string} [styles]
+ * @returns {CSSStyleSheet|HTMLStyleElement|undefined} */
+export function define(tag: string, element: CustomElementConstructor, styles?: string): CSSStyleSheet | HTMLStyleElement | undefined;
 //# sourceMappingURL=define.d.ts.map

package/types/base/utils/define.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../../lib/base/utils/define.js"],"names":[],"mappings":"AAEA;;6BAE6B;AAC7B,4BAHY,MAAM,WACP,wBAAwB,WACxB,MAAM,mBAehB"}
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../../lib/base/utils/define.js"],"names":[],"mappings":"AAKA;;;yDAGyD;AACzD,4BAJY,MAAM,WACP,wBAAwB,WACxB,MAAM,GACJ,aAAa,GAAC,gBAAgB,GAAC,SAAS,CAkCpD"}

package/types/base/utils/format.d.ts

@@ -1,13 +1,19 @@
 /**
- * Convert Strings from camelCase to kebab-case
- * @param {string} input @returns {string} */
+ * Convert Strings from camelCase to kebab-case.
+ * @param {string} input
+ * @returns {string}
+ */
 export function camelToKebab(input: string): string;
 /**
- * Convert Strings from kebab-case to camelCase
- * @param {string} input @returns {string} */
+ * Convert Strings from kebab-case to camelCase.
+ * @param {string} input
+ * @returns {string}
+ */
 export function kebabToCamel(input: string): string;
 /**
- * Convert Strings from snake to camelCase
- * @param {string} input @returns {string} */
+ * Convert Strings from snake to camelCase.
+ * @param {string} input
+ * @returns {string}
+ */
 export function snakeToCamel(input: string): string;
 //# sourceMappingURL=format.d.ts.map

package/types/base/utils/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../lib/base/utils/format.js"],"names":[],"mappings":"AAAA;;6CAE6C;AAC7C,oCADW,MAAM,GAAkB,MAAM,CAGxC;AAED;;6CAE6C;AAC7C,oCADW,MAAM,GAAkB,MAAM,CAKxC;AAED;;6CAE6C;AAC7C,oCADW,MAAM,GAAkB,MAAM,CAKxC"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../lib/base/utils/format.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,oCAHW,MAAM,GACJ,MAAM,CAIlB;AAED;;;;GAIG;AACH,oCAHW,MAAM,GACJ,MAAM,CAMlB;AAED;;;;GAIG;AACH,oCAHW,MAAM,GACJ,MAAM,CAMlB"}

package/types/base/utils/helpers.d.ts

@@ -1,11 +1,31 @@
-/** @param {HTMLElement} self */
-export function listen(self: HTMLElement): void;
+/**
+ * Binds declarative event handlers in descendant nodes for a component.
+ * @param {Component|HTMLElement} self
+ * @returns {void}
+ */
+export function listen(self: Component | HTMLElement): void;
 /** @param {HTMLElement} self @param {string[]} properties */
 export function reflect(self: HTMLElement, properties: string[]): void;
-/** @param {object} object @param {string} path @param {any} value */
-export function set(object: object, path: string, value: any): void;
-/** @param {object} object @param {string} path @param {any} fallback */
-export function get(object: object, path: string, fallback: any): any;
-/** @param {object} object @return {string} */
+/**
+ * Sets a nested property value by object path.
+ * @param {unknown} object
+ * @param {string} path
+ * @param {any} value
+ * @returns {void}
+ */
+export function set(object: unknown, path: string, value: any): void;
+/**
+ * Reads a nested property value by path.
+ * @param {unknown} object
+ * @param {string} path
+ * @param {any} fallback
+ * @returns {any}
+ */
+export function get(object: unknown, path: string, fallback: any): any;
+/** @param {object} object
+ * @return {string}
+ * @description Returns truthy CSS class names from object values.
+ */
 export function keys(object: object): string;
+import type { Component } from '../component/component.js';
 //# sourceMappingURL=helpers.d.ts.map

package/types/base/utils/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../lib/base/utils/helpers.js"],"names":[],"mappings":"AAEA,gCAAgC;AAChC,6BADY,WAAW,QAyDtB;AAeD,6DAA6D;AAC7D,8BADY,WAAW,cAAe,MAAM,EAAE,QAiB7C;AAUD,qEAAqE;AACrE,4BADY,MAAM,QAAiB,MAAM,SAAe,GAAG,QAS1D;AAED,wEAAwE;AACxE,4BADY,MAAM,QAAiB,MAAM,YAAe,GAAG,OAM1D;AAED,8CAA8C;AAC9C,6BADY,MAAM,GAAkB,MAAM,CAIzC"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../lib/base/utils/helpers.js"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,6BAHW,SAAS,GAAC,WAAW,GACnB,IAAI,CA6DhB;AAmBD,6DAA6D;AAC7D,8BADY,WAAW,cAAe,MAAM,EAAE,QAiB7C;AAUD;;;;;;GAMG;AACH,4BALW,OAAO,QACP,MAAM,SACN,GAAG,GACD,IAAI,CAWhB;AAED;;;;;;GAMG;AACH,4BALW,OAAO,QACP,MAAM,YACN,GAAG,GACD,GAAG,CAUf;AAED;;;GAGG;AACH,6BAJY,MAAM,GACN,MAAM,CAMjB;+BA5J6B,2BAA2B"}

package/types/base/utils/slots.d.ts

@@ -1,15 +1,13 @@
 /**
+ * Groups child nodes by slot name.
  * @param {HTMLElement} container
- * @return {Object<string, Array<HTMLElement>>}
- * */
-export function getSlots(container: HTMLElement): {
-    [x: string]: Array<HTMLElement>;
-};
+ * @returns {Record<string, HTMLElement[]>}
+ */
+export function getSlots(container: HTMLElement): Record<string, HTMLElement[]>;
 /**
+ * Groups child nodes by slot name.
  * @param {HTMLElement} container
- * @return {Object<string, Array<HTMLElement>>}
- * */
-export function slot(container: HTMLElement): {
-    [x: string]: Array<HTMLElement>;
-};
+ * @returns {Record<string, HTMLElement[]>}
+ */
+export function slot(container: HTMLElement): Record<string, HTMLElement[]>;
 //# sourceMappingURL=slots.d.ts.map

package/types/base/utils/slots.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../../lib/base/utils/slots.js"],"names":[],"mappings":"AAAA;;;KAGK;AACL,oCAHW,WAAW,GACV;QAAO,MAAM,GAAE,KAAK,CAAC,WAAW,CAAC;CAAC,CAa7C;AAfD;;;KAGK;AACL,gCAHW,WAAW,GACV;QAAO,MAAM,GAAE,KAAK,CAAC,WAAW,CAAC;CAAC,CAa7C"}
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../../lib/base/utils/slots.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,oCAHW,WAAW,GACT,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAazC;AAhBD;;;;GAIG;AACH,gCAHW,WAAW,GACT,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAazC"}

package/types/base/utils/uuid.d.ts

@@ -1,3 +1,3 @@
-/** @returns {string} */
+/** @returns {string} Generated RFC-4122-like identifier. */
 export function uuid(): string;
 //# sourceMappingURL=uuid.d.ts.map

package/types/base/utils/uuid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../../lib/base/utils/uuid.js"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,wBADc,MAAM,CAQnB"}
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../../lib/base/utils/uuid.js"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,wBADc,MAAM,CAQnB"}