@knowark/componarkjs 1.14.0 → 1.14.2

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.2",
   "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"}

package/types/components/audio/components/audio.d.ts

@@ -1,18 +1,32 @@
+/**
+ * Audio recorder component.
+ * Emits:
+ * - `error` with `Error` detail on capture/rendering issues.
+ */
 export class Audio extends Component {
-    init(context?: {}): Component;
-    status: string;
-    dataURL: any;
-    timerId: NodeJS.Timer;
-    recorder: any;
-    global: any;
-    /** @param {Event} event */
+    /** @param {object} context
+     *  @returns {Audio} */
+    init(context?: object): Audio;
+    /** @type {'idle'|'recording'|'done'} */
+    status: "idle" | "recording" | "done";
+    dataURL: string | ArrayBuffer;
+    timerId: NodeJS.Timeout;
+    recorder: MediaRecorder;
+    objectURL: string;
+    /** @param {Event} event
+     *  @returns {Promise<void>} */
     start(event: Event): Promise<void>;
-    /** @param {Event} event */
+    /** @param {Event} event
+     *  @returns {void} */
     stop(event: Event): void;
+    /** @returns {void} */
     reset(): void;
-    _time(): NodeJS.Timer;
+    /** @returns {ReturnType<typeof setInterval>} Interval handle. */
+    _time(): ReturnType<typeof setInterval>;
     /** @param {any} event */
     _onData(event: any): void;
+    /** @returns {void} */
+    _revokeObjectURL(): void;
 }
 import { Component } from '#base/index.js';
 //# sourceMappingURL=audio.d.ts.map

package/types/components/audio/components/audio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../../../lib/components/audio/components/audio.js"],"names":[],"mappings":"AAIA;IACE,8BAQC;IAPC,eAAoB;IACpB,aAAmB;IACnB,sBAAmB;IACnB,cAAoB;IACpB,YAAsC;IAoCxC,2BAA2B;IAC3B,aADY,KAAK,iBAahB;IAED,2BAA2B;IAC3B,YADY,KAAK,QAQhB;IAED,cAMC;IAED,sBAYC;IAED,yBAAyB;IACzB,eADY,GAAG,QAQd;CACF;0BAtGyB,gBAAgB"}
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../../../lib/components/audio/components/audio.js"],"names":[],"mappings":"AAIA;;;;GAIG;AACH;IACE;2BACuB;IACvB,eAFY,MAAM,GACJ,KAAK,CAWlB;IATC,wCAAwC;IACxC,QADW,MAAM,GAAC,WAAW,GAAC,MAAM,CAChB;IACpB,8BAAmB;IACnB,wBAAmB;IACnB,wBAAoB;IACpB,kBAAqB;IAqCvB;mCAC+B;IAC/B,aAFY,KAAK,GACH,OAAO,CAAC,IAAI,CAAC,CAa1B;IAED;0BACsB;IACtB,YAFY,KAAK,GACH,IAAI,CAQjB;IAED,sBAAsB;IACtB,SADc,IAAI,CASjB;IAUD,iEAAiE;IACjE,SADc,UAAU,CAAC,OAAO,WAAW,CAAC,CAa3C;IAED,yBAAyB;IACzB,eADY,GAAG,QAUd;IAED,sBAAsB;IACtB,oBADc,IAAI,CAKjB;CACF;0BAtIyB,gBAAgB"}

package/types/components/audio/styles/index.d.ts

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

package/types/components/audio/styles/index.d.ts.map

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

package/types/components/camera/components/camera.d.ts

