feat(core): rename fromChild() -> fromDescendant(), fromChildren() ->

fromDescendants() for precise term

Author: estherbrunner

docs-src/components/module-catalog/module-catalog.ts

@@ -1,4 +1,4 @@
-import { type Component, component, fromChildren, pass } from '../../..'
+import { type Component, component, fromDescendants, pass } from '../../..'
 
 export type ModuleCatalogProps = {
 	total: number
@@ -7,7 +7,7 @@ export type ModuleCatalogProps = {
 export default component(
 	'product-catalog',
 	{
-		total: fromChildren<number, HTMLElement & { value: number }>(
+		total: fromDescendants<number, HTMLElement & { value: number }>(
 			'form-spinbutton',
 			(sum, item) => sum + item.value,
 			0,

docs-src/pages/api.md

@@ -19,7 +19,7 @@ description: 'Functions, types, and constants'
 
 ## Component
 
-Create a Web Component of type [Component](api/type-aliases/Component.html):
+Create a Web Component of type [Component](api/type-aliases/Component.html) with reactive properties that extend [ComponentProps](api/type-aliases/ComponentProps.html).
 
 - [component](api/functions/component.html)
 
@@ -29,28 +29,28 @@ Create a Web Component of type [Component](api/type-aliases/Component.html):
 
 ## Signals
 
-Create a signal of type [Signal](api/type-aliases/Signal.html):
+Create a signal of type [Signal](api/type-aliases/Signal.html).
 
-- [computed](api/functions/computed.html)
-- [selection](api/functions/selection.html)
-- [sensor](api/functions/sensor.html)
-- [state](api/functions/state.html)
+- [computed](api/functions/computed.html) creates a [Computed](api/type-aliases/Computed.html) signal derived from other signals
+- [selection](api/functions/selection.html) creates a [Computed](api/type-aliases/Computed.html) signal that updates according to a dynamic CSS selector
+- [sensor](api/functions/sensor.html) creates a [Computed](api/type-aliases/Computed.html) signal that updates according to events
+- [state](api/functions/state.html) creates a [State](api/type-aliases/State.html) signal
 
 Helper functions:
 
-- [isComputed](api/functions/isComputed.html)
-- [isSignal](api/functions/isSignal.html)
-- [isState](api/functions/isState.html)
+- [isComputed](api/functions/isComputed.html) checks whether a value is a [Computed](api/type-aliases/Computed.html) signal
+- [isSignal](api/functions/isSignal.html) checks whether a value is a [Signal](api/type-aliases/Signal.html)
+- [isState](api/functions/isState.html) checks whether a value is a [State](api/type-aliases/State.html) signal
 
 </section>
 
 <section>
 
 ## Attribute Parsers
 
-Declare how attributes are parsed. Variable of type or function returning [AttributeParser](api/type-aliases/AttributeParser.html):
+Declare how attributes are parsed. Functions returning [AttributeParser](api/type-aliases/AttributeParser.html) that will be used to create [State](api/type-aliases/State.html) signals as reactive properties on the component.
 
-- [asBoolean](api/variables/asBoolean.html)
+- [asBoolean](api/functions/asBoolean.html)
 - [asEnum](api/functions/asEnum.html)
 - [asInteger](api/functions/asInteger.html)
 - [asJSON](api/functions/asJSON.html)
@@ -65,11 +65,11 @@ Declare how attributes are parsed. Variable of type or function returning [Attri
 
 Declare how signals are initialized. Variable of type or function returning [SignalInitializer](api/type-aliases/SignalInitializer.html):
 
-- [consume](api/functions/consume.html)
-- [fromChild](api/functions/fromChild.html)
-- [fromChildren](api/functions/fromChildren.html)
-- [fromEvent](api/functions/fromEvent.html)
-- [fromSelector](api/functions/fromSelector.html)
+- [fromContext](api/functions/fromContext.html) consumes a context value from nearest ancestor context provider component
+- [fromDescendant](api/functions/fromDescendant.html) gets a reactive property of a descendant component
+- [fromDescendants](api/functions/fromDescendants.html) reduces properties of a collection of descendant elements to a single value
+- [fromEvent](api/functions/fromEvent.html) creates a computed signal from an event handler on a descendant element
+- [fromSelector](api/functions/fromSelector.html) creates a computed signal of descentant elements matching a CSS selector
 
 </section>
 

docs-src/pages/api/functions/asBoolean.md

@@ -0,0 +1,21 @@
+[**@zeix/ui-element**](../README.md)
+
+***
+
+[@zeix/ui-element](../globals.md) / asBoolean
+
+# Function: asBoolean()
+
+> **asBoolean**(): [`AttributeParser`](../type-aliases/AttributeParser.md)\<`boolean`\>
+
+Defined in: [src/lib/parsers.ts:23](https://github.com/zeixcom/ui-element/blob/0b9c1517fa2a3615fdcca3ecc679ebb5c5c255e7/src/lib/parsers.ts#L23)
+
+Parse a boolean attribute as an actual boolean value
+
+## Returns
+
+[`AttributeParser`](../type-aliases/AttributeParser.md)\<`boolean`\>
+
+## Since
+
+0.13.1

docs-src/pages/api/functions/asEnum.md

@@ -8,7 +8,7 @@
 
 > **asEnum**(`valid`): [`AttributeParser`](../type-aliases/AttributeParser.md)\<`string`\>
 
-Defined in: [src/lib/parsers.ts:86](https://github.com/zeixcom/ui-element/blob/ef7525ef4fcd5329d68c2b65cc085220a29b7a4f/src/lib/parsers.ts#L86)
+Defined in: [src/lib/parsers.ts:86](https://github.com/zeixcom/ui-element/blob/0b9c1517fa2a3615fdcca3ecc679ebb5c5c255e7/src/lib/parsers.ts#L86)
 
 Parse an attribute as a multi-state value (for examnple: true, false, mixed), defaulting to the first valid option
 

docs-src/pages/api/functions/asInteger.md

@@ -8,7 +8,7 @@
 
 > **asInteger**(`fallback?`): [`AttributeParser`](../type-aliases/AttributeParser.md)\<`number`\>
 
-Defined in: [src/lib/parsers.ts:37](https://github.com/zeixcom/ui-element/blob/ef7525ef4fcd5329d68c2b65cc085220a29b7a4f/src/lib/parsers.ts#L37)
+Defined in: [src/lib/parsers.ts:37](https://github.com/zeixcom/ui-element/blob/0b9c1517fa2a3615fdcca3ecc679ebb5c5c255e7/src/lib/parsers.ts#L37)
 
 Parse an attribute as as number forced to integer with a fallback
 

docs-src/pages/api/functions/asJSON.md

@@ -8,7 +8,7 @@
 
 > **asJSON**\<`T`\>(`fallback`): [`AttributeParser`](../type-aliases/AttributeParser.md)\<`T`\>
 
-Defined in: [src/lib/parsers.ts:104](https://github.com/zeixcom/ui-element/blob/ef7525ef4fcd5329d68c2b65cc085220a29b7a4f/src/lib/parsers.ts#L104)
+Defined in: [src/lib/parsers.ts:104](https://github.com/zeixcom/ui-element/blob/0b9c1517fa2a3615fdcca3ecc679ebb5c5c255e7/src/lib/parsers.ts#L104)
 
 Parse an attribute as a JSON serialized object with a fallback
 

docs-src/pages/api/functions/asNumber.md

@@ -8,7 +8,7 @@
 
 > **asNumber**(`fallback?`): [`AttributeParser`](../type-aliases/AttributeParser.md)\<`number`\>
 
-Defined in: [src/lib/parsers.ts:62](https://github.com/zeixcom/ui-element/blob/ef7525ef4fcd5329d68c2b65cc085220a29b7a4f/src/lib/parsers.ts#L62)
+Defined in: [src/lib/parsers.ts:62](https://github.com/zeixcom/ui-element/blob/0b9c1517fa2a3615fdcca3ecc679ebb5c5c255e7/src/lib/parsers.ts#L62)
 
 Parse an attribute as as number with a fallback
 

docs-src/pages/api/functions/asString.md

@@ -8,7 +8,7 @@
 
 > **asString**(`fallback?`): [`AttributeParser`](../type-aliases/AttributeParser.md)\<`string`\>
 
-Defined in: [src/lib/parsers.ts:74](https://github.com/zeixcom/ui-element/blob/ef7525ef4fcd5329d68c2b65cc085220a29b7a4f/src/lib/parsers.ts#L74)
+Defined in: [src/lib/parsers.ts:74](https://github.com/zeixcom/ui-element/blob/0b9c1517fa2a3615fdcca3ecc679ebb5c5c255e7/src/lib/parsers.ts#L74)
 
 Parse an attribute as a string with a fallback
 

docs-src/pages/api/functions/component.md

@@ -8,7 +8,7 @@
 
 > **component**\<`P`\>(`name`, `init`, `setup`): [`Component`](../type-aliases/Component.md)\<`P`\>
 
-Defined in: [src/component.ts:279](https://github.com/zeixcom/ui-element/blob/ef7525ef4fcd5329d68c2b65cc085220a29b7a4f/src/component.ts#L279)
+Defined in: [src/component.ts:279](https://github.com/zeixcom/ui-element/blob/0b9c1517fa2a3615fdcca3ecc679ebb5c5c255e7/src/component.ts#L279)
 
 Define a component with its states and setup function (connectedCallback)
 

docs-src/pages/api/functions/dangerouslySetInnerHTML.md

@@ -8,7 +8,7 @@
 
 > **dangerouslySetInnerHTML**\<`P`, `E`\>(`s`, `options`): [`FxFunction`](../type-aliases/FxFunction.md)\<`P`, `E`\>
 
-Defined in: [src/lib/effects.ts:448](https://github.com/zeixcom/ui-element/blob/ef7525ef4fcd5329d68c2b65cc085220a29b7a4f/src/lib/effects.ts#L448)
+Defined in: [src/lib/effects.ts:448](https://github.com/zeixcom/ui-element/blob/0b9c1517fa2a3615fdcca3ecc679ebb5c5c255e7/src/lib/effects.ts#L448)
 
 Set inner HTML of an element