@@ -1,14 +1,22 @@
+/**
+ * Camera capture component.
+ */
 export class Camera extends Component {
-    init(context?: {}): Component;
+    /** @param {object} context
+     *  @returns {Camera} */
+    init(context?: object): Camera;
     width: any;
     height: any;
     facingMode: any;
-    global: any;
     /** @returns {string} */
     dataURL(width?: any, height?: any): string;
+    /** @returns {Promise<void>} */
     start(): Promise<void>;
+    /** @returns {void} */
     stop(): void;
-    setCameraOrientation(facingMode: any): Promise<void>;
+    /** @param {string} facingMode
+     *  @returns {Promise<void>} */
+    setCameraOrientation(facingMode: string): Promise<void>;
     /** @returns {HTMLVideoElement} */
     get video(): HTMLVideoElement;
     /** @returns {HTMLCanvasElement} */

package/types/components/camera/components/camera.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../../../../lib/components/camera/components/camera.js"],"names":[],"mappings":"AAIA;IACE,8BAOC;IANC,WAA+C;IAC/C,YAAkD;IAClD,gBAAiE;IACjE,YAAsC;IAyBxC,wBAAwB;IACxB,oCADc,MAAM,CAanB;IAED,uBAWC;IAED,aAIC;IAED,qDAIC;IAED,kCAAkC;IAClC,8BAEC;IAED,mCAAmC;IACnC,gCAEC;CACF;0BAnFyB,gBAAgB"}
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../../../../lib/components/camera/components/camera.js"],"names":[],"mappings":"AAIA;;GAEG;AACH;IACE;4BACwB;IACxB,eAFY,MAAM,GACJ,MAAM,CAQnB;IANC,WAA+C;IAC/C,YAAkD;IAClD,gBAAiE;IA0BnE,wBAAwB;IACxB,oCADc,MAAM,CAanB;IAED,+BAA+B;IAC/B,SADc,OAAO,CAAC,IAAI,CAAC,CAY1B;IAED,sBAAsB;IACtB,QADc,IAAI,CAKjB;IAED;mCAC+B;IAC/B,iCAFY,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAK1B;IAQD,kCAAkC;IAClC,8BAEC;IAED,mCAAmC;IACnC,gCAEC;CACF;0BAlGyB,gBAAgB"}

package/types/components/camera/styles/index.d.ts

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

package/types/components/camera/styles/index.d.ts.map

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

package/types/components/capture/components/capture.d.ts

@@ -1,10 +1,30 @@
+/** Template-driven renderer component. */
 export class Capture extends Component {
     receive: string;
+    /** @param {object} context
+     *  @returns {Capture} */
+    init(context?: object): Capture;
     source: any;
     template: any;
-    handle(event: any): void;
-    _format(template: any): (data: any) => any;
-    _pop(selector: any): any;
+    /** @param {{detail:any}} event */
+    handle(event: {
+        detail: any;
+    }): void;
+    /**
+     * @param {string} template
+     * @returns {(data: any) => string}
+     */
+    _format(template: string): (data: any) => string;
+    /**
+     * @param {string} selector
+     * @returns {HTMLElement|null}
+     */
+    _pop(selector: string): HTMLElement | null;
+    /**
+     * @param {string|null} source
+     * @returns {object|null}
+     */
+    _parseJSON(source: string | null): object | null;
 }
 import { Component } from "#base/index.js";
 //# sourceMappingURL=capture.d.ts.map

package/types/components/capture/components/capture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../../../lib/components/capture/components/capture.js"],"names":[],"mappings":"AAGA;IAGI,gBAAqC;IAWrC,YAC8C;IAC9C,cACsC;IAkBxC,yBAGC;IAED,2CAEC;IAED,yBAIC;CACF;0BApDyB,gBAAgB"}
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../../../lib/components/capture/components/capture.js"],"names":[],"mappings":"AAGA,0CAA0C;AAC1C;IAGI,gBAAqC;IAQvC;6BACyB;IACzB,eAFY,MAAM,GACJ,OAAO,CASpB;IANC,YAC8C;IAC9C,cACsC;IAkBxC,kCAAkC;IAClC,cADY;QAAC,MAAM,EAAC,GAAG,CAAA;KAAC,QAIvB;IAED;;;OAGG;IACH,kBAHW,MAAM,GACJ,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,CAqBjC;IAED;;;OAGG;IACH,eAHW,MAAM,GACJ,WAAW,GAAC,IAAI,CAM5B;IAED;;;OAGG;IACH,mBAHW,MAAM,GAAC,IAAI,GACT,MAAM,GAAC,IAAI,CAWvB;CACF;0BA/FyB,gBAAgB"}